콘솔을 사용하여 템플리트에서 도구 체인 작성

템플릿을 출발점으로 삼아 특정 도구 통합 세트가 포함된 툴체인을 구축할 수 있습니다. 사용하는 템플리트에 따라 특정 도구 통합 세트가 있는 도구 체인을 작성하거나 도구 통합을 추가할 수 있는 빈 도구 체인을 작성할 수 있습니다. IBM Cloud Garage 메소드에서 템플리트를 사용하는 방법에 대해 자세히 알아보십시오.

1. IBM Cloud에 로그인하십시오.

2. IBM Cloud 콘솔에서 메뉴 아이콘 > 플랫폼 자동화 > 툴체인을 클릭합니다.

3. 도구 체인 페이지에서 도구 체인 작성을 클릭하십시오.

4. '툴체인 생성' 페이지에서 툴체인 템플릿을 클릭합니다.

5. 작성하려는 도구 체인의 다이어그램을 검토하십시오. 다이어그램은 도구 체인에서 해당 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다.

   일부 도구 체인 템플리트에는 도구 통합의 여러 인스턴스가 있습니다. 예를 들어, IBM Cloud Public의 " Kubernetes 및 Helm 을 사용하여 마이크로서비스 개발 및 테스트" 툴체인 템플릿에는 GitHub 의 인스턴스 4개와 Delivery Pipeline 의 인스턴스 4개가 포함되어 있습니다.

   다음 이미지의 다이어그램을 예로 들 수 있습니다. 도구 체인을 작성할 때 다이어그램은 도구 체인의 일부인 각 도구 통합을 표시합니다.

   

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 키 ’를 선택하세요.

   g. 작성하여 Key Project에 복사한 API 키는 이제 도구 체인 작성 페이지에서 사용할 수 있습니다. 시크릿이 필요한 모든 도구 통합에는 키 아이콘이 표시됩니다. 키 아이콘을 클릭하면 ‘Secrets Picker’ 대화 상자가 열리며, 하나 이상의 Key Protect 또는 Secrets Manager 인스턴스에서 시크릿을 가져올 수 있습니다.

8. 작성을 클릭하십시오. 여러 단계가 자동으로 실행되어 도구 체인을 설정합니다. 설정된 도구 통합은 선택된 도구 체인 템플리트에 따라 서로 다릅니다. 예를 들어, IBM Cloud 퍼블릭에서 " Kubernetes 및 Helm를 사용하여 마이크로서비스 개발 및 테스트" 도구 체인을 작성하는 경우 다음 단계가 실행됩니다.

   • 도구 체인이 작성됩니다.
   • Delivery Pipeline을 구성한 경우에는 파이프라인이 작성되고 트리거됩니다.
   • Event Notifications 를 구성한 경우, 툴체인은 사용자가 지정한 Event Notifications 서비스로 이벤트 알림을 전송하도록 설정됩니다.
   • Sauce Labs를 구성한 경우에는 Sauce Labs 테스트 작업을 파이프라인에 추가하도록 도구 체인이 설정됩니다.
   • PagerDuty를 구성한 경우에는 경보 알림을 지정된 PagerDuty 서비스에 전송하도록 도구 체인이 설정됩니다.
   • Slack을 구성한 경우에는 배치 상태에 대한 알림을 지정된 Slack 채널에 전송하도록 도구 체인이 설정됩니다.
   • GitHub 등의 소스 코드 도구 통합을 구성한 경우에는 샘플 GitHub 저장소가 GitHub 계정으로 복제됩니다.

   이제 다음을 사용하여 이벤트 알림을 배포할 수 있습니다 Event NotificationsPagerDuty 도구 통합을 사용하여 이벤트 알림을 배포할 수 있습니다. IBM Cloud Event Notifications 는 Slack, 이메일, SMS, 푸시 알림, 웹훅, Microsoft® Teams, ServiceNow, 및 IBM Cloud Functions 와 같은 기타 커뮤니케이션 채널에 알림을 배포하는 데 선호되는 방법입니다. Event Notifications 사용에 대한 자세한 내용은 툴체인에 대한 이벤트 알림 사용 설정하기를 참조하세요.

콘솔을 사용하여 앱에서 도구 체인 작성

앱에서 도구 체인을 작성할 수 있습니다. 도구 체인은 연속 개발, 배치, 모니터링 등을 지원할 수 있으며 사용하는 앱과 연관됩니다. 각 앱은 하나의 도구 체인과 연관될 수 있습니다. 도구 체인의 GitHub 저장소에 변경사항을 푸시하면 파이프라인이 자동으로 앱을 빌드하고 배치합니다.

1. IBM Cloud Public을 사용하여 앱을 생성한 경우, 해당 앱은 앱 스타터 코드가 포함된 새로운 GitHub 저장소에서 지속적인 배포가 이루어지도록 구성되어 있습니다.

2. 도구 체인 구성 페이지에서 작성하려는 도구 체인의 다이어그램을 검토하십시오. 다이어그램은 도구 체인에서 해당 라이프사이클 단계(Phase)에 있는 각 도구 통합을 보여줍니다.

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 Docs에서 도구 체인 작성 을 참조하십시오.

Terraform을 사용하여 도구 체인 작성

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

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