Pub từ GitHub Actions
Job GitHub Actions đọc và xuất bản package riêng tư mà không cần lưu secret: mỗi job trao đổi token danh tính của chính nó lấy một token Pub có hiệu lực 15 phút. Cách hoạt động trên mọi nhà cung cấp có trong Pub từ CI.
1. Tin cậy bên phát hành
GitHub.com đã được tin cậy sẵn. Với GitHub Enterprise Server, một chủ sở hữu thêm bên phát hành của nó, https://<your host>/_services/token, làm bên phát hành riêng của tổ chức này.
2. Liên kết kho mã
Trong Control Room, mở “Organization”, rồi “CI access”, “Bind a repository”, và chọn GitHub Actions. Biểu mẫu yêu cầu:
- Repository: owner/name, như trong URL của repository: acme/app.
- Owner: người dùng hoặc tổ chức sở hữu repository: acme.
- Workflow file, optional: workflow được phép xuất bản: .github/workflows/release.yml. Một workflow tái sử dụng trong repository khác là owner/repo/.github/workflows/<file>.yml.
- Environment name, optional: một environment GitHub mà job chạy trong đó, chẳng hạn release. Khi đó, các quy tắc bảo vệ của environment kiểm soát mọi lần trao đổi.
- Ref pattern, optional: một ref của branch, tag hoặc pull request: refs/tags/v* hoặc refs/heads/main.
Sau đó cấp package cho liên kết bằng nút “Packages”: đọc, hoặc đọc và xuất bản.
3. Trao đổi trong job
Đặt ID tổ chức của bạn, lấy từ cùng màn hình “Organization”, vào DARTASTIC_ORG_ID. Job này xuất bản; với job chỉ đọc, bỏ dart pub publish và chỉ cấp quyền đọc cho liên kết.
# .github/workflows/publish.yml: publish on a version tag
on:
push:
tags: ['v*']
permissions:
contents: read
id-token: write # lets the job request its OIDC token
jobs:
publish:
runs-on: ubuntu-latest
environment: release # optional: bind the environment too, so its reviewers gate publishing
env:
DARTASTIC_ORG_ID: <your organization id>
steps:
- uses: actions/checkout@v4
- uses: dart-lang/setup-dart@v1
- name: Exchange this job's identity for a 15-minute Pub token
run: |
set -euo pipefail
OIDC=$(curl -sS --fail-with-body \
-H "Authorization: Bearer $ACTIONS_ID_TOKEN_REQUEST_TOKEN" \
"$ACTIONS_ID_TOKEN_REQUEST_URL&audience=https://dartastic.io" | jq -er .value)
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 "::add-mask::$PUB_TOKEN"
echo "PUB_TOKEN=$PUB_TOKEN" >> "$GITHUB_ENV"
- run: dart pub get
- run: dart pub publish --force- Workflow cần permissions: id-token: write, nếu không GitHub không cấp cho job token nào để trao đổi.
- Yêu cầu token với audience https://dartastic.io: lệnh gọi ACTIONS_ID_TOKEN_REQUEST_URL trong đoạn mã làm việc đó.
- ::add-mask:: giữ token Pub ngoài log của job.
Khi bị từ chối
Log của job hiển thị lý do trước tiên, chẳng hạn TRUSTED PUBLISHER REF MISMATCH. Mọi lý do và cách xử lý có trong Pub từ CI. Hướng dẫn riêng của GitHub Actions về token của họ có trong tài liệu của họ.