배포

Atlassian Cloud번역일: 2026-08-19원본 보기

배포 설정하기

이 가이드는 배포 환경의 일반적인 설정 방법을 다룹니다. 특정 플랫폼에 대한 정보를 찾고 있다면 배포 가이드를 확인하세요.

먼저 Bitbucket 설정에서 환경을 정의합니다.

설정할 수 있는 항목:

이름
환경의 유형
대시보드에 표시되는 순서
해당 환경에만 적용되는 변수
그리고 프리미엄 플랜을 사용 중이라면 각 환경에 배포할 수 있는 사용자

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

1단계: 환경 정의하기

먼저 환경의 세부 정보를 추가합니다.

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

환경 유형은 환경을 논리적으로 정렬하는 용도로만 사용되므로, 유형이 실제 사용 목적과 정확히 맞지 않더라도 걱정하지 않아도 됩니다.

왼쪽 사이드바의 리포지토리 이름 옆에서 더 보기(…)를 선택한 다음 설정을 선택합니다.
파이프라인 섹션에서 배포를 선택합니다.
환경을 선택하면 다음을 할 수 있습니다:
- 이름 변경
- 환경별 배포 변수 설정
  배포 변수는 팀 변수와 리포지토리 변수를 모두 재정의합니다. 또한 이름이 같은 변수라도 각 배포 환경마다 다른 값을 가질 수 있습니다. 예를 들어 환경별로 서로 다른 $DEPLOYMENT_SECRET_KEY를 설정할 수 있습니다. 여기에 환경을 제한하면 관리자만 시크릿 키를 사용할 수 있습니다.
- 배포 권한을 관리자 또는 특정 브랜치로 제한. 참고: 이 기능은 프리미엄 기능이므로 프리미엄 플랜 고객만 사용할 수 있습니다

환경을 더 추가하려면 어떤 유형(test, staging, production)이 가장 적합한지 정한 다음 해당 섹션에서 환경 추가를 선택합니다.

왼쪽 가장자리를 선택해 끌어서 같은 유형 안에서 환경 순서를 옮길 수도 있습니다.

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 파일에서 배포가 다음 순서로 정렬되어야 합니다:

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

Pipelines는 세 가지 환경 유형을 모두 요구하지 않으며, 각 유형 내의 단계와 스테이지는 어떤 순서로든 배치할 수 있습니다.

예를 들어 배포 설정 페이지에 다음과 같은 배포 환경이 구성되어 있다고 가정해 봅시다:

테스트 환경 — 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
          - aws deploy push --application-name $APPLICATION_NAME --s3-location s3://$S3_BUCKET/test_app_$BITBUCKET_BUILD_NUMBER --ignore-hidden-files
    - step:
        name: Deploy to testing
        image: amazon/aws-cli:latest
        deployment: testbed # Test environment
        script:
          - python deploy.py test
    - step:
        name: Deploy to staging
        image: amazon/aws-cli:latest
        deployment: staging2 # Staging environment
        trigger: manual
        script:
          - python deploy.py staging
    - step:
        name: Deploy to QA staging
        image: amazon/aws-cli:latest
        deployment: staging1 # Staging environment
        trigger: manual
        script:
          - python deploy.py staging
    - step:
        name: Deploy to production
        image: amazon/aws-cli:latest
        deployment: production-east # Production environment
        trigger: manual
        script:
          - python deploy.py prod