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

Pub w CircleCI

Zadania w CircleCI 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ż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.

[TODO: zrzut ekranu: „This organization's own CI issuers” z wybranym „CircleCI” i wpisanym identyfikatorem organizacji]

2. Powiązanie repozytorium

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

  • Project ID: w CircleCI: „Project Settings”, „Overview”.
  • Organization ID, optional: „Organization Settings”, „Overview”. Jeśli pole jest puste, identyfikator jest odczytywany z wystawcy.
  • Context ID, optional: kontekst, którego musi używać zadanie („Organization Settings”, „Contexts”). Jego grupy bezpieczeństwa warunkują wtedy każdą wymianę.
  • Ref pattern, optional: gałąź lub tag: refs/tags/v* albo refs/heads/main.

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

[TODO: zrzut ekranu: okno „Bind a repository” z wybranym wystawcą CircleCI i wpisanym identyfikatorem projektu]

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
# .circleci/config.yml: publish on a version tag
version: 2.1
jobs:
  publish:
    docker:
      - image: dart:stable
    environment:
      DARTASTIC_ORG_ID: <your organization id>
    steps:
      - checkout
      - run: apt-get update -qq && apt-get install -y -qq jq
      - run:
          name: Exchange this job's identity for a 15-minute Pub token
          command: |
            OIDC=$(circleci run oidc get --aud https://dartastic.io)
            RESP=$(curl -sS --fail-with-body -X POST https://api.dartastic.io/v1/ci/exchange \
              -H "Authorization: Bearer $OIDC" -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
            echo "export PUB_TOKEN=$PUB_TOKEN" >> "$BASH_ENV"
      - run: dart pub get
      - run: dart pub publish --force
workflows:
  release:
    jobs:
      - publish:
          filters:
            tags: { only: /^v.*/ }
            branches: { ignore: /.*/ }
  • circleci run oidc get --aud https://dartastic.io daje zadaniu token dla tego audience. Tokeny, które CircleCI ustawia samodzielnie, mają jako audience identyfikator organizacji, dlatego są odrzucane.
  • Zadanie uruchomione ponownie z SSH jest odrzucane: osoba w powłoce mogłaby przejąć jego token. Należy uruchomić je ponownie bez SSH.

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 CircleCI po jego tokenach jest w jego dokumentacji.