Halaman ini menampilkan URL Cloud. Masuk di Dedicated, lalu halaman ini menampilkan URL server Anda.

Pub dari GitLab CI/CD

Job GitLab CI/CD membaca dan memublikasikan package pribadi Anda tanpa secret yang disimpan: setiap job menukar token identitasnya sendiri dengan token Pub yang berlaku selama 15 menit. Cara kerjanya di setiap penyedia dijelaskan di Pub dari CI.

BUILDARSITEKTUR DARTASTICPENGGUNAtokentikettoken Pubpushpertukaran CIaplikasi sampai ke pengguna: toko aplikasi, web, serversimbolcrashstack tracekode sumbertelemetriKomputer developerflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roombuat token · kontrol akses berbasis peranControl Planeorganisasi · peran · tokenDartastic Pubpackage · kode sumberObservatorysesi · trace · logSymbolizercrash → baris kode sumberDartastic AIjawaban dari keduanyaIssue trackerGitHub · Jira · LinearAplikasi seluler + desktopponsel · tablet · desktopmengirim dengan token OTLPAplikasi webdi browsermengirim dengan token Browser OTLPServer Dartbackend · layananmengirim dengan token OTLP

1. Percayai issuer

GitLab.com sudah dipercaya. Untuk GitLab self-managed, pemilik organisasi menambahkan alamatnya, https://<your host>, sebagai issuer milik organisasi ini.

2. Ikat repositori

Di Control Room, buka Organization, lalu CI access, Bind a repository, dan pilih GitLab CI/CD. Formulirnya meminta:

  • Project path: path lengkap proyek, termasuk grup bertingkat: acme/mobile/app.
  • Namespace path, optional: grup tempat proyek berada: acme/mobile. Jika dikosongkan, nilainya dibaca dari path proyek.
  • Pipeline configuration file, optional: konfigurasi yang diizinkan memublikasikan: .gitlab-ci.yml.
  • Environment name, optional: environment: sebuah job, seperti production. Environment yang diproteksi kemudian menyaring setiap pertukaran.
  • Ref pattern, optional: branch atau tag: refs/tags/v* atau refs/heads/main.

Lalu beri pengikatan itu package-nya dengan tombol Packages: baca, atau baca dan publikasikan.

[TODO: screenshot jendela “Bind a repository” dengan GitLab CI/CD dipilih dan acme/mobile/app terisi]

3. Lakukan pertukaran di dalam job

Masukkan ID organisasi Anda, dari layar “Organization” yang sama, ke DARTASTIC_ORG_ID. Job ini memublikasikan; untuk job yang hanya membaca, hapus dart pub publish dan beri pengikatan akses baca saja.

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: memberi job token-nya di variabel yang Anda namai, di sini DARTASTIC_ID_TOKEN, dengan aud: https://dartastic.io.
  • Tandai tag atau branch yang dipakai untuk memublikasikan sebagai protected di GitLab, sehingga hanya maintainer yang dapat memulai run yang melakukan pertukaran.
[TODO: screenshot job pipeline GitLab yang pertukarannya berhasil, lalu dart pub publish]

Saat ditolak

Log job menampilkan alasannya lebih dulu, misalnya TRUSTED PUBLISHER REF MISMATCH. Setiap alasan dan yang perlu dilakukan ada di Pub dari CI. Panduan GitLab CI/CD sendiri tentang tokennya ada di dokumentasinya.