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

Pub depuis Bitbucket Pipelines

Les jobs Bitbucket Pipelines 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 espace de travail Bitbucket a son propre émetteur : un propriétaire l’ajoute donc d’abord. Dans « CI access », sous « This organization’s own CI issuers », choisissez Bitbucket Pipelines et saisissez le nom d’URL de l’espace de travail.

[TODO : capture d’écran de « This organization’s own CI issuers » avec Bitbucket Pipelines choisi et un espace de travail saisi]

2. Lier le dépôt

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

  • Repository UUID : dans Bitbucket, Repository settings, OpenID Connect : l’UUID du dépôt, accolades comprises.
  • Workspace UUID : sur la même page : l’UUID de l’espace de travail.
  • Deployment environment UUID, optional : sur la même page, pour une étape avec deployment:. Ses autorisations de déploiement conditionnent alors chaque échange.
  • Ref pattern, optional : une branche : refs/heads/main. Le jeton de Bitbucket ne nomme qu’une branche, jamais un tag.

Accordez ensuite ses packages à la liaison avec son bouton Packages : lecture, ou lecture et publication.

[TODO : capture d’écran de la page Repository settings, OpenID Connect de Bitbucket, avec les UUID du dépôt et de l’espace de travail]
[TODO : capture d’écran de la fenêtre « Bind a repository » avec l’émetteur Bitbucket choisi et les UUID renseignés]

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
# bitbucket-pipelines.yml: publish from main
image: dart:stable
pipelines:
  branches:
    main:
      - step:
          name: Publish
          deployment: production   # optional: bind the environment too
          oidc: true
          script:
            - export DARTASTIC_ORG_ID="<your organization id>"
            - 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 $BITBUCKET_STEP_OIDC_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
options:
  oidc:
    audiences:
      - https://dartastic.io
  • oidc: true sur l’étape lui donne $BITBUCKET_STEP_OIDC_TOKEN, et la liste des audiences sous oidc: fixe son audience à https://dartastic.io.
  • Le jeton de Bitbucket ne désigne le dépôt que par son UUID : c’est pourquoi la liaison demande des UUID.

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