CI'da Pub
CI'nız, özel paketlerinizi saklanmış bir secret olmadan okur ve yayımlar. Her iş, hangi depoya ait olduğunu CI sağlayıcısının kendi kimlik token'ıyla kanıtlar ve 15 dakika geçerli bir Pub token'ı alır.
Nasıl çalışır
- Depoyu bağlayın. Control Room'da Organization ekranını açın ve CI access bölümünü bulun. Bind a repository ile hangi deponun CI çalıştırmalarının kuruluşunuz adına hareket edeceğini, isteğe bağlı olarak da yalnızca tek bir iş akışından, ortamdan veya branch'ten gelenleri belirlersiniz. Bağlamayı bir sahip veya yönetici yapar.
- Paket erişimi verin. Her bağlama, kuruluşunuzun bir CI üyesidir. Packages düğmesi, tıpkı bir ekip arkadaşında olduğu gibi, ona okuma ya da okuma ve yayımlama için paket erişimi verir. Hiçbir erişim verilmezse global paketleri ve varsa kuruluşunuzun motorunu okur, hiçbir şey yayımlamaz. Bağlamayı kaldırmak, üyeyi ve ona verilen her şeyi kaldırır.
- Token değişimini işte yapın. İş,
https://dartastic.ioaudience değeri için kimlik token'ını ister ve bunu, aynı “Organization” ekranında bulunan kuruluş ID'nizle birlikte token değişimine gönderir. - Pub token'ını kullanın.
dart pub token addtoken'ıdart pub getvedart pub publishkomutlarına verir (flutter pubda aynı şekilde çalışır).
CI sağlayıcınız
| Sağlayıcı | Bağlamadan önce |
|---|---|
| GitHub Actions | GitHub.com zaten güvenilir kabul edilir. GitHub Enterprise Server için bir kuruluş sahibi, sunucunun veren (issuer) adresini, https://<your host>/_services/token, bu kuruluşun kendi vereni olarak ekler. |
| GitLab CI/CD | GitLab.com zaten güvenilir kabul edilir. Kendi yönettiğiniz bir GitLab için bir kuruluş sahibi, sunucunun adresini, https://<your host>, bu kuruluşun kendi vereni (issuer) olarak ekler. |
| Bitbucket Pipelines | Her Bitbucket workspace'inin kendi vereni (issuer) vardır, bu yüzden önce bir kuruluş sahibi onu ekler: “CI access” içinde, “This organization's own CI issuers” altında Bitbucket Pipelines'ı seçip workspace'in URL adını girin. |
| CircleCI | Her CircleCI kuruluşunun kendi vereni (issuer) vardır, bu yüzden önce bir kuruluş sahibi onu ekler: “CI access” içinde, “This organization's own CI issuers” altında CircleCI'ı seçip kuruluş kimliğini girin. |
Token değişimi
İş, kimlik token'ını bearer token olarak, kuruluş ID'nizi de gövde olarak gönderir:
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>"}'Yanıt olarak Pub token'ını ve bu token'ın neler yapabileceğini döndürür:
{
"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
}- Her kimlik token'ı yalnızca bir kez değiştirilebilir. Değişimi her işte bir kez, başta yapın ve Pub token'ını işin sonraki adımları için saklayın.
- Pub token'ı global paketleri, varsa kuruluşunuzun motorunu ve CI üyesine erişim verilen her paketi okur; yayımlama erişimi verilenleri de yayımlar. Başka hiçbir şey yapamaz.
- Her değişim; depo, çalıştırma ve commit bilgileriyle kuruluşunuzun denetim logunda yer alır.
Token değişimi reddedildiğinde
Bir ret yanıtı önce nedenini belirtir, böylece işin logunda olduğu gibi görünür:
{"error": {"code": "permission-denied",
"message": "TRUSTED PUBLISHER REF MISMATCH: …",
"details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}| Neden | Ne yapmalı |
|---|---|
CI EXCHANGE ORG MISSING | İstek hiçbir kuruluş belirtmedi. Gövde olarak {"orgId": "<your organization id>"} gönderin. |
CI OIDC TOKEN MISSING | İstek bir CI token'ı taşımıyordu. Token'ı Authorization: Bearer <token> olarak gönderin. |
CI OIDC AUDIENCE INVALID | Token başka bir audience için istenmiş. Örnekteki gibi https://dartastic.io için isteyin. |
CI OIDC ISSUER NOT TRUSTED | Token'ın vereni bu kuruluş için güvenilir değil. Bitbucket, CircleCI, GitHub Enterprise Server veya kendi yönettiğiniz bir GitLab için önce bir kuruluş sahibi vereni ekler. |
CI OIDC EXPIRED | Token takas edilmeden önce süresi doldu. Job token'ı ister istemez takas edin. |
CI OIDC TOKEN REPLAYED | Bu token zaten takas edildi. Her token bir kez takas edilir: Her job'da bir kez takas edin. |
TRUSTED PUBLISHER NOT BOUND | Bu kuruluşun hiçbir bağlaması job'ın deposunu belirtmiyor. Depoyu “CI access” içinde bağlayın ve workflow'daki orgId değerini kontrol edin. |
TRUSTED PUBLISHER REPOSITORY MISMATCH | Bağlama başka bir depoyu veya projeyi belirtiyor. UUID'ler ve kimlikler job'ın kendisine ait olmalıdır. |
TRUSTED PUBLISHER WORKFLOW MISMATCH | Job, bağlamanın izin verdiğinden farklı bir workflow veya pipeline dosyasından çalıştı. |
TRUSTED PUBLISHER ENVIRONMENT MISMATCH | Job, bağlamanın environment'ında çalışmadı (veya CircleCI'da onun context'ini kullanmadı). |
TRUSTED PUBLISHER REF MISMATCH | Job, bağlamanın ref pattern'ının eşleşmediği bir branch veya tag üzerinde çalıştı. |
TRUSTED PUBLISHER REPOSITORY ID MISMATCH | Depo silinip aynı adla yeniden oluşturulmuş. Bağlamayı kaldırın ve yeni depoyu bağlayın. |
TRUSTED PUBLISHER AMBIGUOUS | Job ile birden fazla bağlama eşleşiyor. Tam olarak biri eşleşecek şekilde bağlamaları daraltın (workflow, environment veya ref). |
CI OIDC CLAIM MISSING | Token'da, sağlayıcının her zaman gönderdiği bir claim eksik. Token'ın, sağlayıcının kendi CI token'ı olduğunu ve örnekteki gibi istendiğini kontrol edin. |
CI OIDC SSH RERUN | SSH ile yeniden çalıştırılan bir CircleCI job'ı. Job'ı SSH olmadan yeniden çalıştırın. |
CI EXCHANGE RATE LIMITED | Bu depo veya kuruluş için kısa sürede çok fazla takas yapıldı. Her job'da bir kez takas edin, ardından bekleyip yeniden deneyin. |
BOX STATE PUSH FAILED | Paket deposu yeni token'ı almadı. Job'ı yeniden çalıştırın. |