從CircleCI使用Pub
CircleCI作業不需儲存任何密鑰,就能讀取及發布您的私有套件:每個作業將自己的身分識別權杖交換為有效期15分鐘的Pub權杖。各供應商的運作方式請參閱從CI使用Pub。
1. 信任簽發者
每個CircleCI組織都有自己的簽發者,因此請由擁有者先新增:在「CI access」的「This organization's own CI issuers」下,選擇CircleCI,並輸入組織ID。
[TODO:「This organization's own CI issuers」,已選擇CircleCI並輸入組織ID的螢幕截圖]
2. 繫結存放庫
在Control Room中開啟Organization,然後依序選擇CI access、Bind a repository,再選擇CircleCI。表單會要求填寫:
- Project ID: 在CircleCI的「Project Settings」中的「Overview」。
- Organization ID, optional: 「Organization Settings」中的「Overview」。未填寫時,會從簽發者讀取。
- Context ID, optional: 作業必須使用的context(「Organization Settings」中的「Contexts」)。其安全性群組會把關每一次交換。
- Ref pattern, optional: 分支或標籤:refs/tags/v*或refs/heads/main。
接著透過繫結的Packages按鈕授予其套件權限:讀取,或讀取並發布。
[TODO:「Bind a repository」視窗,已選擇CircleCI簽發者並填入專案ID的螢幕截圖]
3. 在作業中交換
將您的組織ID(位於同一個「Organization」畫面)放入DARTASTIC_ORG_ID。這個作業會發布套件;若作業只需讀取,請移除dart pub publish,並只授予該繫結讀取權限。
yaml
# .circleci/config.yml: publish on a version tag
version: 2.1
jobs:
publish:
docker:
- image: dart:stable
environment:
DARTASTIC_ORG_ID: <your organization id>
steps:
- checkout
- run: apt-get update -qq && apt-get install -y -qq jq
- run:
name: Exchange this job's identity for a 15-minute Pub token
command: |
OIDC=$(circleci run oidc get --aud https://dartastic.io)
RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
-H "Authorization: Bearer $OIDC" -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
echo "export PUB_TOKEN=$PUB_TOKEN" >> "$BASH_ENV"
- run: dart pub get
- run: dart pub publish --force
workflows:
release:
jobs:
- publish:
filters:
tags: { only: /^v.*/ }
branches: { ignore: /.*/ }- circleci run oidc get --aud https://dartastic.io會給作業一個以此為對象的權杖。CircleCI自動設定的權杖以您的組織ID為對象,因此會被拒絕。
- 以SSH重新執行的作業會被拒絕:在shell中的人可能取得其權杖。請不使用SSH再執行一次。
遭拒時
作業的記錄會先顯示原因,例如TRUSTED PUBLISHER REF MISMATCH。所有原因及處理方式請參閱從CI使用Pub。CircleCI本身的權杖指南請參閱其文件。