IBM Cloud에 배치 단추 작성

IBM Cloud에 배치 단추는 도구 체인을 사용하여 다른 사람들이 코드를 실험하고 IBM Cloud에 배치할 수 있도록 공용 Git 소스 앱을 공유하는 효율적인 방법입니다. 이 단추를 사용하려면 최소한의 구성이 필요하며 마크업을 지원하는 모든 위치에 이 단추를 삽입할 수 있습니다. 단추를 클릭하는 모든 사용자는 원래의 앱이 영향을 받지 않도록 새 Git 저장소에 코드의 복제된 사본을 작성합니다.

사용자가 단추를 클릭하면 다음과 같은 조치가 수행됩니다.

  1. 사용자가 활성 IBM Cloud 계정을 갖고 있지 않은 경우 계정을 작성해야 합니다. 평가판 계정 또는 실제 계정을 작성할 수 있습니다.

  2. 사용자는 Delivery Pipeline 아이콘을 클릭하여 영역, 자원 그룹 및 앱 이름을 선택할 수 있습니다. 제안된 앱 이름은 원래의 Git 저장소의 이름 및 시간으로 생성된 도구 체인 이름과 동일합니다. 도구 체인 이름도 편집할 수 있습니다.

  3. Git 저장소의 새 개인용 복제본, 코드 변경사항 빌드 및 배치를 위한 파이프라인, 문제 트래커를 포함하는 도구 체인이 작성됩니다.

    .bluemix 디렉토리에 toolchain.yml 파일이 포함된 경우 파일은 도구 체인에 대한 도구 통합을 지정하는 데 사용됩니다. toolchain.yml 파일에 대한 자세한 내용은 ‘사용자 지정 툴체인 템플릿 만들기’를 참조하십시오.

  4. 앱에 빌드 파일이 필요한 경우 빌드 파일이 자동으로 발견되어 앱을 빌드합니다.

  5. 파이프라인이 빌드 및 배치 프로세스에 대해 구성된 경우 앱을 배치하는 데 pipeline.yml 파일이 사용됩니다.

  6. 앱에 컨테이너가 필요한 경우 IBM Cloud Kubernetes Service를 정의하는 pipeline.yml 파일 및 이미지를 정의하는 Dockerfile은 IBM Cloud Kubernetes Service에 앱을 배치하는 데 사용됩니다.

  7. 앱은 사용자가 선택한 IBM Cloud 조직에 배치됩니다.

단추 예

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

공용 Git Repos and Issue Tracking 저장소에 대한 앱 단추 예를 참조하십시오.

IBM Cloud 에 배치 단추

공용 GitHub 저장소에 대한 앱 단추 예를 참조하십시오.

IBM Cloud 에 배치 단추

단추 작성

IBM Cloud에 배치 단추를 작성하려면 다음 스니펫 템플리트 중 하나를 복사하고 수정하십시오. URL에 Git 저장소 및 분기를 지정하십시오.

HTML에서 단추 작성

HTML에서 단추를 작성하려면 이 스니펫을 복사하여 공용 Git 저장소 URL 및 분기를 삽입하십시오.

<a href="https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>"><img src="https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg" alt="Deploy to IBM Cloud" target="_blank"></a>

스니펫의 저장소 URL에 branch 매개변수를 포함하지 않은 경우 IBM Cloud에 배치 단추가 기본적으로 저장소의 마스터 분기로 설정됩니다.

마크다운에서 단추 작성

마크다운에서 단추를 작성하려면 이 스니펫을 복사하여 공용 Git 저장소 URL 및 분기를 삽입하십시오.

[![Deploy to IBM Cloud button](https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg)](https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>)

스니펫의 저장소 URL에 branch 매개변수를 포함하지 않은 경우 IBM Cloud에 배치 단추가 기본적으로 저장소의 마스터 분기로 설정됩니다.

단추 스니펫 사용

IBM Cloud에 배치 단추 스니펫을 작성한 후 블로그, 기사, 위키, readme 파일 또는 앱을 홍보할 모든 위치에 삽입할 수 있습니다.

‘ IBM Cloud 에 배포’ 버튼의 스니펫을 사용자 정의할 때는, 두 템플릿 모두 SVG 형식의 외부 버튼 이미지에 대한 기본 경로를 사용하며, 해당 이미지의 텍스트가 영어로 되어 있다는 점을 유의하시기 바랍니다. 이미지를 로컬로 저장하려는 경우 이미지를 다운로드하여 Git 저장소에 저장할 수 있습니다. 이미지의 상대 위치를 사용하도록 경로를 조정하십시오.

저장소 고려사항

IBM Cloud에 배치 단추에 사용하는 저장소에 대한 다음 고려사항을 검토하십시오.

빌드 파일 요구사항

앱을 배치하기 전에 빌드해야 하는 경우 저장소에 빌드 파일을 포함해야 합니다. 빌드 스크립트 파일이 저장소의 루트 디렉토리에서 발견되면 코드의 자동화된 빌드가 배치 전에 트리거됩니다.

지원되는 빌더는 다음과 같습니다.

  • Ant: build.xml, 이 명령은 ./output/ 폴더에 출력물을 생성합니다
  • Gradle: /build.gradle, 이 스크립트는 . 폴더에 출력물을 생성합니다
  • Grunt: /Gruntfile.js, 이 스크립트는 . 폴더에 결과물을 생성합니다
  • Maven: /pom.xml, 이 프로젝트는 ./target/ 폴더에 출력물을 생성합니다

파이프라인 파일 요구사항

.bluemix 디렉토리에 도구 체인의 파이프라인을 구성하려면 pipeline.yml 파일을 포함하십시오. 해당 디렉토리에 있는 각 pipeline.yml 파일의 경우 도구 체인이 인스턴스화될 때 파이프라인이 작성됩니다.

파이프라인 파일을 생성하려면 ‘사용자 정의 툴체인 템플릿 만들기’ 문서의 예제 파일을 참조하십시오. 웹 인터페이스의 파이프라인을 정의할 때 단계 및 작업을 작성하고 입력 및 환경 변수를 설정하며 스크립트를 추가하여 텍스트의 파이프라인을 정의합니다. 이 데모 프로젝트에서는 더 복잡한 파이프라인 파일들도 여러 개 확인할 수 있습니다.

컨테이너 Dockerfile 요구사항

IBM Cloud Kubernetes Service를 사용하여 컨테이너에 앱을 배치하려면 저장소의 루트 디렉토리에 Dockerfile을 포함하고 .bluemix 디렉토리에 pipeline.yml 파일을 포함해야 합니다.

Dockerfile은 앱에 대한 빌드 스크립트 종류로 작동합니다. Dockerfile이 저장소에서 발견되면 앱이 컨테이너에 배치되기 전에 이미지에 자동으로 빌드됩니다. 앱이 이미지로 빌드되기 전에 앱이 자체적으로 빌드되어야 하는 경우 앱 및 Dockerfile에 대한 빌드 스크립트를 포함해야 합니다.

Dockerfile 작성에 대해 자세히 알아보려면 ‘ Docker ’ 문서를 참조하세요. Kubernetes에 대해 자세히 알아보려면 IBM Cloud Kuberenetes Service를 참조하십시오.

컨테이너 전용 pipeline.yml 를 수동으로 생성하려면 GitHub 에 있는 예제를 참조하십시오.