GitHub Actions'ta Pub
GitHub Actions işleri, özel paketlerinizi saklanmış bir secret olmadan okur ve yayımlar: her iş kendi kimlik token'ını 15 dakika geçerli bir Pub token'ıyla değiştirir. Her sağlayıcıda nasıl çalıştığı CI'da Pub sayfasında anlatılır.
1. Token verene (issuer) güvenin
GitHub.com zaten güvenilir kabul edilir. GitHub Enterprise Server için bir kuruluş sahibi, sunucunun veren (issuer) adresini, https://<your host>/_services/token, bu kuruluşun kendi vereni olarak ekler.
2. Depoyu bağlayın
Control Room'da Organization ekranını, ardından CI access ve Bind a repository seçeneklerini açın ve sağlayıcı olarak GitHub Actions seçin. Form şunları ister:
- Repository: owner/name, deponun URL'sindeki gibi: acme/app.
- Owner: depoya sahip olan kullanıcı veya kuruluş: acme.
- Workflow file, optional: yayımlamasına izin verilen workflow: .github/workflows/release.yml. Başka bir depodaki yeniden kullanılabilir bir workflow şöyle yazılır: owner/repo/.github/workflows/<file>.yml.
- Environment name, optional: job'ın çalıştığı bir GitHub environment'ı, örneğin release. Bu durumda her takası onun koruma kuralları denetler.
- Ref pattern, optional: bir branch, tag veya pull request ref'i: refs/tags/v* ya da refs/heads/main.
Ardından bağlamaya Packages düğmesiyle paket erişimi verin: okuma ya da okuma ve yayımlama.
3. Token değişimini işte yapın
Aynı “Organization” ekranındaki kuruluş ID'nizi DARTASTIC_ORG_ID değişkenine yazın. Bu iş yayımlama yapar; yalnızca okuyan bir iş için dart pub publish adımını çıkarın ve bağlamaya yalnızca okuma erişimi verin.
# .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'un permissions: id-token: write iznine ihtiyacı vardır; yoksa GitHub job'a takas edilecek bir token vermez.
- Token'ı https://dartastic.io audience değeriyle isteyin: Örnekteki ACTIONS_ID_TOKEN_REQUEST_URL çağrısı bunu yapar.
- ::add-mask::, Pub token'ını job'ın logunun dışında tutar.
Reddedildiğinde
İşin logu önce nedeni gösterir, örneğin TRUSTED PUBLISHER REF MISMATCH. Tüm nedenler ve ne yapılacağı CI'da Pub sayfasında. GitHub Actions sağlayıcısının token'larıyla ilgili kendi rehberi kendi dokümantasyonunda bulunur.