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

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.

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

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.

[TODO: screenshot di « This organization's own CI issuers » con CircleCI scelto e un ID di organizzazione inserito]

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.

[TODO: screenshot di la finestra « Bind a repository » con l’emittente CircleCI scelto e un ID di progetto 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
# .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.