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.
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.
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.
# .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.
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.