Deze pagina’s tonen de URL’s van Cloud. Log in op Dedicated, dan tonen ze die van uw server.

Pub vanuit CI

Uw CI leest en publiceert uw privépackages zonder opgeslagen secret. Elke job bewijst welke repository hij is met het eigen identiteitstoken van de CI-provider en krijgt een Pub-token dat 15 minuten geldig is.

BUILDDARTASTIC-ARCHITECTUURGEBRUIKERStokensissuesPub-tokenpushCI-uitwisselingapps bereiken gebruikers via appstores, het web en serverssymbolencrashesstacktracesbroncodetelemetrieOntwikkelaarscomputerflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtokens aanmaken · rolgebaseerd toegangsbeheerControl Planeorganisaties · rollen · tokensDartastic Pubpackages · broncodeObservatorysessies · traces · logsSymbolizercrashes → broncoderegelsDartastic AIantwoorden uit beideIssuetrackerGitHub · Jira · LinearMobiele en desktopappstelefoons · tablets · desktopsverstuurt met een OTLP-tokenWebappsin browsersverstuurt met een Browser OTLP-tokenDart-serversbackends · servicesverstuurt met een OTLP-token

Zo werkt het

  1. Koppel de repository. Open in de Control Room Organization en zoek CI access. Met Bind a repository legt u vast welke repository’s CI-runs namens uw organisatie handelen, eventueel alleen vanuit één workflow, environment of branch. Een eigenaar of beheerder koppelt.
  2. Geef het packages. Elke koppeling is een CI-lid van uw organisatie. Met de knop Packages geeft u het packages om te lezen, of om te lezen en te publiceren, precies zoals voor een teamgenoot. Zonder toegang leest het de globale packages en de engine van uw organisatie, als die er een heeft, en publiceert het niets. Wie de koppeling verwijdert, verwijdert het lid en alles wat het had gekregen.
  3. Wissel in de job. De job vraagt zijn identiteitstoken aan voor de audience https://dartastic.io en stuurt het naar de uitwisseling met de id van uw organisatie, die op hetzelfde scherm “Organization” staat.
  4. Gebruik het Pub-token. dart pub token add geeft het door aan dart pub get en dart pub publish (flutter pub werkt op dezelfde manier).

Uw CI-provider

ProviderVoordat u koppelt
GitHub ActionsGitHub.com wordt al vertrouwd. Voor GitHub Enterprise Server voegt een eigenaar de issuer ervan, https://<your host>/_services/token, toe als eigen issuer van deze organisatie.
GitLab CI/CDGitLab.com wordt al vertrouwd. Voor een zelfbeheerde GitLab voegt een eigenaar het adres ervan, https://<your host>, toe als eigen issuer van deze organisatie.
Bitbucket PipelinesElke Bitbucket-workspace heeft een eigen issuer, dus een eigenaar voegt die eerst toe: kies in “CI access”, onder “This organization's own CI issuers”, Bitbucket Pipelines en vul de URL-naam van de workspace in.
CircleCIElke CircleCI-organisatie heeft een eigen issuer, dus een eigenaar voegt die eerst toe: kies in “CI access”, onder “This organization's own CI issuers”, CircleCI en vul het organisatie-id in.

De uitwisseling

De job stuurt zijn identiteitstoken als bearer-token en de id van uw organisatie als body:

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>"}'

Het antwoord bevat het Pub-token en wat het mag doen:

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
}
  • Elk identiteitstoken wordt één keer uitgewisseld. Wissel één keer per job, aan het begin, en bewaar het Pub-token voor de latere stappen van de job.
  • Het Pub-token leest de globale packages, de engine van uw organisatie als die er een heeft, en elk package waartoe het CI-lid toegang heeft, en publiceert de packages waarvoor publiceren is toegestaan. Meer kan het niet.
  • Elke uitwisseling staat in de “Audit Log” van uw organisatie, met de repository, de run en de commit.

Als de uitwisseling weigert

Een weigering noemt eerst de reden, zodat de log van de job die letterlijk toont:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
RedenWat te doen
CI EXCHANGE ORG MISSINGHet verzoek noemde geen organisatie. Stuur {"orgId": "<your organization id>"} als body.
CI OIDC TOKEN MISSINGHet verzoek bevatte geen CI-token. Stuur het als Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDHet token is aangevraagd voor een andere audience. Vraag het aan voor https://dartastic.io, zoals het fragment doet.
CI OIDC ISSUER NOT TRUSTEDDe issuer van het token wordt niet vertrouwd voor deze organisatie. Voor Bitbucket, CircleCI, GitHub Enterprise Server of een zelfbeheerde GitLab voegt een eigenaar eerst de issuer toe.
CI OIDC EXPIREDHet token is verlopen voordat het werd uitgewisseld. Wissel het uit zodra de job het aanvraagt.
CI OIDC TOKEN REPLAYEDDit token is al uitgewisseld. Elk token wordt één keer uitgewisseld: wissel één keer per job uit.
TRUSTED PUBLISHER NOT BOUNDGeen koppeling van deze organisatie noemt de repository van de job. Koppel die in “CI access” en controleer orgId in de workflow.
TRUSTED PUBLISHER REPOSITORY MISMATCHDe koppeling noemt een andere repository of een ander project. De UUID’s en id’s moeten die van de job zelf zijn.
TRUSTED PUBLISHER WORKFLOW MISMATCHDe job draaide vanuit een ander workflow- of pipelinebestand dan de koppeling toestaat.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHDe job draaide niet in de environment van de koppeling (of gebruikte, op CircleCI, de context ervan niet).
TRUSTED PUBLISHER REF MISMATCHDe job draaide op een branch of tag die niet overeenkomt met het ref-patroon van de koppeling.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHDe repository is verwijderd en onder dezelfde naam opnieuw aangemaakt. Verwijder de koppeling en koppel de nieuwe repository.
TRUSTED PUBLISHER AMBIGUOUSMeer dan één koppeling komt overeen met de job. Maak ze specifieker (workflow, environment of ref), zodat er precies één overeenkomt.
CI OIDC CLAIM MISSINGHet token mist een claim die de provider altijd meestuurt. Controleer of het token het eigen CI-token van de provider is, aangevraagd zoals het fragment doet.
CI OIDC SSH RERUNEen CircleCI-job is opnieuw met SSH uitgevoerd. Voer de job opnieuw uit zonder SSH.
CI EXCHANGE RATE LIMITEDTe veel uitwisselingen voor deze repository of organisatie in korte tijd. Wissel één keer per job uit, wacht dan even en probeer het opnieuw.
BOX STATE PUSH FAILEDDe registry heeft het nieuwe token niet ontvangen. Voer de job opnieuw uit.