Pub dalla CI
La sua CI legge e pubblica i suoi pacchetti privati senza alcun segreto memorizzato. Ogni job dimostra da quale repository proviene con il token di identità del proprio provider CI e riceve un token Pub valido 15 minuti.
Come funziona
- Associ il repository. Nella Control Room, apra Organization e trovi CI access. Bind a repository indica per quale repository le esecuzioni CI agiscono per conto della sua organizzazione, facoltativamente solo da un workflow, un ambiente o un branch. L’associazione spetta a un proprietario o a un amministratore.
- Le conceda dei pacchetti. Ogni associazione è un membro CI della sua organizzazione. Il pulsante Packages dell’associazione le concede pacchetti in lettura, o in lettura e pubblicazione, esattamente come per un collega. Senza concessioni, l’associazione legge i pacchetti globali e il motore della sua organizzazione, se ne ha uno, e non pubblica nulla. Rimuovere l’associazione rimuove il membro e tutto ciò che le era stato concesso.
- Esegua lo scambio nel job. Il job richiede il proprio token di identità per l’audience
https://dartastic.ioe lo invia allo scambio con l’ID della sua organizzazione, che si trova nella stessa schermata « Organization ». - Usi il token Pub.
dart pub token addlo passa adart pub getedart pub publish(flutter pubfunziona allo stesso modo).
Il suo provider CI
| Provider | Prima di associare |
|---|---|
| GitHub Actions | GitHub.com è già considerato attendibile. Per GitHub Enterprise Server, un proprietario aggiunge il suo emittente, https://<your host>/_services/token, come emittente proprio di questa organizzazione. |
| GitLab CI/CD | 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. |
| Bitbucket Pipelines | Ogni workspace Bitbucket ha il proprio emittente, quindi un proprietario lo aggiunge per primo: in « CI access », sotto « This organization's own CI issuers », scelga Bitbucket Pipelines e inserisca il nome URL del workspace. |
| CircleCI | 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. |
Lo scambio
Il job invia il proprio token di identità come bearer token e l’ID della sua organizzazione nel corpo:
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 risposta contiene il token Pub e ciò che può fare:
{
"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
}- Ogni token di identità si scambia una sola volta. Esegua lo scambio una volta per job, all’inizio, e conservi il token Pub per i passaggi successivi del job.
- Il token Pub legge i pacchetti globali, il motore della sua organizzazione se ne ha uno, e ogni pacchetto concesso al membro CI, e pubblica quelli concessi in pubblicazione. Non può fare nient’altro.
- Ogni scambio compare nell’Audit Log della sua organizzazione, con il repository, l’esecuzione e il commit.
Quando lo scambio viene rifiutato
Un rifiuto indica per prima cosa il motivo, così il log del job lo mostra così com’è:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Motivo | Cosa fare |
|---|---|
CI EXCHANGE ORG MISSING | La richiesta non indicava alcuna organizzazione. Invii {"orgId": "<your organization id>"} come corpo. |
CI OIDC TOKEN MISSING | La richiesta non conteneva alcun token CI. Lo invii come Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | Il token è stato richiesto per un’altra audience. Lo richieda per https://dartastic.io, come fa lo snippet. |
CI OIDC ISSUER NOT TRUSTED | L’emittente del token non è considerato attendibile per questa organizzazione. Per Bitbucket, CircleCI, GitHub Enterprise Server o un GitLab self-managed, un proprietario deve prima aggiungere l’emittente. |
CI OIDC EXPIRED | Il token è scaduto prima di essere scambiato. Lo scambi appena il job lo richiede. |
CI OIDC TOKEN REPLAYED | Questo token è già stato scambiato. Ogni token si scambia una sola volta: esegua lo scambio una volta per job. |
TRUSTED PUBLISHER NOT BOUND | Nessuna associazione di questa organizzazione indica il repository del job. Lo associ in « CI access » e controlli il orgId nel workflow. |
TRUSTED PUBLISHER REPOSITORY MISMATCH | L’associazione indica un altro repository o progetto. Gli UUID e gli ID devono essere quelli del job. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | Il job è stato eseguito da un file di workflow o di pipeline diverso da quello consentito dall’associazione. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | Il job non è stato eseguito nell’ambiente dell’associazione (o, su CircleCI, non ha usato il suo context). |
TRUSTED PUBLISHER REF MISMATCH | Il job è stato eseguito su un branch o un tag che non corrisponde al ref pattern dell’associazione. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | Il repository è stato eliminato e ricreato con lo stesso nome. Rimuova l’associazione e associ il nuovo repository. |
TRUSTED PUBLISHER AMBIGUOUS | Più di un’associazione corrisponde al job. Le restringa (workflow, ambiente o ref) in modo che ne corrisponda esattamente una. |
CI OIDC CLAIM MISSING | Al token manca un’attestazione che il provider invia sempre. Verifichi che il token sia il token CI del provider, richiesto come fa lo snippet. |
CI OIDC SSH RERUN | Un job CircleCI rieseguito con SSH. Lo esegua di nuovo senza SSH. |
CI EXCHANGE RATE LIMITED | Troppi scambi per questo repository o questa organizzazione in poco tempo. Esegua lo scambio una volta per job, poi attenda e riprovi. |
BOX STATE PUSH FAILED | Il registro non ha ricevuto il nuovo token. Riesegua il job. |