在 Kubernetes 上安装 Gitpod 自托管

本节介绍如何使用Helm在任何 Kubernetes 集群上安装 Gitpod 。这是安装 Gitpod 最灵活和通用的方式。稳定版本的图表位于 Helm 存储库charts.gitpod.io,分支构建的图表可以在这里找到,图表的来源在我们的公共 git 存储库中
对于某些平台,我们提供Terraform脚本来简化基础设施设置。一旦脚本创建了必要的基础设施,它将输出一个values.terraform.yaml包含helm部署的特定于基础设施的配置。

先决条件

请参阅Gitpod 自托管的安装要求

安装

要在 Kubernetes 集群中安装 Gitpod,请执行以下步骤:

  1. 创建一个values.custom.yaml包含以下内容的文件(请替换密钥/秘密,例如用openssl rand -hex 20):

    1. docker-registry:
    2. authentication:
    3. username: gitpod
    4. password: your-registry-password
    5. rabbitmq:
    6. auth:
    7. username: your-rabbitmq-user
    8. password: your-secret-rabbitmq-password
    9. minio:
    10. accessKey: your-random-access-key
    11. secretKey: your-random-secret-key

    您应该使用 2 个不同的随机字符串替换这些密钥,这些字符串对于您的安装是唯一的。

  2. 在本地终端中运行以下命令:

    helm repo add gitpod.io https://charts.gitpod.io  
    helm repo update  
    helm install -f values.custom.yaml gitpod gitpod.io/gitpod --version=0.10.0
    
  3. 配置域和 https

  4. 运行kubectl get pods并验证所有 pod 都处于 state RUNNING。如果有些不是,请参阅故障排除指南
  5. 转到https://并按照步骤完成安装。

    升级

  6. 查看升级指南并按照那里列出的步骤进行操作。

  7. 运行更新

    helm install -f values.custom.yaml gitpod gitpod.io/gitpod --version=0.10.0
    
  8. 运行kubectl get pods并验证所有 pod 都处于 state RUNNING。如果有些不是,请参阅故障排除指南

    推荐配置

    默认情况下,Helm chart 会在很多场景中安装一个可用的 Gitpod 安装。然而,在安装 Gitpod 以供长期使用和/或更多受众时,您可能需要查看某些内容:

  • 数据库:配置 Gitpod 存储所有内部运行时数据的位置。
  • 存储:配置 Gitpod 将工作区内容持久化的位置。
  • Docker Registry:配置 Gitpod 存储工作区映像的位置。

    定制

    进一步的定制:

  • Kubernetes 节点:配置文件系统布局和工作区的节点关联性。

  • 工作区:配置工作区大小。