第 1 章 安装 OpenShift Pipelines
本指南帮助集群管理员了解将 Red Hat OpenShift Pipelines Operator 安装到 OpenShift Container Platform 集群的整个过程。
先决条件
-
可以使用具有
cluster-admin权限的账户访问 OpenShift Container Platform 集群。 -
已安装了
ocCLI。 -
您已在本地系统中安装了 OpenShift Pipelines ( tkn
)CLI。 - 您的集群启用了 Marketplace 功能，或者手动配置 Red Hat Operator 目录源。
在同时具有 Windows 和 Linux 节点的集群中，Red Hat OpenShift Pipelines 只能在 Linux 节点上运行。
1.1. 在 Web 控制台中安装 Red Hat OpenShift Pipelines Operator
您可以使用 OpenShift Container Platform OperatorHub 中列出的 Operator 来安装 Red Hat OpenShift Pipelines。安装 Red Hat OpenShift Pipelines Operator 时，管道配置所需的自定义资源（CR）与 Operator 一起自动安装。
默认 Operator 自定义资源定义（CRD）config.operator.tekton.dev 现在被 tektonconfigs.operator.tekton.dev 替代。另外，Operator 提供以下额外的 CRD 来单独管理 OpenShift Pipelines 组件：tektonpipelines.operator.tekton.dev、tektontriggers.operator.tekton.dev 和 tektonaddons.operator.tekton.dev。
如果在集群中安装了 OpenShift Pipelines，现有安装会无缝升级。Operator 会根据需要将集群中的 config.operator.tekton.dev 实例替换为 tektonconfigs.operator.tekton.dev 实例，以及其它 CRD 的额外对象。
如果您手动更改现有安装，例如，在 config.operator.tekton.dev CRD 实例中修改了目标命名空间（更改了 resource name - cluster 的项），则升级过程将不会非常流畅。在这种情况下，推荐的工作流是，先卸载安装，然后再重新安装 Red Hat OpenShift Pipelines Operator。
Red Hat OpenShift Pipelines Operator 现在提供选择您要安装的组件的选项，方法是将配置集指定为 TektonConfig 自定义资源 (CR) 的一部分。在安装 Operator 时会自动安装 TektonConfig CR。支持的配置集有：
- Lite：只安装 Tekton Pipelines。
- Basic：安装 Tekton Pipelines、Tekton Triggers 和 Tekton 链。
-
All：在安装了
TektonConfigCR 时，使用的默认配置集。此配置集安装所有 Tekton 组件，包括 Tekton Pipelines、Tekton Triggers、Tekton Chains、Pipelines as Code 和 Tekton Addons。Tekton Addons 包括ClusterTasks,ClusterTriggerBindings,ConsoleCLIDownload,ConsoleQuickStart, 和ConsoleYAMLSample资源，以及使用openshift-pipelines命名空间中的集群解析器可用的任务。
流程
-
在控制台的 Administrator 视角中，导航到 Operators
OperatorHub。 -
使用 Filter by keyword 复选框在目录中搜索
Red Hat OpenShift PipelinesOperator。点 Red Hat OpenShift Pipelines Operator 标题。 - 参阅 Red Hat OpenShift Pipelines Operator 页中有关 Operator 的简单描述。点 Install。
在 Install Operator 页面中：
-
为 Installation Mode 选择 All namespaces on the cluster (default)。选择该项会将 Operator 安装至默认
openshift-operators命名空间，这将启用 Operator 以进行监视并在集群中的所有命名空间中可用。 - 为 Approval Strategy 选择 Automatic。这样可确保以后对 Operator 的升级由 Operator Lifecycle Manager (OLM) 自动进行。如果您选择 Manual 批准策略，OLM 会创建一个更新请求。作为集群管理员，您必须手动批准 OLM 更新请求，才可将 Operator 更新至新版本。
选择一个 Update Channel。
-
latest频道启用 Red Hat OpenShift Pipelines Operator 最新稳定版本的安装。目前，这是安装 Red Hat OpenShift Pipelines Operator 的默认频道。 要安装 Red Hat OpenShift Pipelines Operator 的特定版本，集群管理员可以使用对应的
pipelines-<version>频道。例如，要安装 Red Hat OpenShift Pipelines Operator 版本1.8.x，您可以使用pipelines-1.8频道。注意从 OpenShift Container Platform 4.11 开始，用于安装和升级 Red Hat OpenShift Pipelines Operator 的
preview和stable频道不可用。但是，在 OpenShift Container Platform 4.10 及更早的版本中，您可以使用preview和stable频道来安装和升级 Operator。
-
-
为 Installation Mode 选择 All namespaces on the cluster (default)。选择该项会将 Operator 安装至默认
点 Install。您会看到 Installed Operators 页面中列出的 Operator。
注意Operator 会自动安装到
openshift-operators命名空间中。检查 Status 是否已被设置为 Succeeded Up to date 来确认 Red Hat OpenShift Pipelines Operator 已安装成功。
警告即使其他组件的安装正在进行中，成功状态也可能会显示为 Succeeded Up to date。因此，在终端中手动验证安装非常重要。
验证 Red Hat OpenShift Pipelines Operator 的所有组件都已成功安装。在终端中登录到集群，并运行以下命令：
$ oc get tektonconfig config
输出示例
NAME VERSION READY REASON config 1.15.0 True
如果 READY 条件为 True，则代表 Operator 及其组件已被成功安装。
另外，运行以下命令来检查组件版本：
$ oc get tektonpipeline,tektontrigger,tektonchain,tektonaddon,pac
输出示例
NAME VERSION READY REASON tektonpipeline.operator.tekton.dev/pipeline v0.47.0 True NAME VERSION READY REASON tektontrigger.operator.tekton.dev/trigger v0.23.1 True NAME VERSION READY REASON tektonchain.operator.tekton.dev/chain v0.16.0 True NAME VERSION READY REASON tektonaddon.operator.tekton.dev/addon 1.11.0 True NAME VERSION READY REASON openshiftpipelinesascode.operator.tekton.dev/pipelines-as-code v0.19.0 True
