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

CI에서 Pub 사용하기

CI는 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 CI 공급자가 발급한 ID 토큰으로 자신이 어느 저장소인지 증명하고, 15분 동안 유효한 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. 저장소를 바인딩합니다. Control Room에서 Organization 화면을 열고 CI access 항목을 찾으세요. Bind a repository 버튼으로 어느 저장소의 CI 실행이 조직을 대신해 작업할지 지정하며, 원하면 특정 워크플로, 환경, 브랜치로 제한할 수 있습니다. 바인딩은 소유자나 관리자가 합니다.
  2. 패키지를 부여합니다. 각 바인딩은 조직의 CI 멤버입니다. 바인딩의 Packages 버튼으로, 팀원에게 하는 것과 똑같이 패키지의 읽기 권한 또는 읽기 및 게시 권한을 부여합니다. 부여한 패키지가 없으면 전역 패키지와 조직의 엔진(있는 경우)만 읽고, 아무것도 게시하지 않습니다. 바인딩을 삭제하면 해당 멤버와 부여된 모든 권한이 함께 삭제됩니다.
  3. 작업에서 교환합니다. 작업은 대상(audience) https://dartastic.io 값으로 ID 토큰을 요청하고, 같은 Organization 화면에 있는 조직 ID와 함께 교환 엔드포인트로 보냅니다.
  4. Pub 토큰을 사용합니다. dart pub token add 명령이 토큰을 dart pub get 및 dart pub publish 명령에 전달합니다(flutter pub 명령도 같은 방식으로 동작합니다).

CI 공급자

공급자바인딩 전 준비 사항
GitHub ActionsGitHub.com은 이미 신뢰할 수 있는 발급자로 등록되어 있습니다. GitHub Enterprise Server를 사용한다면 소유자가 그 발급자(https://<your host>/_services/token)를 이 조직의 자체 발급자로 추가하세요.
GitLab CI/CDGitLab.com은 이미 신뢰할 수 있는 발급자로 등록되어 있습니다. 자체 관리형 GitLab을 사용한다면 소유자가 그 주소(https://<your host>)를 이 조직의 자체 발급자로 추가하세요.
Bitbucket PipelinesBitbucket 워크스페이스마다 고유한 발급자가 있으므로 먼저 소유자가 이를 추가해야 합니다. “CI access”의 “This organization's own CI issuers”에서 “Bitbucket Pipelines”를 선택하고 워크스페이스의 URL 이름을 입력하세요.
CircleCICircleCI 조직마다 고유한 발급자가 있으므로 먼저 소유자가 이를 추가해야 합니다. “CI access”의 “This organization's own CI issuers”에서 “CircleCI”를 선택하고 조직 ID를 입력하세요.

교환

작업은 ID 토큰을 Bearer 토큰으로, 조직 ID를 본문으로 보냅니다:

shell
curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
  -H "Authorization: Bearer $CI_TOKEN" -H "Content-Type: application/json" \
  -d '{"orgId":"<your organization id>"}'

응답에는 Pub 토큰과 그 토큰으로 할 수 있는 작업이 담겨 있습니다:

json
{
  "token": "dtc_…",                 // the Pub token, valid for 15 minutes
  "keyId": "…",
  "organizationId": "<your organization id>",
  "packages": ["my_package"],       // what it may publish ([] when it only reads)
  "packageAccess": { … },           // what it may read
  "expiresAt": 1767225600           // seconds since 1970
}
  • 각 ID 토큰은 한 번만 교환할 수 있습니다. 작업마다 시작할 때 한 번 교환하고, 받은 Pub 토큰을 이후 단계에서 계속 사용하세요.
  • Pub 토큰은 전역 패키지, 조직의 엔진(있는 경우), CI 멤버에게 부여된 모든 패키지를 읽을 수 있고, 게시 권한이 부여된 패키지를 게시할 수 있습니다. 그 밖의 작업은 할 수 없습니다.
  • 모든 교환은 저장소, 실행, 커밋 정보와 함께 조직의 “Audit Log”에 기록됩니다.

교환이 거부될 때

거부 응답은 이유를 맨 앞에 밝히므로 작업 로그에 그대로 표시됩니다:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
이유조치 방법
CI EXCHANGE ORG MISSING요청에 조직이 지정되지 않았습니다. 본문으로 {"orgId": "<your organization id>"} 값을 보내세요.
CI OIDC TOKEN MISSING요청에 CI 토큰이 없습니다. Authorization: Bearer <token> 형식으로 보내세요.
CI OIDC AUDIENCE INVALID토큰이 다른 audience로 요청되었습니다. 스니펫처럼 https://dartastic.io 값으로 요청하세요.
CI OIDC ISSUER NOT TRUSTED토큰 발급자가 이 조직에서 신뢰할 수 있는 발급자가 아닙니다. Bitbucket, CircleCI, GitHub Enterprise Server, 자체 관리형 GitLab은 먼저 소유자가 발급자를 추가해야 합니다.
CI OIDC EXPIRED교환하기 전에 토큰이 만료되었습니다. 작업이 토큰을 요청하면 바로 교환하세요.
CI OIDC TOKEN REPLAYED이미 교환된 토큰입니다. 토큰은 한 번만 교환할 수 있으므로 작업마다 한 번 교환하세요.
TRUSTED PUBLISHER NOT BOUND이 조직의 어떤 바인딩도 작업의 저장소를 지정하지 않습니다. “CI access”에서 저장소를 바인딩하고, 워크플로의 orgId 값을 확인하세요.
TRUSTED PUBLISHER REPOSITORY MISMATCH바인딩이 다른 저장소나 프로젝트를 지정하고 있습니다. UUID와 ID는 작업 자신의 값이어야 합니다.
TRUSTED PUBLISHER WORKFLOW MISMATCH바인딩이 허용하지 않는 워크플로 파일이나 파이프라인 파일에서 작업이 실행되었습니다.
TRUSTED PUBLISHER ENVIRONMENT MISMATCH작업이 바인딩의 환경에서 실행되지 않았습니다(CircleCI에서는 바인딩의 컨텍스트를 사용하지 않았습니다).
TRUSTED PUBLISHER REF MISMATCH바인딩의 ref 패턴과 일치하지 않는 브랜치나 태그에서 작업이 실행되었습니다.
TRUSTED PUBLISHER REPOSITORY ID MISMATCH저장소가 삭제된 뒤 같은 이름으로 다시 생성되었습니다. 바인딩을 제거하고 새 저장소를 바인딩하세요.
TRUSTED PUBLISHER AMBIGUOUS작업과 일치하는 바인딩이 둘 이상입니다. 정확히 하나만 일치하도록 범위(워크플로, 환경, ref)를 좁히세요.
CI OIDC CLAIM MISSING토큰에 제공자가 항상 보내는 클레임이 없습니다. 토큰이 해당 제공자의 CI 토큰이며 스니펫처럼 요청되었는지 확인하세요.
CI OIDC SSH RERUNSSH로 다시 실행한 CircleCI 작업입니다. SSH 없이 다시 실행하세요.
CI EXCHANGE RATE LIMITED짧은 시간에 이 저장소나 조직의 교환 요청이 너무 많습니다. 작업마다 한 번만 교환하고, 잠시 기다린 뒤 다시 시도하세요.
BOX STATE PUSH FAILED레지스트리가 새 토큰을 받지 못했습니다. 작업을 다시 실행하세요.