Pub w CI
CI czyta i publikuje prywatne pakiety bez żadnego przechowywanego sekretu. Każde zadanie potwierdza, z którego repozytorium pochodzi, tokenem tożsamości własnego dostawcy CI i otrzymuje token Pub ważny 15 minut.
Jak to działa
- Powiązanie repozytorium. W Control Room należy otworzyć Organization i znaleźć CI access. Bind a repository określa, którego repozytorium przebiegi CI działają w imieniu organizacji, opcjonalnie tylko z jednego workflow, środowiska lub gałęzi. Powiązanie tworzy właściciel lub administrator.
- Przydzielenie pakietów. Każde powiązanie jest członkiem CI organizacji. Jego przycisk Packages przydziela mu pakiety do odczytu albo do odczytu i publikacji, dokładnie jak członkowi zespołu. Bez przydziału czyta pakiety globalne i silnik organizacji, jeśli go ma, i niczego nie publikuje. Usunięcie powiązania usuwa członka i wszystko, co mu przydzielono.
- Wymiana w zadaniu. Zadanie pobiera swój token tożsamości dla odbiorcy (audience)
https://dartastic.ioi wysyła go do wymiany razem z identyfikatorem organizacji, który jest na tym samym ekranie „Organization”. - Użycie tokenu Pub.
dart pub token addprzekazuje go dodart pub getidart pub publish(flutter pubdziała tak samo).
Dostawca CI
| Dostawca | Przed powiązaniem |
|---|---|
| GitHub Actions | GitHub.com jest już zaufany. W przypadku GitHub Enterprise Server właściciel organizacji dodaje jego wystawcę, https://<your host>/_services/token, jako własnego wystawcę tej organizacji. |
| GitLab CI/CD | GitLab.com jest już zaufany. W przypadku instancji GitLab zarządzanej samodzielnie właściciel organizacji dodaje jej adres, https://<your host>, jako własnego wystawcę tej organizacji. |
| Bitbucket Pipelines | Każdy workspace Bitbucket ma własnego wystawcę, więc najpierw dodaje go właściciel organizacji: w „CI access”, w sekcji „This organization's own CI issuers”, należy wybrać „Bitbucket Pipelines” i wpisać nazwę workspace używaną w adresie URL. |
| CircleCI | Każda organizacja CircleCI ma własnego wystawcę, więc najpierw dodaje go właściciel organizacji: w „CI access”, w sekcji „This organization's own CI issuers”, należy wybrać „CircleCI” i wpisać identyfikator organizacji. |
Wymiana
Zadanie wysyła swój token tożsamości jako token bearer, a identyfikator organizacji w treści żądania:
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>"}'Odpowiedź zawiera token Pub i to, co wolno mu robić:
{
"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
}- Każdy token tożsamości można wymienić tylko raz. Wymiany należy dokonać raz na zadanie, na początku, a token Pub zachować na dalsze kroki zadania.
- Token Pub czyta pakiety globalne, silnik organizacji, jeśli go ma, oraz każdy pakiet przydzielony członkowi CI, a publikuje te, które przydzielono do publikacji. Nic innego nie może zrobić.
- Każda wymiana trafia do dziennika audytu organizacji, z repozytorium, przebiegiem i commitem.
Gdy wymiana zostaje odrzucona
Odmowa zaczyna się od przyczyny, więc log zadania pokazuje ją bez zmian:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Przyczyna | Co zrobić |
|---|---|
CI EXCHANGE ORG MISSING | Żądanie nie wskazywało organizacji. Należy wysłać {"orgId": "<your organization id>"} jako treść żądania. |
CI OIDC TOKEN MISSING | Żądanie nie zawierało tokenu CI. Należy wysłać go jako Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | Tokenu zażądano dla innego audience. Należy zażądać go dla https://dartastic.io, tak jak robi to fragment kodu. |
CI OIDC ISSUER NOT TRUSTED | Wystawca tokenu nie jest zaufany w tej organizacji. W przypadku Bitbucket, CircleCI, GitHub Enterprise Server lub instancji GitLab zarządzanej samodzielnie właściciel najpierw dodaje wystawcę. |
CI OIDC EXPIRED | Token wygasł przed wymianą. Należy wymienić go zaraz po tym, jak zadanie go otrzyma. |
CI OIDC TOKEN REPLAYED | Ten token został już wymieniony. Każdy token wymienia się raz: jedna wymiana na zadanie. |
TRUSTED PUBLISHER NOT BOUND | Żadne powiązanie tej organizacji nie wskazuje repozytorium zadania. Należy je powiązać w „CI access” i sprawdzić orgId w workflow. |
TRUSTED PUBLISHER REPOSITORY MISMATCH | Powiązanie wskazuje inne repozytorium lub projekt. UUID i identyfikatory muszą pochodzić z zadania. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | Zadanie zostało uruchomione z innego pliku workflow lub pipeline niż ten, na który pozwala powiązanie. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | Zadanie nie działało w środowisku powiązania (lub, w CircleCI, nie używało jego kontekstu). |
TRUSTED PUBLISHER REF MISMATCH | Zadanie działało na gałęzi lub tagu, do których nie pasuje wzorzec ref powiązania. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | Repozytorium zostało usunięte i utworzone ponownie pod tą samą nazwą. Należy usunąć powiązanie i powiązać nowe repozytorium. |
TRUSTED PUBLISHER AMBIGUOUS | Do zadania pasuje więcej niż jedno powiązanie. Należy je zawęzić (workflow, środowisko lub ref), aby pasowało dokładnie jedno. |
CI OIDC CLAIM MISSING | W tokenie brakuje claimu, który dostawca zawsze wysyła. Należy sprawdzić, czy to własny token CI dostawcy, zażądany tak jak we fragmencie kodu. |
CI OIDC SSH RERUN | Zadanie CircleCI uruchomione ponownie z SSH. Należy uruchomić je ponownie bez SSH. |
CI EXCHANGE RATE LIMITED | Zbyt wiele wymian dla tego repozytorium lub organizacji w krótkim czasie. Należy wykonywać jedną wymianę na zadanie, a potem odczekać i spróbować ponownie. |
BOX STATE PUSH FAILED | Repozytorium pakietów nie otrzymało nowego tokenu. Należy ponowić zadanie. |