Nocalhost 为 KubeSphere 提供更强大的云原生开发环境

2021 年 11 月 30 日
本文字数：4905 字
阅读完需：约 16 分钟

作者简介：

张海立（驭势科技云平台研发总监）：开源爱好者，云原生社区上海站 PMC 成员，KubeSphere Ambassador；日常云原生领域工作涉及 Kubernetes、DevOps、可观察性、服务网格等。

玉易才：Nocalhost Maintainer，CKA、CKAD，Work From Home

KubeSphere 简介

KubeSphere^[1] 是在 Kubernetes 之上构建的以应用为中心的多租户容器平台，提供全栈的 IT 自动化运维的能力，简化企业的 DevOps 工作流。

KubeSphere 提供了运维友好的向导式操作界面，即便是 Kubernetes 经验并不丰富的用户，也能相对轻松地上手开始管理和使用。它提供了基于 Helm 的应用市场，可以在图形化界面下非常轻松地安装各种 Kubernetes 应用。

Nocalhost 简介

Nocalhost^[2] 是一个允许开发者直接在 Kubernetes 集群内开发应用的工具。

Nocalhost 的核心功能是：提供 Nocalhost IDE 插件（包括 VSCode 和 Jetbrains 插件），将远端的工作负载更改为开发模式。在开发模式下，容器的镜像将被替换为包含开发工具（例如 JDK、Go、Python 环境等）的开发镜像。当开发者在本地编写代码时，任何修改都会实时被同步到远端开发容器中，应用程序会立即更新（取决于应用的热加载机制或重新运行应用），开发容器将继承原始工作负载所有的声明式配置（configmap、secret、volume、env 等）。

Nocalhost 还提供：

VSCode 和 Jetbrains IDE 一键 Debug 和 HotReload。
在 IDE 内直接提供开发容器的终端，获得和本地开发一致的体验。
提供基于 Namespace 隔离的开发空间和 Mesh 开发空间。

在使用 Nocalhost 开发 Kubernetes 的应用过程中，免去了镜像构建，更新镜像版本，等待集群调度 Pod 的过程，把编码/测试/调试反馈循环(code/test/debug cycle)从分钟级别降低到了秒级别，大幅提升开发效率

此外，Nocalhost 还提供了 Server 端帮助企业管理 Kubernetes 应用、开发者和开发空间，方便企业统一管理各类开发和测试环境。

null

本文将介绍如何在 KubeSphere 中快速部署 Nocalhost Server^[3]及基本使用，提供一个帮助研发团队统一管理 Nocalhost 应用部署的管理平台；以及 Nocalhost Server 基本使用。

前提条件

安装 KubeSphere

安装 KubeSphere 有两种方法。一是在 Linux 上直接安装，可以参考文档：在 Linux 安装 KubeSphere^[4]；二是在已有 Kubernetes 中安装，可以参考文档：在 Kubernetes 安装 KubeSphere^[5]。

在 KubeSphere 中启用应用商店

在 KubeSphere 中启用应用商店可以参考文档：KubeSphere 应用商店^[6]。

安装 Nocalhost Server

在 KubeSphere 3.2 中从应用商店安装

Nocalhost Server 已经集成在了 KubeSphere 3.2 的应用商店中了，因此可以直接访问应用商店并按常规方式^[7] 进行应用部署。

null

在 KubeSphere 3.x 中通过应用仓库安装

在 KubeSphere 3.x 中，您可以通过应用仓库来部署应用^[8]，下面分步介绍具体的操作过程。

步骤 1：添加应用商店

首先，使用具备企业空间管理权限的账号登陆 KubeSphere 并进入您选定的一个企业空间，在您的企业空间中，进入「应用管理」下的「应用仓库」页面，并点击「添加仓库」。

null

在弹出的对话框中，可将应用仓库名称设置为 nocalhost，将应用仓库的 URL 设置为 https://nocalhost-helm.pkg.coding.net/nocalhost/nocalhost，点击「验证」对 URL 进行验证，验证通过后再点击「确定」。

null

⚠️ 注意：URL 必须贴全链接，不能缺失 https:// 这部分，否则会验证失败

应用仓库导入成功后会显示在如下图所示的列表中。

null

有关添加私有仓库时的更多参数信息，请参见导入 Helm 仓库^[9]。

步骤 2：从应用模版部署应用

进入您选定的用于部署 Nocalhost Server 的项目，如果还没有可用项目，可以直接打开企业空间页面中的「项目」栏目，「创建」一个新的项目。

null

假设我们已经创建了一个名为 nocalhost-server 的项目，进入项目界面，进入「应用负载」下的「应用」页面，再点击「创建」新应用。

null

在弹出的对话框中选择「从应用模板」创建。

null

• 从应用商店：选择内置的应用和以 Helm Chart 形式单独上传的应用。

• 从应用模板：从私有应用仓库和企业空间应用池选择应用。

从下拉列表中选择之前添加的私有应用仓库 nocalhost，可以看到仓库中的 Nocalhost Server Helm Chart 如下显示。

null

您可以查看「应用信息」和「Chart 文件」，在版本下拉列表中选择版本，然后点击「部署」。

null

设置应用「名称」，确认应用「版本」和部署「位置」，点击「下一步」。

null

在「应用设置」标签页，您可以手动编辑清单文件或直接点击「安装」。建议把 service.type 设置为 ClusterIP，以确保安装不受 Kubernetes 网络环境影响。当然，您完全可以结合自身研发环境来选择使用 NodePort 或 LoadBalancer 服务类型来暴露 Nocalhost Server（Server 本身对此并无限制）。

null

最后等待 Nocalhost Server 创建完成并开始运行，可以在「应用」中看到如下应用状态（可能需要刷新一下页面）。

null

步骤 3：暴露 Nocalhost Server 服务

进入「应用负载」下的「服务」页面，选择 nocalhost-web 服务，在最右侧的拉下菜单中选择「编辑外部访问」。

null

在弹出的对话框中选择合适当前云端网络环境的外网「访问方式」，然后点击「确定」即可应用服务配置。

null

本文假设我们仍然保持 ClusterIP 的访问方式，通过 kubectl port-forward 来进行后续的 Nocalhost Server 使用。

❯ kubectl -n nocalhost-server port-forward service/nocalhost-web 8080:80Forwardingfrom127.0.0.1:8080-> 80Forwardingfrom[::1]:8080-> 80

复制代码

⚠️ 注意：这里的 nocalhost-server 请替换为您实际使用的部署了 Nocalhost 应用的 Namespace

至此，已完成在 Kubesphere 中快速部署 Nocalhost Server，如您是第一次使用 Nocalhost Server，可继续以下关于 Nocalhost Server Dashboard 配置、在 Nocalhost IDE 插件中进行开发体验的内容

使用 Nocalhost Server

完成 Port Forward 后可使用 http://localhost:8080 来打开 Nocalhost Server Dashboard 页面；使用默认账号 admin@admin.com 及密码 123456 进行登陆。
登录后请更改默认密码。

null

创建集群

Nocalhost Server 多用于管理整个团队的 Nocalhost 研发环境，因此我们首先需要添加可进行管理的集群。

在 Nocalhost Server Dashboard 中选择左侧菜单列表中的「集群」，进入页面后选择「添加集群」。

null

在弹出的对话框中输入「集群名称」，并录入 kubectl 可用的、具备 cluster-admin 权限的 kubeconfig 文件后「确认」。

null

目前可导入的 kubeconfig 文件内容还不支持 exec 类型的用户凭证，如果您使用的是这里凭证，建议您另外生成一个具有足够权限的 ServiceAccount 并使用其对应的 kubeconfig。

这里有多种方式获取目标集群的 kubeconfig，例如您可以返回 KubeSphere 并进入集群页面，获取当前集群的 kubeconfig 文件。注意，如果使用 kubeconfig 文件的应用部署在当前集群外，您需要将 clusters:cluster:server 参数的值修改为对外暴露的 Kubernetes API 服务器地址。