Skip to main content

All our posts

使用 Nocalhost 开发 Rainbond 上的微服务应用

Qi Zhang

Qi Zhang

Cloud Native Enthusiasts

本文将介绍如何使用 Nocalhost 快速开发 Rainbond 上的微服务应用的开发流程以及实践操作步骤。

Nocalhost 可以直接在 Kubernetes 中开发应用，Rainbond 可以快速部署微服务项目，无需编写Yaml，Nocalhost 结合 Rainbond 加速我们的微服务开发效率。

一. 简介#

Nocalhost 是一款开源的基于 IDE 的云原生应用开发工具：

  • 直接在 Kubernetes 集群中构建、测试和调试应用程序
  • 提供易于使用的 IDE 插件（支持 VS Code 和 JetBrains），即使在 Kubernetes 集群中进行开发和调试，使用 Nocalhost 之后也能够获得和本地开发一样的开发体验
  • 使用即时文件同步进行开发： 即时将您的代码更改同步到远端容器，而无需重建镜像或重新启动容器。

Rainbond 是一款云原生应用管理平台：

  • 使用简单，不需要懂容器、Kubernetes和底层复杂技术，支持管理多个Kubernetes集群，和管理企业应用全生命周期。主要功能包括应用开发环境、应用市场、微服务架构、应用交付、应用运维、应用级多云管理等。

二. 本地 + Rainbond 开发微服务#

在以往的开发模式中，我们在本地 + Rainbond 开发微服务时，要开发的模块我们运行在本地，其他模块运行在 Rainbond 上，我们通过 Rainbond 的网关与本地进行通信、联调。

这种场景下，我们有以下问题急需解决：

  • 多人协作开发联调困难
  • 本地环境差异化
  • 无法通过注册中心(Nacos)调用其他微服务
  • 远程Debug较难
  • 受限于本地资源

三. 使用 Nocalhost + Rainbond 开发微服务#

现在我们通过 Nocalhost + Rainbond 开发微服务时，所有服务都运行在 Rainbond 上，在开发过程中可以使用 VSCode 插件 Nocalhost 连接进入到 Rainbond 组件中，并将本地代码实时同步到 Rainbond 组件中。多人开发联调时，可通过 Rainbond 内置的 Service Mesh 进行服务之间调用。

使用 Nocalhost 开发，可以解决本地开发时遇到的问题：

  • 多人联调开发更便捷
  • 服务都运行在 Rainbond 上，不再受限于本地
  • 与生产环境更接近
  • 远程Debug
  • 通过注册中心(Nacos)调用其他微服务组件

四. 实践操作步骤#

Nocalhost 目前支持两种开发模式：

  • Replace DevMode
  • Duplicate DevMode

本篇将主要介绍 Replace DevMode，当进入 Replace DevMode 时，Nocalhost 会对 组件 执行以下操作:

  1. 将副本数缩减为 1
  2. 替换容器的镜像为开发镜像
  3. 增加一个 sidecar 容器。
  4. 转发一个本地端口到文件同步服务器。
  5. 启动本地文件同步客户端。
  6. 打开远程终端。

4.1 安装 Nocalhost 插件#

Nocalhost IDE 插件支持 VSCode JetBrains ，这里我们主要介绍 VSCode 插件安装参考官网文档。

  1. 打开 VSCode，点击左侧的 Extension 按钮 img 图标
  2. 在搜索框中输入 Nocalhost 选择 Nocalhost 插件，并点击 Install 按钮

4.2 安装 Rainbond#

我们选择 基于主机安装 Rainbond

4.3 Nocalhost 对接 Rainbond 集群#

  1. 获取 kubeconfig 文件，进入 Rainbond 集群视图 -> 点击节点配置 -> kubeconfig

  1. 我们将 kubeconfig 文件复制到本地并保存为 yaml 文件。

  2. 打开 VSCode，点击按钮 ，打开 Nocalhost 插件，选择 Connect to Cluster，选择我们 kubeconfig 文件的路径，点击 Add Cluster，添加集群。

  3. 添加完成后，如下图：

4.4 在 Rainbond 上部署 Spring Cloud 应用#

  1. 这里选择从开源应用商店安装 Spring Cloud Pig 微服务组件，在应用商店中搜索 Pig 进行安装。

  2. 部署完成后，效果如下：

4.5 进入 Nocalhost 开发模式#

上面我们已经在本地 VSCode 中对接好了集群，并且也已经在 Rainbond 中安装了 Spring Cloud Pig 微服务，那么接下来我们在本地 VSCode 中选择其中一个组件进行开发，这里为了效果更明显，选择开发 pig-ui 组件。

Spring Cloud Pig 后端

Spring Cloud Pig 前端

4.5.1 克隆 Pig-ui 代码到本地#

git clone https://gitee.com/zhangbigqi/pig-ui

4.5.2 启动本地开发#

打开 VSCode，点击按钮 ，找到我们的 Pig-ui 组件，由于该应用是从开源应用商店中安装，Deployment名称是自动生成的字符串，我们需要在组件中查询下。

我们点击旁边的🔨进入开发模式，

  1. 提示选择容器，我们选择 gred5f1c 这个容器。

    另外一个容器是 Rainbond 默认注入的 sidecar 容器，用于组件之间的内部通信。

  2. 提示指定源代码目录，选择我们刚刚克隆下来的代码目录。
  3. 等待片刻后，会默认打开远端容器的终端界面并且将本地项目的文件同步至容器内，如下：

4.5.3 启动项目#

  1. 安装项目依赖，执行
npm install
  1. 运行项目
npm run dev

启动后效果如下，容器内端口为 80

  1. 开启端口转发，点击按钮 ，找到我们的 Deployment，右键选择 Port Forward，Add Port Forward，输入 38000:80 将容器的80端口转发到本地的38000端口。
  1. 通过 http://localhost:38000 可以访问到页面，并且也可以正常登录。

4.5.4 修改代码查看效果#

上面已经演示了如果通过本地访问到远端容器内的服务，接下来我们修改代码看下效果。

修改 src/page/wel.vue，新增一段代码，保存。可以发现，当我们保存的时候，终端中就自动重启了，与本地开发效果一致。

文件的修改会实时同步到容器中。

刷新页面http://localhost:38000，可以看到修改的内容已生效。

写在最后#

通过以上的实践步骤，我们已经可以通过 Nocalhost 开发 Rainbond 上的微服务应用，进入云原生快速开发，提升我们的开发效率。

本文仅介绍了基本的开发，还可以为项目配置 Nocalhost开发配置 等等，小伙伴们可以自行探索。