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

Pub depuis CircleCI

Les jobs CircleCI 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

Chaque organisation CircleCI a son propre émetteur : un propriétaire l’ajoute donc d’abord. Dans « CI access », sous « This organization’s own CI issuers », choisissez CircleCI et saisissez l’ID de l’organisation.

[TODO : capture d’écran de « This organization’s own CI issuers » avec CircleCI choisi et un ID d’organisation saisi]

2. Lier le dépôt

Dans le Control Room, ouvrez Organization, puis CI access, Bind a repository, et choisissez CircleCI. Le formulaire demande :

  • Project ID : dans CircleCI, Project Settings, Overview.
  • Organization ID, optional : Organization Settings, Overview. S’il est omis, il est déduit de l’émetteur.
  • Context ID, optional : un contexte que le job doit utiliser (Organization Settings, Contexts). Ses groupes de sécurité conditionnent alors chaque échange.
  • Ref pattern, optional : une branche ou un tag : 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 l’émetteur CircleCI choisi et un ID de projet 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
# .circleci/config.yml: publish on a version tag
version: 2.1
jobs:
  publish:
    docker:
      - image: dart:stable
    environment:
      DARTASTIC_ORG_ID: <your organization id>
    steps:
      - checkout
      - run: apt-get update -qq && apt-get install -y -qq jq
      - run:
          name: Exchange this job's identity for a 15-minute Pub token
          command: |
            OIDC=$(circleci run oidc get --aud https://dartastic.io)
            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 "export PUB_TOKEN=$PUB_TOKEN" >> "$BASH_ENV"
      - run: dart pub get
      - run: dart pub publish --force
workflows:
  release:
    jobs:
      - publish:
          filters:
            tags: { only: /^v.*/ }
            branches: { ignore: /.*/ }
  • circleci run oidc get --aud https://dartastic.io donne au job un jeton pour cette audience. Les jetons que CircleCI définit de lui-même portent l’ID de votre organisation comme audience : ils sont donc refusés.
  • Un job relancé avec SSH est refusé : une personne connectée au shell pourrait détenir son jeton. Relancez-le sans SSH.

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 CircleCI sur ses propres jetons se trouve dans sa documentation.