배포 설정 및 모니터링

원본 보기

배포 설정 및 모니터링

배포 설정하기

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

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

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

환경 이름
환경 타입
대시보드에 표시되는 순서
해당 환경에 특정한 변수
그리고 프리미엄 플랜이 있는 경우, 각 환경에 배포할 수 있는 사용자

그런 다음 bitbucket-pipelines.yml 파일에서 해당 환경을 참조하여 배포 대시보드에서 확인할 수 있습니다.

1단계: 환경 정의하기

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

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

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

저장소에서 왼쪽 사이드바의 저장소 설정을 선택합니다.
Pipelines 섹션 하위에서 배포를 선택합니다.
다음을 위해 환경을 선택합니다:
- 이름 변경
- 환경별 배포 변수 설정.
  배포 변수는 팀 변수와 저장소 변수를 모두 재정의합니다. 또한 동일한 이름의 변수라도 각 배포 환경마다 다른 값을 가질 수 있습니다. 예를 들어, 각 환경마다 다른 $DEPLOYMENT_SECRET_KEY를 설정할 수 있습니다. 환경을 제한하면 관리자만 비밀 키를 사용할 수 있습니다.
- 관리자 또는 특정 브랜치로만 배포할 수 있도록 제한. 참고: 이는 Premium 기능으로, Premium 고객만 이용할 수 있습니다

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

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

2단계: 배포 단계 구성

step 또는 stage에 deployment 키워드를 추가한 다음 환경 이름을 입력하세요. 기본 Pipelines 배포 환경은 test, staging 또는 production입니다.

예시:

pipelines:
  default:
    - step:
        name: Deploy to production
        deployment: production
        script:
          - python deployscript.py prod

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

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

테스트 환경
스테이징 환경
프로덕션 환경

파이프라인에는 세 가지 환경 유형이 모두 필요하지 않으며, 각 유형 내의 단계와 스테이지는 임의의 순서로 배치할 수 있습니다.

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

테스트 환경 — 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. 배포 요약
환경 카드에서 배포를 선택하거나 히스토리 목록에서 배포 요약에 액세스할 수 있습니다. 요약에는 다음을 포함한 배포에 대한 정보가 표시됩니다:
배포된 환경
해당 환경의 이전 배포
배포 상태
배포를 실행한 사용자 (수동 배포인 경우)
배포가 발생한 날짜
배포에 포함된 전체 커밋 목록
새 배포와 환경의 이전 배포 간 파일 차이점
커밋 메시지에서 언급한 연결된 Jira 이슈
임의 환경에 처음 배포되는 빌드는 해당 빌드와 연결된 커밋만 표시됩니다. 빌드가 다시 실행되는 경우, 이러한 빌드 간에는 차이가 없으므로 해당 빌드에 대한 차이점은 표시되지 않습니다.
작업을 추적하기 위해 Jira를 사용하는 경우, 추가 이점을 위해 Jira와 Bitbucket을 연결할 수 있습니다.
연결되면 배포와 관련된 이슈가 배포 요약 및 배포 미리보기 화면에 표시되고, 배포가 관련 Jira 이슈에도 표시됩니다. 커밋 메시지에 이슈 키를 추가하면 나머지는 자동으로 처리됩니다. 
예시
git commit -m "PT-323 Add created workers to container cluster"

Bitbucket에서는 다음 이미지와 같이 표시됩니다.
Jira에서는 다음과 같이 표시됩니다:
성공한 배포를 다시 실행하면 Jira는 재실행이 아닌 첫 번째 성공한 배포의 세부 정보를 계속 표시합니다.
배포 롤백
Bitbucket Pipelines를 사용하면 전체 파이프라인을 실행하지 않고도 배포 단계를 롤백할 수 있습니다. 배포가 실패한 경우, 마지막으로 성공한 배포로 복원할 수 있습니다.
시작하기 전에
Redeploy 버튼이 활성화되려면:
파이프라인의 초기 배포 단계가 성공적으로 완료되어야 합니다
배포 권한 이 단계의 재배포를 허용해야 합니다 (프리미엄 플랜만 해당)
아티팩트가 만료되지 않아야 합니다
배포 롤백하기
배포 단계를 롤백하려면:
다시 배포하려는 배포를 선택하고 Redeploy 버튼을 선택하세요. 
Redeploy 화면에서 변경사항을 검토하고 Redeploy를 선택하세요:
또는 Deployments 대시보드에서 Redeploy를 선택할 수도 있습니다:


여전히 도움이 필요하신가요?
Atlassian Community가 도와드리겠습니다.
커뮤니티에 질문하기