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.
Cara kerjanya
- 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.
- 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.
- Lakukan pertukaran di dalam job. Job meminta token identitasnya untuk audience
https://dartastic.iodan mengirimkannya ke pertukaran bersama ID organisasi Anda, yang ada di layar “Organization” yang sama. - Gunakan token Pub.
dart pub token addmenyerahkannya kedart pub getdandart pub publish(flutter pubbekerja dengan cara yang sama).
Penyedia CI Anda
| Penyedia | Sebelum mengikat |
|---|---|
| GitHub Actions | GitHub.com sudah dipercaya. Untuk GitHub Enterprise Server, pemilik organisasi menambahkan issuer-nya, https://<your host>/_services/token, sebagai issuer milik organisasi ini. |
| GitLab CI/CD | GitLab.com sudah dipercaya. Untuk GitLab self-managed, pemilik organisasi menambahkan alamatnya, https://<your host>, sebagai issuer milik organisasi ini. |
| Bitbucket Pipelines | Setiap 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. |
| CircleCI | Setiap 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:
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:
{
"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:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Alasan | Yang perlu dilakukan |
|---|---|
CI EXCHANGE ORG MISSING | Permintaan tidak menyebut organisasi. Kirim {"orgId": "<your organization id>"} sebagai body. |
CI OIDC TOKEN MISSING | Permintaan tidak membawa token CI. Kirim sebagai Authorization: Bearer <token>. |
CI OIDC AUDIENCE INVALID | Token diminta untuk audience lain. Minta untuk https://dartastic.io, seperti dalam cuplikan kode. |
CI OIDC ISSUER NOT TRUSTED | Issuer 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 EXPIRED | Token kedaluwarsa sebelum ditukar. Tukar segera setelah job memintanya. |
CI OIDC TOKEN REPLAYED | Token ini sudah ditukar. Setiap token hanya ditukar sekali: lakukan pertukaran sekali per job. |
TRUSTED PUBLISHER NOT BOUND | Tidak ada pengikatan di organisasi ini yang menyebut repositori job tersebut. Ikat repositorinya di “CI access”, dan periksa orgId di workflow. |
TRUSTED PUBLISHER REPOSITORY MISMATCH | Pengikatan menyebut repositori atau proyek lain. UUID dan ID harus milik job itu sendiri. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | Job berjalan dari file workflow atau pipeline yang berbeda dari yang diizinkan pengikatan. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | Job tidak berjalan di environment pengikatan (atau, di CircleCI, tidak memakai context-nya). |
TRUSTED PUBLISHER REF MISMATCH | Job berjalan di branch atau tag yang tidak cocok dengan pola ref pengikatan. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | Repositori dihapus lalu dibuat lagi dengan nama yang sama. Hapus pengikatannya dan ikat repositori yang baru. |
TRUSTED PUBLISHER AMBIGUOUS | Lebih dari satu pengikatan cocok dengan job. Persempit (workflow, environment, atau ref) sehingga tepat satu yang cocok. |
CI OIDC CLAIM MISSING | Token tidak memiliki claim yang selalu dikirim penyedia. Pastikan token tersebut adalah token CI milik penyedia, diminta seperti dalam cuplikan kode. |
CI OIDC SSH RERUN | Job CircleCI dijalankan ulang dengan SSH. Jalankan lagi tanpa SSH. |
CI EXCHANGE RATE LIMITED | Terlalu banyak pertukaran untuk repositori atau organisasi ini dalam waktu singkat. Lakukan pertukaran sekali per job, lalu tunggu dan coba lagi. |
BOX STATE PUSH FAILED | Registry tidak menerima token baru. Jalankan ulang job. |