Pipelines

流程

1. 在控制台的 Administrator 视角中，导航到 Operators → OperatorHub。

2. 使用 Filter by keyword 复选框在目录中搜索 OpenShift Pipelines Operator。点 OpenShift Pipelines Operator。

   注意

   确保您没有选择 OpenShift Pipelines Operator 的 Community 版本。

3. 参阅 OpenShift Pipelines Operator 页中有关 Operator 的简单描述。点 Install.

4. 在 Create Operator Subscription 页面：

   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。

      • ocp-<4.x> 频道将启用 OpenShift Pipelines Operator 最新稳定版本的安装。
      • preview3 频道启用 OpenShift Pipelines Operator 的最新预览版本，该版本可能包含 4.x 更新频道中还未提供的功能。

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

   注意

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

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

流程

1. 创建一个订阅对象 YAML 文件，以便为 OpenShift Pipelines Operator 订阅一个命名空间，如 sub.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

   1

   指定您要订阅 Operator 的频道名称

   2

   要订阅的 Operator 的名称。

   3

   提供 Operator 的 CatalogSource 的名称。

   4

   CatalogSource 的命名空间。将 openshift-marketplace 用于默认的 OperatorHub CatalogSource。

2. 创建订阅对象：

   $ oc apply -f sub.yaml

   OpenShift Pipelines Operator 现在安装在默认目标命名空间 openshift-operators 中。

流程

1. 在 Web 控制台的 Administrator 视角中，导航至 Administration → Custom Resource Definition。
2. 在 Filter by name 框中键入 config.operator.tekton.dev 来搜索 OpenShift Pipelines Operator CR。
3. 点击 CRD Config 查看 Custom Resource Definition Details 页面。

4. 点击 Actions 下拉菜单并选择 Delete Custom Resource Definition。

   注意

   删除 CR 将删除 OpenShift Pipelines 组件，并丢失集群上的所有任务和管道。

5. 点击 Delete 以确认删除 CR。

流程

1. 在 Operators → OperatorHub 页面中，使用 Filter by keyword 复选框来搜索 OpenShift Pipelines Operator。
2. 点 OpenShift Pipelines Operator。Operator 标题表示已安装该 Operator。
3. 在 OpenShift Pipelines Operator 描述符页面中，点击 Uninstall。

流程

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

   $ oc login -u <login> -p <password> https://openshift.example.com:6443

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

   $ oc new-project pipelines-tutorial

   注意

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

3. 检查 pipeline ServiceAccount：

   OpenShift Pipelines Operator 添加并配置一个名为 pipeline 的 ServiceAccount，它有足够的权限来构建和推送镜像。这个 ServiceAccount 由 PipelineRun 使用。

   $ oc get serviceaccount pipeline

流程

1. 从 pipelines-tutorial 存储库（它包括了一组可为管道重复使用的任务）中安装 apply-manifests 和 update-deployment 任务：

   $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/release-tech-preview-1/01_pipeline/01_apply_manifest_task.yaml
   $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/release-tech-preview-1/01_pipeline/02_update_deployment_task.yaml

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

   $ tkn task list

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

   NAME                DESCRIPTION   AGE
   apply-manifests                   1 minute ago
   update-deployment                 48 seconds ago

3. 使用 tkn clustertasks list 命令列出由 Operator 安装的额外 ClusterTasks，如 buildah 和 s2i-python-3:

   注意

   您必须使用特权 Pod 容器来运行 buildah ClusterTask，因为它需要特权安全上下文。如需了解更多有关 pod 安全性上下文约束（SCC）的信息，请参阅附加资源部分。

   $ tkn clustertasks list

   输出中列出了 Operator 安装的 ClusterTasks:

   NAME                       DESCRIPTION   AGE
   buildah                                  1 day ago
   buildah-v0-11-3                          1 day ago
   git-clone                                1 day ago
   jib-maven                                1 day ago
   kn                                       1 day ago
   maven                                    1 day ago
   openshift-client                         1 day ago
   openshift-client-v0-11-3                 1 day ago
   s2i                                      1 day ago
   s2i-dotnet-3                             1 day ago
   s2i-dotnet-3-v0-11-3                     1 day ago
   s2i-go                                   1 day ago
   s2i-go-v0-11-3                           1 day ago
   s2i-java-11                              1 day ago
   s2i-java-11-v0-11-3                      1 day ago
   s2i-java-8                               1 day ago
   s2i-java-8-v0-11-3                       1 day ago
   s2i-nodejs                               1 day ago
   s2i-nodejs-v0-11-3                       1 day ago
   s2i-perl                                 1 day ago
   s2i-perl-v0-11-3                         1 day ago
   s2i-php                                  1 day ago
   s2i-php-v0-11-3                          1 day ago
   s2i-python-3                             1 day ago
   s2i-python-3-v0-11-3                     1 day ago
   s2i-ruby                                 1 day ago
   s2i-ruby-v0-11-3                         1 day ago
   s2i-v0-11-3                              1 day ago
   tkn                                      1 day ago

流程

1. 为前端应用程序创建定义 Git 存储库的 PipelineResource:

   $ tkn resource create
   ? Enter a name for a pipeline resource : ui-repo
   ? Select a resource type to create : git
   ? Enter a value for url : http://github.com/openshift-pipelines/vote-ui.git
   ? Enter a value for revision : release-tech-preview-1

   检查输出来验证 ui-repo PipelineResource 是否已创建。

   New git resource "ui-repo" has been created

2. 创建一个 PipelineResource，用于定义 OpenShift Container Platform 内部镜像 registry（您要将前端镜像推送到的位置）：

   $ tkn resource create
   ? Enter a name for a pipeline resource : ui-image
   ? Select a resource type to create : image
   ? Enter a value for url : image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/ui:latest
   ? Enter a value for digest :

   检查输出来验证 ui-image PipelineResource 是否已创建。

   New image resource "ui-image" has been created

3. 创建用于为后端应用程序定义 Git 存储库的 PipelineResource:

   $ tkn resource create
   ? Enter a name for a pipeline resource : api-repo
   ? Select a resource type to create : git
   ? Enter a value for url : http://github.com/openshift-pipelines/vote-api.git
   ? Enter a value for revision : release-tech-preview-1

   检查输出来验证是否已创建了 api-repo PipelineResource。

   New git resource "api-repo" has been created

4. 创建一个 PipelineResource，用于定义 OpenShift Container Platform 内部镜像 registry（您要将后端镜像推送到的位置）：

   $ tkn resource create
   ? Enter a name for a pipeline resource : api-image
   ? Select a resource type to create : image
   ? Enter a value for url : image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/api:latest
   ? Enter a value for digest :

   检查输出来验证是否已创建 api-image PipelineResource。

   New image resource "api-image" has been created

5. 查看创建的 resources 列表：

   $ tkn resource list

   输出会列出创建的所有 PipelineResource。

   NAME        TYPE    DETAILS
   api-repo    git     url: http://github.com/openshift-pipelines/vote-api.git
   ui-repo     git     url: http://github.com/openshift-pipelines/vote-ui.git
   api-image   image   url: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/api:latest
   ui-image    image   url: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/ui:latest

流程

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

   apiVersion: tekton.dev/v1beta1
   kind: Pipeline
   metadata:
     name: build-and-deploy
   spec:
     resources:
     - name: git-repo
       type: git
     - name: image
       type: image
     params:
     - name: deployment-name
       type: string
       description: name of the deployment to be patched
     tasks:
     - name: build-image
       taskRef:
         name: buildah
         kind: ClusterTask
       resources:
         inputs:
         - name: source
           resource: git-repo
         outputs:
         - name: image
           resource: image
       params:
       - name: TLSVERIFY
         value: "false"
     - name: apply-manifests
       taskRef:
         name: apply-manifests
       resources:
         inputs:
         - name: source
           resource: git-repo
       runAfter:
       - build-image
     - name: update-deployment
       taskRef:
         name: update-deployment
       resources:
         inputs:
         - name: image
           resource: image
       params:
       - name: deployment
         value: $(params.deployment-name)
       runAfter:
       - apply-manifests

   请注意，Pipeline 定义提取了要在 Pipeline 执行过程中使用的 Git 源存储库和镜像 registry 的特定内容。

2. 创建 Pipeline:

   $ oc create -f <pipeline-yaml-file-name.yaml>

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

   $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/release-tech-preview-1/01_pipeline/04_pipeline.yaml

3. 使用 tkn pipeline list 命令来验证是否在应用程序中添加了 Pipeline:

   $ tkn pipeline list

   检查输出来验证创建了 build-and-deploy Pipeline:

   NAME               AGE            LAST RUN   STARTED   DURATION   STATUS
   build-and-deploy   1 minute ago   ---        ---       ---        ---

流程

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

   $ tkn pipeline start build-and-deploy -r git-repo=api-repo -r image=api-image -p deployment-name=vote-api

   请注意命令输出返回的 PipelineRun ID。

2. 跟踪 PipelineRun 进程：

   $ tkn pipelinerun logs <pipelinerun ID> -f

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

   $ tkn pipeline start build-and-deploy -r git-repo=ui-repo -r image=ui-image -p deployment-name=vote-ui

   请注意命令输出返回的 PipelineRun ID。

4. 跟踪 PipelineRun 进程：

   $ tkn pipelinerun logs <pipelinerun ID> -f

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

   $ tkn pipelinerun list

   输出中列出了 PipelineRuns:

    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

6. 获取应用程序路由：

   $ oc get route vote-ui --template='http://{{.spec.host}}'

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

7. 要重新运行最后一个 PipelineRun，请使用之前 Pipeline 的 PipelineResources 和 ServiceAccount 运行：

   $ tkn pipeline start build-and-deploy --last

流程

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

   apiVersion: triggers.tekton.dev/v1alpha1
   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)

2. 创建 TriggerBinding:

   $ oc create -f <triggerbinding-yaml-file-name.yaml>

   或者，您可以直接从 pipelines-tutorial Git 存储库创建 TriggerBinding：

   $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/release-tech-preview-1/03_triggers/01_binding.yaml

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

   apiVersion: triggers.tekton.dev/v1alpha1
   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: master
     - name: git-repo-name
       description: The name of the deployment to be created / patched
   
     resourcetemplates:
     - apiVersion: tekton.dev/v1alpha1
       kind: PipelineResource
       metadata:
         name: $(params.git-repo-name)-git-repo-$(uid)
       spec:
         type: git
         params:
         - name: revision
           value: $(params.git-revision)
         - name: url
           value: $(params.git-repo-url)
   
     - apiVersion: tekton.dev/v1alpha1
       kind: PipelineResource
       metadata:
         name: $(params.git-repo-name)-image-$(uid)
       spec:
         type: image
         params:
         - name: url
           value: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/$(params.git-repo-name):latest
   
     - apiVersion: tekton.dev/v1beta1
       kind: PipelineRun
       metadata:
         name: build-deploy-$(params.git-repo-name)-$(uid)
       spec:
         serviceAccountName: pipeline
         pipelineRef:
           name: build-and-deploy
         resources:
         - name: git-repo
           resourceRef:
             name: $(params.git-repo-name)-git-repo-$(uid)
         - name: image
           resourceRef:
             name: $(params.git-repo-name)-image-$(uid)
         params:
         - name: deployment-name
           value: $(params.git-repo-name)

4. 创建 TriggerTemplate:

   $ oc create -f <triggertemplate-yaml-file-name.yaml>

   另外，您还可以从 pipelines-tutorial Git 存储库直接创建 TriggerTemplate：

   $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/release-tech-preview-1/03_triggers/02_template.yaml

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

   apiVersion: triggers.tekton.dev/v1alpha1
   kind: EventListener
   metadata:
     name: vote-app
   spec:
     serviceAccountName: pipeline
     triggers:
     - bindings:
       - name: vote-app
       template:
         name: vote-app

6. 创建 EventListener:

   $ oc create -f <eventlistener-yaml-file-name.yaml>

   或者，您可以直接从 pipelines-tutorial Git 存储库创建 EvenListener：

   $ oc create -f https://raw.githubusercontent.com/openshift/pipelines-tutorial/release-tech-preview-1/03_triggers/03_event_listener.yaml

7. 将 EventListener 服务以 OpenShift Container Platform 路由的形式公开，以便公众可以访问它：

   $ oc expose svc el-vote-app

流程

1. 获取 Webhook URL:

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

   记录下输出中的 URL。

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

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

   3. 在 Webhooks/Add Webhook 页面中：

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

流程

1. 在终端中，克隆 Git 存储库 vote-api 的副本：

   $ git clone git@github.com:<your GitHub ID>/vote-api.git -b release-tech-preview-1

2. 推送空提交：

   $ git commit -m "empty-commit" --allow-empty && git push origin release-tech-preview-1

3. 检查 PipelineRun 是否被触发：

   $ tkn pipelinerun list

   请注意，一个新的 PipelineRun 被启动。

流程

1. 在 Developer 视角的 Pipelines 视图中，从 Project 下拉列表中选择一个项目，以查看该项目中的 Pipelines。
2. 点击所需 Pipeline 查看 Pipeline Details 页面。这可显示 Pipeline 中所有串行和并行任务。这些任务也列在页面的右下角。您可以点击列出的 任务来查看具体任务的详情。

3. 另外，在 Pipeline Details 页面中：

   • 点击 Pipeline Runs 标签页，查看完成、正在运行或运行失败的 Pipeline。您可以使用 Options 菜单 来停止正在运行的 Pipeline，使用与之前的 Pipeline 执行相同的参数和资源重新运行 Pipeline，或删除 PipelineRun。
   • 点击 Parameters 标签，查看 Pipeline 中定义的参数。您还可以根据需要添加或者编辑附加参数。
   • 点击 Resources 标签页，查看 Pipeline 中定义的资源。您还可以根据需要添加或编辑附加资源。