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

Pub depuis GitLab CI/CD

Les jobs GitLab CI/CD 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

GitLab.com est déjà approuvé. Pour un GitLab autogéré, un propriétaire ajoute son adresse, https://<your host>, 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 GitLab CI/CD. Le formulaire demande :

  • Project path : le chemin complet du projet, groupes imbriqués compris : acme/mobile/app.
  • Namespace path, optional : le groupe qui contient le projet : acme/mobile. S’il est omis, il est déduit du chemin du projet.
  • Pipeline configuration file, optional : la configuration autorisée à publier : .gitlab-ci.yml.
  • Environment name, optional : le environment: d’un job, comme production. Les environnements protégés 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 GitLab CI/CD choisi et acme/mobile/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
# .gitlab-ci.yml: publish on a version tag
publish:
  image: dart:stable
  rules:
    - if: $CI_COMMIT_TAG =~ /^v/
  environment: production   # optional: bind the environment too
  id_tokens:
    DARTASTIC_ID_TOKEN:
      aud: https://dartastic.io
  variables:
    DARTASTIC_ORG_ID: "<your organization id>"
  script:
    - apt-get update -qq && apt-get install -y -qq jq
    - |
      RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
        -H "Authorization: Bearer $DARTASTIC_ID_TOKEN" -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
    - dart pub get
    - dart pub publish --force
  • id_tokens: donne au job son jeton dans la variable que vous nommez, ici DARTASTIC_ID_TOKEN, avec aud: https://dartastic.io.
  • Marquez comme protégés dans GitLab les tags ou les branches de publication, pour que seuls les mainteneurs puissent lancer une exécution qui procède à l’échange.
[TODO : capture d’écran de un job de pipeline GitLab dont l’échange a réussi, suivi 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 GitLab CI/CD sur ses propres jetons se trouve dans sa documentation.