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.
So funktioniert es
- 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.
- 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.
- Im Job austauschen. Der Job fordert sein Identitätstoken für die Zielgruppe (Audience)
https://dartastic.ioan und sendet es zusammen mit der ID Ihrer Organisation, die in derselben Ansicht „Organization“ steht, an den Austausch. - Das Pub-Token verwenden.
dart pub token addübergibt es andart pub getunddart pub publish(flutter pubfunktioniert genauso).
Ihr CI-Anbieter
| Anbieter | Vor dem Binden |
|---|---|
| GitHub Actions | GitHub.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/CD | GitLab.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 Pipelines | Jeder 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. |
| CircleCI | Jede 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:
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:
{
"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:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Grund | Was zu tun ist |
|---|---|
CI EXCHANGE ORG MISSING | Die Anfrage nannte keine Organisation. Senden Sie {"orgId": "<your organization id>"} als Body. |
CI OIDC TOKEN MISSING | Die Anfrage enthielt kein CI-Token. Senden Sie es als Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | Das 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 TRUSTED | Der 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 EXPIRED | Das Token ist abgelaufen, bevor es ausgetauscht wurde. Tauschen Sie es aus, sobald der Job es anfordert. |
CI OIDC TOKEN REPLAYED | Dieses Token wurde bereits ausgetauscht. Jedes Token wird nur einmal ausgetauscht: einmal pro Job. |
TRUSTED PUBLISHER NOT BOUND | Keine 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 MISMATCH | Die Bindung nennt ein anderes Repository oder Projekt. Die UUIDs und IDs müssen die des Jobs sein. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | Der Job lief aus einer anderen Workflow- oder Pipeline-Datei, als die Bindung erlaubt. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | Der Job lief nicht im Environment der Bindung (oder verwendete bei CircleCI nicht deren Context). |
TRUSTED PUBLISHER REF MISMATCH | Der Job lief auf einem Branch oder Tag, auf den das Ref-Muster der Bindung nicht passt. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | Das Repository wurde gelöscht und unter demselben Namen neu angelegt. Entfernen Sie die Bindung und binden Sie das neue Repository. |
TRUSTED PUBLISHER AMBIGUOUS | Mehr als eine Bindung passt auf den Job. Grenzen Sie sie ein (Workflow, Environment oder Ref), sodass genau eine passt. |
CI OIDC CLAIM MISSING | Dem 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 RERUN | Ein CircleCI-Job wurde mit SSH erneut ausgeführt. Führen Sie ihn ohne SSH erneut aus. |
CI EXCHANGE RATE LIMITED | Zu 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 FAILED | Die Registry hat das neue Token nicht erhalten. Führen Sie den Job erneut aus. |