在Bitbucket Pipelines中使用Pub
Bitbucket Pipelines作业无需存储任何密钥即可读取和发布您的私有package:每个作业用自己的身份令牌交换一个有效期15分钟的Pub令牌。各提供商的工作原理请参阅在CI中使用Pub。
1. 信任颁发者
每个Bitbucket工作区都有自己的颁发者,因此需由所有者先添加:在“CI access”的“This organization's own CI issuers”下,选择Bitbucket Pipelines并输入工作区的URL名称。
[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按钮为它授予package:读取,或读取和发布。
[TODO:Bitbucket“Repository settings”中的“OpenID Connect”页面,显示仓库和工作区的UUID的屏幕截图]
[TODO:“Bind a repository”对话框,已选择Bitbucket颁发者并填入UUID的屏幕截图]
3. 在作业中交换令牌
将您的组织ID(在同一个“Organization”页面上)填入DARTASTIC_ORG_ID。此作业会发布package;若作业只需读取,请删除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:下的受众列表将其受众设为https://dartastic.io。
- Bitbucket的令牌只通过UUID标识仓库,因此绑定使用UUID。
被拒绝时
作业日志会首先显示原因,例如TRUSTED PUBLISHER REF MISMATCH。所有原因及处理方法请参阅在CI中使用Pub。Bitbucket Pipelines关于其令牌的官方指南见其文档。