Estas páginas muestran las URL de Cloud. Inicie sesión en Dedicated y muestran las de su servidor.

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.

DESARROLLOARQUITECTURA DE DARTASTICUSUARIOStokensticketstoken de Pubpushintercambio de CIlas apps llegan a los usuarios: tiendas de apps, la web, servidoressímboloscrashespilas de llamadascódigo fuentetelemetríaEquipo del desarrolladorflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcrear tokens · control de acceso por rolesPlano de controlorganizaciones · roles · tokensDartastic Pubpaquetes · código fuenteObservatorysesiones · trazas · logsSymbolizercrashes → líneas de códigoDartastic AIrespuestas a partir de ambosGestor de ticketsGitHub · Jira · LinearApps móviles y de escritorioteléfonos · tabletas · equiposenvía con un token OTLPApps weben navegadoresenvía con un token Browser OTLPServidores Dartbackends · serviciosenvía con un token OTLP

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.

[PENDIENTE: captura de pantalla de la ventana “Bind a repository” con GitHub Actions elegido y acme/app completado]

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.

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
  • 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.
[PENDIENTE: captura de pantalla de una ejecución de GitHub Actions cuyo paso de intercambio tuvo éxito, seguido de dart pub publish]

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.