Baca salasilah larian pengekodan
Salasilah membantu menjawab tiga soalan: apa yang dijalankan, apa yang gagal, dan file
apa yang berubah. Gunakan jq untuk perintah JSON di bawah. Direktori larian mengandungi ringkasan, log peristiwa, transkrip, dan—apabila
strim peristiwa boleh direduksi—dua file salasilah. File salasilah menyusun
larian; log peristiwa dan transkrip menyediakan butiran di sebalik setiap langkah.
Cari larian
Mulakan dengan direktori output yang dicetak oleh perintah raider run anda atau yang ditetapkan oleh
pilihan --out. Setiap seruan yang selesai mendapat direktori work-<id>
sendiri. Gantikan pemegang tempat di bawah dengan laluan sebenar yang dicetak oleh
larian anda; larian baharu mempunyai nama direktori yang berbeza.
RUN_DIR='<path-to-the-printed-work-directory>'
cat "$RUN_DIR/summary.md"
cat "$RUN_DIR/run.json"
| File | Gunakannya untuk |
|---|---|
summary.md | Dapatkan status larian dan kod keluar yang boleh dibaca manusia. |
run.json | Periksa hasil berstruktur, semakan, dan perakaunan. |
events.jsonl | Jejak peristiwa tertib dan hasil proses/alat yang terperinci. |
transcript.json | Baca perbualan larian dan jejak alat. |
lineage.scala | Lihat unjuran Scala bagi graf yang direkodkan. |
lineage-data.json | Cari butiran nod menggunakan kunci dataRef mereka. |
Bagi contoh yang boleh anda baca tanpa menjalankan Raider, buka hasil CI yang disimpan.
Apa yang dijalankan?
Buka lineage-data.json. Setiap item dalam nodes mempunyai nombor jujukan (seq),
jenis, dan biasanya dataRef. parentId menunjukkan pembendungan, seperti panggilan alat
di bawah panggilan model. inputs mengenal pasti nod terdahulu yang hasilnya menyuap
langkah itu. Objek data memetakan setiap dataRef kepada butiran model atau alat
yang direkodkan.
Sebagai contoh, periksa larian baharu tanpa mengandaikan ID nod yang tetap:
jq '.nodes[] | {seq, id, kind, parentId, inputs, dataRef}' \
"$RUN_DIR/lineage-data.json"
jq '.data | to_entries[] | {ref: .key, detail: .value}' \
"$RUN_DIR/lineage-data.json"
Bagi tangkapan CI berbilang peringkat, successful-run.json mengandungi indeks
aplikasi dan enam larian natif yang berasingan. Periksa senarai peringkat dan
ringkasan natif dengan:
jq '.pipelineIndex.stages' docs/examples/ci-pipeline/successful-run.json
jq '.nativeRuns[] | {stage, runId, nativeStatus, nativeExitCode, nodes}' \
docs/examples/ci-pipeline/successful-run.json
Enam akar itu dipautkan oleh indeks aplikasi; ia bukan satu graf
natif. Nilai nativeWorkDir tangkapan mengenal pasti lokasi artifak
asal, manakala JSON yang didaftar masuk mengandungi petikan yang telah disanitasi.
Panduan talian paip menerangkan peringkat dan hasilnya.
Apa yang gagal?
Ikuti dataRef yang berkaitan untuk mencari operasi, kemudian periksa hasil prosesnya
dalam events.jsonl atau transcript.json. Panggilan alat dengan hasil
Succeeded bermakna alat mengembalikan hasil. Ia tidak bermakna perintah
yang dilancarkan oleh alat itu lulus. Dalam contoh pengebilan, proses ujian pra-edit
keluar dengan kod 1 kerana sempadan diskaun yang ketat masih ada. Edit
kemudian dan semakan yang lulus ialah langkah yang berasingan. Baca summary.md dan
run.json untuk status keseluruhan, dan jangan simpulkannya daripada satu nod.
File apa yang berubah?
Periksa ruang kerja yang digunakan untuk larian. Bagi contoh CI, bandingkan sumber yang disalin dengan lekapan asal. Gantikan laluan output dengan laluan yang anda pilih semasa melancarkannya:
PIPELINE_DIR='artifacts/user-ci/run-<your-timestamp>'
diff -u examples/user-guide/fixture/src/main/scala/billing/Discount.scala \
"$PIPELINE_DIR/workspace/src/main/scala/billing/Discount.scala"
Pembaikan yang berjaya menukar > kepada >=. diff keluar dengan kod 1 apabila ia menemui perubahan;
itu dijangka di sini. Bagi tugas dalam projek Git, jalankan git diff daripada
salinan kerja projek itu. Semak diff sebenar dan output ujian sebelum menerima
apa yang diubah oleh ejen.
Unjuran Scala
Perender semasa menghasilkan Program Scala 3 yang berjenis menggunakan gubahan LineageStep
dan Task. Petikan kecil daripada artifak bersatu semasa:
val phase_baseline_check: Program[Unit, Vector[StepReport]] =
Program.fromFunction("phase_baseline_check") { _ =>
LineageStep.phase("camp-billing:n1", "baseline-check", None, Vector.empty, nesting = 1)
.flatMap { n_camp_billing_n1 =>
delegation_ci_baseline(())
.map { n_camp_billing_n2 =>
n_camp_billing_n1 ++ n_camp_billing_n2
}
}
}
Langkah fasa dan anak mengembalikan laporan berstruktur: jenis dan ID nod,
dataRef, input, dan penyarangan. Muatan kekal dalam lineage-data.json.
Unjuran ini ialah perihalan larian kering: melaksanakan
programnya melaporkan struktur graf panggilan yang direkodkan; ia tidak melakukan panggilan model, panggilan
alat, atau I/O. Ia bukan main semula atau jalan semula secara langsung.
Baca artifak Scala salasilah bersatu yang lengkap bersama cara contoh ini dijana. Bagi tangkapan CI enam akar yang berasingan, lihat unjuran natif sejarah yang ditangkap; unjuran komen sahaja yang disimpan itu mendahului perender semasa.
Had main semula
Main semula mempunyai sokongan terhad untuk respons yang direkodkan dan operasi baca sahaja. Ia tidak dapat memainkan semula pembaikan pengebilan yang disimpan di sini. Menjalankan unjuran Scala yang dijana hanya memerihalkan graf; ia tidak menjalankan semula ejen atau mengulangi perubahannya. Lihat rujukan main semula untuk input yang disokong.