安装和配置

流程

1. 在控制台的 Administrator 视角中，导航到 Operators → OperatorHub。
2. 使用 Filter by keyword 复选框在目录中搜索 Red Hat OpenShift Pipelines Operator。点 Red Hat OpenShift Pipelines Operator 标题。
3. 参阅 Red Hat OpenShift Pipelines Operator 页中有关 Operator 的简单描述。点 Install。

4. 在 Install Operator 页面中：

   1. 为 Installation Mode 选择 All namespaces on the cluster (default)。选择该项会将 Operator 安装至默认openshift-operators 命名空间，这将启用 Operator 以进行监视并在集群中的所有命名空间中可用。
   2. 为 Approval Strategy 选择 Automatic。这样可确保以后对 Operator 的升级由 Operator Lifecycle Manager (OLM) 自动进行。如果您选择 Manual 批准策略，OLM 会创建一个更新请求。作为集群管理员，您必须手动批准 OLM 更新请求，才可将 Operator 更新至新版本。

   3. 选择一个 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。

5. 点 Install。您会看到 Installed Operators 页面中列出的 Operator。

   注意

   Operator 会自动安装到 openshift-operators 命名空间中。

6. 检查 Status 是否已被设置为 Succeeded Up to date 来确认 Red Hat OpenShift Pipelines Operator 已安装成功。

   警告

   即使其他组件的安装正在进行中，成功状态也可能会显示为 Succeeded Up to date。因此，在终端中手动验证安装非常重要。

7. 验证 Red Hat OpenShift Pipelines Operator 的所有组件都已成功安装。在终端中登录到集群，并运行以下命令：

   $ oc get tektonconfig config

   Copy to clipboard

   输出示例

   NAME     VERSION   READY   REASON
   config   1.18.0     True

   Copy to clipboard

   如果 READY 条件为 True，则代表 Operator 及其组件已被成功安装。

   另外，运行以下命令来检查组件版本：

   $ oc get tektonpipeline,tektontrigger,tektonchain,tektonaddon,pac

   Copy to clipboard

   输出示例

   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

流程

1. 创建一个 Subscription 对象 YAML 文件，以便为 Red Hat OpenShift Pipelines Operator 订阅一个命名空间，如 sub.yaml ：

   Subscription YAML 示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-pipelines-operator
     namespace: openshift-operators
   spec:
     channel:  <channel_name> 1
     name: openshift-pipelines-operator-rh 2
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace 4

   Copy to clipboard

   1

   要订阅的频道的名称。pipelines-<version> 频道是默认频道。例如，Red Hat OpenShift Pipelines Operator 版本 1.7 的默认频道是 pipelines-1.7。latest 频道启用 Red Hat OpenShift Pipelines Operator 最新稳定版本的安装。

   2

   要订阅的 Operator 的名称。

   3

   提供 Operator 的 CatalogSource 对象的名称。

   4

   CatalogSource 对象的命名空间。将 openshift-marketplace 用于默认的 OperatorHub 目录源。

2. 运行以下命令来创建 Subscription 对象：

   $ oc apply -f sub.yaml

   Copy to clipboard

   订阅会将 Red Hat OpenShift Pipelines Operator 安装到 openshift-operators 命名空间中。Operator 会自动将 OpenShift Pipelines 安装到默认的 openshift-pipelines 目标命名空间中。

流程

1. 在 Web 控制台的 Administrator 视角中，进入到 Administration → CustomResourceDefinitions。
2. 在 Filter by name 字段中键入 TektonHub 以搜索 TektonHub 自定义资源定义(CRD)。
3. 点 TektonHub CRD 的名称，以显示 CRD 的详情页面。
4. 单击 实例选项卡。
5. 如果显示实例，点显示的实例的 Options 菜单 。
6. 选择 Delete TektonHub。
7. 点 Delete 以确认删除 CR。
8. 重复这些步骤，在 Filter by name 框中搜索 TektonResult，然后搜索 TektonConfig。如果为这些 CRD 找到任何实例，请删除这些实例。

流程

1. 在 Operators → OperatorHub 页面中，使用 Filter by keyword 复选框来搜索 Red Hat OpenShift Pipelines Operator。
2. 点 Red Hat OpenShift Pipelines Operator 标题。Operator 标题表示已安装 Operator。
3. 在 Red Hat OpenShift Pipelines Operator 描述页面中，点 Uninstall。
4. 在 Uninstall Operator? 窗口中，为这个 operator 选择 Delete all operand 实例，然后点 Uninstall。

流程

1. 在 Web 控制台的 Administrator 视角中，进入到 Administration → CustomResourceDefinitions。
2. 在 Filter by name 框中键入 operator.tekton.dev 来搜索 operator.tekton.dev 组中的 CRD。

3. 要删除每个显示的 CRD，请完成以下步骤：

   1. 点 Options 菜单 。
   2. 选择 Delete CustomResourceDefinition。
   3. 点 Delete 以确认删除 CRD。

流程

1. 在 Web 控制台的 Administrator 视角中，进入到 Administration → CustomResourceDefinitions。
2. 使用 Search by name 复选框搜索 tektonconfigs.operator.tekton.dev 自定义资源定义 (CRD)。点 TektonConfig 查看 CRD 详情页面。
3. 点 实例 选项卡。
4. 点 config 实例查看 TektonConfig CR 详情。
5. 点 YAML 标签。

6. 根据您的要求编辑 TektonConfig YAML 文件。

   带有默认值的 TektonConfig CR 示例

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonConfig
   metadata:
     name: config
   spec:
     pipeline:
       running-in-environment-with-injected-sidecars: true
       metrics.taskrun.duration-type: histogram
       metrics.pipelinerun.duration-type: histogram
       await-sidecar-readiness: true
       params:
         - name: enableMetrics
           value: 'true'
       default-service-account: pipeline
       require-git-ssh-secret-known-hosts: false
       enable-tekton-oci-bundles: false
       metrics.taskrun.level: task
       metrics.pipelinerun.level: pipeline
       enable-api-fields: stable
       enable-provenance-in-status: false
       enable-custom-tasks: true
       disable-creds-init: false
       disable-affinity-assistant: true

   Copy to clipboard

流程

1. 运行以下命令来编辑 TektonConfig CR：

   $ oc edit TektonConfig config

   Copy to clipboard

2. 在 TektonConfig CR 中，将 .addon.params spec 中的 resolverTasks 和 pipelineTemplates 参数值设置为 false ：

   禁用解析器任务和管道模板资源的示例

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonConfig
   metadata:
     name: config
   spec:
   # ...
     addon:
       params:
         - name: resolverTasks
           value: 'false'
         - name: pipelineTemplates
           value: 'false'
   # ...

   Copy to clipboard

   重要

   只有在 resolverTasks 参数的值为 true 时，才可将 pipelinesTemplates 参数的值设置为 true。

流程

1. 运行以下命令来编辑 TektonConfig CR：

   $ oc edit TektonConfig config

   Copy to clipboard
2. 在 TektonConfig CR 中，将 createRbacResource param 设置为 false ：

流程

1. 查看 OpenShift Pipelines 控制器创建的 webhook 列表。Webhook 有两种类型：变异 Webhook 和验证 Webhook。

   1. 要查看变异 Webhook 列表，请输入以下命令：

      $ oc get MutatingWebhookConfiguration

      Copy to clipboard

      输出示例

      NAME                             WEBHOOKS   AGE
      annotation.operator.tekton.dev   1          4m20s
      proxy.operator.tekton.dev        1          4m20s
      webhook.operator.tekton.dev      1          4m22s
      webhook.pipeline.tekton.dev      1          4m20s
      webhook.triggers.tekton.dev      1          3m50s

      Copy to clipboard

   2. 要查看验证 Webhook 列表，请输入以下命令：

      $ oc get ValidatingWebhookConfiguration

      Copy to clipboard

      输出示例

      NAME                                                 WEBHOOKS   AGE
      config.webhook.operator.tekton.dev                   1          4m24s
      config.webhook.pipeline.tekton.dev                   1          4m22s
      config.webhook.triggers.tekton.dev                   1          3m52s
      namespace.operator.tekton.dev                        1          4m22s
      validation.pipelinesascode.tekton.dev                1          2m49s
      validation.webhook.operator.tekton.dev               1          4m24s
      validation.webhook.pipeline.tekton.dev               1          4m22s
      validation.webhook.triggers.tekton.dev               1          3m52s

      Copy to clipboard

2. 在 TektonConfig 自定义资源(CR)中，根据需要为每个控制器添加变异并验证 Webhook 的配置，如下例所示。将 validation.webhook.pipeline.tekton.dev spec 用于验证 webhook，将 webhook.pipeline.tekton.dev spec 用于变异 Webhook。

   重要
   • 您无法为 Operator Webhook 设置配置。
   • 所有设置都是可选的。例如，您可以设置 timeoutSeconds 参数，并省略 failurePolicy 和 sideEffects 参数。

   Pipelines 控制器的设置示例

   apiVersion: operator.tekton.dev/v1
   kind: TektonConfig
   metadata:
     name: config
   spec:
     pipeline:
       options:
         webhookConfigurationOptions:
           validation.webhook.pipeline.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None
           webhook.pipeline.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None

   Copy to clipboard

   Triggers 控制器的设置示例

   apiVersion: operator.tekton.dev/v1
   kind: TektonConfig
   metadata:
     name: config
   spec:
     triggers:
       options:
         webhookConfigurationOptions:
           validation.webhook.triggers.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None
           webhook.triggers.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None

   Copy to clipboard

   Pipelines as Code 控制器的设置示例

   apiVersion: operator.tekton.dev/v1
   kind: TektonConfig
   metadata:
     name: config
   spec:
     pipelinesAsCode:
       options:
         webhookConfigurationOptions:
           validation.pipelinesascode.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None
           pipelines.triggers.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None

   Copy to clipboard

   Tekton Hub 控制器的设置示例

   apiVersion: operator.tekton.dev/v1
   kind: TektonConfig
   metadata:
     name: config
   spec:
     hub:
       options:
         webhookConfigurationOptions:
           validation.webhook.hub.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None
           webhook.hub.tekton.dev:
             failurePolicy: Fail
             timeoutSeconds: 20
             sideEffects: None

   Copy to clipboard