Ces pages affichent les URL de Cloud. Connectez-vous sur Dedicated et elles affichent celles de votre serveur.

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.

BUILDARCHITECTURE DARTASTICUTILISATEURSjetonsticketsjeton Pubpushéchange CIles applis sont livrées aux utilisateurs : stores d’applications, web, serveurssymbolescrashspiles d’appelscode sourcetélémétriePoste développeurflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcréation de jetons · contrôle d’accès par rôlePlan de contrôleorganisations · rôles · jetonsDartastic Pubpackages · code sourceObservatorysessions · traces · logsSymbolizercrashs → lignes de codeDartastic AIrépond à partir des deuxSuivi des ticketsGitHub · Jira · LinearApplis mobiles + bureautéléphones · tablettes · ordinateursenvoie avec un jeton OTLPApplis webdans les navigateursenvoie avec un jeton Browser OTLPServeurs Dartbackends · servicesenvoie avec un jeton OTLP

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.

[TODO : capture d’écran de la fenêtre « Bind a repository » avec GitHub Actions choisi et acme/app renseigné]

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.

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
  • 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.
[TODO : capture d’écran de une exécution GitHub Actions dont l’étape d’échange a réussi, suivie de dart pub publish]

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.