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

GitLab CI/CD에서 Pub 사용하기

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

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

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

3. 작업에서 교환

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

yaml
# .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에서 보호 대상으로 지정하세요. 그러면 메인테이너만 교환하는 실행을 시작할 수 있습니다.
[TODO: 교환이 성공한 뒤 dart pub publish 명령이 실행된 GitLab 파이프라인 작업 스크린샷]

거부될 때

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