Queste pagine mostrano gli URL di Cloud. Acceda su Dedicated e vedrà quelli del suo server.

Pub da GitLab CI/CD

I job di GitLab CI/CD leggono e pubblicano i suoi pacchetti privati senza alcun segreto memorizzato: ogni job scambia il proprio token di identità con un token Pub valido 15 minuti. Il funzionamento con ogni provider è spiegato in Pub dalla CI.

BUILDARCHITETTURA DARTASTICUTENTItokentickettoken Pubpushscambio CIle app arrivano agli utenti: app store, web, serversimbolicrashstack tracecodice sorgentetelemetriaComputer dello sviluppatoreflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcreazione di token · controllo degli accessi basato sui ruoliPiano di controlloorganizzazioni · ruoli · tokenDartastic Pubpacchetti · codice sorgenteObservatorysessioni · tracce · logSymbolizercrash → righe di codice sorgenteDartastic AIrisposte da entrambiSistema di ticketingGitHub · Jira · LinearApp mobile e desktoptelefoni · tablet · computerinvia con un token OTLPApp webnei browserinvia con un token Browser OTLPServer Dartbackend · serviziinvia con un token OTLP

1. Considerare attendibile l’emittente

GitLab.com è già considerato attendibile. Per un GitLab self-managed, un proprietario aggiunge il suo indirizzo, https://<your host>, come emittente proprio di questa organizzazione.

2. Associare il repository

Nella Control Room, apra Organization, poi CI access, Bind a repository, e scelga GitLab CI/CD. Il modulo chiede:

  • Project path: il percorso completo del progetto, compresi i gruppi annidati: acme/mobile/app.
  • Namespace path, optional: il gruppo che contiene il progetto: acme/mobile. Se omesso, viene ricavato dal percorso del progetto.
  • Pipeline configuration file, optional: la configurazione autorizzata a pubblicare: .gitlab-ci.yml.
  • Environment name, optional: il environment: di un job, come production. Gli ambienti protetti condizionano allora ogni scambio.
  • Ref pattern, optional: un branch o un tag: refs/tags/v* o refs/heads/main.

Poi conceda all’associazione i suoi pacchetti con il pulsante Packages: in lettura, o in lettura e pubblicazione.

[TODO: screenshot di la finestra « Bind a repository » con GitLab CI/CD scelto e acme/mobile/app inserito]

3. Eseguire lo scambio nel job

Inserisca l’ID della sua organizzazione, dalla stessa schermata « Organization », in DARTASTIC_ORG_ID. Questo job pubblica; per uno che legge soltanto, tolga dart pub publish e conceda all’associazione la sola lettura.

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: dà al job il suo token nella variabile indicata, qui DARTASTIC_ID_TOKEN, con aud: https://dartastic.io.
  • Contrassegni come protetti in GitLab i tag o i branch di pubblicazione, così solo i maintainer possono avviare un’esecuzione che effettua lo scambio.
[TODO: screenshot di un job di pipeline GitLab il cui scambio è riuscito, seguito da dart pub publish]

Quando viene rifiutato

Il log del job mostra per primo il motivo, ad esempio TRUSTED PUBLISHER REF MISMATCH. Ogni motivo e cosa fare sono spiegati in Pub dalla CI. La guida di GitLab CI/CD ai propri token si trova nella sua documentazione.