使用主控台為 Tekton 建立 Delivery Pipeline

配置 Delivery Pipeline 工具整合時，可以選取要建立的管線類型。

1. 如果您沒有工具鏈，請選取範本以 建立工具鏈。 視您使用的範本而定，可能會有不同的欄位。 請檢閱預設欄位值，並在必要時變更那些設定。

2. 如果您有一個工具鏈並且要向其中添加此工具集成，請從IBM Cloud控制台單擊菜單圖標>平台自動化>工具鏈。 在 工具鏈頁面上，按一下工具鏈以開啟其概述頁面。 或者，在應用程式之「概觀」頁面的「持續交付」卡片上，按一下檢視工具鏈。 然後，按一下概觀。

3. 將 Delivery Pipeline 整合新增至工具鏈:

   a. 按一下新增工具。

   b. 在「工具整合」區段中，按一下 Delivery Pipeline。

4. 指定新管線的名稱。

5. 選取 Tekton 以建立 Tekton Delivery Pipeline。 您可以在定義的 Kubernetes 叢集上檢視 Tekton 管道執行的輸出，並支援設定管道定義 repos、管道觸發器、管道執行位置和簡單的秘密。

6. 如果您計劃使用管線來部署使用者介面，請選取在「檢視應用程式」功能表中顯示應用程式勾選框。 管線所建立的所有應用程式都會顯示在工具鏈之「概觀」頁面的檢視應用程式清單中。

7. 按一下建立整合，以將 Delivery Pipeline 新增至您的工具鏈。

   header['x-github-event'] == 'pull_request' &&
      (body.action == 'opened' || body.action == 'synchronize') &&
      body.pull_request.base.ref == 'main'

   header['x-github-event'] == 'push' && body.ref == 'refs/heads/main'

   header['x-github-event'] == 'push' &&
      body.ref == 'refs/heads/main' &&
      !body.head_commit.message.contains("skip run")

   header['x-github-event'] == 'issue_comment' &&
      body.action == 'created' && has(body.issue.pull_request) &&
      body.comment.body.contains('/lgtm')

   header['x-github-event'] == 'issues' &&
      body.action == 'opened' &&
      body.issue.labels.exists(label, label.name == 'urgent')

   header['x-gitlab-event'] == 'Merge Request Hook' &&
      (body.object_attributes.action == 'open' || body.object_attributes.action == 'update') &&
      body.object_attributes.target_branch == 'main'

   header['x-gitlab-event'] == 'Push Hook' && body.ref == 'refs/heads/main'

   header['x-gitlab-event'] == 'Push Hook' &&
      body.ref == 'refs/heads/main' &&
      !body.object_attributes.last_commit.message("skip run")

   header['x-gitlab-event'] == 'Note Hook' &&
      body.object_attributes.noteable_type == 'MergeRequest' &&
      body.object_attributes.action == 'create' &&
      body.object_attributes.note.contains('/lgtm')

   header['x-gitlab-event'] == 'Issue Hook' &&
      (body.object_attributes.action == 'open') &&
      body.object_attributes.labels.exists(label, label.name == 'urgent')

   (header['x-event-key'] == 'pullrequest:created' || header['x-event-key'] == 'pullrequest:updated') &&
       body.pullrequest.destination.branch.name == 'main'

   header['x-event-key'] == 'repo:push' && body.push.changes[0].new.name == 'main'

   header['x-event-key'] == 'repo:push' &&
      body.push.changes[0].new.name == 'main' &&
      !body.push.changes[0].commits[0].message("skip run")

   header['x-event-key'] == 'pullrequest:comment_created' &&
      body.comment.content.raw.contains('/lgtm')

   header['x-event-key'] == 'issue:created' &&
      body.issue.kind == 'bug'

過濾器

篩選器可讓使用者根據特定條件精細拉取請求。 過濾欄位目前支援在拉取請求中指定標籤，從而根據標籤的存在與否控制管道的執行。 但是，它不會在標籤新增或移除時觸發管道；相反地，它會在允許執行管道之前驗證 PR 的標籤。

如何運作：

• 如果 PR 事件發生 (像是新增了一個提交)，管道會檢查 PR 上的標籤。
• 如果 PR 符合標籤條件 (例如，具有「核准」標籤)，則管道會執行。
• 如果 PR 不符合標籤條件，管道將不會執行。

範例配置

下面的截圖顯示了一個範例，觸發器設定為標籤「已批准」和「已審查」。

• 只有當兩個標籤都存在時，才會觸發 PR 管道。
• 如果缺少任一標籤，管道將無法執行。

檢查事件負載

當您編寫用於事件過濾的 CEL 表達式時，您必須了解將根據其計算表達式的 Webhook 負載的結構和內容。 您可以從「管道運行詳細資料」頁面檢查現有運行的有效負載。

要查看事件負載，請前往管道運行詳細資訊頁面並點擊顯示上下文。 您可以查看觸發管道運行的原始 Webhook 負載，並確認 CEL 表達式的相關欄位是否符合您所需的條件。

使用 API 為 Tekton 建立 Delivery Pipeline

1. 取得 IAM 持有人記號。 或者，如果您使用 SDK，請 取得 IAM API 金鑰，並使用環境變數來設定用戶端選項。

   export CD_TEKTON_PIPELINE_APIKEY={api_key}
   

2. 判定您要新增 Delivery Pipeline 工具整合的工具鏈 的地區及 ID。

3. 將 Delivery Pipeline 工具整合新增至工具鏈。

   curl -X POST \
     https://api.{region}.devops.cloud.ibm.com/toolchain/v2/toolchains/{toolchain_id}/tools \
     -H 'Authorization: Bearer {iam_token}' \
     -H 'Accept: application/json` \
     -H 'Content-Type: application/json' \
     -d '{
       "tool_type_id": "pipeline",
       "parameters": {
         "name": "{tool_integration_name}",
         "type" : "tekton"
       }
     }'
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   ...
   (async () => {
      const toolchainService = CdToolchainV2.newInstance();
      const pipelinePrototypeModel = {
         toolchainId: {toolchain_id},
         toolTypeId: 'pipeline',
         name: {tool_integration_name},
         type: "tekton"
      };
      const pipelineTool = await toolchainService.createTool(pipelinePrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createPipelineToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, "pipeline")
   createPipelineToolOptions.SetName({tool_integration_name})
   createPipelineToolOptions.SetType("tekton")
   pipelineTool, response, err := toolchainClient.CreateTool(createPipelineToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   pipeline_tool = toolchain_service.create_tool(
      name = {tool_integration_name},
      toolchain_id = {toolchain_id},
      tool_type_id = "pipeline",
      type = "tekton"
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   CreateToolOptions createPipelineToolOptions = new CreateToolOptions.Builder()
      .name({tool_integration_name})
      .toolchainId({toolchain_id})
      .toolTypeId("pipeline")
      .type("tekton")
      .build();
   Response<ToolchainToolPost> response = toolchainService.createTool(createPipelineToolOptions).execute();
   ToolchainToolPost pipelineTool = response.getResult();
   

   下表列出並說明前一個步驟中使用的每一個變數。

   用於新增Delivery Pipeline工具與 API 整合的變量

   變數	說明
   {region}	工具鏈所在的地區，例如 us-south。
   {tool_integration_name}	工具整合的名稱，例如 ci-pipeline。
   {toolchain_id}	要新增工具整合的工具鏈 ID。
   {iam_token}	有效的 IAM 承載令牌。

4. 配置 Delivery Pipeline 以使用指定地區內的公用受管理工作者節點。

   curl -X POST \
      https://api.{region}.devops.cloud.ibm.com/pipeline/v2/tekton_pipelines \
      -H 'Authorization: Bearer {iam_token}' \
      -H 'Accept: application/json` \
      -H 'Content-Type: application/json' \
      -d '{
         "id": "{pipeline_id}",
         "worker": { "id": "public" }
      }'
   

   const CdTektonPipelineV2 = require('@ibm-cloud/continuous-delivery/cd-tekton-pipeline/v2');
   ...
   (async () => {
      const tektonService = CdTektonPipelineV2.newInstance();
      const workerIdentityModel = {
         id: 'public',
      };
      const params = {
         id: {pipeline_id},
         worker: workerIdentityModel,
      };
      const res = await tektonService.createTektonPipeline(params);
   })();
   

   import {
      "github.com/IBM/continuous-delivery-go-sdk/cdtektonpipelinev2"
   }
   ...
   cdTektonPipelineOptions := &cdtektonpipelinev2.CdTektonPipelineV2Options{}
   pipelineSvc, err = cdtektonpipelinev2.NewCdTektonPipelineV2UsingExternalConfig(cdTektonPipelineOptions)
   createTektonPipelineOptions := pipelineSvc.NewCreateTektonPipelineOptions(
      {pipeline_id}
   )
   workerIdentityModel := &cdtektonpipelinev2.WorkerIdentity{
      ID: core.StringPtr("public"),
   }
   createTektonPipelineOptions.SetWorker(workerIdentityModel)
   tektonPipeline, response, err := pipelineSvc.CreateTektonPipeline(createTektonPipelineOptions)
   

   from ibm_continuous_delivery.cd_tekton_pipeline_v2 import CdTektonPipelineV2
   ...
   pipeline_service = CdTektonPipelineV2.new_instance()
   worker_identity_model = {
      'id': 'public',
   }
   response = pipeline_service.create_tekton_pipeline(
      id = {pipeline_id},
      worker = worker_identity_model
   )
   tekton_pipeline = response.get_result()
   

   import com.ibm.cloud.continuous_delivery.cd_tekton_pipeline.v2.CdTektonPipeline;
   import com.ibm.cloud.continuous_delivery.cd_tekton_pipeline.v2.model.*;
   ...
   CdTektonPipeline pipelineSvc = CdTektonPipeline.newInstance();
   WorkerIdentity workerIdentityModel = new WorkerIdentity.Builder()
      .id("public")
      .build();
   CreateTektonPipelineOptions createTektonPipelineOptions = new CreateTektonPipelineOptions.Builder()
      .id({pipeline_id})
      .worker(workerIdentityModel)
      .build();
   Response<TektonPipeline> response = pipelineSvc.createTektonPipeline(createTektonPipelineOptions).execute();
   TektonPipeline tektonPipeline = response.getResult();
   

   下表列出並說明前一個步驟中使用的每一個變數。

   用於使用 API 配置Delivery Pipeline的變數

   變數	說明
   {region}	工具鏈所在的地區，例如 us-south。
   {pipeline_id}	從建立管線工具整合的前一個步驟傳回的管線 ID。
   {iam_token}	有效的 IAM 承載令牌。

如需 Delivery Pipeline API 的相關資訊，請參閱 API 文件。

使用 Terraform 為 Tekton 建立 Delivery Pipeline

1. 若要安裝 Terraform CLI 並配置適用於 Terraform 的 IBM Cloud 提供者外掛程式，請遵循 開始使用 Terraform on IBM Cloud® 的指導教學。

2. 建立名為 main.tf 的 Terraform 配置檔案。 在此檔案中，新增配置以使用 HashiCorp 配置語言來建立管線。 如需使用此配置語言的相關資訊，請參閱 Terraform 文件。

   管線必須屬於工具鏈。 您也可以 使用 Terraform 來建立工具鏈。

   下列範例會使用指定的 Terraform 資源來建立工具鏈及管線。

   data "ibm_resource_group" "group" {
     name = "default"
   }
   
   resource "ibm_cd_toolchain" "my_toolchain" {
     name              = "terraform_toolchain"
     resource_group_id = data.ibm_resource_group.group.id
   }
   
   resource "ibm_cd_toolchain_tool_pipeline" "my_pipeline_tool" {
     parameters {
        name = "terraform-pipeline-integration"
     }
     toolchain_id = ibm_cd_toolchain.my_toolchain.id
   }
   
   resource "ibm_cd_tekton_pipeline" "my_tekton_pipeline" {
    worker {
        id = "public"
    }
    pipeline_id = ibm_cd_toolchain_tool_pipeline.my_pipeline_tool.tool_id
   }
   

   如需 ibm_cd_toolchain_tool_pipeline 和 ibm_cd_tekton_pipeline 資源的相關資訊，請參閱「Terraform 登錄文件」中的引數參照詳細資料。

3. 必要的話，起始設定 Terraform CLI。

   terraform init
   

4. 建立 Terraform 執行計劃。 此計劃彙總必須執行以建立工具鏈的所有動作。

   terraform plan
   

5. 套用 Terraform 執行計劃。 Terraform 會採取所有必要動作來建立工具鏈。

   terraform apply
   

使用 API 刪除 Delivery Pipeline

1. 取得 IAM 持有人記號。 或者，如果您使用 SDK，請 取得 IAM API 金鑰，並使用環境變數來設定用戶端選項。

   export CD_TEKTON_PIPELINE_APIKEY={api_key}
   

2. 判定您要新增 DevOps Insights 工具整合之工具鏈的地區及 ID。

3. 刪除管線。

   curl -X DELETE \
     https://api.{region}.devops.cloud.ibm.com/toolchain/v2/toolchains/{toolchain_id}/tools/{pipeline_id} \
     -H 'Authorization: Bearer {iam_token}'
   

   const CdTektonPipelineV2 = require('@ibm-cloud/continuous-delivery/cd-tekton-pipeline/v2');
   ...
   (async () => {
      const pipelineSvc = CdTektonPipelineV2.newInstance();
      const params = {
         id: {pipeline_id},
      };
      const res = await pipelineSvc.deleteTektonPipeline(params);
   })();
   

   import {
      "github.com/IBM/continuous-delivery-go-sdk/cdtektonpipelinev2"
   }
   ...
   cdTektonPipelineOptions := &cdtektonpipelinev2.CdTektonPipelineV2Options{}
   pipelineSvc, err = cdtektonpipelinev2.NewCdTektonPipelineV2UsingExternalConfig(cdTektonPipelineOptions)
   deleteTektonPipelineOptions := pipelineSvc.NewDeleteTektonPipelineOptions(
      {pipeline_id}
   )
   response, err := pipelineSvc.DeleteTektonPipeline(deleteTektonPipelineOptions)
   

   from ibm_continuous_delivery.cd_tekton_pipeline_v2 import CdTektonPipelineV2
   ...
   pipeline_service = CdTektonPipelineV2.new_instance()
   response = pipeline_service.delete_tekton_pipeline(
      id={pipeline_id}
   )
   

   import com.ibm.cloud.continuous_delivery.cd_tekton_pipeline.v2.CdTektonPipeline;
   import com.ibm.cloud.continuous_delivery.cd_tekton_pipeline.v2.model.*;
   ...
   CdTektonPipeline pipelineSvc = CdTektonPipeline.newInstance();
   DeleteTektonPipelineOptions deleteTektonPipelineOptions = new DeleteTektonPipelineOptions.Builder()
      .id({pipeline_id})
      .build();
   Response<Void> response = pipelineSvc.deleteTektonPipeline(deleteTektonPipelineOptions).execute();
   

下表列出並說明前一個步驟中使用的每一個變數。

使用觸發器

您可以使用 Web UI 或命令列/API 呼叫觸發管道。 這通常用於 CI、CD 或 CC 管道等管道。

檢視 TaskRun Pod 的詳細資料

若要檢視特定 TaskRun 的基礎 Kubernetes Pod 的相關資訊，請按一下 Task 名稱，然後按一下 Pod。

您可以檢視 Pod 的詳細資料，以及工作者所報告的任何相關事件。 此資訊可協助您對特定失敗進行除錯，或判定在執行期間花費時間的位置。