Diese Seiten zeigen die URLs von Cloud. Wenn Sie sich bei Dedicated anmelden, zeigen sie die Ihres Servers.

Pub aus der CI

Ihre CI liest und veröffentlicht Ihre privaten Packages ohne gespeichertes Secret. Jeder Job weist mit dem eigenen Identitätstoken seines CI-Anbieters nach, welches Repository er ist, und erhält ein Pub-Token, das 15 Minuten gilt.

ENTWICKLUNGDARTASTIC-ARCHITEKTURNUTZERTokensTicketsPub-TokenPushCI-AustauschApps gehen an Nutzer: App-Stores, Web, ServerSymboleAbstürzeStacktracesQuellcodeTelemetrieEntwicklerrechnerflutter run · dart pub getCIGitHub Actions, GitLab, …Control RoomTokens erstellen · rollenbasierte ZugriffskontrolleControl PlaneOrganisationen · Rollen · TokensDartastic PubPackages · QuellcodeObservatorySitzungen · Traces · LogsSymbolizerAbstürze → QuellcodezeilenDartastic AIAntworten aus beidenIssue-TrackerGitHub · Jira · LinearMobile + Desktop-AppsSmartphones · Tablets · Desktopssendet mit einem OTLP-TokenWeb-Appsim Browsersendet mit einem Browser-OTLP-TokenDart-ServerBackends · Dienstesendet mit einem OTLP-Token

So funktioniert es

  1. Das Repository binden. Öffnen Sie im Control Room Organization und suchen Sie CI access. Mit Bind a repository legen Sie fest, welche CI-Läufe welches Repositorys für Ihre Organisation handeln, optional nur aus einem bestimmten Workflow, einer Umgebung oder einem Branch. Binden kann ein Inhaber oder ein Administrator.
  2. Packages freigeben. Jede Bindung ist ein CI-Mitglied Ihrer Organisation. Mit ihrer Schaltfläche Packages erteilen Sie ihr Packages zum Lesen oder zum Lesen und Veröffentlichen, genau wie einem Teammitglied. Ohne Freigabe liest sie die globalen Packages und die Engine Ihrer Organisation, falls vorhanden, und veröffentlicht nichts. Wenn Sie die Bindung entfernen, werden das Mitglied und alle seine Freigaben entfernt.
  3. Im Job austauschen. Der Job fordert sein Identitätstoken für die Zielgruppe (Audience) https://dartastic.io an und sendet es zusammen mit der ID Ihrer Organisation, die in derselben Ansicht „Organization“ steht, an den Austausch.
  4. Das Pub-Token verwenden. dart pub token add übergibt es an dart pub get und dart pub publish (flutter pub funktioniert genauso).

Ihr CI-Anbieter

AnbieterVor dem Binden
GitHub ActionsGitHub.com ist bereits vertrauenswürdig. Für GitHub Enterprise Server fügt ein Inhaber dessen Aussteller https://<your host>/_services/token als eigenen Aussteller dieser Organisation hinzu.
GitLab CI/CDGitLab.com ist bereits vertrauenswürdig. Für ein selbstverwaltetes GitLab fügt ein Inhaber dessen Adresse https://<your host> als eigenen Aussteller dieser Organisation hinzu.
Bitbucket PipelinesJeder Bitbucket-Workspace hat einen eigenen Aussteller, daher fügt ein Inhaber ihn zuerst hinzu: Wählen Sie unter „CI access“ im Abschnitt „This organization's own CI issuers“ den Eintrag Bitbucket Pipelines und geben Sie den URL-Namen des Workspace ein.
CircleCIJede CircleCI-Organisation hat einen eigenen Aussteller, daher fügt ein Inhaber ihn zuerst hinzu: Wählen Sie unter „CI access“ im Abschnitt „This organization's own CI issuers“ den Eintrag CircleCI und geben Sie die Organisations-ID ein.

Der Austausch

Der Job sendet sein Identitätstoken als Bearer-Token und die ID Ihrer Organisation 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>"}'

Die Antwort enthält das Pub-Token und was es darf:

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
}
  • Jedes Identitätstoken wird einmal ausgetauscht. Tauschen Sie einmal pro Job aus, zu Beginn, und behalten Sie das Pub-Token für die späteren Schritte des Jobs.
  • Das Pub-Token liest die globalen Packages, die Engine Ihrer Organisation, falls vorhanden, und jedes Package, das dem CI-Mitglied freigegeben ist, und veröffentlicht die zum Veröffentlichen freigegebenen. Sonst kann es nichts.
  • Jeder Austausch steht im „Audit Log“ Ihrer Organisation, mit Repository, Lauf und Commit.

Wenn der Austausch ablehnt

Eine Ablehnung nennt zuerst ihren Grund, damit das Log des Jobs ihn unverändert zeigt:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
GrundWas zu tun ist
CI EXCHANGE ORG MISSINGDie Anfrage nannte keine Organisation. Senden Sie {"orgId": "<your organization id>"} als Body.
CI OIDC TOKEN MISSINGDie Anfrage enthielt kein CI-Token. Senden Sie es als Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDDas Token wurde für eine andere Audience angefordert. Fordern Sie es für https://dartastic.io an, wie es das Snippet tut.
CI OIDC ISSUER NOT TRUSTEDDer Aussteller des Tokens ist für diese Organisation nicht vertrauenswürdig. Für Bitbucket, CircleCI, GitHub Enterprise Server oder ein selbstverwaltetes GitLab fügt ein Inhaber den Aussteller zuerst hinzu.
CI OIDC EXPIREDDas Token ist abgelaufen, bevor es ausgetauscht wurde. Tauschen Sie es aus, sobald der Job es anfordert.
CI OIDC TOKEN REPLAYEDDieses Token wurde bereits ausgetauscht. Jedes Token wird nur einmal ausgetauscht: einmal pro Job.
TRUSTED PUBLISHER NOT BOUNDKeine Bindung dieser Organisation nennt das Repository des Jobs. Binden Sie es unter „CI access“ und prüfen Sie das Feld orgId im Workflow.
TRUSTED PUBLISHER REPOSITORY MISMATCHDie Bindung nennt ein anderes Repository oder Projekt. Die UUIDs und IDs müssen die des Jobs sein.
TRUSTED PUBLISHER WORKFLOW MISMATCHDer Job lief aus einer anderen Workflow- oder Pipeline-Datei, als die Bindung erlaubt.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHDer Job lief nicht im Environment der Bindung (oder verwendete bei CircleCI nicht deren Context).
TRUSTED PUBLISHER REF MISMATCHDer Job lief auf einem Branch oder Tag, auf den das Ref-Muster der Bindung nicht passt.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHDas Repository wurde gelöscht und unter demselben Namen neu angelegt. Entfernen Sie die Bindung und binden Sie das neue Repository.
TRUSTED PUBLISHER AMBIGUOUSMehr als eine Bindung passt auf den Job. Grenzen Sie sie ein (Workflow, Environment oder Ref), sodass genau eine passt.
CI OIDC CLAIM MISSINGDem Token fehlt ein Claim, den der Anbieter immer sendet. Prüfen Sie, ob das Token das eigene CI-Token des Anbieters ist, angefordert wie im Snippet.
CI OIDC SSH RERUNEin CircleCI-Job wurde mit SSH erneut ausgeführt. Führen Sie ihn ohne SSH erneut aus.
CI EXCHANGE RATE LIMITEDZu viele Austausche für dieses Repository oder diese Organisation in kurzer Zeit. Tauschen Sie einmal pro Job aus, warten Sie dann und versuchen Sie es erneut.
BOX STATE PUSH FAILEDDie Registry hat das neue Token nicht erhalten. Führen Sie den Job erneut aus.