Help us learn about your current experience with the documentation. Take the survey.

创建 Civo Kubernetes 集群

每个新的 Civo 账户都会获得 $250 信用额度 来开始使用 GitLab 与 Civo Kubernetes 的集成。你也可以使用市场应用在 Civo Kubernetes 集群上安装 GitLab。

学习如何通过基础设施即代码 (IaC)在 Civo Kubernetes 上创建新集群。此过程使用 Civo 和 Kubernetes Terraform 提供程序来创建 Civo Kubernetes 集群。你可以使用 GitLab for Kubernetes 的代理将集群连接到 GitLab。

开始之前：

步骤：

  1. 导入示例项目。
  2. 注册 Kubernetes 代理。
  3. 配置你的项目。
  4. 配置你的集群。

导入示例项目

要从 GitLab 使用基础设施即代码创建集群，你必须创建一个项目来管理集群。在本教程中，你从一个示例项目开始，并根据你的需求进行修改。

首先通过 URL 导入示例项目。

要导入项目：

  1. 在 GitLab 中，在左侧边栏选择 Search or go to。
  2. 选择 View all my projects。
  3. 在页面右侧，选择 New project。
  4. 选择 Import project。
  5. 选择 Repository by URL。
  6. 对于 Git repository URL，输入 https://gitlab.com/civocloud/gitlab-terraform-civo.git。
  7. 完成字段并选择 Create project。

这个项目为你提供：

注册代理

要创建 GitLab for Kubernetes 代理：

  1. 在左侧边栏，选择 Operate > Kubernetes clusters。
  2. 选择 Connect a cluster。
  3. 从 Select an agent 下拉列表中，选择 civo-agent 并选择 Register。
  4. GitLab 为代理生成一个代理访问令牌。安全地存储这个秘密令牌，因为你稍后会需要它。
  5. GitLab 提供了一个代理服务器 (KAS) 的地址，你稍后也会需要它。

配置你的项目

使用 CI/CD 环境变量来配置你的项目。

必需配置：

  1. 在左侧边栏，选择 Settings > CI/CD。
  2. 展开 Variables。
  3. 将变量 CIVO_TOKEN 设置为你的 Civo 账户的令牌。
  4. 将变量 TF_VAR_agent_token 设置为你在上一个任务中收到的代理令牌。
  5. 将变量 TF_VAR_kas_address 设置为上一个任务中的代理服务器地址。

必需配置

可选配置：

文件 variables.tf 包含其他变量，你可以根据需要覆盖它们：

  • TF_VAR_civo_region：设置你的集群区域。
  • TF_VAR_cluster_name：设置你的集群名称。
  • TF_VAR_cluster_description：为集群设置描述。要在 Civo 集群详情页面上创建对 GitLab 项目的引用，请将此值设置为 $CI_PROJECT_URL。此值帮助你确定哪个项目负责在 Civo 仪表板上你看到的集群。
  • TF_VAR_target_nodes_size：设置用于集群的节点大小。
  • TF_VAR_num_target_nodes：设置 Kubernetes 节点数量。
  • TF_VAR_agent_version：设置 GitLab for Kubernetes 代理的版本。
  • TF_VAR_agent_namespace：设置 GitLab for Kubernetes 代理的 Kubernetes 命名空间。

有关更多资源选项，请参阅 Civo Terraform 提供程序 和 Kubernetes Terraform 提供程序 文档。

配置你的集群

配置你的项目后，手动触发集群的配置。在 GitLab 中：

  1. 在左侧边栏，选择 Build > Pipelines。
  2. 选择 New pipeline。
  3. 选择 Run pipeline，然后从列表中选择新创建的管道。
  4. 在 deploy 作业旁边，选择 Manual action ( status_manual )。

当管道成功完成时，你可以看到你的新集群：

  • 在 Civo 仪表板：在你的 Kubernetes 选项卡上。
  • 在 GitLab：从你的项目侧边栏，选择 Operate > Kubernetes clusters。

如果你没有设置 TF_VAR_civo_region 变量，集群将在 ’lon1’ 区域创建。

使用你的集群

配置集群后，它已连接到 GitLab 并准备就绪，可以部署。要检查连接：

  1. 在左侧边栏，选择 Operate > Kubernetes clusters。
  2. 在列表中，查看 Connection status 列。

有关连接功能的更多信息，请参阅 GitLab for Kubernetes 代理文档。

删除集群

默认情况下，你的管道中包含一个清理作业。

要删除所有创建的资源：

  1. 在左侧边栏，选择 Build > Pipelines，然后选择最近的管道。
  2. 在 destroy-environment 作业旁边，选择 Manual action ( status_manual )。

Civo 支持

此 Civo 集成由 Civo 支持。将你的支持请求发送到 Civo support。