Pub depuis GitHub Actions
Les jobs GitHub Actions lisent et publient vos packages privés sans aucun secret stocké : chaque job échange son propre jeton d’identité contre un jeton Pub valable 15 minutes. Le fonctionnement, quel que soit le fournisseur, est décrit dans Pub depuis la CI.
1. Faire confiance à l’émetteur
GitHub.com est déjà approuvé. Pour GitHub Enterprise Server, un propriétaire ajoute son émetteur, https://<your host>/_services/token, comme émetteur propre à cette organisation.
2. Lier le dépôt
Dans le Control Room, ouvrez Organization, puis CI access, Bind a repository, et choisissez GitHub Actions. Le formulaire demande :
- Repository : owner/name, comme dans l’URL du dépôt : acme/app.
- Owner : l’utilisateur ou l’organisation propriétaire du dépôt : acme.
- Workflow file, optional : le workflow autorisé à publier : .github/workflows/release.yml. Un workflow réutilisable d’un autre dépôt s’écrit owner/repo/.github/workflows/<file>.yml.
- Environment name, optional : un environnement GitHub dans lequel s’exécute le job, comme release. Ses règles de protection conditionnent alors chaque échange.
- Ref pattern, optional : une ref de branche, de tag ou de pull request : refs/tags/v* ou refs/heads/main.
Accordez ensuite ses packages à la liaison avec son bouton Packages : lecture, ou lecture et publication.
3. Faire l’échange dans le job
Placez l’identifiant de votre organisation, présent sur le même écran « Organization », dans DARTASTIC_ORG_ID. Ce job publie ; pour un job qui ne fait que lire, retirez dart pub publish et accordez la lecture seule à la liaison.
# .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- Le workflow a besoin de permissions: id-token: write, sinon GitHub ne donne au job aucun jeton à échanger.
- Demandez le jeton avec l’audience https://dartastic.io : c’est ce que fait l’appel ACTIONS_ID_TOKEN_REQUEST_URL de l’extrait.
- ::add-mask:: garde le jeton Pub hors du log du job.
En cas de refus
Le log du job affiche d’abord la raison, par exemple TRUSTED PUBLISHER REF MISMATCH. Chaque raison et ce qu’il faut faire figurent dans Pub depuis la CI. Le guide de GitHub Actions sur ses propres jetons se trouve dans sa documentation.