배포 설정하기

이 가이드는 배포 환경의 일반적인 설정을 다룹니다. 플랫폼별 구체적인 정보를 찾고 있다면 배포 가이드를 확인해보세요.

먼저 Bitbucket 설정에서 환경을 정의하겠습니다.

다음 항목을 설정할 수 있습니다:

• 환경 이름

• 환경의 유형

• 대시보드에 표시될 순서

• 해당 환경에 특정한 변수들

• 그리고 프리미엄 플랜을 이용 중이라면, 각 환경에 배포할 수 있는 사용자 권한

그런 다음 bitbucket-pipelines.yml 파일에서 이들을 참조하기만 하면 배포 대시보드에서 확인할 수 있습니다.

1단계: 환경 정의하기

먼저 환경의 세부 정보를 추가하겠습니다.

파이프라인을 활성화하면 기본적으로 3개의 기본 환경이 생성됩니다. 'Test'라는 테스트 환경, 'Staging'이라는 스테이징 환경, 그리고 (짐작하셨겠지만!) 'Production'이라는 프로덕션 환경입니다.

환경 유형은 환경을 논리적으로 정렬하는 용도로만 사용되므로, 유형이 실제 사용 용도와 정확히 일치하지 않아도 걱정하지 마세요.

• 왼쪽 사이드바에서 저장소 이름 옆의 More actions (…)를 선택한 다음 Settings를 선택합니다.

• Pipelines 섹션 아래에서 Deployments를 선택합니다.

• 환경을 선택하여 다음을 수행할 수 있습니다:

  • 이름 변경

  • 환경별 배포 변수 설정.

    배포 변수는 팀 및 저장소 변수를 모두 재정의합니다. 또한 같은 이름의 변수가 각 배포 환경마다 다른 값을 가질 수 있습니다. 예를 들어, 각 환경마다 다른 $DEPLOYMENT_SECRET_KEY를 설정할 수 있습니다. 환경을 제한하면 관리자만 비밀 키를 사용할 수 있습니다.

  • 관리자 또는 특정 브랜치에만 배포 권한 제한. 참고: 이는 Premium 기능으로 Prem 요금제 고객만 사용할 수 있습니다

더 많은 환경을 추가하려면 해당 환경을 가장 잘 설명하는 환경 유형(테스트, 스테이징 또는 프로덕션)을 결정하고 해당 섹션에서 add environment를 선택합니다.

또한 왼쪽 가장자리를 선택하고 드래그하여 해당 유형 내에서 환경을 이동할 수 있습니다.

2단계: 배포 단계 구성

step 또는 stage에 deployment 키워드를 추가하고, 그 뒤에 환경 이름을 작성하세요. Pipelines의 기본 배포 환경은 test, staging, 또는 production입니다.

예시:

bitbucket-pipelines.yml 파일에 변경 사항을 커밋하여 배포 파이프라인을 실행하세요. 배포 단계 또는 스테이지가 이제 배포 대시보드에 표시됩니다.

여러 배포 환경을 추가할 때, Bitbucket Pipelines에서는 bitbucket-pipelines.yml 파일에서 배포를 다음과 같은 순서로 정렬해야 합니다:

1. 테스트 환경

2. 스테이징 환경

3. 프로덕션 환경

파이프라인은 세 가지 환경 유형을 모두 필요로 하지 않으며, 각 유형 내의 단계와 스테이지는 어떤 순서든 될 수 있습니다.

예를 들어, 배포 설정 페이지에서 다음과 같은 배포 환경이 구성되어 있다면:

• 테스트 환경 — testbed

• 스테이징 환경 — staging1 및 staging2

• 프로덕션 환경 — production-east

연관된 단계나 스테이지를 파이프라인에 추가할 때, 스테이징 환경(staging1 및 staging2)이 모든 테스트 환경 뒤에, 그리고 모든 프로덕션 환경 앞에 그룹화되도록 해야 합니다.

예시:

pipelines: default: - step: name: Build and push to S3 script: - apt-get update - apt-get install -y python-dev - curl -O https://bootstrap.pypa.io/get-pip.py - python get-pip.py - pip install awscli 3단계: 배포 추적하기

배포 단계가 실행되면, Deployments 대시보드에서 배포를 추적할 수 있습니다.

배포 대시보드 이해하기

배포 대시보드를 사용하여 모든 배포 환경에 대한 정보를 한눈에 확인할 수 있습니다. 또한 권한이 있는 배포 변수를 사용하여 원하는 브랜치나 사람만 배포할 수 있도록 보장할 수 있습니다.

참고: 각 환경에서는 진행 중인 배포를 하나만 가질 수 있습니다. 동일한 환경에 배포하는 이후 파이프라인은 자동으로 일시 중지됩니다. 진행 중인 배포가 완료되면 일시 중지된 배포 단계를 수동으로 재개할 수 있습니다.

배포 정보

환경 카드에서 다양한 정보에 액세스할 수 있습니다.

1. 배포 이력

환경 이름을 선택하면 해당 환경에 대한 모든 이전 배포의 이력을 볼 수 있습니다. 이 중 아무거나 선택하여 배포 요약을 확인할 수 있습니다.

2. 파이프라인 보기

파이프라인 번호를 선택하면 해당 파이프라인 실행의 요약 페이지로 이동하여 로그 등을 볼 수 있습니다.

3. 배포 요약

환경 카드나 히스토리 목록에서 배포를 선택하여 배포 요약에 접근하세요. 요약에는 다음을 포함한 배포 정보가 표시됩니다:

• 배포된 환경

• 환경에서 이전 배포

• 배포 상태

• 배포를 실행한 사용자 (배포가 수동 단계인 경우)

• 배포가 발생한 날짜

• 배포에 포함된 전체 커밋 목록

• 새 배포와 환경에서 이전 배포 간의 파일 diff

• 커밋 메시지에서 언급한 연결된 Jira 이슈

어떤 환경에 처음 배포되는 빌드는 해당 빌드와 관련된 커밋만 표시됩니다. 빌드를 다시 실행하면 이러한 빌드들 간에는 차이가 없으므로 해당 빌드에는 diff가 표시되지 않습니다.

Jira를 사용하여 작업을 추적하는 경우, 추가 혜택을 위해 Jira와 Bitbucket을 연결할 수 있습니다.

연결이 완료되면, 배포와 관련된 이슈가 배포 요약 및 배포 미리보기 화면에 표시되며, 배포는 관련 Jira 이슈에 나타납니다. 커밋 메시지에 이슈 키 하나 또는 여러 개를 추가하기만 하면 나머지는 자동으로 처리됩니다.

예시

git commit -m "PT-323 Add created workers to container cluster"

Bitbucket에서는 다음 이미지와 같이 표시됩니다.

Jira에서는 다음과 같이 표시됩니다:

성공한 배포를 다시 실행하는 경우, Jira는 다시 실행된 배포가 아닌 첫 번째 성공한 배포의 세부 정보를 계속 표시합니다.

배포 롤백

Bitbucket Pipelines를 사용하면 전체 파이프라인을 실행하지 않고도 배포 단계를 롤백할 수 있습니다. 배포가 실패한 경우 마지막으로 성공한 배포를 복원할 수 있습니다.

시작하기 전에

Redeploy 버튼이 활성화되려면:

• 파이프라인의 초기 배포 단계가 성공적으로 완료되어야 합니다

• 배포 권한이 단계를 재배포할 수 있도록 허용해야 합니다 (프리미엄 플랜 전용)

• 아티팩트가 만료되면 안 됩니다

배포 롤백하기

배포 단계를 롤백하려면:

1. 재배포하려는 배포를 선택하고 Redeploy 버튼을 클릭합니다. 

2. Redeploy 화면에서 변경사항을 검토하고 Redeploy를 선택합니다:

또는 Deployments 대시보드에서 Redeploy를 선택할 수도 있습니다: