IBM Cloud Docs
使用 Continuous Delivery 和 Satellite 配置将应用程序部署到集群

使用 Continuous Delivery 和 Satellite 配置将应用程序部署到集群

将 Kubernetes 资源 (例如部署) 从 GitHub 或 GitLab 存储库部署到具有 IBM Cloud® Continuous Delivery 和 Satellite Config 的多个集群。

目标

在本教程中，您将学习如何使用 Continuous Delivery 将应用程序部署到多个集群来创建开放式工具链。 您还将了解如何在 Continuous Delivery 服务中实现工具链，以及如何使用仅 Continuous Delivery工具链模板来部署简单 Web 应用程序。

使用 Satellite 配置，可创建用于指定要部署到集群组的 Kubernetes 资源的配置。 然后，设置 Continuous Delivery 管道以在对配置进行更改时跨集群组部署这些资源。

本教程中使用的工具链通过管理 Satellite 位置中的部署，实现围绕持续交付功能的标准 DevOps 实践。 创建集群并将其与 Satellite 集群组关联后，可以创建工具链以更改部署源代码并将更改推送到 GitHub 存储库。 将更改推送到存储库时，基于 Tekton 的交付管道会自动将代码部署到集群。

受众

本教程适用于首次使用 Continuous Delivery 工具链和 Satellite 配置来部署资源的管理员。

先决条件

在开始本教程之前，请确保已准备好以下资源。

  • IBM Cloud 帐户。 根据您的 IBM Cloud 帐户类型，可能会限制对特定资源的访问。 根据您的帐户计划限制，某些部署策略所需的某些功能可能不可用。 有关 IBM Cloud 帐户的更多信息，请参阅 设置 IBM Cloud 帐户 和 升级帐户。

  • 向 Satellite 位置注册的 Satellite 集群或 IBM Cloud 上的 Red Hat® OpenShift® 集群。

如果您没有 Satellite 集群，那么可以 向 Satellite 注册 Red Hat OpenShift 集群。

入门

开始在 IBM Cloud中创建工具链。

  1. 使用 IBM Cloud 凭证登录到 IBM Cloud 工具链。
  2. 选择工具链的资源组和位置。
  3. 单击 创建工具链。
  4. 在“创建工具链”页面上，选择 过滤器 下的 Satellite 以显示适用于 Satellite的模板。
  5. 选择 将 Kubernetes 资源部署到多个集群 模板。
  6. 阅读信息以了解工具链的工作方式，然后单击 启动。

定义工具链设置

定义工具链的名称，区域和资源组。

  1. 提供工具链的名称。
  2. 选择要在其中创建工具链的区域。
  3. 选择要在其中创建工具链的资源组。
  4. 单击继续。

定义源存储库

指定您希望此工具链侦听的源存储库的详细信息。 可以使用标准配置选项或高级配置选项来指定此信息。

  1. 选择源提供者。 根据您选择的源提供程序，将显示特定于该源提供程序的选项。 例如，可以选择 Github Enterprise Whitewater 作为源提供程序。

  2. 定义源存储库。

    • 要将新存储库用于此工具链，请单击 创建新源存储库 并命名新存储库。
    • 要将现有存储库用于此工具链，请单击 使用现有源存储库 并提供存储库 URL。 选择 源提供程序，然后输入存储库的 URL，例如: https://github.com/my-org/my-repo。

  3. 单击继续。

如果要访问更高级的源存储库设置 (例如，使用定制服务器和更改克隆行为)，请选择 切换到高级配置。

设置交付管道

命名用于将应用程序部署到 Satellite 集群组中的多个集群的交付管道。

  1. 输入在工具链中显示的管道名称。

  2. 单击继续。

提供 API 密钥

提供工具链可用于访问 Satellite 位置的 IBM Cloud API 密钥信息。

如果您具有现有 API 密钥或多个现有 API 密钥，请执行以下步骤。

  1. 选择您使用的一个或多个私钥提供程序。 您可以选择一个或多个。

  2. 单击继续。

  3. 提供访问私钥提供程序所需的信息。

如果您没有现有 API 密钥，那么可以忽略此页面上的选项，然后单击 继续 以进入下一页，您可以在其中创建 IBM Cloud API 密钥并将其保存到私钥提供程序。

设置 Satellite 配置

指定 Satellite 配置工具在部署资源时可以使用的设置。

  1. 提供 IBM Cloud API 密钥。 如果未在上一页上提供现有 IBM Cloud API 密钥，那么可以通过单击 新建来创建新的 IBM Cloud API 密钥。

    通过在创建新密钥时选择该选项或单击密钥图标，可以将此密钥保存到您选择的密钥提供程序以供复用。

  2. 定义要将资源部署到的名称空间。 这必须是现有名称空间。

  3. 指定要将资源部署到的分支; 例如，v1。

  4. 提供要将资源部署到的路径; 例如，deployments。

  5. 选择集群组以接收要部署的资源。

  6. 提供 Satellite 配置的显示名称。

  7. 单击继续。

复审摘要

复审摘要并确认以创建工具链。

  • 要更改先前提供的任何参数，请单击 上一步。

  • 要使用提供的参数创建工具链，请单击 创建工具链。

测试工具链

创建工具链时，将显示“工具链概述”页面。 在此页面上，您可以查看与此工具链关联的存储库，管道和任何 IBM Cloud 工具。

存储库 下是您的源存储库以及用于 Tekton 目录和管道任务的其他存储库。 如果您对使用 Tekton 感到满意，那么可以转至这些 Tekton 存储库以对工具链进行更改。

在 交付管道下，您可以查看管道运行的状态。 您可以单击管道的名称以查看有关管道的详细信息，并设置“从此管道概述”，可以设置管道的触发器。 触发器定义管道何时启动。

您可以通过以下任一方式启动交付管道。

  • 通过设置手动触发器来手动触发交付管道。
  • 将落实推送到 Git 存储库触发器所定义的部署源存储库。 要设置 Git 存储库触发器，请参阅 从其他分支部署新版本的应用程序。

要启动手动管道运行，请执行以下步骤。

  1. 在工具链的 概述 中的 交付管道下，选择交付管道以查看其状态。
  2. 单击 运行管道。
  3. 请查看触发器属性以确保它们与您的配置相匹配。
  4. 单击 运行 以运行工具链并部署应用程序。
  5. 可选: 单击运行的名称以查看状态，日志和详细信息。
  6. 可选: 应用程序运行后，请转至 Satellite 配置 或运行 ibmcloud sat config 命令以查看 Satellite 配置资源。

验证样本应用程序是否正在运行

设置工具链并成功完成 Delivery Pipeline 之后，请运行以下步骤来检查应用程序。

  1. 从“集群”页面中，单击用于部署应用程序的集群。
  2. 单击 OpenShift Web 控制台。
  3. 在 工作负载 > Pod 部分中，按项目或集群名称空间进行过滤，并验证 pod 是否正在运行。
  4. 在“联网 > 路由”部分中，按项目或集群名称空间进行过滤，然后找到应用程序 URL。
  5. 通过使用浏览器访问应用程序 URL 来验证应用程序是否正在运行。
  6. 可选: 您可以查看 Satellite 配置 在控制台中，也可以通过运行 ibmcloud sat config ls 命令。

从其他分支部署应用程序的新版本

如果存储库中有多个分支表示应用程序的多个版本，那么可以部署另一个分支以查看正在运行的应用程序的新版本。 请遵循以下步骤来修改工具链，以部署源存储库的其他分支。

  1. 在工具链的 概述 上，选择要修改的交付管道。
  2. 单击 触发器。
  3. 单击 commit-push 触发器的操作菜单。
  4. 选择编辑。
  5. 在 分支 字段中，选择要部署的分支。 例如，v2。
  6. 在 属性下的 deployment-branch 行中，单击 编辑 图标。
  7. 将此属性的值修改为要部署的分支名称。 例如，v2。
  8. 保存更改。
  9. 通过使用浏览器访问应用程序 URL，检查应用程序是否正在运行新版本。
  10. 可选: 在 Satellite 配置 控制台 中或通过运行 ibmcloud sat config get --config CONFIG 命令 来查看新版本的配置。

现在，您可以使用单个工具链将 Kubernetes 资源部署到多个集群。