관련 컨텐츠

• Continuous Delivery 시작하기
• 클러스터 시작하기
• 도구 체인 시작하기

도구 체인 이름 및 지역 구성

도구 체인 설정에 대한 기본 정보를 검토하십시오. 도구 체인의 이름은 IBM Cloud에서 해당 도구 체인을 식별합니다. 도구 체인의 이름이 IBM Cloud의 동일한 지역 및 리소스 그룹에 대해 도구 체인 내에서 고유한지 확인하십시오.

도구 체인 지역은 클러스터 및 레지스트리 지역과 다를 수 있습니다.

배치 전략 선택

도구 체인은 지속적인 배치 파이프라인을 작성하여 IBM Cloud® Kubernetes Service에 애플리케이션 도커 이미지를 배치합니다. 사용할 배치 전략을 선택하십시오. 선택하는 배치 전략(롤링, Blue-Green 또는 카나리아)에 따라 자세한 정보를 제공해야 합니다.

1. 도구 체인에 사용할 배치 전략을 클릭하십시오.

   

2. 계속을 클릭합니다.

애플리케이션 소스 코드 저장소 구성

애플리케이션 단계에서는 애플리케이션 소스 코드 저장소에 대한 권장 옵션이 기본적으로 표시됩니다. 기본 Git 통합에 사용 가능한 모든 옵션을 보려면 고급 옵션을 클릭하십시오. 기본적으로, 도구 체인은 샘플 앱을 IBM 호스팅 Git Repos and Issue Tracking 저장로서 복제하는 기본 샘플을 사용합니다.

앱 저장소의 이름은 변경이 가능합니다. 저장소의 지역은 도구 체인의 지역과 동일하게 유지됩니다.

이 툴체인 템플릿은 Maven 빌드를 사용하는 샘플 ‘ Java™ ’ Spring 애플리케이션을 제공합니다. 도구 체인의 기존 애플리케이션 저장소를 링크하려면, 자체 앱 가져오기를 선택한 후 저장소의 URL을 지정하십시오. 도구 체인은 기존 Git Repos and Issue Tracking 저장소에 대한 링크만 지원합니다.

기본적으로, 애플리케이션 저장소 템플리트는 Git Repos and Issue Tracking 조직으로 복제됩니다. 조직을 변경하려면, 고급 옵션을 사용하고 저장소 소유자를 지정하십시오.

인벤토리 저장소 구성

인벤토리 저장소는 지속적 통합 도구 체인으로 빌드된 아티팩트의 세부사항을 기록합니다. 인벤토리 리포지토리 템플릿을 복제한 새로운 인벤토리 리포지토리를 생성하거나, 여러 툴체인 간에 공유하는 기존 인벤토리 리포지토리를 사용할 수 있습니다.

기본적으로, 인벤토리 저장소 템플리트는 Git Repos and Issue Tracking 조직에 복제됩니다. 조직을 변경하려면, 고급 옵션을 선택하고 저장소 소유자를 지정하십시오.

안전하게 시크릿 저장

이 도구 체인 내의 여러 도구에서는 IBM Cloud API 키 등의 시크릿이 필요합니다. 모든 시크릿을 시크릿 볼트(vault)에 안전하게 저장한 후 도구 체인에서 필요하면 이를 참조해야 합니다.

IBM Cloud의 사용을 통해, 중요한 데이터의 보호와 시크릿의 중앙집중화에 도움이 되는 다양한 시크릿 관리 및 데이터 보호 오퍼링 중에서 선택할 수 있습니다. 시크릿 단계에서는 도구 체인에서 추가 또는 제거할 시크릿 볼트(vault) 통합을 지정할 수 있습니다. 전제조건 포함 및 힌트를 사용한 볼트(vault) 통합의 추가 및 제거에 대한 자세한 정보는 IBM Cloud 시크릿 관리를 참조하십시오.

템플리트 내에서 힌트를 사용하여, 도구 체인은 사전 구성된 시크릿으로 자동 채워집니다. 도구 체인에 연결된 볼트(vault) 통합에서 시크릿을 수동으로 선택할 필요가 없습니다.

이 학습서에서는 시크릿 볼트(vault)로서 IBM Secrets Manager를 사용합니다.

IBM Secrets Manager는 도구 체인의 일부인 API 키, 이미지 서명 또는 HashiCorp 신임 정보 등의 시크릿을 안전하게 저장하고 적용합니다.

IBM Key Protect 또는 HashiCorp, 에서 비밀번호 관리에 대한 자세한 내용은 비밀번호를 참조하세요.

VPC 세부 사항 구성

VPC및 VSI(Virtual Server Instances)에 대한 정보를 지정하여 도구 체인을 구성합니다.

사용할 배치 전략을 선택할 때 IBM Cloud® Schematics 및 Terraform을 사용하여 VPC및 VSI를 프로비저닝했습니다.

• 가상 사설 클라우드 영역: VPC를 프로비저닝한 영역을 선택하십시오.
• 가상 사설 클라우드 이름: Terraform 템플리트를 사용하여 프로비저닝한 VPC를 선택하십시오. 옵션에는 선택된 영역에 사용 가능한 모든 VPC가 포함됩니다.
• VPC 인스턴스의 사용자 이름: VPC 인스턴스를 프로비저닝할 때 구성한 사용자 이름을 지정하십시오. VPC에 있는 모든 VSIs는 사용자 이름과 SSH 키를 사용하여 로그인하여 해당 인스턴스를 배치해야 합니다.
• Base64 VPC 인스턴스에 대한 인코드된 SSH 키: VPC 인스턴스를 프로비저닝할 때 구성한 공용 SSH 키의 base64-encoded 양식으로 개인 SSH 키를 지정하십시오.

Bastion 호스트 세부사항 구성

또한, Terraform 템플리트는 Bastion 호스트로 사용하기 위해 VSI를 작성합니다. 기본 호스트는 VPC내의 VSI에 연결하여 배치 및 유지보수 작업을 완료하는 안전한 방법을 제공합니다. Bastion 호스트는 VPC 세부사항에서 구성한 신임 정보(사용자 이름 및 SSH 키)를 사용하여 SSH를 통해 VSIs에 연결합니다.

도구 체인에서는 VPC내의 VSIs에 로그인하여 앱 바이너리를 배치하고 앱을 시작 및 중지하고 써드파티 종속성을 다운로드하여 앱을 실행해야 합니다. 이러한 모든 태스크는 Bastion 호스트에서 SSH-Tunneling을 사용하여 수행됩니다. 도구 체인은 동일한 신임 정보를 사용하여 Bastion 호스트가 VSIs에 연결하는 데 사용하는 Bastion 호스트에 로그인합니다.

• Bastion 호스트: Terraform 템플리트에 의해 Bastion 호스트로 프로비저닝되는 VSI를 선택하십시오.

로드 밸랜서 세부사항 구성

VPC에 있는 VSIs에 배치된 샘플 앱은 8080 포트에 간단한 웹 페이지를 표시합니다. DNS 이름을 사용하여 인터넷에서 앱을 사용할 수 있도록 하고 앱을 실행하는 여러 VSIs 사이의 트래픽을 로드 밸런싱하기 위해 Terraform 템플리트는 앱 로드 밸랜서를 프로비저닝합니다. 이 앱을 실행하는 모든 VSIs는 로드 밸랜서를 위한 서버의 백엔드 풀을 구성합니다.

도구 체인은 로드 밸랜서 및 두 개의 백엔드 풀에 대한 세부사항을 사용하여 파란색-녹색 배치 프로세스 중에 실시간 앱 트래픽을 구성하고 경로 재지정합니다. 파란색 백엔드 풀과 녹색 백엔드 풀은 동일한 수의 VSIs를 포함합니다. 언제든지, 풀 중 하나만이 라이브 트래픽을 활발하게 제공하는 반면 다른 하나는 앱의 이전 버전을 실행하여 유휴 상태로 남아 있습니다. 로드 밸랜서는 각 배치와 함께 라이브 트래픽을 제공하는 백엔드 풀을 교환하거나 전환합니다. 파란색 백엔드 풀이 현재 활성화되어 있는 동안 다음 배치는 초록색 백엔드 풀의 VSIs에 앱을 배치하고 파란색 백엔드 풀이 수동 상태인 동안 활성화되도록 합니다.

로드 밸랜서에 대한 정보를 지정하여 도구 체인을 구성하십시오.

• 로드 밸랜서 이름: Terraform 템플리트가 프로비저닝하는 앱 로드 밸런서를 선택하십시오.
• 파란색 백엔드 풀 이름: 로드 밸랜서에 대해 Terraform 템플리트가 제공하는 파란색 백엔드 풀을 선택하십시오.
• 녹색 백엔드 풀 이름: 로드 밸랜서에 대해 Terraform 템플리트가 제공하는 녹색 백엔드 풀을 선택하십시오.

deployment target 단계에 대한 세부사항이 채워지면 다음 단계로 진행하십시오.

아티팩트 스토리지 구성

소스를 변경하면 지속적인 통합 파이프라인이 트리거됩니다. 지속적 통합 실행에 성공하면 빌드 또는 2진 아티팩트가 작성되어 임시 스토리지에 저장된 다음 대상 VSIs에 배치됩니다.

IBM Cloud Object Storage을 사용하여 임시 빌드 아티팩트를 도구 체인에 저장할 수 있습니다. 지속적 통합 파이프라인은 샘플 Spring Java 앱의 실행 가능한 .jar 파일을 빌드합니다.

또는 사용자 고유의 Artifactory 인스턴스가 있는 경우 Artifactory를 사용할 수 있습니다.

파이프라인 탐색

파이프라인을 탐색하여 도구 체인 플로우 및 각 파이프라인 내에서 실행되는 다양한 옵션을 이해할 수 있습니다. 방금 작성한 도구 체인에는 세 개의 파이프라인이 포함되어 있습니다.

• 가져오기 요청 파이프라인: 개발자가 개발 분기의 변경사항을 마스터 분기로 또는 저장소의 다른 분기로 병합할 때 실행됩니다. 가져오기 요청 파이프라인은 애플리케이션 소스 코드에서 단위 테스트 및 정적 스캔을 실행합니다.
• 지속적 통합 파이프라인: 애플리케이션 소스 코드 저장소의 마스터 분기로 변경사항을 병합할 때 실행됩니다. 지속적 통합 파이프라인은 애플리케이션 소스 코드, CIS 검사 및 BOM(Bill Of Materials) 검사에서 단위 테스트, 코드 적용 범위 및 정적 스캔을 실행합니다. 또한 지속적 딜리버리 파이프라인은 도구 체인의 구성대로 2진 빌드 아티팩트를 생성한 후 이를 IBM Cloud® Kubernetes Service에 업로드합니다. 그리고 지속적 통합 파이프라인은 빌드 아티팩트의 메타데이터를 생성한 후 이를 인벤토리 저장소에 저장합니다.
• 지속적 배치 파이프라인: 배치 환경에 빌드 아티팩트를 배치합니다. 파이프라인은 상태 확인을 실행하여 앱의 성공적인 배치를 확인합니다. 지속적 통합 파이프라인이 성공적으로 완료되면, 이 파이프라인을 수동으로 트리거해야 합니다. 선택된 배치 전략에 따라, 더 많은 트리거가 지속적 딜리버리 파이프라인에 추가됩니다.

가져오기 요청 및 지속적 통합 파이프라인 실행

가져오기 요청 파이프라인을 시작하려면, 앱 저장소에서 병합 요청을 작성하십시오.

1. 도구 체인의 개요 페이지에 있는 저장소 카드에서, compliance-app-<timestamp> 앱 저장소를 클릭하십시오.
2. 마스터 저장소에서 분기를 작성하십시오.
3. 샘플 노드 앱이나 readme 파일에서 일부 코드를 업데이트한 후 해당 변경사항을 저장하십시오.
4. 병합 요청을 제출하십시오.
5. 도구 체인의 개요 페이지에 있는 저장소 카드에서, pr-pipeline 저장소를 클릭하여 가져오기 요청 파이프라인을 시작하십시오. 앱 저장소의 대응되는 병합 요청은 가져오기 요청 파이프라인의 모든 단계가 성공적으로 완료될 때까지 보류 상태를 유지합니다.
6. 가져오기 요청 파이프라인 실행에 성공하면, 이를 선택하여 완료된 단계를 탐색할 수 있습니다.

지속적 통합 파이프라인을 시작하려면, 앱 저장소에서 지속적 통합 병합 요청을 병합하십시오.

1. 병합 요청으로 이동하십시오.
2. 변경사항이 앱 저장소의 마스터 분기에 복사되도록 요청을 병합하십시오. 지속적 통합 파이프라인은 자동으로 트리거됩니다.
3. Continuous Integration 도구 체인 개요 페이지의 저장소 카드에서 ci-pipeline 저장소를 클릭하여 Continuous Integration 파이프라인을 시작하십시오.
4. 지속적 통합 파이프라인 실행에 성공하면, 파이프라인 실행을 클릭하여 완료된 단계를 탐색할 수 있습니다.

파이프라인 실행 중에 실패가 있는지 평가하려면, 파이프라인 평가자가 있는 파이프라인의 최종 단계를 확인하십시오.

지속적 딜리버리 파이프라인 탐색

가져오기 요청 및 지속적 통합 파이프라인은 모든 배치 전략에서 공통입니다. 지속적 딜리버리 파이프라인 설계 및 구현 변경사항은 이 학습서에서 이전에 선택된 배치 전략을 기반으로 합니다.

이 학습서에서는 샘플 앱을 사용하여 롤링 배치 전략이 어떻게 작동하는지 설명합니다.

Blue-Green 배치 탐색

이 학습서에서 사용되는 파란색-녹색 배치 전략은 Continuous Delivery 서비스와 함께 배치 전략을 사용하여 VPC에서 프로덕션 워크로드를 실행하는 방법을 설명합니다. 지속적 전달 파이프라인은 파란색-녹색 배치를 위한 세 개의 트리거를 제공합니다. 다음 방법 중 하나로 지속적 전달 파이프라인을 시작할 수 있습니다.

• 지속적 딜리버리 파이프라인을 수동으로 트리거합니다.
• 인벤토리 저장소에서 각 Merge 조치 이후에 지속적 딜리버리 파이프라인을 자동으로 트리거합니다. 병합 후에는 지속적 전달 파이프라인 실행을 수동으로 트리거해야 합니다.
• 자동화된 롤백에 대해 파란색 및 녹색 배치 사이를 전환합니다.

이 학습서에서는 샘플 앱을 사용하여 Blue-Green 배치 전략이 어떻게 작동하는지를 보여 줍니다.

1. 지속적 전달 파이프라인에서 수동 트리거를 실행하여 앱의 첫 번째 버전을 배치하십시오.

   

2. 지속적 전달 파이프라인의 release 단계에서 앱 URL을 찾고 URL을 클릭하여 앱이 실행 중인지 확인하십시오.

   

3. 앱 코드를 업데이트하고 변경사항을 커미트하십시오. 샘플 앱의 경우 시작 메시지를 업데이트하십시오.

   a. 도구 체인의 개요 페이지에 있는 저장소 카드에서, 샘플 앱 저장소를 클릭하십시오.

   b. utils.js 파일에서 시작 메시지를 업데이트하십시오.

   c. 지속적 통합 파이프라인 실행이 완료될 때까지 대기하십시오.

4. 지속적 전달 파이프라인에서 수동 트리거를 실행하고 지속적 전달 파이프라인 실행이 완료될 때까지 대기하십시오.

5. 업데이트된 앱이 배치되었는지 확인하려면 앱 URL을 다시 확인하십시오. 두 개의 앱 버전이 동시에 실행 중입니다. 모든 네트워크 트래픽이 업데이트된 앱으로 플로우됩니다.

6. 지속적 전달 파이프라인에서 switch-blue-green 트리거를 실행하여 롤백을 테스트하십시오. 스위치 트리거 파이프라인 실행이 완료될 때까지 기다리십시오.

   

7. 앱의 이전 버전이 표시되었는지 확인하려면 앱 URL을 다시 확인하십시오.

스위치 트리거를 여러 번 실행하여 앱의 이전 버전과 최신 버전 사이에서 대체할 수 있습니다.