Label CI
Pada GitHub Actions, GITHUB_JOB ialah kunci kerja daripada file aliran kerja. Setiap
kejadian kerja matriks berkongsi kunci itu. Untuk membezakannya, hantar
--label ci.job=${{ github.job }}-${{ strategy.job-index }}. Bendera itu
menindih pengesanan automatik.
yb ci
yb ci env mencetak YABANIN_GATEWAY_URL, YABANIN_LABELS,
ANTHROPIC_BASE_URL, dan ANTHROPIC_CUSTOM_HEADERS untuk kerja semasa.
--openai-env menambah OPENAI_BASE_URL. --with-key turut mencetak kunci CI
sebagai YABANIN_API_KEY, OPENAI_API_KEY, dan ANTHROPIC_AUTH_TOKEN.
yb ci exec -- <command> meletakkan persekitaran itu pada proses anak sahaja.
Shell induk tidak berubah, dan stdout arahan ialah stdout proses anak.
Apabila codex atau opencode berada pada PATH, proses anak turut menerima
konfigurasi Codex sementara atau OPENCODE_CONFIG_CONTENT. --isolate menuding
CLAUDE_CONFIG_DIR ke direktori kosong supaya file tetapan runner tidak dapat
menindih pengepala. Kod keluar proses ialah kod keluar proses anak.
yabanin-ci.json merekodkan label, cap masa, kod keluar, dan penggunaan.
Dalam mod sesi, file itu menunggu sehingga 30 saat untuk complete: true.
Dalam mod pengepala, ia meninjau sehingga dua bacaan sepadan, atau 30 saat berlalu. Kunci
tanpa can_read_usage tetap menulis laporan, dengan usage null dan
amaran pada stderr.
yb ci report --pipeline menjumlahkan talian paip. Pada GitLab, tetingkap lalai
bermula pada CI_PIPELINE_CREATED_AT. --fail-over-cost keluar dengan kod 4 selepas
laporan ditulis apabila kos lebih tinggi. --gitlab-metrics menulis
OpenMetrics (yabanin_cost_usd, yabanin_tokens_in, yabanin_tokens_out,
yabanin_requests) untuk artifacts:reports:metrics. GitLab menunjukkan
widget itu pada Premium dan Ultimate. Pada Free, file itu hanyalah artifak.
yb ci finish menulis laporan tanpa menjalankan arahan. Jika langkah finish
tidak dijalankan, kunci sesi tamat tempoh pada TTL-nya.
Coretan pemasangan dan pemboleh ubah checksum binari berada dalam integrations/README.md.
Kos talian paip atau tiket
yb ci exec --session=on mengeluarkan kunci ybs_ apabila kunci CI mempunyai
can_mint_sessions. Proses anak menerima kunci itu, bukan kunci jangka panjang.
Laporan kemudian meninjau GET /v1/yabanin/session-keys/{id}/usage sehingga
complete benar atau 30 saat berlalu. Mod pengepala meninjau
GET /v1/yabanin/usage sehingga dua badan sepadan. Dalam mana-mana keadaan
yabanin-ci.json mempunyai version 1, mode, session_key_id (null apabila
tiada sesi), dan usage.
yb ci report --pipeline menjumlahkan talian paip. Penapis peneroka untuk
larian yang sama ialah label.ci.pipeline = "<id>". Tiket menggunakan label yang
dihasilkan oleh dasar, biasanya label.issue = "PAY-123":
label.issue = "PAY-123"
Panel talian paip pada papan CI mengumpulkan cost_usd mengikut label:ci.pipeline,
maka id yang sama menunjukkan permintaan yang sama selepas log mempunyainya. Mod
sesi mengaitkan permintaan itu kepada kunci induk dan kepada id sesi.
Keselamatan
Kunci CI bertopeng dan dilindungi. Aliran kerja daripada fork tidak boleh menerima
kunci itu. pull_request daripada fork tidak mendapat rahsia. Jangan gunakan
pull_request_target untuk menjalankan kod daripada permintaan tarik: peristiwa itu mendedahkan
rahsia kepada kod yang tidak dipercayai.
Berikan kunci CI hak minimum: mengeluarkan kunci sesi dan membaca penggunaannya sendiri. Jangan berikan pentadbiran organisasi.
Pada GitLab, jangan tulis kunci ke dalam artifak dotenv. yb ci env --format gitlab-dotenv --with-key menolak melainkan
--allow-secret-dotenv ditetapkan. Utamakan yb ci exec, yang menghantar kunci
kepada proses anak sahaja.
yb tidak mencetak kunci API. yb ci env --format github mengeluarkan
::add-mask:: sebelum setiap rahsia. yb harness key dan yb key print menulis
kunci tanpa newline di hujung dan tanpa teks lain, untuk proses pembantu,
bukan untuk log.