Pub no GitHub Actions
Os jobs do GitHub Actions leem e publicam seus packages privados sem nenhum segredo armazenado: cada job troca o próprio token de identidade por um token do Pub que dura 15 minutos. Como isso funciona em todos os provedores está em Pub na CI.
1. Confie no emissor
O GitHub.com já é confiável. Para o GitHub Enterprise Server, um proprietário adiciona o emissor dele, https://<your host>/_services/token, como emissor próprio desta organização.
2. Vincule o repositório
No Control Room, abra Organization, depois CI access, Bind a repository, e escolha GitHub Actions. O formulário pede:
- Repository: owner/name, como na URL do repositório: acme/app.
- Owner: o usuário ou a organização dona do repositório: acme.
- Workflow file, optional: o workflow com permissão para publicar: .github/workflows/release.yml. Um workflow reutilizável em outro repositório é owner/repo/.github/workflows/<file>.yml.
- Environment name, optional: um environment do GitHub em que o job roda, como release. As regras de proteção dele passam a controlar cada troca.
- Ref pattern, optional: uma ref de branch, tag ou pull request: refs/tags/v* ou refs/heads/main.
Depois, conceda packages ao vínculo com o botão Packages dele: leitura, ou leitura e publicação.
3. Faça a troca no job
Coloque o id da sua organização, da mesma tela Organization, em DARTASTIC_ORG_ID. Este job publica; para um que só lê, remova dart pub publish e conceda ao vínculo só leitura.
# .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- O workflow precisa de permissions: id-token: write; sem isso, o GitHub não dá ao job nenhum token para trocar.
- Solicite o token com a audiência https://dartastic.io: a chamada a ACTIONS_ID_TOKEN_REQUEST_URL no exemplo faz isso.
- ::add-mask:: mantém o token do Pub fora do log do job.
Quando é recusado
O log do job mostra o motivo primeiro, como TRUSTED PUBLISHER REF MISMATCH. Todos os motivos e o que fazer estão em Pub na CI. O guia do próprio GitHub Actions sobre seus tokens está na documentação dele.