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