CircleCI에서 Pub 사용하기
CircleCI 작업은 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 자체 ID 토큰을 15분 동안 유효한 Pub 토큰으로 교환합니다. 모든 공급자에 공통인 작동 방식은 CI에서 Pub 사용하기에서 설명합니다.
1. 발급자 신뢰 설정
CircleCI 조직마다 고유한 발급자가 있으므로 먼저 소유자가 이를 추가해야 합니다. “CI access”의 “This organization's own CI issuers”에서 “CircleCI”를 선택하고 조직 ID를 입력하세요.
2. 저장소 바인딩
Control Room에서 Organization, CI access, Bind a repository 순서로 연 뒤 CircleCI 항목을 선택하세요. 양식에서 다음 항목을 입력합니다:
- Project ID: CircleCI의 “Project Settings” > “Overview”.
- Organization ID, optional: “Organization Settings” > “Overview”. 비워 두면 발급자에서 읽어 옵니다.
- Context ID, optional: 작업이 반드시 사용해야 하는 컨텍스트(“Organization Settings” > “Contexts”). 그러면 그 컨텍스트의 보안 그룹이 모든 교환을 통제합니다.
- Ref pattern, optional: 브랜치 또는 태그: refs/tags/v* 또는 refs/heads/main.
그런 다음 바인딩의 Packages 버튼으로 패키지를 부여하세요: 읽기, 또는 읽기와 게시.
3. 작업에서 교환
같은 Organization 화면에 있는 조직 ID를 DARTASTIC_ORG_ID 변수에 넣으세요. 이 작업은 게시까지 합니다. 읽기만 하는 작업이라면 dart pub publish 단계를 빼고, 바인딩에 읽기 권한만 부여하세요.
# .circleci/config.yml: publish on a version tag
version: 2.1
jobs:
publish:
docker:
- image: dart:stable
environment:
DARTASTIC_ORG_ID: <your organization id>
steps:
- checkout
- run: apt-get update -qq && apt-get install -y -qq jq
- run:
name: Exchange this job's identity for a 15-minute Pub token
command: |
OIDC=$(circleci run oidc get --aud https://dartastic.io)
RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
-H "Authorization: Bearer $OIDC" -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
echo "export PUB_TOKEN=$PUB_TOKEN" >> "$BASH_ENV"
- run: dart pub get
- run: dart pub publish --force
workflows:
release:
jobs:
- publish:
filters:
tags: { only: /^v.*/ }
branches: { ignore: /.*/ }- circleci run oidc get --aud https://dartastic.io 명령은 이 audience에 대한 토큰을 작업에 제공합니다. CircleCI가 자동으로 설정하는 토큰은 audience가 조직 ID이므로 거부됩니다.
- SSH로 다시 실행한 작업은 거부됩니다. 셸에 접속한 사람이 토큰을 가져갈 수 있기 때문입니다. SSH 없이 다시 실행하세요.
거부될 때
작업 로그에 TRUSTED PUBLISHER REF MISMATCH 같은 이유가 맨 앞에 표시됩니다. 모든 이유와 조치 방법은 CI에서 Pub 사용하기에 있습니다. CircleCI 자체의 토큰 안내는 공식 문서에서 볼 수 있습니다.