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

CircleCI에서 Pub 사용하기

CircleCI 작업은 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 자체 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. 발급자 신뢰 설정

CircleCI 조직마다 고유한 발급자가 있으므로 먼저 소유자가 이를 추가해야 합니다. “CI access”의 “This organization's own CI issuers”에서 “CircleCI”를 선택하고 조직 ID를 입력하세요.

[TODO: “CircleCI”를 선택하고 조직 ID를 입력한 “This organization's own CI issuers” 스크린샷]

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

[TODO: CircleCI 발급자를 선택하고 프로젝트 ID를 입력한 “Bind a repository” 창 스크린샷]

3. 작업에서 교환

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

yaml
# .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 자체의 토큰 안내는 공식 문서에서 볼 수 있습니다.