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

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.

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

Come funziona

  1. 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.
  2. 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.
  3. Esegua lo scambio nel job. Il job richiede il proprio token di identità per l’audience https://dartastic.io e lo invia allo scambio con l’ID della sua organizzazione, che si trova nella stessa schermata « Organization ».
  4. Usi il token Pub. dart pub token add lo passa a dart pub get e dart pub publish (flutter pub funziona allo stesso modo).

Il suo provider CI

ProviderPrima di associare
GitHub ActionsGitHub.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/CDGitLab.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 PipelinesOgni 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.
CircleCIOgni 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:

shell
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:

json
{
  "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’è:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
MotivoCosa fare
CI EXCHANGE ORG MISSINGLa richiesta non indicava alcuna organizzazione. Invii {"orgId": "<your organization id>"} come corpo.
CI OIDC TOKEN MISSINGLa richiesta non conteneva alcun token CI. Lo invii come Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDIl token è stato richiesto per un’altra audience. Lo richieda per https://dartastic.io, come fa lo snippet.
CI OIDC ISSUER NOT TRUSTEDL’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 EXPIREDIl token è scaduto prima di essere scambiato. Lo scambi appena il job lo richiede.
CI OIDC TOKEN REPLAYEDQuesto token è già stato scambiato. Ogni token si scambia una sola volta: esegua lo scambio una volta per job.
TRUSTED PUBLISHER NOT BOUNDNessuna associazione di questa organizzazione indica il repository del job. Lo associ in « CI access » e controlli il orgId nel workflow.
TRUSTED PUBLISHER REPOSITORY MISMATCHL’associazione indica un altro repository o progetto. Gli UUID e gli ID devono essere quelli del job.
TRUSTED PUBLISHER WORKFLOW MISMATCHIl job è stato eseguito da un file di workflow o di pipeline diverso da quello consentito dall’associazione.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHIl job non è stato eseguito nell’ambiente dell’associazione (o, su CircleCI, non ha usato il suo context).
TRUSTED PUBLISHER REF MISMATCHIl job è stato eseguito su un branch o un tag che non corrisponde al ref pattern dell’associazione.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHIl repository è stato eliminato e ricreato con lo stesso nome. Rimuova l’associazione e associ il nuovo repository.
TRUSTED PUBLISHER AMBIGUOUSPiù di un’associazione corrisponde al job. Le restringa (workflow, ambiente o ref) in modo che ne corrisponda esattamente una.
CI OIDC CLAIM MISSINGAl 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 RERUNUn job CircleCI rieseguito con SSH. Lo esegua di nuovo senza SSH.
CI EXCHANGE RATE LIMITEDTroppi scambi per questo repository o questa organizzazione in poco tempo. Esegua lo scambio una volta per job, poi attenda e riprovi.
BOX STATE PUSH FAILEDIl registro non ha ricevuto il nuovo token. Riesegua il job.