관련 컨텐츠

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

도구 체인 이름 및 지역 구성

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

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

배치 전략 선택

도구 체인은 Satellite에 정의된 클러스터 그룹에서 애플리케이션 Docker 이미지를 배치하기 위한 지속적 배치 파이프라인을 작성합니다.

1. Satellite의 사용으로 앱을 배치하려면 Satellite를 통한 다중 클러스터를 클릭하십시오.

   

2. 계속을 클릭합니다.

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

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

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

도구 체인 템플리트는 Hello 컨테이너 애플리케이션 앱을 제공합니다. 도구 체인의 기존 애플리케이션 저장소를 링크하려면, 자체 앱 가져오기를 선택한 후 저장소의 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, 에서 비밀번호 관리에 대한 자세한 내용은 비밀번호를 참조하세요.

파이프라인 탐색

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

• 가져오기 요청 파이프라인: 개발자가 개발 분기의 변경사항을 마스터 분기로 또는 저장소의 다른 분기로 병합할 때 실행됩니다. 가져오기 요청 파이프라인은 애플리케이션 소스 코드에서 단위 테스트 및 정적 스캔을 실행합니다.
• 지속적 통합 파이프라인: 애플리케이션 소스 코드 저장소의 마스터 분기로 변경사항을 병합할 때 실행됩니다. 지속적 통합 파이프라인은 애플리케이션 소스 코드, 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. 지속적 통합 파이프라인 실행에 성공하면, 파이프라인 실행을 클릭하여 완료된 단계를 탐색할 수 있습니다.

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

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

다음의 방법 중 하나로 지속적 딜리버리 파이프라인을 시작할 수 있습니다.

• 지속적 딜리버리 파이프라인을 수동으로 트리거합니다.
• 인벤토리 저장소에서 각 Merge 조치 이후에 지속적 딜리버리 파이프라인을 자동으로 트리거합니다. 병합 후에는 지속적 딜리버리 파이프라인 실행을 수동으로 트리거해야 합니다.

Git Repos and Issue Tracking 트리거는 자동 지속적 딜리버리 파이프라인을 트리거하도록 설정되지만, 이는 기본적으로 사용되지 않습니다. 처음으로 변경사항을 승격한 후에 이 트리거를 사용할 수 있습니다.