GitLab CI/CD에서 Pub 사용하기
GitLab CI/CD 작업은 저장된 시크릿 없이 비공개 패키지를 읽고 게시합니다. 각 작업은 자체 ID 토큰을 15분 동안 유효한 Pub 토큰으로 교환합니다. 모든 공급자에 공통인 작동 방식은 CI에서 Pub 사용하기에서 설명합니다.
1. 발급자 신뢰 설정
GitLab.com은 이미 신뢰할 수 있는 발급자로 등록되어 있습니다. 자체 관리형 GitLab을 사용한다면 소유자가 그 주소(https://<your host>)를 이 조직의 자체 발급자로 추가하세요.
2. 저장소 바인딩
Control Room에서 Organization, CI access, Bind a repository 순서로 연 뒤 GitLab CI/CD 항목을 선택하세요. 양식에서 다음 항목을 입력합니다:
- Project path: 중첩된 그룹을 포함한 프로젝트의 전체 경로: acme/mobile/app.
- Namespace path, optional: 프로젝트가 속한 그룹: acme/mobile. 비워 두면 프로젝트 경로에서 읽어 옵니다.
- Pipeline configuration file, optional: 게시가 허용된 설정 파일: .gitlab-ci.yml.
- Environment name, optional: 작업의 environment: 값(예: production). 그러면 보호된 환경 설정이 모든 교환을 통제합니다.
- Ref pattern, optional: 브랜치 또는 태그: refs/tags/v* 또는 refs/heads/main.
그런 다음 바인딩의 Packages 버튼으로 패키지를 부여하세요: 읽기, 또는 읽기와 게시.
3. 작업에서 교환
같은 Organization 화면에 있는 조직 ID를 DARTASTIC_ORG_ID 변수에 넣으세요. 이 작업은 게시까지 합니다. 읽기만 하는 작업이라면 dart pub publish 단계를 빼고, 바인딩에 읽기 권한만 부여하세요.
# .gitlab-ci.yml: publish on a version tag
publish:
image: dart:stable
rules:
- if: $CI_COMMIT_TAG =~ /^v/
environment: production # optional: bind the environment too
id_tokens:
DARTASTIC_ID_TOKEN:
aud: https://dartastic.io
variables:
DARTASTIC_ORG_ID: "<your organization id>"
script:
- apt-get update -qq && apt-get install -y -qq jq
- |
RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
-H "Authorization: Bearer $DARTASTIC_ID_TOKEN" -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
- dart pub get
- dart pub publish --force- id_tokens: 설정은 지정한 변수(여기서는 DARTASTIC_ID_TOKEN)에 aud: https://dartastic.io 값을 담은 토큰을 작업에 제공합니다.
- 게시에 쓰는 태그나 브랜치를 GitLab에서 보호 대상으로 지정하세요. 그러면 메인테이너만 교환하는 실행을 시작할 수 있습니다.
거부될 때
작업 로그에 TRUSTED PUBLISHER REF MISMATCH 같은 이유가 맨 앞에 표시됩니다. 모든 이유와 조치 방법은 CI에서 Pub 사용하기에 있습니다. GitLab CI/CD 자체의 토큰 안내는 공식 문서에서 볼 수 있습니다.