Pub da CircleCI
I job di CircleCI 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
Ogni organizzazione CircleCI ha il proprio emittente, quindi un proprietario lo aggiunge per primo: in « CI access », sotto « This organization's own CI issuers », scelga CircleCI e inserisca l’ID dell’organizzazione.
2. Associare il repository
Nella Control Room, apra Organization, poi CI access, Bind a repository, e scelga CircleCI. Il modulo chiede:
- Project ID: in CircleCI, « Project Settings », « Overview ».
- Organization ID, optional: « Organization Settings », « Overview ». Se omesso, viene ricavato dall’emittente.
- Context ID, optional: un context che il job deve usare (« Organization Settings », « Contexts »). I suoi gruppi di sicurezza 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.
# .circleci/config.yml: publish on a version tag
version: 2.1
jobs:
publish:
docker:
- image: dart:stable
environment:
DARTASTIC_ORG_ID: <your organization id>
steps:
- checkout
- run: apt-get update -qq && apt-get install -y -qq jq
- run:
name: Exchange this job's identity for a 15-minute Pub token
command: |
OIDC=$(circleci run oidc get --aud https://dartastic.io)
RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
-H "Authorization: Bearer $OIDC" -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
echo "export PUB_TOKEN=$PUB_TOKEN" >> "$BASH_ENV"
- run: dart pub get
- run: dart pub publish --force
workflows:
release:
jobs:
- publish:
filters:
tags: { only: /^v.*/ }
branches: { ignore: /.*/ }- circleci run oidc get --aud https://dartastic.io dà al job un token per questa audience. I token che CircleCI imposta da sé hanno come audience l’ID della sua organizzazione, quindi vengono rifiutati.
- Un job rieseguito con SSH viene rifiutato: una persona alla shell potrebbe impossessarsi del suo token. Lo esegua di nuovo senza SSH.
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 CircleCI ai propri token si trova nella sua documentazione.