使用主控台從範本建立工具鏈

您可以將包含特定工具整合套件的範本作為起點，來建立 建立工具鏈。 視您使用的範本而定，您可以建立具有一組特定工具整合的工具鏈，或是建立可在其中新增工具整合的空白工具鏈。 進一步瞭解如何使用 IBM Cloud Garage Method中的範本。

1. 登入 IBM Cloud。

2. 在IBM Cloud控制台中，點選選單圖示>平台自動化>工具鏈。

3. 在「工具鏈」頁面上，按一下「建立工具鏈」。

4. 在「建立工具鏈」頁面上，點選一個工具鏈範本。

5. 檢閱即將建立之工具鏈的圖表。 此圖會顯示每個工具整合在工具鏈中的生命週期階段。

   有一些工具鏈範本會有多個工具整合實例。 例如，IBM Cloud Public 上的 "Develop and test microservices with Kubernetes and Helm " 工具鏈模板包含四個 GitHub 實例和四個 Delivery Pipeline 實例。

   下列影像中的圖表是範例。 當您建立工具鏈時，圖表會顯示每一個屬於工具鏈一部分的工具整合。

   

6. 檢閱工具鏈設定的預設資訊：

   • 在 IBM Cloud 中，可透過工具鏈名稱來識別工具鏈。 如果您要使用不同的名稱，請變更工具鏈的名稱。
   • 要在其中建立工具鏈的地區。 如果您要使用不同的地區，請從可用地區清單中選取它。
   • 用於建立工具鏈的資源群組。 若要使用其他資源群組，請從「可用資源群組」清單中選取該資源群組。
   • 來源儲存庫的提供者，例如 GitHub、GitLab 或 Bitbucket。 若要使用不同的來源提供者，請從可用儲存庫清單選取。

7. 在「工具整合」區段中，選取您要配置給工具鏈的每一個工具整合。 有些工具整合不需要進行配置。 如需配置工具整合的相關資訊，請參閱配置工具整合。

   組成工具鏈的許多工具整合都需要秘密才能與 Continuous Delivery 服務驗證。

   密鑰是可以以密碼、鑑別記號、API 金鑰或憑證形式提供的認證。 例如，當您將 Delivery Pipeline 工具整合新增至工具鏈時，必須以 API 金鑰形式提供密鑰。

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

   b. 按一下 新建，以建立 IBM Cloud® API 金鑰。

   c. 按一下 確定，以套用新的 API 金鑰。

   每一個使用者最多可以有 20 個 API 金鑰。

   d. 按一下 確定 以建立 API 金鑰，而不儲存金鑰的安全副本。

   e. 若要安全地儲存 API 金鑰，以便您可以在其他工具鏈工作流程中再次使用它，請執行下列動作:

   • 選取 將此金鑰儲存在密鑰儲存庫中以供重複使用 勾選框，以與 Key Protect 或 Secrets Manager 密鑰儲存庫整合。
   • 如果您沒有 Key Protect 或 Secrets Manager的現有實例，請指定實例的名稱及密碼。
   • 按一下 確定，以套用新的 API 金鑰。

   f. 若要驗證已順利建立 Key Protect 或 Secrets Manager 實例，請跳至 IBM Cloud® 資源清單，並展開 服務 小三角形。 若要檢視 API 金鑰，請從功能表列按一下 管理> 存取權 (IAM)，然後選取 IBM Cloud® API 金鑰。

   如： 您建立並複製到「金鑰專案」的 API 金鑰現在可以在「建立工具鏈」頁面上使用。 任何需要密鑰的工具整合都會顯示金鑰圖示。 按一下金鑰圖示以開啟「密鑰選取器」對話框，以從一個以上 Key Protect 或 Secrets Manager 實例中擷取密鑰。

8. 按一下建立。 會自動執行數個步驟來設定工具鏈。 根據您選取的工具鏈範本，所設定的工具整合會有所不同。 例如，當您在 IBM Cloud Public 上建立「使用 Kubernetes 和 Helm來開發及測試微服務」工具鏈時，會執行下列步驟:

   • 建立工具鏈。
   • 如果您已配置 Delivery Pipeline，則會建立及觸發管線。
   • 若您已設定「Event Notifications」，工具鏈將設定為將事件通知傳送至您指定的「Event Notifications」服務。
   • 如果您已配置 Sauce Labs，則會設定工具鏈將 Sauce Labs 測試工作新增至管線。
   • 如果您已配置 PagerDuty，則會設定工具鏈將警示通知傳送至所指定的 PagerDuty 服務。
   • 如果您已配置 Slack，則會設定工具鏈將部署狀態通知傳送至所指定的 Slack 頻道。
   • 如果您已配置原始碼工具整合（例如 GitHub），則會將範例 GitHub 儲存庫複製到 GitHub 帳戶。

   現在您可以透過使用 Event Notifications 工具集成。IBM Cloud Event Notifications 是向 PagerDuty 和其他通訊渠道（如 Slack、電子郵件、SMS、推送通知、webhook、Microsoft® Teams, ServiceNow, 和 IBM Cloud Functions ）發佈通知的首選方法。 有關使用 Event Notifications 的詳細資訊，請參閱 啟用工具鏈的事件通知。

使用主控台從應用程式建立工具鏈

您可以從應用程式建立工具鏈。 工具鏈可以支援連續開發、部署、監視及其他作業，且與您的應用程式相關聯。 每個應用程式都可以與工具鏈相關聯。 將變更推送至工具鏈的 GitHub 儲存庫時，管線會自動建置及部署應用程式。

1. 如果您是透過 IBM Cloud Public 建立應用程式，該應用程式已設定為從一個新的 GitHub 儲存庫進行持續交付，該儲存庫中已載入應用程式的起始程式碼。

2. 在工具鏈配置頁面上，檢閱即將建立之工具鏈的圖表。 此圖會顯示每個工具整合在工具鏈中的生命週期階段。

3. 檢閱工具鏈設定的預設資訊。 在 IBM Cloud 中，可透過工具鏈名稱來識別工具鏈。 如果您要使用不同的名稱，請變更工具鏈的名稱。

4. 在「工具整合」區段中，選取您要配置給工具鏈的每一個工具整合。 有些工具整合不需要進行配置。 如需配置工具整合的相關資訊，請參閱配置工具整合。

5. 按一下建立。 會自動執行數個步驟來設定工具鏈。 例如，當您從 IBM Cloud Public 的應用程式建立工具鏈時，會執行下列步驟：

   • 建立工具鏈。
   • 如果您已配置 Delivery Pipeline，則會建立及觸發管線。
   • 如果您已配置 GitHub，則會將範例 GitHub 儲存庫複製到 GitHub 帳戶。

使用 API 建立工具鏈

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

   export CD_TOOLCHAIN_AUTH_TYPE=iam && \
   export CD_TOOLCHAIN_APIKEY={iam_api_key} && \
   export CD_TOOLCHAIN_URL={base_url}
   

2. 查閱您要在其中建立工具鏈的資源群組 ID。

3. 選擇您要在其中建立工具鏈的地區。

4. 建立工具鏈的實例。

   curl -X POST \
     "{base_url}/toolchains" \
     -H 'Authorization: Bearer {token}' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "{toolchain_name}",
       "resource_group_id": "{resource_group_id}"
     }'
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolchainPrototypeModel = {
         description: {toolchain_description},
         name: {toolchain_name},
         resourceGroupId: {resource_group_id}
      };
      const response = await toolchainService.createToolchain(toolchainPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createToolchainOptions := toolchainClient.NewCreateToolchainOptions({toolchain_name}, {resource_group_id})
   createToolchainOptions.SetDescription({toolchain_description})
   toolchain, response, err := toolchainClient.CreateToolchain(createToolchainOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   toolchain = toolchain_service.create_toolchain(
      description = {toolchain_description},
      name = {toolchain_name},
      resource_group_id = {resource_group_id}
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   CreateToolchainOptions createToolchainOptions = new CreateToolchainOptions.Builder()
      .description({toolchain_description})
      .name({toolchain_name})
      .resourceGroupId({resource_group_id})
      .build();
   Response<ToolchainPost> response = toolchainService.createToolchain(createToolchainOptions).execute();
   ToolchainPost toolchain = response.getResult();
   

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

如需使用 API 建立工具鏈的相關資訊，請參閱 IBM Cloud API 文件中的 建立工具鏈。

使用 Terraform 建立工具鏈

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

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

   下列範例會使用 ibm_cd_toolchain 資源來建立工具鏈。

   data "ibm_resource_group" "group" {
     name = "default"
   }
   resource "ibm_cd_toolchain" "cd_toolchain" {
     name              = "my toolchain"
     resource_group_id = data.ibm_resource_group.group.id
   }
   

   如需 ibm_cd_toolchain 的相關資訊，請參閱 Terraform 登錄文件中的引數參照詳細資料。

3. 起始設定 Terraform CLI。

   terraform init
   

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

   terraform plan
   

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

   terraform apply