Skip to main content

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"
FileGunakannya untuk
summary.mdDapatkan status larian dan kod keluar yang boleh dibaca manusia.
run.jsonPeriksa hasil berstruktur, semakan, dan perakaunan.
events.jsonlJejak peristiwa tertib dan hasil proses/alat yang terperinci.
transcript.jsonBaca perbualan larian dan jejak alat.
lineage.scalaLihat unjuran Scala bagi graf yang direkodkan.
lineage-data.jsonCari 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.