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

Pub depuis la CI

Votre CI lit et publie vos packages privés sans aucun secret stocké. Chaque job prouve de quel dépôt il provient avec le jeton d’identité de son fournisseur de CI et obtient un jeton Pub valable 15 minutes.

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

Fonctionnement

  1. Liez le dépôt. Dans le Control Room, ouvrez Organization et trouvez CI access. Bind a repository indique le dépôt dont les exécutions de CI agissent pour votre organisation, éventuellement limitées à un workflow, un environnement ou une branche. C’est un propriétaire ou un administrateur qui fait la liaison.
  2. Accordez-lui des packages. Chaque liaison est un membre CI de votre organisation. Son bouton Packages lui accorde des packages en lecture, ou en lecture et publication, exactement comme pour un coéquipier. Sans autorisation, il lit les packages globaux et le moteur de votre organisation, s’il en a un, et ne publie rien. Supprimer la liaison supprime le membre et tout ce qui lui avait été accordé.
  3. Faites l’échange dans le job. Le job demande son jeton d’identité pour l’audience https://dartastic.io et l’envoie à l’échange avec l’identifiant de votre organisation, qui figure sur le même écran « Organization ».
  4. Utilisez le jeton Pub. dart pub token add le transmet à dart pub get et à dart pub publish (flutter pub fonctionne de la même façon).

Votre fournisseur de CI

FournisseurAvant la liaison
GitHub ActionsGitHub.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.
GitLab CI/CDGitLab.com est déjà approuvé. Pour un GitLab autogéré, un propriétaire ajoute son adresse, https://<your host>, comme émetteur propre à cette organisation.
Bitbucket PipelinesChaque 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.
CircleCIChaque 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.

L’échange

Le job envoie son jeton d’identité comme jeton bearer et l’identifiant de votre organisation dans le corps :

shell
curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
  -H "Authorization: Bearer $CI_TOKEN" -H "Content-Type: application/json" \
  -d '{"orgId":"<your organization id>"}'

La réponse contient le jeton Pub et ce qu’il permet de faire :

json
{
  "token": "dtc_…",                 // the Pub token, valid for 15 minutes
  "keyId": "…",
  "organizationId": "<your organization id>",
  "packages": ["my_package"],       // what it may publish ([] when it only reads)
  "packageAccess": { … },           // what it may read
  "expiresAt": 1767225600           // seconds since 1970
}
  • Chaque jeton d’identité ne s’échange qu’une fois. Faites l’échange une fois par job, au début, et gardez le jeton Pub pour les étapes suivantes du job.
  • Le jeton Pub lit les packages globaux, le moteur de votre organisation s’il en a un, et chaque package accordé au membre CI, et publie ceux pour lesquels la publication est accordée. Il ne peut rien faire d’autre.
  • Chaque échange figure dans le journal d’audit de votre organisation, avec le dépôt, l’exécution et le commit.

Quand l’échange refuse

Un refus indique d’abord sa raison, pour que le log du job l’affiche telle quelle :

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
RaisonQue faire
CI EXCHANGE ORG MISSINGLa requête ne nommait aucune organisation. Envoyez {"orgId": "<your organization id>"} comme corps de la requête.
CI OIDC TOKEN MISSINGLa requête ne contenait aucun jeton CI. Envoyez-le sous la forme Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDLe jeton a été demandé pour une autre audience. Demandez-le pour https://dartastic.io, comme le fait l’extrait.
CI OIDC ISSUER NOT TRUSTEDL’émetteur du jeton n’est pas approuvé pour cette organisation. Pour Bitbucket, CircleCI, GitHub Enterprise Server ou un GitLab autogéré, un propriétaire ajoute d’abord l’émetteur.
CI OIDC EXPIREDLe jeton a expiré avant d’être échangé. Échangez-le dès que le job le demande.
CI OIDC TOKEN REPLAYEDCe jeton a déjà été échangé. Chaque jeton ne s’échange qu’une fois : faites un seul échange par job.
TRUSTED PUBLISHER NOT BOUNDAucune liaison de cette organisation ne nomme le dépôt du job. Liez-le dans « CI access », et vérifiez orgId dans le workflow.
TRUSTED PUBLISHER REPOSITORY MISMATCHLa liaison nomme un autre dépôt ou projet. Les UUID et les ID doivent être ceux du job.
TRUSTED PUBLISHER WORKFLOW MISMATCHLe job s’est exécuté depuis un autre fichier de workflow ou de pipeline que celui autorisé par la liaison.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHLe job ne s’est pas exécuté dans l’environnement de la liaison (ou, sur CircleCI, n’a pas utilisé son contexte).
TRUSTED PUBLISHER REF MISMATCHLe job s’est exécuté sur une branche ou un tag que le motif de ref de la liaison ne couvre pas.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHLe dépôt a été supprimé puis recréé sous le même nom. Supprimez la liaison et liez le nouveau dépôt.
TRUSTED PUBLISHER AMBIGUOUSPlusieurs liaisons correspondent au job. Restreignez-les (workflow, environnement ou ref) pour qu’une seule corresponde.
CI OIDC CLAIM MISSINGIl manque au jeton une revendication que le fournisseur envoie toujours. Vérifiez que le jeton est bien le jeton CI du fournisseur, demandé comme dans l’extrait.
CI OIDC SSH RERUNUn job CircleCI relancé avec SSH. Relancez-le sans SSH.
CI EXCHANGE RATE LIMITEDTrop d’échanges pour ce dépôt ou cette organisation en peu de temps. Faites un seul échange par job, puis attendez et réessayez.
BOX STATE PUSH FAILEDLe registre n’a pas reçu le nouveau jeton. Relancez le job.