Bitbucket Pipelines에서 Pub 사용하기
Bitbucket Pipelines 작업은 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 자체 ID 토큰을 15분 동안 유효한 Pub 토큰으로 교환합니다. 모든 공급자에 공통인 작동 방식은 CI에서 Pub 사용하기에서 설명합니다.
1. 발급자 신뢰 설정
Bitbucket 워크스페이스마다 고유한 발급자가 있으므로 먼저 소유자가 이를 추가해야 합니다. “CI access”의 “This organization's own CI issuers”에서 “Bitbucket Pipelines”를 선택하고 워크스페이스의 URL 이름을 입력하세요.
2. 저장소 바인딩
Control Room에서 Organization, CI access, Bind a repository 순서로 연 뒤 Bitbucket Pipelines 항목을 선택하세요. 양식에서 다음 항목을 입력합니다:
- Repository UUID: Bitbucket의 “Repository settings” > “OpenID Connect”에 있는 저장소 UUID(중괄호 포함).
- Workspace UUID: 같은 페이지에 있는 워크스페이스 UUID.
- Deployment environment UUID, optional: 같은 페이지에 있으며, deployment: 설정이 있는 단계에 사용합니다. 그러면 해당 배포 권한이 모든 교환을 통제합니다.
- Ref pattern, optional: 브랜치: refs/heads/main. Bitbucket 토큰에는 브랜치만 담기며 태그는 담기지 않습니다.
그런 다음 바인딩의 Packages 버튼으로 패키지를 부여하세요: 읽기, 또는 읽기와 게시.
3. 작업에서 교환
같은 Organization 화면에 있는 조직 ID를 DARTASTIC_ORG_ID 변수에 넣으세요. 이 작업은 게시까지 합니다. 읽기만 하는 작업이라면 dart pub publish 단계를 빼고, 바인딩에 읽기 권한만 부여하세요.
# bitbucket-pipelines.yml: publish from main
image: dart:stable
pipelines:
branches:
main:
- step:
name: Publish
deployment: production # optional: bind the environment too
oidc: true
script:
- export DARTASTIC_ORG_ID="<your organization id>"
- apt-get update -qq && apt-get install -y -qq jq
- |
RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
-H "Authorization: Bearer $BITBUCKET_STEP_OIDC_TOKEN" -H "Content-Type: application/json" \
-d "{\"orgId\":\"$DARTASTIC_ORG_ID\"}") || { echo "$RESP" >&2; exit 1; }
export PUB_TOKEN=$(echo "$RESP" | jq -er .token)
dart pub token add https://pub.dartastic.io --env-var PUB_TOKEN
- dart pub get
- dart pub publish --force
options:
oidc:
audiences:
- https://dartastic.io- 단계에 oidc: true 설정을 넣으면 $BITBUCKET_STEP_OIDC_TOKEN 변수가 주어지고, oidc: 아래의 audiences 목록이 audience를 https://dartastic.io 값으로 정합니다.
- Bitbucket 토큰은 저장소를 UUID로만 식별하므로 바인딩에도 UUID를 입력합니다.
거부될 때
작업 로그에 TRUSTED PUBLISHER REF MISMATCH 같은 이유가 맨 앞에 표시됩니다. 모든 이유와 조치 방법은 CI에서 Pub 사용하기에 있습니다. Bitbucket Pipelines 자체의 토큰 안내는 공식 문서에서 볼 수 있습니다.