GitHub Actions에서 Pub 사용하기
GitHub Actions 작업은 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 자체 ID 토큰을 15분 동안 유효한 Pub 토큰으로 교환합니다. 모든 공급자에 공통인 작동 방식은 CI에서 Pub 사용하기에서 설명합니다.
1. 발급자 신뢰 설정
GitHub.com은 이미 신뢰할 수 있는 발급자로 등록되어 있습니다. GitHub Enterprise Server를 사용한다면 소유자가 그 발급자(https://<your host>/_services/token)를 이 조직의 자체 발급자로 추가하세요.
2. 저장소 바인딩
Control Room에서 Organization, CI access, Bind a repository 순서로 연 뒤 GitHub Actions 항목을 선택하세요. 양식에서 다음 항목을 입력합니다:
- Repository: 저장소 URL에 나오는 owner/name 형식: acme/app.
- Owner: 저장소를 소유한 사용자 또는 조직: acme.
- Workflow file, optional: 게시가 허용된 워크플로: .github/workflows/release.yml. 다른 저장소에 있는 재사용 가능한 워크플로는 owner/repo/.github/workflows/<file>.yml 형식으로 씁니다.
- Environment name, optional: 작업이 실행되는 GitHub 환경(예: release). 그러면 그 환경의 보호 규칙이 모든 교환을 통제합니다.
- Ref pattern, optional: 브랜치, 태그 또는 pull request의 ref: refs/tags/v* 또는 refs/heads/main.
그런 다음 바인딩의 Packages 버튼으로 패키지를 부여하세요: 읽기, 또는 읽기와 게시.
3. 작업에서 교환
같은 Organization 화면에 있는 조직 ID를 DARTASTIC_ORG_ID 변수에 넣으세요. 이 작업은 게시까지 합니다. 읽기만 하는 작업이라면 dart pub publish 단계를 빼고, 바인딩에 읽기 권한만 부여하세요.
# .github/workflows/publish.yml: publish on a version tag
on:
push:
tags: ['v*']
permissions:
contents: read
id-token: write # lets the job request its OIDC token
jobs:
publish:
runs-on: ubuntu-latest
environment: release # optional: bind the environment too, so its reviewers gate publishing
env:
DARTASTIC_ORG_ID: <your organization id>
steps:
- uses: actions/checkout@v4
- uses: dart-lang/setup-dart@v1
- name: Exchange this job's identity for a 15-minute Pub token
run: |
set -euo pipefail
OIDC=$(curl -sS --fail-with-body \
-H "Authorization: Bearer $ACTIONS_ID_TOKEN_REQUEST_TOKEN" \
"$ACTIONS_ID_TOKEN_REQUEST_URL&audience=https://dartastic.io" | jq -er .value)
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 "::add-mask::$PUB_TOKEN"
echo "PUB_TOKEN=$PUB_TOKEN" >> "$GITHUB_ENV"
- run: dart pub get
- run: dart pub publish --force- 워크플로에 permissions: id-token: write 권한이 있어야 합니다. 없으면 GitHub가 작업에 교환할 토큰을 주지 않습니다.
- audience에 https://dartastic.io 값을 지정해 토큰을 요청하세요. 스니펫의 ACTIONS_ID_TOKEN_REQUEST_URL 호출이 이를 처리합니다.
- ::add-mask:: 설정으로 Pub 토큰이 작업 로그에 남지 않습니다.
거부될 때
작업 로그에 TRUSTED PUBLISHER REF MISMATCH 같은 이유가 맨 앞에 표시됩니다. 모든 이유와 조치 방법은 CI에서 Pub 사용하기에 있습니다. GitHub Actions 자체의 토큰 안내는 공식 문서에서 볼 수 있습니다.