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

Pub w GitLab CI/CD

Zadania w GitLab CI/CD 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

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.

2. Powiązanie repozytorium

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

  • Project path: pełna ścieżka projektu, łącznie z zagnieżdżonymi grupami: acme/mobile/app.
  • Namespace path, optional: grupa, w której jest projekt: acme/mobile. Jeśli pole jest puste, grupa jest odczytywana ze ścieżki projektu.
  • Pipeline configuration file, optional: konfiguracja, która może publikować: .gitlab-ci.yml.
  • Environment name, optional: environment: zadania, np. production. Chronione środowiska 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 GitLab CI/CD i wpisanym acme/mobile/app]

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
# .gitlab-ci.yml: publish on a version tag
publish:
  image: dart:stable
  rules:
    - if: $CI_COMMIT_TAG =~ /^v/
  environment: production   # optional: bind the environment too
  id_tokens:
    DARTASTIC_ID_TOKEN:
      aud: https://dartastic.io
  variables:
    DARTASTIC_ORG_ID: "<your organization id>"
  script:
    - 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 $DARTASTIC_ID_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
  • id_tokens: przekazuje zadaniu token w zmiennej o wybranej nazwie, tutaj DARTASTIC_ID_TOKEN, z aud: https://dartastic.io.
  • Tagi lub gałęzie używane do publikacji należy oznaczyć w GitLab jako chronione, aby tylko osoby z rolą Maintainer mogły uruchomić przebieg, który wykonuje wymianę.
[TODO: zrzut ekranu: zadanie w pipeline GitLab z udaną wymianą, a potem dart pub publish]

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 GitLab CI/CD po jego tokenach jest w jego dokumentacji.