Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

创建 CI/CD 管道

Red Hat OpenShift Pipelines 1.10

在 OpenShift Pipelines 中创建并运行任务和管道入门

Red Hat OpenShift Documentation Team

摘要

本文档提供有关在 OpenShift Pipelines 中创建和运行任务和管道的信息。

使用 Red Hat OpenShift Pipelines，您可以创建一个自定义的 CI/CD 解决方案来构建、测试和部署应用程序。

要为应用程序创建一个完整的自助 CI/CD 管道，请执行以下任务：

  • 创建自定义任务，或安装现有的可重复使用的任务。
  • 为应用程序创建并定义交付管道。

  • 使用以下方法之一提供附加到管道执行的工作区中的存储卷或文件系统：

    • 指定创建持久性卷声明的卷声明模板
    • 指定一个持久性卷声明
  • 创建一个 PipelineRun 对象来实例化并调用管道。
  • 添加触发器以捕获源仓库中的事件。

本节使用 pipelines-tutorial 示例来演示前面的任务。这个示例使用一个简单的应用程序，它由以下部分组成：

  • 一个前端接口，pipelines-vote-ui，它的源代码在 pipelines-vote-ui Git 存储库中。
  • 一个后端接口 pipelines-vote-api，它的源代码在 pipelines-vote-api Git 存储库中。
  • apply-manifests 和 update-deployment 任务在 pipelines-tutorial Git 存储库中。

1.1. 先决条件
复制链接

1.2. 创建项目并检查管道服务帐户
复制链接

流程

  1. 登录您的 OpenShift Container Platform 集群： 

    $ oc login -u <login> -p <password> https://openshift.example.com:6443
    Copy to Clipboard Toggle word wrap

  2. 为示例应用程序创建一个项目。在本例中，创建 pipelines-tutorial 项目： 

    $ oc new-project pipelines-tutorial
    Copy to Clipboard Toggle word wrap
    注意

    如果您使用其他名称创建项目，请确定使用您的项目名称更新示例中使用的资源 URL。

  3. 查看 pipeline 服务帐户：

    Red Hat OpenShift Pipelines Operator 添加并配置一个名为 pipeline 的服务帐户，该帐户有足够的权限来构建和推送镜像。PipelineRun 对象使用此服务帐户。 

    $ oc get serviceaccount pipeline
    Copy to Clipboard Toggle word wrap

1.3. 创建管道任务
复制链接

流程

  1. 从 pipelines-tutorial 存储库安装 apply-manifests 和 update-deployment 任务资源，其中包含可为管道重复使用的任务列表： 

    $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/01_pipeline/01_apply_manifest_task.yaml
$ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/01_pipeline/02_update_deployment_task.yaml
    Copy to Clipboard Toggle word wrap

  2. 使用 tkn task list 命令列出您创建的任务： 

    $ tkn task list
    Copy to Clipboard Toggle word wrap

    输出会确认创建了 apply-manifests 和 update-deployment 任务： 

    NAME                DESCRIPTION   AGE
apply-manifests                   1 minute ago
update-deployment                 48 seconds ago
    Copy to Clipboard Toggle word wrap

  3. 使用 tkn clustertasks list 命令列出由 Operator 安装的额外集群任务，如 buildah 和 s2i-python：

    注意

    要在受限环境中使用 buildah 集群任务，您必须确保 Dockerfile 使用内部镜像流作为基础镜像。 

    $ tkn clustertasks list
    Copy to Clipboard Toggle word wrap

    输出列出了 Operator 安装的 ClusterTask 资源： 

    NAME                       DESCRIPTION   AGE
buildah                                  1 day ago
git-clone                                1 day ago
s2i-python                               1 day ago
tkn                                      1 day ago
    Copy to Clipboard Toggle word wrap
重要

在 Red Hat OpenShift Pipelines 1.10 中，集群任务功能已弃用，计划在以后的发行版本中删除。

1.4. 组装管道
复制链接

管道（pipeline）代表一个 CI/CD 流，由要执行的任务定义。它被设计为在多个应用程序和环境中通用且可重复使用。

管道指定任务如何使用 from 和 runAfter 参数相互交互以及它们执行的顺序。它使用 workspaces 字段指定管道中每个任务在执行过程中所需的一个或多个卷。

在本小节中，您将创建一个管道，从 GitHub 获取应用程序的源代码，然后在 OpenShift Container Platform 上构建和部署应用程序。

管道为后端应用程序 pipelines-vote-api 和前端应用程序 pipelines-vote-ui 执行以下任务：

  • 通过引用 git-url 和 git-revision 参数，从 Git 存储库中克隆应用程序的源代码。
  • 使用 buildah 集群任务构建容器镜像。
  • 通过引用 image 参数将镜像推送到 OpenShift 镜像 registry。
  • 通过使用 apply-manifests 和 update-deployment 任务在 OpenShift Container Platform 上部署新镜像。

流程

  1. 复制以下管道 YAML 文件示例内容并保存： 

    apiVersion: tekton.dev/v1beta1
kind: Pipeline
metadata:
  name: build-and-deploy
spec:
  workspaces:
  - name: shared-workspace
  params:
  - name: deployment-name
    type: string
    description: name of the deployment to be patched
  - name: git-url
    type: string
    description: url of the git repo for the code of deployment
  - name: git-revision
    type: string
    description: revision to be used from repo of the code for deployment
    default: "pipelines-1.10"
  - name: IMAGE
    type: string
    description: image to be built from the code
  tasks:
  - name: fetch-repository
    taskRef:
      name: git-clone
      kind: ClusterTask
    workspaces:
    - name: output
      workspace: shared-workspace
    params:
    - name: url
      value: $(params.git-url)
    - name: subdirectory
      value: ""
    - name: deleteExisting
      value: "true"
    - name: revision
      value: $(params.git-revision)
  - name: build-image
    taskRef:
      name: buildah
      kind: ClusterTask
    params:
    - name: IMAGE
      value: $(params.IMAGE)
    workspaces:
    - name: source
      workspace: shared-workspace
    runAfter:
    - fetch-repository
  - name: apply-manifests
    taskRef:
      name: apply-manifests
    workspaces:
    - name: source
      workspace: shared-workspace
    runAfter:
    - build-image
  - name: update-deployment
    taskRef:
      name: update-deployment
    params:
    - name: deployment
      value: $(params.deployment-name)
    - name: IMAGE
      value: $(params.IMAGE)
    runAfter:
    - apply-manifests
    Copy to Clipboard Toggle word wrap

    Pipeline 定义提取 Git 源存储库和镜像 registry 的特定内容。当一个管道被触发并执行时，这些详细信息会作为 params 添加。

  2. 创建管道： 

    $ oc create -f <pipeline-yaml-file-name.yaml>
    Copy to Clipboard Toggle word wrap

    或者，还可以从 Git 存储库直接执行 YAML 文件： 

    $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/01_pipeline/04_pipeline.yaml
    Copy to Clipboard Toggle word wrap

  3. 使用 tkn pipeline list 命令来验证管道是否已添加到应用程序中： 

    $ tkn pipeline list
    Copy to Clipboard Toggle word wrap

    检查输出来验证创建了 build-and-deploy pipeline： 

    NAME               AGE            LAST RUN   STARTED   DURATION   STATUS
build-and-deploy   1 minute ago   ---        ---       ---        ---
    Copy to Clipboard Toggle word wrap

1.5. 镜像以在受限环境中运行管道
复制链接

要在断开连接的集群或受限环境中置备的集群中运行 OpenShift Pipelines，请确保为受限网络配置了 Samples Operator，或者集群管理员创建了带有镜像 registry 的集群。

以下流程使用 pipelines-tutorial 示例，使用带有镜像 registry 的集群在受限环境中为应用程序创建管道。为确保 pipelines-tutorial 示例在受限环境中工作，您必须为前端接口（pipelines-vote-ui）后端接口（pipelines-vote-api）和 cli 从 mirror registry 中镜像相应的构建器镜像。

流程

  1. 为前端接口 pipelines-vote-ui 从 mirror registry 中镜像构建器镜像。

    1. 验证所需镜像标签没有导入： 

      $ oc describe imagestream python -n openshift
      Copy to Clipboard Toggle word wrap

      输出示例

      Name:			python
Namespace:		openshift
[...]

3.8-ubi8 (latest)
  tagged from registry.redhat.io/ubi8/python-38:latest
    prefer registry pullthrough when referencing this tag

  Build and run Python 3.8 applications on UBI 8. For more information about using this builder image, including OpenShift considerations, see https://github.com/sclorg/s2i-python-container/blob/master/3.8/README.md.
  Tags: builder, python
  Supports: python:3.8, python
  Example Repo: https://github.com/sclorg/django-ex.git

[...]
      Copy to Clipboard Toggle word wrap

    2. 将支持的镜像标签镜像到私有 registry： 

      $ oc image mirror registry.redhat.io/ubi8/python-38:latest <mirror-registry>:<port>/ubi8/python-38
      Copy to Clipboard Toggle word wrap

    3. 导入镜像： 

      $ oc tag <mirror-registry>:<port>/ubi8/python-38 python:latest --scheduled -n openshift
      Copy to Clipboard Toggle word wrap

      您必须定期重新导入镜像。--scheduled 标志启用镜像自动重新导入。

    4. 验证带有指定标签的镜像已被导入： 

      $ oc describe imagestream python -n openshift
      Copy to Clipboard Toggle word wrap

      输出示例

      Name:			python
Namespace:		openshift
[...]

latest
  updates automatically from registry <mirror-registry>:<port>/ubi8/python-38

  * <mirror-registry>:<port>/ubi8/python-38@sha256:3ee3c2e70251e75bfeac25c0c33356add9cc4abcbc9c51d858f39e4dc29c5f58

[...]
      Copy to Clipboard Toggle word wrap

  2. 为后端接口 pipelines-vote-api 从 mirror registry 中镜像构建器镜像。

    1. 验证所需镜像标签没有导入： 

      $ oc describe imagestream golang -n openshift
      Copy to Clipboard Toggle word wrap

      输出示例

      Name:			golang
Namespace:		openshift
[...]

1.14.7-ubi8 (latest)
  tagged from registry.redhat.io/ubi8/go-toolset:1.14.7
    prefer registry pullthrough when referencing this tag

  Build and run Go applications on UBI 8. For more information about using this builder image, including OpenShift considerations, see https://github.com/sclorg/golang-container/blob/master/README.md.
  Tags: builder, golang, go
  Supports: golang
  Example Repo: https://github.com/sclorg/golang-ex.git

[...]
      Copy to Clipboard Toggle word wrap

    2. 将支持的镜像标签镜像到私有 registry： 

      $ oc image mirror registry.redhat.io/ubi8/go-toolset:1.14.7 <mirror-registry>:<port>/ubi8/go-toolset
      Copy to Clipboard Toggle word wrap

    3. 导入镜像： 

      $ oc tag <mirror-registry>:<port>/ubi8/go-toolset golang:latest --scheduled -n openshift
      Copy to Clipboard Toggle word wrap

      您必须定期重新导入镜像。--scheduled 标志启用镜像自动重新导入。

    4. 验证带有指定标签的镜像已被导入： 

      $ oc describe imagestream golang -n openshift
      Copy to Clipboard Toggle word wrap

      输出示例

      Name:			golang
Namespace:		openshift
[...]

latest
  updates automatically from registry <mirror-registry>:<port>/ubi8/go-toolset

  * <mirror-registry>:<port>/ubi8/go-toolset@sha256:59a74d581df3a2bd63ab55f7ac106677694bf612a1fe9e7e3e1487f55c421b37

[...]
      Copy to Clipboard Toggle word wrap

  3. 从 cli 的镜像 registry 中镜像构建器镜像。

    1. 验证所需镜像标签没有导入： 

      $ oc describe imagestream cli -n openshift
      Copy to Clipboard Toggle word wrap

      输出示例

      Name:                   cli
Namespace:              openshift
[...]

latest
  updates automatically from registry quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:65c68e8c22487375c4c6ce6f18ed5485915f2bf612e41fef6d41cbfcdb143551

  * quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:65c68e8c22487375c4c6ce6f18ed5485915f2bf612e41fef6d41cbfcdb143551

[...]
      Copy to Clipboard Toggle word wrap

    2. 将支持的镜像标签镜像到私有 registry： 

      $ oc image mirror quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:65c68e8c22487375c4c6ce6f18ed5485915f2bf612e41fef6d41cbfcdb143551 <mirror-registry>:<port>/openshift-release-dev/ocp-v4.0-art-dev:latest
      Copy to Clipboard Toggle word wrap

    3. 导入镜像： 

      $ oc tag <mirror-registry>:<port>/openshift-release-dev/ocp-v4.0-art-dev cli:latest --scheduled -n openshift
      Copy to Clipboard Toggle word wrap

      您必须定期重新导入镜像。--scheduled 标志启用镜像自动重新导入。

    4. 验证带有指定标签的镜像已被导入： 

      $ oc describe imagestream cli -n openshift
      Copy to Clipboard Toggle word wrap

      输出示例

      Name:                   cli
Namespace:              openshift
[...]

latest
  updates automatically from registry <mirror-registry>:<port>/openshift-release-dev/ocp-v4.0-art-dev

  * <mirror-registry>:<port>/openshift-release-dev/ocp-v4.0-art-dev@sha256:65c68e8c22487375c4c6ce6f18ed5485915f2bf612e41fef6d41cbfcdb143551

[...]
      Copy to Clipboard Toggle word wrap

1.6. 运行管道
复制链接

PipelineRun 资源启动管道，并将其与 Git 和用于特定调用的镜像资源相关联。它为管道中的每个任务自动创建并启动 TaskRun 资源。

流程

  1. 启动后端应用程序的管道： 

    $ tkn pipeline start build-and-deploy \
    -w name=shared-workspace,volumeClaimTemplateFile=https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/01_pipeline/03_persistent_volume_claim.yaml \
    -p deployment-name=pipelines-vote-api \
    -p git-url=https://github.com/openshift/pipelines-vote-api.git \
    -p IMAGE='image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/pipelines-vote-api' \
    --use-param-defaults
    Copy to Clipboard Toggle word wrap

    上一命令使用卷声明模板，该模板为管道执行创建持久性卷声明。

  2. 要跟踪管道运行的进度，请输入以下命令： 

    $ tkn pipelinerun logs <pipelinerun_id> -f
    Copy to Clipboard Toggle word wrap

    上述命令中的 <pipelinerun_id> 是上一命令输出返回的 PipelineRun 的 ID。

  3. 启动前端应用程序的管道： 

    $ tkn pipeline start build-and-deploy \
    -w name=shared-workspace,volumeClaimTemplateFile=https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/01_pipeline/03_persistent_volume_claim.yaml \
    -p deployment-name=pipelines-vote-ui \
    -p git-url=https://github.com/openshift/pipelines-vote-ui.git \
    -p IMAGE='image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/pipelines-vote-ui' \
    --use-param-defaults
    Copy to Clipboard Toggle word wrap

  4. 要跟踪管道运行的进度，请输入以下命令： 

    $ tkn pipelinerun logs <pipelinerun_id> -f
    Copy to Clipboard Toggle word wrap

    上述命令中的 <pipelinerun_id> 是上一命令输出返回的 PipelineRun 的 ID。

  5. 几分钟后，使用 tkn pipelinerun list 命令列出所有管道运行来验证管道是否成功运行： 

    $ tkn pipelinerun list
    Copy to Clipboard Toggle word wrap

    输出列出了管道运行： 

     NAME                         STARTED      DURATION     STATUS
 build-and-deploy-run-xy7rw   1 hour ago   2 minutes    Succeeded
 build-and-deploy-run-z2rz8   1 hour ago   19 minutes   Succeeded
    Copy to Clipboard Toggle word wrap

  6. 获取应用程序路由： 

    $ oc get route pipelines-vote-ui --template='http://{{.spec.host}}'
    Copy to Clipboard Toggle word wrap

    记录上一个命令的输出。您可以使用此路由来访问应用程序。

  7. 要重新运行最后的管道运行,请使用上一管道的管道资源和服务帐户运行： 

    $ tkn pipeline start build-and-deploy --last
    Copy to Clipboard Toggle word wrap

1.7. 在管道中添加触发器
复制链接

触发器（Trigger）使 Pipelines 可以响应外部 GitHub 事件，如推送事件和拉取请求。在为应用程序组装并启动管道后，添加 TriggerBinding、TriggerTemplate、Trigger 和 EventListener 资源来捕获 GitHub 事件。

流程

  1. 复制以下 TriggerBinding YAML 示例文件的内容并保存： 

    apiVersion: triggers.tekton.dev/v1beta1
kind: TriggerBinding
metadata:
  name: vote-app
spec:
  params:
  - name: git-repo-url
    value: $(body.repository.url)
  - name: git-repo-name
    value: $(body.repository.name)
  - name: git-revision
    value: $(body.head_commit.id)
    Copy to Clipboard Toggle word wrap

  2. 创建 TriggerBinding 资源： 

    $ oc create -f <triggerbinding-yaml-file-name.yaml>
    Copy to Clipboard Toggle word wrap

    或者，您可以直接从 pipelines-tutorial Git 仓库创建 TriggerBinding 资源： 

    $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/03_triggers/01_binding.yaml
    Copy to Clipboard Toggle word wrap

  3. 复制以下 TriggerTemplate YAML 示例文件的内容并保存： 

    apiVersion: triggers.tekton.dev/v1beta1
kind: TriggerTemplate
metadata:
  name: vote-app
spec:
  params:
  - name: git-repo-url
    description: The git repository url
  - name: git-revision
    description: The git revision
    default: pipelines-1.10
  - name: git-repo-name
    description: The name of the deployment to be created / patched

  resourcetemplates:
  - apiVersion: tekton.dev/v1beta1
    kind: PipelineRun
    metadata:
      generateName: build-deploy-$(tt.params.git-repo-name)-
    spec:
      serviceAccountName: pipeline
      pipelineRef:
        name: build-and-deploy
      params:
      - name: deployment-name
        value: $(tt.params.git-repo-name)
      - name: git-url
        value: $(tt.params.git-repo-url)
      - name: git-revision
        value: $(tt.params.git-revision)
      - name: IMAGE
        value: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/$(tt.params.git-repo-name)
      workspaces:
      - name: shared-workspace
        volumeClaimTemplate:
          spec:
            accessModes:
              - ReadWriteOnce
            resources:
              requests:
                storage: 500Mi
    Copy to Clipboard Toggle word wrap

    模板指定一个卷声明模板，用于创建用于为工作空间定义存储卷的持久性卷声明。因此，您不需要创建持久性卷声明来提供数据存储。

  4. 创建 TriggerTemplate 资源： 

    $ oc create -f <triggertemplate-yaml-file-name.yaml>
    Copy to Clipboard Toggle word wrap

    另外，您还可以从 pipelines-tutorial Git 仓库直接创建 TriggerTemplate 资源： 

    $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/03_triggers/02_template.yaml
    Copy to Clipboard Toggle word wrap

  5. 复制以下 Trigger YAML 示例文件的内容并保存： 

    apiVersion: triggers.tekton.dev/v1beta1
kind: Trigger
metadata:
  name: vote-trigger
spec:
  serviceAccountName: pipeline
  bindings:
    - ref: vote-app
  template:
    ref: vote-app
    Copy to Clipboard Toggle word wrap

  6. 创建 Trigger 资源： 

    $ oc create -f <trigger-yaml-file-name.yaml>
    Copy to Clipboard Toggle word wrap

    另外，您还可以直接从 pipelines-tutorial Git 仓库创建 Trigger 资源： 

    $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/03_triggers/03_trigger.yaml
    Copy to Clipboard Toggle word wrap

  7. 复制以下 EventListener YAML 示例文件的内容并保存： 

    apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: vote-app
spec:
  serviceAccountName: pipeline
  triggers:
    - triggerRef: vote-trigger
    Copy to Clipboard Toggle word wrap

    或者，如果您还没有定义触发器自定义资源，将绑定和模板规格添加到 EventListener YAML 文件中，而不是引用触发器的名称： 

    apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: vote-app
spec:
  serviceAccountName: pipeline
  triggers:
  - bindings:
    - ref: vote-app
    template:
      ref: vote-app
    Copy to Clipboard Toggle word wrap

  8. 通过执行以下步骤来创建 EventListener 资源：

    • 使用安全 HTTPS 连接创建 EventListener 资源：

      1. 添加一个标签，在 Eventlistener 资源中启用安全 HTTPS 连接： 

        $ oc label namespace <ns-name> operator.tekton.dev/enable-annotation=enabled
        Copy to Clipboard Toggle word wrap

      2. 创建 EventListener 资源： 

        $ oc create -f <eventlistener-yaml-file-name.yaml>
        Copy to Clipboard Toggle word wrap

        或者，您可以直接从 pipelines-tutorial Git 仓库创建 EvenListener 资源： 

        $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.10/03_triggers/04_event_listener.yaml
        Copy to Clipboard Toggle word wrap

      3. 使用重新加密 TLS 终止创建路由： 

        $ oc create route reencrypt --service=<svc-name> --cert=tls.crt --key=tls.key --ca-cert=ca.crt --hostname=<hostname>
        Copy to Clipboard Toggle word wrap

        另外，您可以创建一个重新加密 TLS 终止 YAML 文件，以创建安全路由。

        安全路由重新加密 TLS 终止 YAML 示例

        apiVersion: route.openshift.io/v1
kind: Route
metadata:
  name: route-passthrough-secured
        1 
        
spec:
  host: <hostname>
  to:
    kind: Service
    name: frontend
        2 
        
  tls:
    termination: reencrypt
        3 
        
    key: [as in edge termination]
    certificate: [as in edge termination]
    caCertificate: [as in edge termination]
    destinationCACertificate: |-
        4 
        
      -----BEGIN CERTIFICATE-----
      [...]
      -----END CERTIFICATE-----
        Copy to Clipboard Toggle word wrap

        1 2
        对象的名称，长度限于 63 个字符。
        3
        termination 字段设置为 reencrypt。这是唯一需要 tls 的字段。
        4
        重新加密需要。destinationCACertificate 指定用来验证端点证书的 CA 证书，保护从路由器到目标 pod 的连接。如果服务使用服务签名证书，或者管理员为路由器指定默认 CA 证书，且服务有由该 CA 签名的证书，则可以省略此字段。

        如需了解更多选项，请参阅 oc create route reencrypt --help。

    • 使用不安全的 HTTP 连接创建 EventListener 资源：

      1. 创建 EventListener 资源。

      2. 将 EventListener 服务公开为 OpenShift Container Platform 路由，使其可以被公开访问： 

        $ oc expose svc el-vote-app
        Copy to Clipboard Toggle word wrap
注意

如果要创建一个基本的 CI/CD 管道，您可以跳过此部分。但是，如果您的部署策略涉及多个命名空间，您可以将事件监听程序配置为为多个命名空间提供服务。

为了提高 EvenListener 对象的可重用性，集群管理员可将它们配置为为多个命名空间的多租户事件监听程序进行配置和部署。

流程

  1. 为事件监听程序配置集群范围的获取权限。

    1. 设置在 ClusterRoleBinding 和 EventListener 对象中使用的服务帐户名称。例如，el-sa。

      ServiceAccount.yaml 示例

      apiVersion: v1
kind: ServiceAccount
metadata:
  name: el-sa
---
      Copy to Clipboard Toggle word wrap

    2. 在 ClusterRole.yaml 文件的 rules 部分，为每个事件监听器部署设置适当的权限，以便正常工作集群范围的。

      ClusterRole.yaml 示例

      kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: el-sel-clusterrole
rules:
- apiGroups: ["triggers.tekton.dev"]
  resources: ["eventlisteners", "clustertriggerbindings", "clusterinterceptors", "triggerbindings", "triggertemplates", "triggers"]
  verbs: ["get", "list", "watch"]
- apiGroups: [""]
  resources: ["configmaps", "secrets"]
  verbs: ["get", "list", "watch"]
- apiGroups: [""]
  resources: ["serviceaccounts"]
  verbs: ["impersonate"]
...
      Copy to Clipboard Toggle word wrap

    3. 使用适当的服务帐户名称和集群角色名称配置集群角色绑定。

      ClusterRoleBinding.yaml 示例

      apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: el-mul-clusterrolebinding
subjects:
- kind: ServiceAccount
  name: el-sa
  namespace: default
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: el-sel-clusterrole
...
      Copy to Clipboard Toggle word wrap

  2. 在事件监听器的 spec 参数中，添加服务帐户名称，如 el-sa。使用事件监听程序要服务的命名空间名称填充 namespaceSelector 参数。

    EventListener.yaml 示例

    apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: namespace-selector-listener
spec:
  serviceAccountName: el-sa
  namespaceSelector:
    matchNames:
    - default
    - foo
...
    Copy to Clipboard Toggle word wrap

  3. 创建具有必要权限的服务帐户，如 foo-trigger-sa。使用它来绑定触发器。

    ServiceAccount.yaml 示例

    apiVersion: v1
kind: ServiceAccount
metadata:
  name: foo-trigger-sa
  namespace: foo
...
    Copy to Clipboard Toggle word wrap

    RoleBinding.yaml 示例

    apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: triggercr-rolebinding
  namespace: foo
subjects:
- kind: ServiceAccount
  name: foo-trigger-sa
  namespace: foo
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: tekton-triggers-eventlistener-roles
...
    Copy to Clipboard Toggle word wrap

  4. 使用适当的触发器模板、触发器绑定和服务帐户名称创建触发器。

    Trigger.yaml 示例

    apiVersion: triggers.tekton.dev/v1beta1
kind: Trigger
metadata:
  name: trigger
  namespace: foo
spec:
  serviceAccountName: foo-trigger-sa
  interceptors:
    - ref:
        name: "github"
      params:
        - name: "secretRef"
          value:
            secretName: github-secret
            secretKey: secretToken
        - name: "eventTypes"
          value: ["push"]
  bindings:
    - ref: vote-app
  template:
    ref: vote-app
...
    Copy to Clipboard Toggle word wrap

1.9. 创建 Webhook
复制链接

Webhook 是事件监听程序在存储库中配置事件时接收到的 HTTP POST 信息。然后，事件有效负载映射到触发器绑定，并由触发器模板处理。触发器模板最终启动一个或多个管道运行，从而创建并部署 Kubernetes 资源。

在本小节中，您将在 Git 存储库 pipelines-vote-ui 和 pipelines-vote-api 的副本中配置 webhook URL。这个 URL 指向公开访问的 EventListener 服务路由。

注意

添加 Webhook 需要对该存储库有管理特权。如果您没有对库的管理权限，请联络您的系统管理员来添加 webhook。

流程

  1. 获取 Webhook URL：

    • 对于安全 HTTPS 连接： 

      $ echo "URL: $(oc  get route el-vote-app --template='https://{{.spec.host}}')"
      Copy to Clipboard Toggle word wrap

    • 对于 HTTP（不安全）连接： 

      $ echo "URL: $(oc  get route el-vote-app --template='http://{{.spec.host}}')"
      Copy to Clipboard Toggle word wrap

      记录下输出中的 URL。

  2. 在前端存储库中手动配置 Webhook：

    1. 在浏览器中打开前端 Git 存储库 pipelines-vote-ui。
    2. 点 Settings → Webhooks → Add Webhook

    3. 在 Webhooks/Add Webhook 页面中：

      1. 在 Payload URL 字段中输入第 1 步中的 webhook URL
      2. 为 Content type 选择 application/json
      3. 在 Secret 字段中指定 secret
      4. 确定选择了 Just the push event
      5. 选择 Active
      6. 点击 Add webhook。
  3. 重复步骤 2 来使用后端存储库 pipelines-vote-api。

1.10. 触发一个管道运行
复制链接

每当 Git 仓库中发生 push 事件时，配置的 Webhook 会将事件有效负载发送到公开的 EventListener 服务路由。应用程序的 EventListener 服务处理有效负载，并将其传递给相关的 TriggerBinding 和 TriggerTemplate 资源对。TriggerBinding 资源提取参数，TriggerTemplate 资源使用这些参数并指定必须创建资源的方式。这可能会重建并重新部署应用程序。

在本小节中，您将把一个空的提交推送到前端 pipelines-vote-ui 存储库，该存储库将触发管道运行。

流程

  1. 在终端中，克隆 fork 的 Git 存储库 pipelines-vote-ui： 

    $ git clone git@github.com:<your GitHub ID>/pipelines-vote-ui.git -b pipelines-1.10
    Copy to Clipboard Toggle word wrap

  2. 推送空提交： 

    $ git commit -m "empty-commit" --allow-empty && git push origin pipelines-1.10
    Copy to Clipboard Toggle word wrap

  3. 检查管道运行是否已触发： 

    $ tkn pipelinerun list
    Copy to Clipboard Toggle word wrap

    请注意，一个新的管道运行被启动。

作为集群管理员，在用户定义的项目中收集 Triggers 服务的事件监听程序指标，并在 OpenShift Container Platform Web 控制台中显示它们，您可以为每个事件监听程序创建服务监控器。在收到 HTTP 请求时，Triggers 服务的事件监听程序返回三个指标数据 - eventlistener_http_duration_seconds, eventlistener_event_count, 和 eventlistener_triggered_resources。

先决条件

  • 已登陆到 OpenShift Container Platform Web 控制台。
  • 已安装 Red Hat OpenShift Pipelines Operator。
  • 您已为用户定义的项目启用了监控。

流程

  1. 对于每个事件侦听器，创建一个服务监控器。例如，要查看 test 命名空间中的 github-listener 事件监听程序的指标，请创建以下服务监控器： 

    apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  labels:
    app.kubernetes.io/managed-by: EventListener
    app.kubernetes.io/part-of: Triggers
    eventlistener: github-listener
  annotations:
    networkoperator.openshift.io/ignore-errors: ""
  name: el-monitor
  namespace: test
spec:
  endpoints:
    - interval: 10s
      port: http-metrics
  jobLabel: name
  namespaceSelector:
    matchNames:
      - test
  selector:
    matchLabels:
      app.kubernetes.io/managed-by: EventListener
      app.kubernetes.io/part-of: Triggers
      eventlistener: github-listener
...
    Copy to Clipboard Toggle word wrap

  2. 通过将请求发送到事件监听程序来测试服务监控器。例如，推送空提交： 

    $ git commit -m "empty-commit" --allow-empty && git push origin main
    Copy to Clipboard Toggle word wrap
  3. 在 OpenShift Container Platform web 控制台中进入 Administrator → Observe → Metrics。
  4. 要查看指标，请按名称搜索。例如，若要查看 github-listener 事件监听器的 eventlistener_http_resources 指标的详细信息，请使用 eventlistener_http_resources 关键字搜索。

您可以使用 Administrator 或 Developer 视角从 OpenShift Container Platform Web 控制台中的 Pipelines 页面创建和修改 Pipeline、PipelineRun 和 Repository 对象。您还可以使用 web 控制台的 Developer 视角中的 +Add 页面为软件交付过程创建 CI/CD 管道。

在 Developer 视角中，您可以从 +Add 页面访问以下选项来创建管道：

  • 使用 +Add → Pipelines → Pipeline builder 选项为您的应用程序创建自定义管道。
  • 使用 +Add → From Git 选项，在创建应用程序时使用管道模板和资源创建管道。

在为应用程序创建管道后，可以在 Pipelines 视图中查看并以视觉化的形式与部署进行交互。您还可以使用 Topology 视图与使用 From Git 选项创建的管道交互。您需要将自定义标识应用到使用 Pipeline builder 创建的管道，以便在 Topology 视图中查看它。

先决条件

2.1.1. 使用 Pipeline 构建器构建管道
复制链接

在控制台的 Developer 视角中，您可以使用 +Add → Pipeline → Pipeline Builder 选项：

  • 使用 Pipeline 构建器 或 YAML 视图 配置管道。
  • 使用现有任务和集群任务构建管道流。安装 OpenShift Pipelines Operator 时，它会在集群中添加可重复使用的管道集群任务。
重要

在 Red Hat OpenShift Pipelines 1.10 中，集群任务功能已弃用，计划在以后的发行版本中删除。

  • 指定管道运行所需的资源类型，如有必要，将额外参数添加到管道。
  • 引用管道中的每个任务中的这些管道资源作为输入和输出资源。
  • 如果需要，引用任务中添加至管道的任何额外参数。任务的参数会根据任务的规格预先填充。
  • 使用 Operator 安装的、可重复使用的片断和示例来创建详细的管道。

流程

  1. 在 Developer 视角的 Add 视图中，点 Pipeline 标题查看 Pipeline Builder 页面。

  2. 使用 Pipeline 构建器 视图或 YAML 视图配置管道。

    注意

    Pipeline 构建器 视图支持有限的字段，而 YAML 视图支持所有可用字段。另外，您还可以使用 Operator 安装的、可重复使用的片断和样本来创建详细的管道。

    图 2.1. YAML 视图

    op pipeline yaml

  3. 使用 Pipeline 构建器配置管道：

    1. 在 Name 字段中输入管道的唯一名称。

    2. 在 Tasks 部分：

      1. 单击 Add task。
      2. 使用快速搜索字段搜索任务，然后从显示的列表中选择所需的任务。

      3. 点击 Add 或 Install and add。在本例中,使用 s2i-nodejs 任务。

        注意

        搜索列表包含集群中可用的所有 Tekton Hub 任务和任务。此外，如果某一任务已经安装，它将显示 Add 添加该任务，而它将显示 Install and add 以安装和添加该任务。当使用更新的版本添加相同的任务时，它将显示 Update and add。

        • 在管道中添加后续任务：

          • 点击任务右侧或左侧的加号图标 → 点 Add task。
          • 使用快速搜索字段搜索任务，然后从显示的列表中选择所需的任务。

          • 点击 Add 或 Install and add。

            图 2.2. Pipeline 构建器

            op pipeline builder

        • 添加最后一项任务：

          • 点 Add finally task → Click Add task。
          • 使用快速搜索字段搜索任务，然后从显示的列表中选择所需的任务。
          • 点击 Add 或 Install and add。

    3. 在 Resources 部分，点 Add Resources 指定管道运行的资源的名称和类型。这些资源然后会被管道中的任务使用作为输入和输出。在此例中：

      1. 添加一个输入资源。在 Name 字段中输入 Source，从 Resource Type 下拉列表中选择 Git。

      2. 添加一个输出资源。在 Name 字段中输入 img，从 Resource Type 下拉列表中选择 Image。

        注意

        如果缺少资源，任务旁边会出现一个红色图标。

    4. 可选：任务的 Parameters 部分会根据任务的规格预先填充。如果需要，使用 Parameters 部分中的 Add Parameters 链接来添加额外的参数。
    5. 在 Workspaces 部分，点 Add workspace，并在 Name 字段中输入唯一工作区名称。您可以在管道中添加多个工作区。

    6. 在 Tasks 部分中，点 s2i-nodejs 任务，以查看带任务详情的侧面板。在任务侧面板中，为 s2i-nodejs 任务指定资源和参数：

      1. 如果需要，在 Parameters 部分，使用 $(params.<param-name>)语法为默认参数添加更多参数。
      2. 在 Image 部分中，按在 Resources 部分中的指定输入 Img。
      3. 从 Workspaces 部分下的 source 下拉菜单中选择一个工作区。
    7. 将资源、参数和工作空间添加到 openshift-client 任务。
  4. 点 Create 在 Pipeline Details 页面中创建并查看管道。
  5. 点 Actions 下拉菜单，然后点 Start，查看 Start Pipeline 页面。
  6. Workspaces 部分列出了您之前创建的工作区。使用对应的下拉菜单为您的工作区指定卷源。您有以下选项： mpty Directory、Config Map、Secret、PersistentVolumeClaim 或 VolumeClaimTemplate。

2.1.2. 创建 OpenShift Pipelines 和应用程序
复制链接

要与应用程序一同创建管道，使用 Developer 视角的 Add+ 视图中的 From Git 选项。您可以查看所有可用的管道，并在导入代码或部署镜像时选择用来创建应用程序的管道。

Tekton Hub 集成默认是启用的，您可以看到集群支持的 Tekton Hub 中的任务。管理员可以选择不使用 Tekton Hub 集成，将不会显示 Tekton Hub 任务。您还可以检查是否为生成的管道存在 webhook URL。为使用 +Add 流创建的管道添加默认 Webhook，URL 在 Topology 视图中所选资源侧面面板中可见。

2.1.3. 使用 Developer 视角与管道交互
复制链接

开发者视角中的 Pipelines 视图列出了项目中的所有管道，以及以下详细信息：

  • 创建管道的命名空间
  • 最后一次管道运行
  • 管道运行中的任务状态
  • 管道运行的状态
  • 最后一次管道运行的创建时间

流程

  1. 在 Developer 视角的 Pipelines 视图中，从 Project 下拉列表中选择一个项目，以查看该项目中的管道。

  2. 点击所需管道查看 Pipeline 详情页面。

    默认情况下，Details 选项卡显示所有串行任务、并行任务、finally 任务以及管道中的 when 表达式的可视化表示。这些任务和 finally 的任务列在页面的右下角。点列出的 Tasks 和 Finally tasks 以查看任务详情。

    图 2.3. Pipeline 详情

    Pipeline 详情

  3. 可选： 在 Pipeline 详情页面中，点 Metrics 选项卡查看有关管道的以下信息：

    • Pipeline 成功率
    • Pipeline 运行数量
    • 管道运行持续时间

    • 任务运行持续时间

      您可以使用这些信息来改进管道工作流，并在管道生命周期的早期解决问题。

  4. 可选：点 YAML 选项卡编辑管道的 YAML 文件。

  5. 可选：点 Pipeline Runs 选项卡查看已完成、正在运行或运行失败的管道。

    Pipeline Runs 选项卡提供有关管道运行、任务状态以及调试失败管道运行的链接。您可以使用 Options 菜单 kebab 来停止正在运行的管道，使用与之前的管道执行相同的参数和资源重新运行管道，或删除管道运行。

    • 点所需的管道运行查看 Pipeline Run details 页面。默认情况下，Details 选项卡显示所有串行任务、并行任务、finally 任务以及管道中运行的 when 表达式的可视化表示。成功运行的结果会显示在页面底部的 Pipeline Run 结果窗格下。另外，您只能查看由集群支持的 Tekton Hub 中的任务。在查看某个任务时，您可以点击相关链接来跳至任务文档。

      注意

      Pipeline Run Details 页面的 Details 部分显示失败管道运行的日志片段。日志片断 提供一般错误信息和日志片断。Logs 部分的链接可让您快速访问失败运行的详细信息。

    • 在 Pipeline Run details 页面中，点 Task Runs 选项卡查看已完成、正在运行和运行失败的任务。

      Task Runs 选项卡提供有关任务运行的信息，以及任务和 pod 的链接，以及任务运行的状态和持续时间。使用 Options 菜单 kebab 来删除任务运行。

    • 点所需的任务运行查看 Task Run details 页面。成功运行的结果显示在页面底部的 Task Run 结果窗格下。

      注意

      Task Run details 页面的 Details 部分显示失败任务运行的日志片段。日志片断 提供一般错误信息和日志片断。Logs 部分的链接可让您快速访问失败的任务运行的详细信息。

  6. 点 Parameters 标签，查看管道中定义的参数。您还可以根据需要添加或者编辑附加参数。
  7. 点 Resources 标签页，查看管道中定义的资源。您还可以根据需要添加或编辑附加资源。

2.1.4. 从 Pipelines 视图启动管道
复制链接

创建管道后，您需要启动它以在定义的顺序中执行包含的任务。您可从 Pipelines 视图、Pipeline Details 页面或 Topology 视图启动管道。

流程

使用 Pipelines 视图启动管道：

  1. 在 Developer 视角 的 Pipelines 视图中，点附加到 Pipeline 的 Options kebab 菜单，然后选择 Start。

  2. Start Pipeline 对话框显示 Git Resources 以及基于管道定义的 Image Resources。

    注意

    对于使用 From Git 选项创建的管道，Start Pipeline 对话框也会在 Parameters 部分显示 APP_NAME 字段，对话框中的所有字段都由管道模板预先填充。

    1. 如果您在命名空间中有资源，Git Resources 和 Image Resources 字段会预先填充这些资源。如果需要，使用下拉菜单选择或创建所需资源并自定义管道运行实例。

  3. 可选：修改 Advanced Options 以添加验证指定私有 Git 服务器或镜像 registry 的凭证。

    1. 在 Advanced Options 下，点 Show Credentials Options 并选择 Add Secret。

    2. 在 Create Source Secret 部分，指定以下内容：

      1. secret 的唯一 Secret Name。
      2. 在 要被验证的指定供应商 部分，在 Access to 字段中指定要验证的供应商，以及基本 服务器 URL。

      3. 选择 Authentication Type 并提供凭证：

        • 对于 Authentication Type Image Registry Credentials，请指定您要进行身份验证的 Registry 服务器地址，并通过Username、Password 和 Email 项中提供您的凭证。

          如果要指定额外的 Registry 服务器地址，选择 Add Credentials 。

        • 如果 Authentication Type 为 Basic Authentication，在 UserName 和 Password or Token 项中指定相关的值。

        • 如果 Authentication Type 为 SSH Keys 时，在 SSH Private Key 字段中指定相关的值。

          注意

          对于基本身份验证和 SSH 身份验证，您可以使用注解，例如：

      4. 选择要添加 secret 的检查标记。

    您可以根据频道中的资源数量添加多个 secret。

  4. 点 Start 启动管道。

  5. Pipeline Run Details 页面显示正在执行的管道。管道启动后，每个任务中的任务和步骤都会被执行。您可以：

    • 将鼠标悬停在任务上，以查看执行每一步骤所需时间。
    • 点一个任务来查看任务中每一步骤的日志。
    • 点 Logs 选项卡查看与任务执行顺序相关的日志。您还可以使用相关按钮扩展窗格，单独或批量下载日志。

    • 点 Events 选项卡查看管道运行生成的事件流。

      您可以使用 Task Runs、Logs 和 Events 选项卡来帮助调试失败的管道运行或失败的任务运行。

      图 2.4. Pipeline 运行详情

      Pipeline 运行详情

2.1.5. 从 Topology 视图启动管道
复制链接

对于使用 From Git 选项创建的管道，您可以在启动后使用 Topology 视图来与管道进行交互：

注意

要使用 Pipeline Builder 在 Topology 视图中查看创建的管道，自定义管道标识来把 Pipeline 与应用程序负载相连接。

流程

  1. 单击左侧导航面板中的 Topology。
  2. 点应用程序在侧面面板中显示 Pipeline Runs。

  3. 在 Pipeline Runs 中，点 Start Last Run 来启动一个新的管道运行，使用与前一个相同的参数和资源。如果没有启动管道运行，这个选项会被禁用。您还可以在创建管道时启动管道运行。

    图 2.5. Topology 视图中的管道

    Topology 视图中的管道

在 Topology 页面中，把鼠标移到应用程序的左侧，以查看其管道运行的状态。添加管道后，底部左图标表示存在关联的管道。

2.1.6. 从 Topology 视图与管道交互
复制链接

Topology 页面中的应用程序节点的侧面板显示管道运行的状态，并可与之交互。

  • 如果管道运行没有自动启动，则侧面板会显示管道无法自动启动的消息，因此需要手动启动。
  • 如果创建一个管道，但用户没有启动管道，则其状态不会启动。当用户点击 Not started status 图标时，Topology 视图中会打开启动对话框。
  • 如果管道没有构建或构建配置，则无法看到 Builds 部分。如果存在管道和构建配置，则 Builds 部分 可见。
  • 当管道运行在特定任务运行时，侧边面板会显示一个 日志片段。您可以在 Pipeline Runs 部分的 Resources 选项卡中查看日志片断。它提供常规错误消息和日志片断。Logs 部分的链接可让您快速访问失败运行的详细信息。

2.1.7. 编辑管道
复制链接

您可以使用 web 控制台的 Developer 视角编辑集群中的管道：

流程

  1. 在 Developer 视角的 Pipelines 视图中，选择您要编辑的管道来查看管道的详情。在 Pipeline Details 页中，点 Actions 并选择 Edit Pipeline。

  2. 在 Pipeline builder 页面中，您可以执行以下任务：

    • 在管道中添加其他任务、参数或资源。
    • 点要修改的任务来查看侧面面板中的任务详情，并修改所需的任务详情，如显示名称、参数和资源。
    • 或者，要删除任务，点任务，在侧面面板中点 Actions 并选择 Remove Task。
  3. 点 Save 保存修改后的管道。

2.1.8. 删除管道
复制链接

您可以使用 web 控制台的 Developer 视角删除集群中的管道。

流程

  1. 在 Developer 视角 的 Pipelines 视图中，点 Pipeline 旁的 Options kebab 菜单，然后选择 Delete Pipeline。
  2. 在 Delete Pipeline 确认提示下，点 Delete 以确认删除。

2.3. 在 Administrator 视角中创建管道模板
复制链接

作为集群管理员，您可以创建管道模板，开发人员可在集群上创建管道时重复使用该模板。

先决条件

  • 您可以使用集群管理员权限访问 OpenShift Container Platform 集群，并切换到 Administrator 视角。
  • 已在集群中安装了 OpenShift Pipelines Operator。

流程

  1. 进入到 Pipelines 页面来查看现有的管道模板。
  2. 点 import icon 图标进入 Import YAML 页面。

  3. 为管道模板添加 YAML。模板必须包含以下信息： 

    apiVersion: tekton.dev/v1beta1
kind: Pipeline
metadata:
# ...
  namespace: openshift
    1 
    
  labels:
    pipeline.openshift.io/runtime: <runtime>
    2 
    
    pipeline.openshift.io/type: <pipeline-type>
    3 
    
# ...
    Copy to Clipboard Toggle word wrap
    1
    模板必须在 openshift 命名空间中创建。
    2
    模板必须包含 pipeline.openshift.io/runtime 标签。此标签接受的运行时值为 nodejs,golang,dotnet,java,php, ruby ,ruby,perl,python,nginx, 和 httpd。
    3
    模板必须包含 pipeline.openshift.io/type: 标签。此标签接受的 type 值为 openshift,knative, 和 kubernetes。
  4. 点 Create。创建管道后，会进入 Pipeline 详情页面，您可以在其中查看或编辑管道的信息。

作为集群管理员，安装 Red Hat OpenShift Pipelines Operator 会为每个默认集群任务创建变体，称为 版本化的集群任务 (VCT) 和非版本的集群任务 (NVCT)。例如，安装 Red Hat OpenShift Pipelines Operator v1.7 创建一个 buildah-1-7-0 VCT 和 buildah NVCT。

NVCT 和 VCT 具有相同的元数据、行为和规格，包括 params、workspaces 和 steps。但是，当禁用 Operator 或升级 Operator 时，它们的行为会有所不同。

重要

在 Red Hat OpenShift Pipelines 1.10 中，集群任务功能已弃用，计划在以后的发行版本中删除。

3.1. 非版本和版本的集群任务之间的区别
复制链接

非版本的和版本化的集群任务有不同的命名约定。另外，Red Hat OpenShift Pipelines Operator 会不同地升级它们。

Expand
表 3.1. 非版本和版本的集群任务之间的区别
 非版本的集群任务版本的集群任务

Nomenclature

NVCT 仅包含集群任务的名称。例如，随 Operator v1.7 安装的 Buildah NVCT 的名称是 buildah。

VCT 包含集群任务的名称，后接为后缀的版本。例如，由 Operator v1.7 安装的 Buildah 的 VCT 的名称是 buildah-1-7-0。

Upgrade（升级）

升级 Operator 时，它会使用最新的更改更新非版本的集群任务。NVCT 的名称保持不变。

升级 Operator 会安装 VCT 的最新版本并保留更早的版本。VCT 的最新版本对应于升级的 Operator。例如，安装 Operator 1.7 安装 buildah-1-7-0 并保留 buildah-1-6-0。

3.2. 非版本和版本的集群任务的优点和缺陷
复制链接

在将未指定版本或版本化的集群任务用作生产环境中的标准之前，集群管理员可能会考虑它们的优点和缺点。

Expand
表 3.2. 非版本和版本的集群任务的优点和缺陷
集群任务优点缺点

非版本的集群任务 (NVCT)

  • 如果您希望使用最新更新和程序错误修复部署管道，请使用 NVCT。
  • 升级 Operator 会升级非版本的集群任务，这会消耗比多个版本的集群任务更少的资源。

如果您部署使用 NVCT 的管道，如果自动升级的集群任务不向后兼容，则它们可能会在 Operator 升级后中断。

版本化的集群任务 (VCT)

  • 如果您的目的是在生产环境中提供稳定的管道，请使用 VCT。
  • 之前的版本会保留在集群中，即使安装了集群任务的更新的版本。您可以继续使用较早的集群任务。
  • 如果您继续使用集群任务的早期版本，您可能会错过最新的功能和关键安全更新。
  • 早期版本的集群任务，它们不正常消耗集群资源。
  • * 升级后，Operator 无法管理更早的 VCT。您可以使用 oc delete clustertask 命令手动删除更早的 VCT，但您无法恢复它。

3.3. 禁用未指定版本和版本的集群任务
复制链接

作为集群管理员，您可以禁用安装 OpenShift Pipelines Operator 的集群任务。

流程

  1. 要删除所有非版本的集群任务和最新版本的集群任务，请编辑 TektonConfig 自定义资源定义(CRD)并将 spec.addon.params 中的 clusterTasks 参数设置为 false。

    TektonConfig CR 示例

    apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  params:
  - name: createRbacResource
    value: "false"
  profile: all
  targetNamespace: openshift-pipelines
  addon:
    params:
    - name: clusterTasks
      value: "false"
...
    Copy to Clipboard Toggle word wrap

    当您禁用集群任务时，Operator 会删除所有非版本的集群任务，且只从集群中删除最新版本的集群任务。

    注意

    重新启用集群任务将安装非版本的集群任务。

  2. 可选： 要删除早期版本的集群任务，请使用以下方法之一：

    1. 要删除个别较早版本的集群任务，请使用 oc delete clustertask 命令，后面是版本化的集群任务名称。例如： 

      $ oc delete clustertask buildah-1-6-0
      Copy to Clipboard Toggle word wrap

    2. 要删除由旧版本 Operator 创建的所有版本集群任务，您可以删除对应的安装程序设置。例如： 

      $ oc delete tektoninstallerset versioned-clustertask-1-6-k98as
      Copy to Clipboard Toggle word wrap
      Important

      如果您删除旧版本的集群任务，则无法恢复它。您只能恢复当前创建的 Operator 版本和未版本的集群任务。

法律通告
复制链接

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2026 Red Hat返回顶部