파이프라인 기본

동작 방식

bitbucket-pipelines.yml	저장소 루트의 설정 파일
Docker containers	각 스텝은 자체 컨테이너에서 실행
Triggers	푸시, PR, 태그, 스케줄, 수동
Build minutes	사용 가능 빌드 시간은 플랜 등급에 따름

파이프라인 활성화

# Repository Settings → Pipelines → Enable
# Add bitbucket-pipelines.yml to repo root
# First push triggers the pipeline

bitbucket-pipelines.yml

최소 설정

image: node:20
pipelines:
  default:
    - step:
        script:
          - npm install
          - npm test

브랜치별 파이프라인

pipelines:
  branches:
    main:
      - step:
          script:
            - npm run build
            - npm run deploy

태그 & PR 파이프라인

pipelines:
  tags:
    'v*':
      - step:
          script:
            - npm run release
  pull-requests:
    '**':
      - step:
          script:
            - npm test

스텝

스텝 옵션

name	스텝 표시 이름
image	전역 Docker 이미지 재정의
script	실행할 셸 명령 목록
size	1x (4GB) 또는 2x (8GB) 메모리
max-time	타임아웃(분, 기본값 120)
trigger	manual로 설정 시 수동 실행만 가능

병렬 스텝

- parallel:
    - step:
        name: "Lint"
        script:
          - npm run lint
    - step:
        name: "Test"
        script:
          - npm test

수동 스텝

- step:
    name: "Deploy to Production"
    trigger: manual
    script:
      - ./deploy.sh prod

변수

변수 유형

Repository variables	Settings → Pipelines → Variables
Deployment variables	배포 환경에 범위 지정
Secured variables	암호화, 로그에서 마스킹
Pipeline variables	YAML 인라인 정의

변수 사용

pipelines:
  default:
    - step:
        script:
          - echo $MY_VAR
          - docker login -u $DOCKER_USER -p $DOCKER_PASS

내장 변수

$BITBUCKET_COMMIT	전체 커밋 SHA
$BITBUCKET_BRANCH	브랜치 이름
$BITBUCKET_TAG	태그 이름 (태그 파이프라인)
$BITBUCKET_BUILD_NUMBER	증가하는 빌드 번호
$BITBUCKET_REPO_SLUG	저장소 슬러그

캐싱

사전 정의 캐시

- step:
    caches:
      - node        # ~/.npm
      - pip         # ~/.cache/pip
      - docker      # Docker layer cache
    script:
      - npm install
      - npm test

커스텀 캐시

definitions:
  caches:
    gradle: ~/.gradle/caches
    mylibs: vendor/libs
pipelines:
  default:
    - step:
        caches:
          - gradle
        script:
          - ./gradlew build

캐시 동작

Duration	캐시는 7일 후 만료
Scope	저장소의 모든 파이프라인에서 공유
Clear	Pipelines → Caches → Delete

아티팩트

스텝 간 파일 전달

- step:
    name: "Build"
    script:
      - npm run build
    artifacts:
      - dist/**
- step:
    name: "Deploy"
    script:
      - ls dist/    # artifacts available
      - ./deploy.sh

아티팩트 옵션

artifacts	전달할 파일의 글로브 패턴
Download	이후 스텝에서 자동으로 사용 가능
Max size	스텝당 1 GB
Retention	빌드 후 14일간 보관

배포

배포 환경

- step:
    name: "Deploy Staging"
    deployment: staging
    script:
      - ./deploy.sh staging
- step:
    name: "Deploy Production"
    deployment: production
    trigger: manual
    script:
      - ./deploy.sh prod

환경 유형

test	테스트 환경
staging	프리 프로덕션 환경
production	라이브 환경, 대시보드에서 추적

일반 패턴

Docker 빌드 & 푸시

- step:
    services:
      - docker
    script:
      - docker build -t myapp:$BITBUCKET_COMMIT .
      - docker login -u $DOCKER_USER -p $DOCKER_PASS
      - docker push myapp:$BITBUCKET_COMMIT

서비스 컨테이너

definitions:
  services:
    postgres:
      image: postgres:16
      variables:
        POSTGRES_DB: testdb
        POSTGRES_PASSWORD: secret
pipelines:
  default:
    - step:
        services:
          - postgres
        script:
          - npm test

파이프를 이용한 조건부 스텝

- step:
    name: "Deploy to S3"
    script:
      - pipe: atlassian/aws-s3-deploy:1.1.0
        variables:
          AWS_ACCESS_KEY_ID: $AWS_KEY
          AWS_SECRET_ACCESS_KEY: $AWS_SECRET
          S3_BUCKET: my-bucket
          LOCAL_PATH: dist/

BITBUCKET PIPELINES 빠른 참조