從GitLab CI/CD使用Pub
GitLab CI/CD作業不需儲存任何密鑰,就能讀取及發布您的私有套件:每個作業將自己的身分識別權杖交換為有效期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按鈕授予其套件權限:讀取,或讀取並發布。
[TODO:「Bind a repository」視窗,已選擇GitLab CI/CD並填入acme/mobile/app的螢幕截圖]
3. 在作業中交換
將您的組織ID(位於同一個「Organization」畫面)放入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:一個GitLab管線作業,交換成功,接著執行dart pub publish的螢幕截圖]
遭拒時
作業的記錄會先顯示原因,例如TRUSTED PUBLISHER REF MISMATCH。所有原因及處理方式請參閱從CI使用Pub。GitLab CI/CD本身的權杖指南請參閱其文件。