在CircleCI中使用Pub
CircleCI作业无需存储任何密钥即可读取和发布您的私有package:每个作业用自己的身份令牌交换一个有效期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: 作业必须使用的上下文(“Organization Settings”的“Contexts”)。此后每次交换都受其安全组约束。
- Ref pattern, optional: 分支或标签:refs/tags/v*或refs/heads/main。
然后通过该绑定的Packages按钮为它授予package:读取,或读取和发布。
[TODO:“Bind a repository”对话框,已选择CircleCI颁发者并填入项目ID的屏幕截图]
3. 在作业中交换令牌
将您的组织ID(在同一个“Organization”页面上)填入DARTASTIC_ORG_ID。此作业会发布package;若作业只需读取,请删除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关于其令牌的官方指南见其文档。