Estas páginas mostram as URLs do Cloud. Faça login no Dedicated e elas passam a mostrar as do seu servidor.

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.

BUILDARQUITETURA DARTASTICUSUÁRIOStokensissuestoken do Pubpushtroca na CIos apps chegam aos usuários: lojas de apps, a web, servidoressímboloscrashesstack tracescódigo-fontetelemetriaComputador do desenvolvedorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcriação de tokens · controle de acesso por papéisPlano de controleorganizações · papéis · tokensDartastic Pubpackages · código-fonteObservatorysessões · traces · logsSymbolizercrashes → linhas do código-fonteDartastic AIrespostas a partir dos doisIssue trackerGitHub · Jira · LinearApps mobile e desktopcelulares · tablets · desktopsenvia com um token OTLPApps webem navegadoresenvia com um token Browser OTLPServidores Dartbackends · serviçosenvia com um token OTLP

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.

[TODO: captura de tela de a janela “Bind a repository” com GitHub Actions escolhido e acme/app preenchido]

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.

yaml
# .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.
[TODO: captura de tela de uma execução do GitHub Actions cuja etapa de troca deu certo, seguida de dart pub publish]

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.