CI에서 Pub 사용하기
CI는 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 CI 공급자가 발급한 ID 토큰으로 자신이 어느 저장소인지 증명하고, 15분 동안 유효한 Pub 토큰을 받습니다.
작동 방식
- 저장소를 바인딩합니다. Control Room에서 Organization 화면을 열고 CI access 항목을 찾으세요. Bind a repository 버튼으로 어느 저장소의 CI 실행이 조직을 대신해 작업할지 지정하며, 원하면 특정 워크플로, 환경, 브랜치로 제한할 수 있습니다. 바인딩은 소유자나 관리자가 합니다.
- 패키지를 부여합니다. 각 바인딩은 조직의 CI 멤버입니다. 바인딩의 Packages 버튼으로, 팀원에게 하는 것과 똑같이 패키지의 읽기 권한 또는 읽기 및 게시 권한을 부여합니다. 부여한 패키지가 없으면 전역 패키지와 조직의 엔진(있는 경우)만 읽고, 아무것도 게시하지 않습니다. 바인딩을 삭제하면 해당 멤버와 부여된 모든 권한이 함께 삭제됩니다.
- 작업에서 교환합니다. 작업은 대상(audience)
https://dartastic.io값으로 ID 토큰을 요청하고, 같은 Organization 화면에 있는 조직 ID와 함께 교환 엔드포인트로 보냅니다. - Pub 토큰을 사용합니다.
dart pub token add명령이 토큰을dart pub get및dart pub publish명령에 전달합니다(flutter pub명령도 같은 방식으로 동작합니다).
CI 공급자
| 공급자 | 바인딩 전 준비 사항 |
|---|---|
| GitHub Actions | GitHub.com은 이미 신뢰할 수 있는 발급자로 등록되어 있습니다. GitHub Enterprise Server를 사용한다면 소유자가 그 발급자(https://<your host>/_services/token)를 이 조직의 자체 발급자로 추가하세요. |
| GitLab CI/CD | GitLab.com은 이미 신뢰할 수 있는 발급자로 등록되어 있습니다. 자체 관리형 GitLab을 사용한다면 소유자가 그 주소(https://<your host>)를 이 조직의 자체 발급자로 추가하세요. |
| Bitbucket Pipelines | Bitbucket 워크스페이스마다 고유한 발급자가 있으므로 먼저 소유자가 이를 추가해야 합니다. “CI access”의 “This organization's own CI issuers”에서 “Bitbucket Pipelines”를 선택하고 워크스페이스의 URL 이름을 입력하세요. |
| CircleCI | CircleCI 조직마다 고유한 발급자가 있으므로 먼저 소유자가 이를 추가해야 합니다. “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 RERUN | SSH로 다시 실행한 CircleCI 작업입니다. SSH 없이 다시 실행하세요. |
CI EXCHANGE RATE LIMITED | 짧은 시간에 이 저장소나 조직의 교환 요청이 너무 많습니다. 작업마다 한 번만 교환하고, 잠시 기다린 뒤 다시 시도하세요. |
BOX STATE PUSH FAILED | 레지스트리가 새 토큰을 받지 못했습니다. 작업을 다시 실행하세요. |