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

Pub w Bitbucket Pipelines

Zadania w Bitbucket Pipelines czytają i publikują prywatne pakiety bez żadnego przechowywanego sekretu: każde zadanie wymienia własny token tożsamości na token Pub ważny 15 minut. Jak to działa u każdego dostawcy, opisuje strona Pub w CI.

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

1. Zaufanie wystawcy

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.

[TODO: zrzut ekranu: „This organization's own CI issuers” z wybranym „Bitbucket Pipelines” i wpisanym workspace]

2. Powiązanie repozytorium

W Control Room należy otworzyć Organization, potem CI access, Bind a repository, i wybrać Bitbucket Pipelines. Formularz wymaga podania:

  • Repository UUID: w Bitbucket, „Repository settings”, „OpenID Connect”: UUID repozytorium razem z nawiasami klamrowymi.
  • Workspace UUID: na tej samej stronie: UUID workspace.
  • Deployment environment UUID, optional: na tej samej stronie, dla kroku z deployment:. Uprawnienia wdrożenia tego środowiska warunkują wtedy każdą wymianę.
  • Ref pattern, optional: gałąź: refs/heads/main. Token Bitbucket wskazuje wyłącznie gałąź, nigdy tag.

Następnie należy przydzielić powiązaniu pakiety jego przyciskiem Packages: do odczytu albo do odczytu i publikacji.

[TODO: zrzut ekranu: strona „Repository settings”, „OpenID Connect” w Bitbucket z UUID repozytorium i workspace]
[TODO: zrzut ekranu: okno „Bind a repository” z wybranym wystawcą Bitbucket i wpisanymi UUID]

3. Wymiana w zadaniu

Identyfikator organizacji, z tego samego ekranu „Organization”, należy umieścić w DARTASTIC_ORG_ID. To zadanie publikuje; dla zadania, które tylko czyta, należy usunąć dart pub publish i przydzielić powiązaniu tylko odczyt.

yaml
# bitbucket-pipelines.yml: publish from main
image: dart:stable
pipelines:
  branches:
    main:
      - step:
          name: Publish
          deployment: production   # optional: bind the environment too
          oidc: true
          script:
            - export DARTASTIC_ORG_ID="<your organization id>"
            - apt-get update -qq && apt-get install -y -qq jq
            - |
              RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
                -H "Authorization: Bearer $BITBUCKET_STEP_OIDC_TOKEN" -H "Content-Type: application/json" \
                -d "{\"orgId\":\"$DARTASTIC_ORG_ID\"}") || { echo "$RESP" >&2; exit 1; }
              export PUB_TOKEN=$(echo "$RESP" | jq -er .token)
              dart pub token add https://pub.dartastic.io --env-var PUB_TOKEN
            - dart pub get
            - dart pub publish --force
options:
  oidc:
    audiences:
      - https://dartastic.io
  • oidc: true w kroku daje mu $BITBUCKET_STEP_OIDC_TOKEN, a lista audiences pod oidc: ustawia jego audience na https://dartastic.io.
  • Token Bitbucket wskazuje repozytorium wyłącznie przez UUID, dlatego powiązanie przyjmuje UUID.

Gdy wymiana zostaje odrzucona

Log zadania pokazuje najpierw przyczynę, na przykład TRUSTED PUBLISHER REF MISMATCH. Każdą przyczynę i sposób postępowania opisuje strona Pub w CI. Przewodnik dostawcy Bitbucket Pipelines po jego tokenach jest w jego dokumentacji.