使用主控台建立 Continuous Delivery 服務實例

1. 登入 IBM Cloud。
2. 從 IBM Cloud 主控台，按一下 型錄 並選取 服務。
3. 選取 Developer Tools 種類。
4. 按一下 Continuous Delivery 磚。
5. 請選擇您要建立「Continuous Delivery」服務的區域。
6. 選擇精簡版或專業版定價方案。 Lite 方案為小型團隊免費提供 Continuous Delivery 的完整功能，並提供使用限制。 如果您建立「精簡方案」實例，則會在建立之後 30 天自動刪除它。 如需 Continuous Delivery 服務方案的相關資訊，請參閱 方案限制和使用。
7. 在 配置資源 區段中，指定您正在建立之 Continuous Delivery 實例的名稱。
8. 請選取您要建立「Continuous Delivery」服務執行個體的資源群組。 在建立 Continuous Delivery 服務實例之後，您無法變更選取的資源群組。 如需如何在 IBM Cloud 帳戶中組織資源的相關資訊，請參閱 在資源群組中組織資源的最佳作法。
9. 指定您要用來組織及過濾資源清單中資源的標籤。 您也可以使用這些標籤來識別團隊使用情形或成本配置。 這些標籤是可見的帳戶範圍。 如需使用標籤的相關資訊，請參閱 使用標籤。
10. 如果您選擇「專業」定價方案，則可以選取 IBM® Key Protect for IBM Cloud® 服務的實例或 IBM Cloud® Hyper Protect Crypto Services的實例，以及用來加密您個人資訊的根金鑰。 請確定 Key Protect 實例或 Hyper Protect Crypto Services 實例及根金鑰已存在，且工具鏈資源已獲授權存取 管理授權 區段中的 Key Protect 或 Hyper Protect Crypto Services。 Hyper Protect Crypto Services 服務實例目前僅支援專用端點。 如需加密哪些類型資料的相關資訊，請參閱 使用 Professional 方案時保護個人資料。
11. 按一下建立。

從 CLI 建立 Continuous Delivery 服務實例

1. 使用 IBM Cloud CLI 登入 IBM Cloud。

   ibmcloud login
   

   如果登入失敗，請執行 ibmcloud login --sso 指令再試一次。 當您使用聯合 ID 登入時，需要 --sso 參數。 如果您使用此選項，請跳至 CLI 輸出中列出的鏈結，以產生一次性密碼。

2. 請選擇您要建立「Continuous Delivery」服務執行個體的帳戶、區域及資源群組。

   ibmcloud target -c ACCOUNT -r REGION -g RESOURCE_GROUP
   

3. 在目標帳戶、地區及資源群組內建立 Continuous Delivery 的實例。

   ibmcloud resource service-instance-create INSTANCE_NAME continuous-delivery PLAN REGION -p ENCRYPTION
   

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

如需方案 ID 或如何在建立實例之後更新服務方案的相關資訊，請參閱 更新服務方案。

使用 API 建立 Continuous Delivery 服務實例

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

   export RESOURCE_CONTROLLER_APIKEY={iam_api_key}
   

2. 查閱您要在其中建立實例的資源群組 ID。

3. 選擇您要在其中建立實例的地區。

4. 查閱您要建立之實例的服務方案 ID。

5. 在目標帳戶、地區及資源群組內建立 Continuous Delivery 的實例。

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H 'Authorization: Bearer {token}' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "{instance_name}",
       "target": "{region}",
       "resource_group": "{resource_group_id}",
       "resource_plan_id": "{plan_id}"
       "parameters": "{parameters}"
     }'
   

   import com.ibm.cloud.platform_services.resource_controller.v2.ResourceController;
   import com.ibm.cloud.platform_services.resource_controller.v2.model.*;
   ...
   ResourceController resourceControllerService = ResourceController.newInstance();
   CreateResourceInstanceOptions createCdInstanceOptions = new CreateResourceInstanceOptions.Builder()
      .name({instance_name})
      .target({region})
      .resourceGroup({resource_group_id})
      .resourcePlanId({plan_id})
      .build();
   Response<ResourceInstance> response = resourceControllerService.createResourceInstance(createCdInstanceOptions).execute();
   ResourceInstance cdInstance = response.getResult();
   

   const ResourceControllerV2 = require('@ibm-cloud/platform-services/resource-controller/v2');
   const resourceControllerService = ResourceControllerV2.newInstance({});
   ...
   (async () => {
      const params = {
         name: {instance_name},
         target: {region},
         resourceGroup: {resource_group_id},
         resourcePlanId: {plan_id},
      };
      const res = await resourceControllerService.createResourceInstance(params);
      const cdInstanceGuid = res.result.guid;
   })();
   

   from ibm_platform_services import ResourceControllerV2
   ...
   resource_controller_service = ResourceControllerV2.new_instance()
   cd_instance = resource_controller_service.create_resource_instance(
      name={instance_name},
      target={region},
      resource_group={resource_group_id},
      resource_plan_id={plan_id}
   ).get_result()
   

   import {
      "github.com/IBM/platform-services-go-sdk/resourcecontrollerv2"
   }
   ...
   resourceControllerServiceOptions := &resourcecontrollerv2.ResourceControllerV2Options{}
   resourceControllerService, err := resourcecontrollerv2.NewResourceControllerV2UsingExternalConfig(resourceControllerServiceOptions)
   createCdInstanceOptions := resourceControllerService.NewCreateResourceInstanceOptions(
      {instance_name},
      {region},
      {resource_group_id},
      {plan_id},
   )
   cdInstance, response, err := resourceControllerService.CreateResourceInstance(createCdInstanceOptions)
   

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

如需建立服務實例的相關資訊，請參閱 使用 API 建立新的資源實例。

使用 Terraform 建立 Continuous Delivery 服務實例

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

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

   下列範例會使用 ibm_resource_instance 資源建立 Continuous Delivery 服務實例，其中 name 是識別資源實例的唯一敘述性名稱。

   data "ibm_resource_group" "group" {
     name = "default"
   }
   resource "ibm_resource_instance" "cd_service_instance" {
     name              = "my CD service instance"
     service           = "continuous-delivery"
     plan              = "lite"
     location          = "us-south"
     resource_group_id = data.ibm_resource_group.group.id
   }
   

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

   若要佈建服務實例以使用客戶管理的加密，請在 parameters 屬性中新增金鑰管理服務實例 ID 及根金鑰 ID。

     parameters = {
       kms_instance = <kms_instance_id>
       kms_key = <kms_key>
     }
   

3. 起始設定 Terraform CLI。

   terraform init
   

4. 建立 Terraform 執行計劃。 此計劃彙總必須執行以建立 Continuous Delivery 服務實例的所有動作。

   terraform plan
   

5. 套用 Terraform 執行計畫。 Terraform 會採取所有必要的動作來建立 Continuous Delivery 服務實例。

   terraform apply