從Bitbucket Pipelines使用Pub
Bitbucket Pipelines作業不需儲存任何密鑰,就能讀取及發布您的私有套件:每個作業將自己的身分識別權杖交換為有效期15分鐘的Pub權杖。各供應商的運作方式請參閱從CI使用Pub。
1. 信任簽發者
每個Bitbucket工作區都有自己的簽發者,因此請由擁有者先新增:在「CI access」的「This organization's own CI issuers」下,選擇Bitbucket Pipelines,並輸入工作區的網址名稱。
[TODO:「This organization's own CI issuers」,已選擇Bitbucket Pipelines並輸入工作區的螢幕截圖]
2. 繫結存放庫
在Control Room中開啟Organization,然後依序選擇CI access、Bind a repository,再選擇Bitbucket Pipelines。表單會要求填寫:
- Repository UUID: 在Bitbucket的「Repository settings」中的「OpenID Connect」:存放庫的UUID,包含大括號。
- Workspace UUID: 同一頁面上:工作區的UUID。
- Deployment environment UUID, optional: 同一頁面上,適用於含有deployment:的步驟。該環境的部署權限會把關每一次交換。
- Ref pattern, optional: 分支:refs/heads/main。Bitbucket的權杖只會指明分支,從不指明標籤。
接著透過繫結的Packages按鈕授予其套件權限:讀取,或讀取並發布。
[TODO:Bitbucket的「Repository settings」中的「OpenID Connect」頁面,顯示存放庫和工作區的UUID的螢幕截圖]
[TODO:「Bind a repository」視窗,已選擇Bitbucket簽發者並填入UUID的螢幕截圖]
3. 在作業中交換
將您的組織ID(位於同一個「Organization」畫面)放入DARTASTIC_ORG_ID。這個作業會發布套件;若作業只需讀取,請移除dart pub publish,並只授予該繫結讀取權限。
yaml
# bitbucket-pipelines.yml: publish from main
image: dart:stable
pipelines:
branches:
main:
- step:
name: Publish
deployment: production # optional: bind the environment too
oidc: true
script:
- export DARTASTIC_ORG_ID="<your organization id>"
- 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 $BITBUCKET_STEP_OIDC_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
options:
oidc:
audiences:
- https://dartastic.io- 步驟上的oidc: true會提供$BITBUCKET_STEP_OIDC_TOKEN,而oidc:下的audiences清單會將其對象設為https://dartastic.io。
- Bitbucket的權杖只以UUID指明存放庫,因此繫結需要填入UUID。
遭拒時
作業的記錄會先顯示原因,例如TRUSTED PUBLISHER REF MISMATCH。所有原因及處理方式請參閱從CI使用Pub。Bitbucket Pipelines本身的權杖指南請參閱其文件。