콘솔을 사용하여 도구 통합 추가

콘솔을 사용하여 도구 체인에 도구 통합을 추가할 수 있습니다.

1. IBM Cloud 콘솔에서 메뉴 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다.
2. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오. 또는 사용자 앱의 앱 세부사항 페이지에서 도구 체인 이름을 클릭하십시오.
3. 추가할 도구 연동 목록을 보려면 ‘추가’를 클릭하세요.
4. 추가할 도구 통합을 클릭하십시오.
5. 도구 통합을 구성하는 데 필요한 정보를 입력하십시오.
6. 통합 작성을 클릭하여 도구 체인에 도구 통합을 추가하십시오.

API와 도구 통합 추가

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. 추가할 도구 통합에 해당하는 tool_type_id 값 을 찾으십시오.

4. 대상 툴체인 내에 도구 통합 기능을 추가하십시오.

   curl -X POST --location --header "Authorization: Bearer {iam_token}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data '{ "name": "{tool_name}", "tool_type_id": "{tool_type_id}", "parameters": {tool_parameters} }' \
     "{base_url}/toolchains/{toolchain_id}/tools"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolPrototypeModel = {
         toolchainId: {toolchain_id},
         toolTypeId: {tool_type_id},
         name: {tool_name},
         parameters: {tool_parameters}
      };
      const response = await toolchainService.createTool(toolPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, {tool_type_id})
   createToolOptions.SetName({tool_name})
   createToolOptions.SetParameters({tool_parameters})
   tool, response, err := toolchainClient.CreateTool(createToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tool = toolchain_service.create_tool(
      name = {tool_name},
      toolchain_id = {toolchain_id},
      tool_type_id = {tool_type_id},
      parameters = {tool_parameters}
   )
   

   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 createToolOptions = new CreateToolOptions.Builder()
      .name({tool_name})
      .parameters({tool_parameters})
      .toolchainId({toolchain_id})
      .toolTypeId({tool_type_id})
      .build();
   Response<ToolchainToolPost> response = toolchainService.createTool(createToolOptions).execute();
   ToolchainToolPost tool = response.getResult();
   

다음 표에서는 이전 단계에서 사용된 각 변수를 나열하고 설명합니다.

Terraform과의 도구 통합 추가

Terraform을 사용하여 도구 체인에 도구 통합을 추가할 수 있습니다.

1. Terraform CLI를 설치하고 Terraform을 위한 IBM Cloud 제공자 플러그인을 구성하려면 IBM Cloud®에서 Terraform 시작하기 튜토리얼을 따르십시오.

2. 이름이 main.tf인 Terraform 구성 파일을 작성하십시오. 이 파일에서 HCL( HashiCorp Configuration Language)을 사용하여 리소스 인스턴스를 생성하는 구성을 추가하십시오. 이 구성 언어 사용에 대한 자세한 정보는 Terraform 문서를 참조하십시오.

   다음 예제는 ibm_cd_toolchain_tool_pipeline 자원을 사용하여 Delivery Pipeline 도구 통합을 작성합니다. 여기서 toolchain_id 는 도구 통합을 작성할 도구 체인을 나타내는 GUID입니다.

   data "ibm_cd_toolchain" "cd_toolchain" {
     toolchain_id = {toolchain_id}
   }
   resource "ibm_cd_toolchain_tool_pipeline" "cd_pipeline" {
     toolchain_id = data.ibm_cd_toolchain.cd_toolchain.id
     parameters {
       name = "myPipeline"
     }
   }
   

   도구 통합 리소스에 대한 자세한 정보는 IBM Cloud Terraform 레지스트리에서 지원되는 도구 통합 리소스의 전체 목록을 참조하십시오.

3. Terraform CLI를 초기화하십시오.

   terraform init
   

4. Terraform 실행 플랜을 작성하십시오. 이 계획은 도구 통합을 작성하기 위해 실행해야 하는 모든 조치를 요약합니다.

   terraform plan
   

5. Terraform 실행 계획을 적용합니다. Terraform은 도구 통합을 작성하는 데 필요한 모든 조치를 수행합니다.

   terraform apply
   

콘솔을 사용하여 도구 통합 업데이트

툴체인을 생성할 때 툴 통합 설정을 연기한 경우, 해당 카드에 ‘구성’ 버튼이 표시됩니다. 툴체인을 생성할 때 툴 연동을 구성한 경우, 콘솔을 사용하여 구성 설정을 업데이트할 수 있습니다.

1. IBM Cloud 콘솔에서 메뉴 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다.
2. '툴체인' 페이지에서 업데이트하려는 도구 통합이 포함된 툴체인을 클릭하여 해당 툴체인의 '개요' 페이지를 엽니다. 또는 사용자 앱의 앱 세부사항 페이지에서 도구 체인 이름을 클릭하십시오.
3. 처음으로 도구 통합을 구성해야 하는 경우에는 해당 카드에서 구성을 클릭하십시오.
4. 도구 통합 구성을 완료하면 통합 저장을 클릭하십시오.
5. 도구 통합의 구성을 업데이트해야 하는 경우 조치 아이콘 > 구성을 클릭하십시오.
6. 설정 업데이트를 완료하면 통합 저장을 클릭하십시오.

API를 사용하여 도구 통합 업데이트

툴체인을 생성할 때 툴 연동을 구성한 경우, 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. 도구 체인의 ID를 사용하여 도구 통합의 ID를 찾으십시오.

4. 대상 도구 체인 내에서 도구 통합을 업데이트하십시오.

   curl -X PATCH --location --header "Authorization: Bearer {iam_token}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/merge-patch+json" \
     --data '{ "name": "{new_tool_name}", "parameters": {new_tool_parameters} }' \
     "{base_url}/toolchains/{toolchain_id}/tools/{tool_id}"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolPatchModel = {
         toolchainId: {toolchain_id},
         toolId: {tool_id},
         name: {new_tool_name},
         parameters: {new_tool_parameters}
      };
      const response = await toolchainService.updateTool(toolPatchModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   toolPatchModel := map[string]interface{}{
      "name": {new_tool_name},
      "parameters": {new_tool_parameters},
   }
   updateToolOptions := toolchainClient.NewUpdateToolOptions({toolchain_id}, {tool_id}, toolPatchModel)
   tool, response, err := toolchainClient.UpdateTool(updateToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tool = toolchain_service.update_tool(
      toolchain_id = {toolchain_id},
      tool_id = {tool_id},
      toolchain_tool_prototype_patch = {
         "name": {new_tool_name},
         "parameters": {new_tool_parameters}
      }
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   HashMap<String,Object> toolchainToolPrototypePatch = new HashMap<>();
   toolchainToolPrototypePatch.put("name", {new_tool_name});
   toolchainToolPrototypePatch.put("parameters", {new_tool_parameters});
   UpdateToolOptions updateToolOptions = new UpdateToolOptions.Builder()
      .toolchainId({toolchain_id})
      .toolId({tool_id})
      .toolchainToolPrototypePatch(toolchainToolPrototypePatch)
      .build();
   Response<ToolchainToolPatch> response = toolchainService.updateTool(updateToolOptions).execute();
   ToolchainToolPatch tool = response.getResult();
   

다음 표에서는 이전 단계에서 사용된 각 변수를 나열하고 설명합니다.

Terraform과의 도구 통합 업데이트

툴체인을 생성할 때 툴 연동을 구성한 경우, Terraform을 사용하여 구성 설정을 업데이트할 수 있습니다.

1. IBM Cloud에 대한 튜토리얼에 따라 Terraform CLI를 설치하고 Terraform에 대한 IBM Cloud 제공자 플러그인을 구성하십시오.

2. 도구 통합을 작성하는 데 사용한 Terraform 구성 파일을 사용하십시오. Terraform을 사용하여 도구 통합을 작성하지 않은 경우 terraform import 를 실행하여 다른 도구 통합을 작성하지 않도록 하십시오. 이 구성 언어 사용에 대한 자세한 정보는 Terraform 문서를 참조하십시오.

   다음 예제는 ibm_cd_toolchain_tool_pipeline 자원을 사용하여 기존 Delivery Pipeline 도구 통합의 이름을 업데이트합니다. 여기서 toolchain_id 은 도구 통합이 존재하는 도구 체인을 나타내는 GUID입니다.

   data "ibm_cd_toolchain" "cd_toolchain" {
     toolchain_id = {toolchain_id}
   }
   resource "ibm_cd_toolchain_tool_pipeline" "cd_pipeline" {
     toolchain_id = data.ibm_cd_toolchain.cd_toolchain.id
     parameters {
       name = "myUpdatedPipelineName"
     }
   }
   

   도구 통합 리소스에 대한 자세한 정보는 IBM Cloud Terraform 레지스트리에서 지원되는 도구 통합 리소스의 전체 목록을 참조하십시오.

3. Terraform CLI를 초기화하십시오.

   terraform init
   

4. Terraform 실행 플랜을 작성하십시오. 이 계획은 도구 통합을 수정하기 위해 실행해야 하는 모든 조치를 요약합니다.

   terraform plan
   

5. Terraform 실행 계획을 적용합니다. Terraform은 도구 통합을 수정하는 데 필요한 모든 조치를 수행합니다.

   terraform apply
   

콘솔을 사용하여 도구 통합 삭제

콘솔을 사용하여 도구 체인에서 도구 통합을 삭제할 수 있습니다. 도구 체인에서 도구 통합을 삭제하는 경우 삭제를 실행 취소할 수 없습니다.

1. IBM Cloud 콘솔에서 메뉴 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다.
2. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오. 또는 사용자 앱의 앱 세부사항 페이지에서 도구 체인 이름을 클릭하십시오.
3. 삭제할 도구 통합에서 조치 아이콘 > 삭제를 클릭하십시오.
4. 삭제를 클릭하여 확인하십시오.

API와의 도구 통합 삭제

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. 도구 체인의 ID를 사용하여 도구 통합의 ID를 찾으십시오.

4. 대상 도구 체인 내에서 도구 통합을 삭제하십시오.

   curl -X DELETE --location --header "Authorization: Bearer {iam_token}" \
     "{base_url}/toolchains/{toolchain_id}/tools/{tool_id}"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const response = await toolchainService.deleteTool({
         toolchainId: {toolchain_id},
         toolId: {tool_id}
      });
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   deleteToolOptions := toolchainClient.NewDeleteToolOptions({toolchain_id}, {tool_id})
   response, err := toolchainClient.DeleteTool(deleteToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   response = toolchain_service.delete_tool(
      toolchain_id = {toolchain_id},
      tool_id = {tool_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();
   DeleteToolOptions deleteToolOptions = new DeleteToolOptions.Builder()
      .toolchainId({toolchain_id})
      .toolId({tool_id})
      .build();
   Response<Void> response = toolchainService.deleteTool(deleteToolOptions).execute();
   

다음 표에서는 이전 단계에서 사용된 각 변수를 나열하고 설명합니다.

Terraform과의 도구 통합 삭제

Terraform을 사용하여 도구 체인에서 도구 통합을 삭제할 수 있습니다. 도구 체인에서 도구 통합을 삭제하는 경우 삭제를 실행 취소할 수 없습니다.

1. Terraform CLI를 설치하고 Terraform을 위한 IBM Cloud 제공자 플러그인을 구성하려면 IBM Cloud에서 Terraform 시작하기 튜토리얼을 따르십시오.

2. 도구 통합을 작성하는 데 사용한 Terraform 구성 파일을 사용하십시오. 구성 파일에서 도구 통합 자원을 주석 처리하거나 제거하십시오.

3. Terraform CLI를 초기화하십시오.

   terraform init
   

4. Terraform 실행 플랜을 작성하십시오. 이 계획은 도구 통합을 삭제하기 위해 실행해야 하는 모든 조치를 요약합니다.

   terraform plan
   

5. Terraform 실행 계획을 적용합니다. Terraform은 도구 통합을 삭제하는 데 필요한 모든 조치를 수행합니다.

   terraform apply