[ Bitbucket ] 다양한 Pipeline 설정하기

 

 

Bitbucket Cloud에서는 하나의 repository에 대해 .bitbucket-pipelines.yml 파일은 하나만 사용하지만,
그 안에 여러 종류의 파이프라인(트리거별, 수동, 조건별 등)을 설정할 수 있습니다.

즉, “여러 개의 pipeline”을 정의할 수 있는 구조는 있지만, 파일은 하나입니다.

---

1. 다양한 파이프라인 설정 방식

1. 브랜치별 파이프라인

pipelines:
  branches:
    main:
      - step:
          name: Build & Deploy Main
          script:
            - ./deploy.sh main

    develop:
      - step:
          name: Build Develop
          script:
            - ./build.sh

• 브랜치 이름에 따라 서로 다른 파이프라인을 실행

---

2. 태그 기반 파이프라인

pipelines:
  tags:
    v*:
      - step:
          name: Release
          script:
            - ./release.sh

• v1.0.0, v2.3.1 같은 태그 push 시 실행

---

3. Pull Request 트리거

pipelines:
  pull-requests:
    "**":
      - step:
          name: PR Test
          script:
            - ./test.sh

• 모든 PR에 대해 실행

---

4. Custom (수동 실행용) 파이프라인

pipelines:
  custom:
    staging-deploy:
      - step:
          name: Deploy to Staging
          script:
            - ./deploy.sh staging

    production-deploy:
      - step:
          name: Deploy to Prod
          script:
            - ./deploy.sh production

• Bitbucket UI에서 "Run pipeline" → staging-deploy 또는 production-deploy를 수동으로 선택해 실행

---

5. 조건부 Step 수동 실행

pipelines:
  default:
    - step:
        name: Build
        script:
          - ./build.sh
    - step:
        name: Manual Approval for Deploy
        trigger: manual
        script:
          - ./deploy.sh

• trigger: manual을 설정하면 이 step만 수동 승인 후 실행

---

2. 정리: 하나의 YAML로 여러 pipeline 구성하기

구성 방식 목적 자동/수동

default	기본 자동 실행	자동
branches	브랜치별 설정	자동
tags	태그 push 트리거	자동
pull-requests	PR 생성/변경 시	자동
custom	사용자가 수동 실행	수동
trigger: manual	특정 step만 수동 승인	반자동

---