이 페이지에는 Cloud의 URL이 표시됩니다. Dedicated에서 로그인하면 귀사 서버의 URL이 표시됩니다.

GitHub Actions에서 Pub 사용하기

GitHub Actions 작업은 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 자체 ID 토큰을 15분 동안 유효한 Pub 토큰으로 교환합니다. 모든 공급자에 공통인 작동 방식은 CI에서 Pub 사용하기에서 설명합니다.

빌드DARTASTIC 아키텍처사용자토큰이슈Pub 토큰pushCI 토큰 교환앱 배포: 앱 스토어, 웹, 서버심볼크래시스택 트레이스소스 코드텔레메트리개발자 컴퓨터flutter run · dart pub getCIGitHub Actions, GitLab, …Control Room토큰 발급 · 역할 기반 접근 제어컨트롤 플레인조직 · 역할 · 토큰Dartastic Pub패키지 · 소스 코드Observatory세션 · 트레이스 · 로그Symbolizer크래시 → 소스 코드 줄Dartastic AI양쪽 데이터로 답변이슈 트래커GitHub · Jira · Linear모바일 + 데스크톱 앱휴대폰 · 태블릿 · 데스크톱OTLP 토큰으로 전송웹 앱브라우저에서 실행Browser OTLP 토큰으로 전송Dart 서버백엔드 · 서비스OTLP 토큰으로 전송

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 버튼으로 패키지를 부여하세요: 읽기, 또는 읽기와 게시.

[TODO: GitHub Actions를 선택하고 acme/app 값을 입력한 “Bind a repository” 창 스크린샷]

3. 작업에서 교환

같은 Organization 화면에 있는 조직 ID를 DARTASTIC_ORG_ID 변수에 넣으세요. 이 작업은 게시까지 합니다. 읽기만 하는 작업이라면 dart pub publish 단계를 빼고, 바인딩에 읽기 권한만 부여하세요.

yaml
# .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 토큰이 작업 로그에 남지 않습니다.
[TODO: 교환 단계가 성공한 뒤 dart pub publish 명령이 실행된 GitHub Actions 실행 화면 스크린샷]

거부될 때

작업 로그에 TRUSTED PUBLISHER REF MISMATCH 같은 이유가 맨 앞에 표시됩니다. 모든 이유와 조치 방법은 CI에서 Pub 사용하기에 있습니다. GitHub Actions 자체의 토큰 안내는 공식 문서에서 볼 수 있습니다.