Bu sayfalar Cloud'un URL'lerini gösterir. Dedicated'da giriş yapın, sayfalar sunucunuzun URL'lerini göstersin.

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.

GELİŞTİRMEDARTASTIC MİMARİSİKULLANICILARtoken'larissue'larPub token'ıpushCI token değişimiuygulamalar kullanıcılara ulaşır: uygulama mağazaları, web, sunucularsembollerçökmelerstack trace'lerkaynak kodtelemetriGeliştirici bilgisayarıflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtoken oluşturma · rol tabanlı erişim denetimiControl Planekuruluşlar · roller · token'larDartastic Pubpaketler · kaynak kodObservatoryoturumlar · trace'ler · loglarSymbolizerçökmeler → kaynak kod satırlarıDartastic AIikisinden de beslenen yanıtlarIssue takip aracıGitHub · Jira · LinearMobil ve masaüstü uygulamalartelefonlar · tabletler · masaüstleriOTLP token'ı ile gönderirWeb uygulamalarıtarayıcılardaBrowser OTLP token'ı ile gönderirDart sunucularıbackend'ler · servislerOTLP token'ı ile gönderir

Nasıl çalışır

  1. 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.
  2. 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.
  3. Token değişimini işte yapın. İş, https://dartastic.io audience 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.
  4. Pub token'ını kullanın. dart pub token add token'ı dart pub get ve dart pub publish komutlarına verir (flutter pub da aynı şekilde çalışır).

CI sağlayıcınız

SağlayıcıBağlamadan önce
GitHub ActionsGitHub.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/CDGitLab.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 PipelinesHer 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.
CircleCIHer 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:

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

Yanıt olarak Pub token'ını ve bu token'ın neler yapabileceğini döndürür:

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
}
  • 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:

json
{"error": {"code": "permission-denied",
  "message": "TRUSTED PUBLISHER REF MISMATCH: …",
  "details": {"reason": "TRUSTED PUBLISHER REF MISMATCH"}}}
NedenNe 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 INVALIDToken başka bir audience için istenmiş. Örnekteki gibi https://dartastic.io için isteyin.
CI OIDC ISSUER NOT TRUSTEDToken'ı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 EXPIREDToken takas edilmeden önce süresi doldu. Job token'ı ister istemez takas edin.
CI OIDC TOKEN REPLAYEDBu token zaten takas edildi. Her token bir kez takas edilir: Her job'da bir kez takas edin.
TRUSTED PUBLISHER NOT BOUNDBu 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 MISMATCHBağlama başka bir depoyu veya projeyi belirtiyor. UUID'ler ve kimlikler job'ın kendisine ait olmalıdır.
TRUSTED PUBLISHER WORKFLOW MISMATCHJob, bağlamanın izin verdiğinden farklı bir workflow veya pipeline dosyasından çalıştı.
TRUSTED PUBLISHER ENVIRONMENT MISMATCHJob, bağlamanın environment'ında çalışmadı (veya CircleCI'da onun context'ini kullanmadı).
TRUSTED PUBLISHER REF MISMATCHJob, bağlamanın ref pattern'ının eşleşmediği bir branch veya tag üzerinde çalıştı.
TRUSTED PUBLISHER REPOSITORY ID MISMATCHDepo silinip aynı adla yeniden oluşturulmuş. Bağlamayı kaldırın ve yeni depoyu bağlayın.
TRUSTED PUBLISHER AMBIGUOUSJob 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 MISSINGToken'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 RERUNSSH ile yeniden çalıştırılan bir CircleCI job'ı. Job'ı SSH olmadan yeniden çalıştırın.
CI EXCHANGE RATE LIMITEDBu 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 FAILEDPaket deposu yeni token'ı almadı. Job'ı yeniden çalıştırın.