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

Pub dari CI

CI Anda membaca dan memublikasikan package pribadi Anda tanpa secret yang disimpan. Setiap job membuktikan repositori asalnya dengan token identitas dari penyedia CI-nya sendiri, lalu mendapatkan token Pub yang berlaku selama 15 menit.

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

Cara kerjanya

  1. Ikat repositori. Di Control Room, buka Organization dan temukan CI access. Bind a repository menentukan run CI dari repositori mana yang bertindak atas nama organisasi Anda, dan secara opsional hanya dari satu workflow, environment, atau branch. Pengikatan dilakukan oleh pemilik atau admin.
  2. Beri akses package. Setiap pengikatan adalah anggota CI di organisasi Anda. Tombol Packages miliknya memberinya package untuk dibaca, atau untuk dibaca dan dipublikasikan, persis seperti untuk rekan tim. Tanpa pemberian akses, anggota ini membaca package global dan engine organisasi Anda (jika ada), dan tidak memublikasikan apa pun. Menghapus pengikatan berarti menghapus anggota tersebut beserta semua yang diberikan kepadanya.
  3. Lakukan pertukaran di dalam job. Job meminta token identitasnya untuk audience https://dartastic.io dan mengirimkannya ke pertukaran bersama ID organisasi Anda, yang ada di layar “Organization” yang sama.
  4. Gunakan token Pub. dart pub token add menyerahkannya ke dart pub get dan dart pub publish (flutter pub bekerja dengan cara yang sama).

Penyedia CI Anda

PenyediaSebelum mengikat
GitHub ActionsGitHub.com sudah dipercaya. Untuk GitHub Enterprise Server, pemilik organisasi menambahkan issuer-nya, https://<your host>/_services/token, sebagai issuer milik organisasi ini.
GitLab CI/CDGitLab.com sudah dipercaya. Untuk GitLab self-managed, pemilik organisasi menambahkan alamatnya, https://<your host>, sebagai issuer milik organisasi ini.
Bitbucket PipelinesSetiap workspace Bitbucket memiliki issuer sendiri, jadi pemilik organisasi menambahkannya terlebih dahulu: di “CI access”, pada “This organization's own CI issuers”, pilih “Bitbucket Pipelines” dan masukkan nama URL workspace.
CircleCISetiap organisasi CircleCI memiliki issuer sendiri, jadi pemilik organisasi menambahkannya terlebih dahulu: di “CI access”, pada “This organization's own CI issuers”, pilih “CircleCI” dan masukkan ID organisasinya.

Pertukaran

Job mengirim token identitasnya sebagai bearer token dan ID organisasi Anda sebagai body:

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

Responsnya berisi token Pub dan apa saja yang boleh dilakukannya:

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
}
  • Setiap token identitas hanya ditukar sekali. Lakukan pertukaran sekali per job, di awal, dan simpan token Pub untuk langkah-langkah job berikutnya.
  • Token Pub membaca package global, engine organisasi Anda jika ada, dan setiap package yang diberikan kepada anggota CI, serta memublikasikan package yang diberi akses publikasi. Token ini tidak dapat melakukan hal lain.
  • Setiap pertukaran tercatat di “Audit Log” organisasi Anda, beserta repositori, run, dan commit-nya.

Saat pertukaran ditolak

Penolakan menyebutkan alasannya lebih dulu, sehingga log job menampilkannya apa adanya:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
AlasanYang perlu dilakukan
CI EXCHANGE ORG MISSINGPermintaan tidak menyebut organisasi. Kirim {"orgId": "<your organization id>"} sebagai body.
CI OIDC TOKEN MISSINGPermintaan tidak membawa token CI. Kirim sebagai Authorization: Bearer <token>.
CI OIDC AUDIENCE INVALIDToken diminta untuk audience lain. Minta untuk https://dartastic.io, seperti dalam cuplikan kode.
CI OIDC ISSUER NOT TRUSTEDIssuer token tidak dipercaya untuk organisasi ini. Untuk Bitbucket, CircleCI, GitHub Enterprise Server, atau GitLab self-managed, pemilik organisasi menambahkan issuer-nya terlebih dahulu.
CI OIDC EXPIREDToken kedaluwarsa sebelum ditukar. Tukar segera setelah job memintanya.
CI OIDC TOKEN REPLAYEDToken ini sudah ditukar. Setiap token hanya ditukar sekali: lakukan pertukaran sekali per job.
TRUSTED PUBLISHER NOT BOUNDTidak ada pengikatan di organisasi ini yang menyebut repositori job tersebut. Ikat repositorinya di “CI access”, dan periksa orgId di workflow.
TRUSTED PUBLISHER REPOSITORY MISMATCHPengikatan menyebut repositori atau proyek lain. UUID dan ID harus milik job itu sendiri.
TRUSTED PUBLISHER WORKFLOW MISMATCHJob berjalan dari file workflow atau pipeline yang berbeda dari yang diizinkan pengikatan.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHJob tidak berjalan di environment pengikatan (atau, di CircleCI, tidak memakai context-nya).
TRUSTED PUBLISHER REF MISMATCHJob berjalan di branch atau tag yang tidak cocok dengan pola ref pengikatan.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHRepositori dihapus lalu dibuat lagi dengan nama yang sama. Hapus pengikatannya dan ikat repositori yang baru.
TRUSTED PUBLISHER AMBIGUOUSLebih dari satu pengikatan cocok dengan job. Persempit (workflow, environment, atau ref) sehingga tepat satu yang cocok.
CI OIDC CLAIM MISSINGToken tidak memiliki claim yang selalu dikirim penyedia. Pastikan token tersebut adalah token CI milik penyedia, diminta seperti dalam cuplikan kode.
CI OIDC SSH RERUNJob CircleCI dijalankan ulang dengan SSH. Jalankan lagi tanpa SSH.
CI EXCHANGE RATE LIMITEDTerlalu banyak pertukaran untuk repositori atau organisasi ini dalam waktu singkat. Lakukan pertukaran sekali per job, lalu tunggu dan coba lagi.
BOX STATE PUSH FAILEDRegistry tidak menerima token baru. Jalankan ulang job.