Pub desde GitHub Actions
Los jobs de GitHub Actions leen y publican sus paquetes privados sin ningún secreto guardado: cada job intercambia su propio token de identidad por un token de Pub que dura 15 minutos. Cómo funciona en cada proveedor se explica en Pub desde CI.
1. Confíe en el emisor
GitHub.com ya es de confianza. Para GitHub Enterprise Server, un propietario agrega su emisor, https://<your host>/_services/token, como emisor propio de esta organización.
2. Vincule el repositorio
En el Control Room, abra Organization, luego CI access, Bind a repository, y elija GitHub Actions. El formulario pide:
- Repository: owner/name, como en la URL del repositorio: acme/app.
- Owner: el usuario o la organización propietaria: acme.
- Workflow file, optional: el workflow autorizado a publicar: .github/workflows/release.yml. Un workflow reutilizable de otro repositorio se escribe owner/repo/.github/workflows/<file>.yml.
- Environment name, optional: un entorno de GitHub en el que se ejecuta el job, como release. Sus reglas de protección controlan entonces cada intercambio.
- Ref pattern, optional: una ref de rama, de etiqueta o de pull request: refs/tags/v* o refs/heads/main.
Luego otorgue a la vinculación sus paquetes con su botón Packages: lectura, o lectura y publicación.
3. Haga el intercambio en el job
Ponga el id de su organización, de la misma pantalla “Organization”, en DARTASTIC_ORG_ID. Este job publica; para uno que solo lee, quite dart pub publish y otorgue a la vinculación solo lectura.
# .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- El workflow necesita permissions: id-token: write; si no, GitHub no da al job ningún token que intercambiar.
- Solicite el token con la audiencia https://dartastic.io: la llamada a ACTIONS_ID_TOKEN_REQUEST_URL del fragmento lo hace.
- ::add-mask:: mantiene el token de Pub fuera del log del job.
Cuando se rechaza
El log del job muestra primero el motivo, como TRUSTED PUBLISHER REF MISMATCH. Cada motivo y qué hacer se explica en Pub desde CI. La guía de GitHub Actions sobre sus tokens está en su documentación.