도구 체인 사용

DevOps Insights 2026년 8월 31일에 서비스 종료되어 중단될 예정입니다. Continuous Delivery 은 2027년 2월 12일에 au-syd, ca-tor, us-east 지역에서 중단될 예정입니다. 또한 해당 날짜를 기점으로 Code Risk Analyzer는 모든 지역에서 서비스가 중단될 예정입니다. 특정 지역에서 해당 기능을 실제로 사용하지 않는 경우, 해당 지역의 기능은 예정보다 일찍 중단될 수 있으며 새로운 인스턴스 등록이 더 이상 허용되지 않을 수 있습니다. 자세히 알아보기

개방형 도구 체인은 IBM Cloud®에서 사용 가능합니다. 도구 체인을 사용하여 일상적인 개발, 배치 및 및 운영 작업의 생산성을 향상시킬 수 있습니다. 도구 체인을 설정한 후에는 도구 통합을 추가, 삭제 또는 구성하거나 도구 체인에 대한 액세스를 관리할 수 있습니다. 도구 통합 작업에 대한 자세한 정보는 도구 통합에 대한 작업 을 참조하십시오.

도구 체인에 대한 액세스 권한 관리

IAM(Identity and Access Management) 서비스를 사용하여 리소스 그룹에 있는 도구 체인에 대한 사용자 액세스 권한을 관리할 수 있습니다. IAM을 사용한 액세스 제어 관리에 대한 자세한 정보는 리소스 그룹에서 도구 체인에 대한 사용자 액세스 권한 관리를 참조하십시오.

도구 체인에 대한 액세스를 가진 사용자는 IBM Cloud® Continuous Delivery 서비스의 권한 부여된 사용자로 간주될 수 있습니다. 권한 부여된 사용자의 카운트 방법에 대한 자세한 정보는 플랜 제한사항 및 사용을 참조하십시오.

도구 체인 구성

도구 체인을 구성하고 나중에 쉽게 찾을 수 있도록 이 도구 체인에 태그를 추가할 수 있습니다. 태그는 도구 체인 목록에서 도구 체인을 쉽게 필터링하기 위해 도구 체인에 지정하는 레이블입니다.

  1. IBM Cloud 콘솔에서 메뉴 아이콘 햄버거 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다.
  2. 도구 체인 페이지에서 태그를 추가할 도구 체인을 찾아 태그 추가를 클릭하십시오.
  3. 도구 체인에 추가할 태그의 이름을 입력하십시오. 쉼표로 구분된 여러 태그를 추가할 수 있습니다.
  4. 저장 을 클릭하십시오.

태그에 대한 자세한 정보는 태그 작업을 참조하십시오.

앱, 클러스터 및 서비스에 대한 도구 체인 연결 보기

Kubernetes 클러스터 및 서비스와 툴체인의 연결 상태를 확인할 수 있습니다.

  1. IBM Cloud 콘솔에서 메뉴 아이콘 햄버거 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다.
  2. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오. 또는 사용자 앱의 앱 세부사항 페이지에서 도구 체인 이름을 클릭하십시오.
  3. 연결 탭을 선택하고 보려는 앱, 클러스터 또는 서비스를 선택하십시오.

도구 체인 삭제

도구 체인을 삭제할 수 있습니다. 도구 체인을 삭제하면 해당 도구 체인에 속하는 모든 도구 통합도 삭제됩니다. 이 삭제는 되돌릴 수 없습니다.

Delivery Pipeline 도구 통합을 삭제하면 연결된 Delivery Pipeline 도 삭제됩니다.

GitHub 또는 Git Repos and Issue Tracking 도구 통합을 삭제할 때 연관된 저장소는 GitHub 또는 Git Repos and Issue Tracking에서 삭제되지 않습니다. 해당 저장소를 수동으로 제거해야 합니다.

콘솔을 사용하여 도구 체인 삭제

  1. IBM Cloud 콘솔에서 메뉴 아이콘 햄버거 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다.
  2. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오. 또는 사용자 앱의 앱 세부사항 페이지에서 도구 체인 이름을 클릭하십시오.
  3. 조치 메뉴를 클릭하고 삭제를 선택하십시오. 도구 체인을 삭제하면 도구 통합이 모두 제거되므로 해당 통합에서 관리하는 리소스를 삭제할 수 있습니다.
  4. 도구 체인의 이름을 입력하고 삭제를 클릭하여 삭제를 확인하십시오.

CLI에서 도구 체인 삭제 (베타)

  1. IBM Cloud CLI 를 사용하여 IBM Cloud 에 로그인하십시오.

    ibmcloud login
    

    로그인에 실패하면 ibmcloud login --sso 명령을 실행하여 다시 시도하십시오. --sso 매개변수는 연합 ID로 로그인할 때 필요합니다. 이 옵션을 사용하는 경우 CLI 출력에 나열된 링크로 이동하여 일회성 패스코드를 생성하십시오.

  2. 선택사항입니다. 대상 계정, 지역 및 리소스 그룹의 모든 도구 체인을 나열하여 삭제할 인스턴스를 식별하십시오.

    ibmcloud dev toolchains
    
  3. ibmcloud dev toolchain-delete 명령을 실행하여 도구 체인을 삭제하십시오.

    ibmcloud dev toolchain-delete TOOLCHAIN-NAME
    

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

CLI에서 툴체인을 삭제하기 위한 변수
가변 설명
TOOLCHAIN_NAME 삭제하려는 툴체인의 이름.

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. 제거하려는 툴체인을 삭제하십시오.

    curl -X DELETE \
      "{base_url}/toolchains/{toolchain_id}" \
      -H 'Authorization: Bearer {token}'
    
    const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
    const toolchainService = CdToolchainV2.newInstance();
    ...
    (async() => {
       const response = await toolchainService.deleteToolchain({
          toolchainId: {toolchain_id}
       });
    })();
    
    import (
    	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
    )
    ...
    toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
    toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
    deleteToolchainOptions := toolchainClient.NewDeleteToolchainOptions({toolchain_id})
    response, err := toolchainClient.DeleteToolchain(deleteToolchainOptions)
    
    from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
    ...
    toolchain_service = CdToolchainV2.new_instance()
    response = toolchain_service.delete_toolchain(
       toolchain_id = toolchain_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();
    DeleteToolchainOptions deleteToolchainOptions = new DeleteToolchainOptions.Builder()
       .toolchainId({toolchain_id})
       .build();
    Response<Void> response = toolchainService.deleteToolchain(deleteToolchainOptions).execute();
    

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

API로 툴체인을 삭제하기 위한 변수
가변 설명
{base_url} 툴체인 API 엔드포인트 URL, 예: https://api.us-south.devops.cloud.ibm.com/toolchain/v2. 이 엔드포인트에 대한 자세한 내용은 URL, 값 목록을 포함하여 엔드포인트 URL 를 참조하세요.
{iam_api_key} IAM API 키.
{token} 유효한 IAM 베어러 토큰입니다.
{toolchain_id} 삭제하려는 툴체인의 ID입니다.

Terraform을 사용하여 도구 체인 삭제

  1. 기존 도구 체인에 대한 resource 블록을 포함하는 Terraform 파일 (예: main.tf) 을 찾으십시오. 도구 체인과 함께 Terraform을 사용하는 방법에 대한 자세한 정보는 Terraform을 사용하여 도구 체인 작성 을 참조하십시오.

    다음 예제의 resource 에서는 기존 도구 체인을 설명합니다.

    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
    }
    
  2. Terraform 파일에서 resource 블록을 제거하십시오.

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

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

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

    terraform apply
    

여러 지역의 대체 도구 체인 관리

Terraform 구성 언어를 사용하여 도구 체인을 정의한 다음, 활성 파이프라인이 있는 기본 영역과 유휴 파이프라인이 있는 대체 영역의 두 가지 영역에서 도구 체인 정의를 적용하고 유지할 수 있습니다. ' Git Repos and Issue Tracking'을 사용하는 경우 기본 지역에서 대체 지역으로 ' ' Git ' 리포지토리 미러링 '를 사용할 수도 있습니다. 기본 및 대체 도구 체인과 Git 리포지토리를 유지 관리하면 장애 복구 및 이중화가 더 빨라집니다. 또한 주 리전에서 문제가 발생하더라도 원활한 운영을 보장합니다. 테라폼에서 툴체인을 코드화하면 툴체인을 업데이트하고 변경 사항을 두 지역에 모두 적용할 수 있습니다.

테라폼 사용에 대한 자세한 내용은 Continuous Delivery 대한 테라폼 설정하기를 참조하세요.