Te strony pokazują adresy URL Cloud. Po zalogowaniu się na Dedicated pokazują adresy własnego serwera: Zaloguj się.

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.

BUDOWANIEARCHITEKTURA DARTASTICUŻYTKOWNICYtokenyzgłoszeniatoken Pubpushwymiana w CIaplikacje trafiają do użytkowników: sklepy z aplikacjami, web, serwerysymboleawariestosy wywołańkod źródłowytelemetriaKomputer programistyflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtworzenie tokenów · kontrola dostępu oparta na rolachPłaszczyzna sterowaniaorganizacje · role · tokenyDartastic Pubpakiety · kod źródłowyObservatorysesje · trasy · logiSymbolizerawarie → linie kodu źródłowegoDartastic AIodpowiedzi z obu źródełSystem zgłoszeńGitHub · Jira · LinearAplikacje mobilne i desktopowetelefony · tablety · komputerywysyła z tokenem OTLPAplikacje webowew przeglądarkachwysyła z tokenem Browser OTLPSerwery Dartbackendy · usługiwysyła z tokenem OTLP

Jak to działa

  1. 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.
  2. 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.
  3. Wymiana w zadaniu. Zadanie pobiera swój token tożsamości dla odbiorcy (audience) https://dartastic.io i wysyła go do wymiany razem z identyfikatorem organizacji, który jest na tym samym ekranie „Organization”.
  4. Użycie tokenu Pub. dart pub token add przekazuje go do dart pub get i dart pub publish (flutter pub działa tak samo).

Dostawca CI

DostawcaPrzed powiązaniem
GitHub ActionsGitHub.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/CDGitLab.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 PipelinesKaż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.
CircleCIKaż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:

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

Odpowiedź zawiera token Pub i to, co wolno mu robić:

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
}
  • 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:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
PrzyczynaCo 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 INVALIDTokenu zażądano dla innego audience. Należy zażądać go dla https://dartastic.io, tak jak robi to fragment kodu.
CI OIDC ISSUER NOT TRUSTEDWystawca 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 EXPIREDToken wygasł przed wymianą. Należy wymienić go zaraz po tym, jak zadanie go otrzyma.
CI OIDC TOKEN REPLAYEDTen 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 MISMATCHPowiązanie wskazuje inne repozytorium lub projekt. UUID i identyfikatory muszą pochodzić z zadania.
TRUSTED PUBLISHER WORKFLOW MISMATCHZadanie zostało uruchomione z innego pliku workflow lub pipeline niż ten, na który pozwala powiązanie.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHZadanie nie działało w środowisku powiązania (lub, w CircleCI, nie używało jego kontekstu).
TRUSTED PUBLISHER REF MISMATCHZadanie działało na gałęzi lub tagu, do których nie pasuje wzorzec ref powiązania.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHRepozytorium zostało usunięte i utworzone ponownie pod tą samą nazwą. Należy usunąć powiązanie i powiązać nowe repozytorium.
TRUSTED PUBLISHER AMBIGUOUSDo 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 MISSINGW 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 RERUNZadanie CircleCI uruchomione ponownie z SSH. Należy uruchomić je ponownie bez SSH.
CI EXCHANGE RATE LIMITEDZbyt 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 FAILEDRepozytorium pakietów nie otrzymało nowego tokenu. Należy ponowić zadanie.