Preflight Cloud Run Jobs untuk inspeksi manufaktur dengan Claude Code
Cek CSV inspeksi, metadata foto, approval, env vars, dan secret sebelum handoff ke Cloud Run Jobs.
Menjelang akhir shift malam, penanggung jawab kualitas hendak mengirim CSV inspeksi dan daftar foto eksterior ke batch cloud. Kepala lini menghentikan proses: lot ini belum disetujui. CSV berisi campuran baris pass, hold, dan fail; salah satu URI foto tampak mengandung nama pekerja; tabel environment variable masih menyimpan nilai seperti API key dalam teks biasa. Job mungkin berjalan, tetapi nanti tim akan sulit menjelaskan perpindahan data itu kepada pelanggan, auditor, atau tim analisis cacat.
Artikel ini membuat workflow preflight dengan Claude Code sebelum laporan inspeksi manufaktur diserahkan ke Cloud Run Jobs. Cloud Run Jobs digunakan untuk batch yang menjalankan container, menyelesaikan tugas, lalu keluar; bukan service HTTP yang terus mendengarkan request. Di sini kita tidak terhubung ke Google Cloud. Judulnya dibatasi sebagai pemeriksaan kontrak lokal sebelum eksekusi, bukan integrasi live.
Klaim teknis yang mudah berubah diverifikasi melalui dokumen resmi: membuat Cloud Run Jobs, environment variable untuk jobs, secrets untuk jobs, service identity untuk jobs, dan Claude Code settings. Validator lokal hanya membuktikan kontrak input lokal, bukan autentikasi, IAM, akses storage, atau perilaku produksi.
Poin utama
- Satukan CSV inspeksi, aturan URI foto, konfigurasi Cloud Run Job, dan checklist approval dalam satu review sebelum handoff.
- Minta Claude Code memeriksa kolom, tipe nilai, status approval, aturan nama, environment variable, dan batas Secret Manager.
- Manusia tetap memutuskan lot hold, penjelasan ke pelanggan, masa retensi, scope service account, dan approval kualitas final.
- Mulai dari fixture lokal fiktif. Artikel ini tidak memanggil Cloud Run, Cloud Storage, Secret Manager, atau MES pabrik.
- CTA utama tunggal adalah training dan konsultasi untuk merancang batas ini dalam workflow perusahaan.
Workflow: mengubah laporan inspeksi menjadi kontrak job cloud
Workflow ini cocok untuk inspeksi visual, inspeksi dimensi, pengecekan mesin, atau ringkasan kualitas akhir shift. Input umumnya berupa inspection_results.csv, daftar URI foto, tabel environment variable untuk batch job, dan checklist approval kualitas. MES berarti manufacturing execution system, yaitu sistem internal yang melacak work order, status proses, dan hasil inspeksi.
Langkah pertama bukan meminta AI menentukan lot baik atau tidak. Langkah pertama adalah mendefinisikan bentuk input yang boleh masuk ke job. Pada contoh ini CSV wajib memiliki report_id, line_id, product_code, lot_no, measured_value, unit, status, inspector, approved, photo_uri, dan retention_until. status hanya boleh pass, hold, atau fail. Baris dengan approved selain yes tidak boleh masuk ke input job.
URI foto juga tidak boleh menjadi kolom catatan tersembunyi. Pola yang lebih aman adalah gs://factory-qc-evidence/line-a/2026-09/LOT-1042/report-QC-9001-01.webp, memakai lini, bulan, lot, dan ID laporan. Jangan masukkan nama pekerja, email, nomor telepon, atau nama lengkap ke object key. Workflow terkait ada di laporan masalah kualitas manufaktur dan review manifest GKE manufaktur. Artikel ini fokus pada kontrak di tengahnya: sebelum batch cloud.
Berikutnya, review konfigurasi Cloud Run Job. Dokumentasi Google Cloud menjelaskan bahwa environment variable disuntikkan sebagai pasangan key/value yang bisa dibaca kode dalam container, dan memperingatkan agar secret tidak disimpan di sana. Untuk secret, gunakan referensi Secret Manager. Jika job mengakses API Google Cloud, cek service identity, yaitu service account yang dipakai job. Claude Code dapat merapikan semua itu menjadi checklist, tetapi approval akun dan role tetap manusia.
flowchart TD
A[Siapkan CSV inspeksi lokal] --> B[Cek URI foto dan aturan retensi]
B --> C[Review batas env/secret Cloud Run Job]
C --> D[Claude Code membuat tabel temuan]
D --> E[Quality owner memutuskan hold/fail]
E --> F[Setelah approval, manusia menyerahkan ke gcloud atau CI]
Apa yang dikerjakan Claude Code dan apa yang diputuskan manusia
Claude Code menangani pemeriksaan kontrak yang berulang. Ia dapat menemukan kolom hilang, pengukuran nonnumerik, baris belum disetujui, pola photo_uri mencurigakan, image yang masih :latest, serviceAccount yang masih default, dan environment variable bernama seperti PASSWORD, TOKEN, atau API_KEY. Ia juga membantu membandingkan CSV, JSON job, dan checklist untuk membuat tabel review.
Manusia memutuskan tanggung jawab kualitas dan risiko operasional. Seseorang harus memutuskan apakah lot hold perlu reinspeksi, apakah pengiriman berhenti, apa yang dijelaskan ke pelanggan, apakah retensi foto sesuai kontrak, izin minimum service account, dan kapan job malam harus dihentikan. Output Claude Code adalah bahan keputusan, bukan nasihat hukum, bukan jaminan kualitas, dan bukan bukti IAM benar.
Untuk permission, gunakan settings Claude Code agar akses file dan Bash terbatas. Jangan masukkan .env, CSV produksi, atau data pribadi tanpa masking ke prompt. Bekerjalah dulu dengan fixture tetap, lalu pindahkan hanya tabel review ke prosedur nyata. Permintaan ke Claude Code bukan “upload ini”, melainkan “cek apakah ini siap untuk upload setelah approval manusia”.
Tiga kasus penggunaan
Use case 1: menentukan baris CSV yang boleh masuk job
Input: CSV inspeksi, definisi kolom, nilai status yang diizinkan, field approval, dan tanggal retensi. Satu file dapat berisi pass, hold, dan fail sekaligus.
Output: tabel kolom hilang, tanggal invalid, baris belum approved, pengukuran nonnumerik, dan retensi kosong. Output memisahkan siap, perlu review manusia, dan blocked.
Cek manusia: quality owner menentukan apakah baris hold atau fail dikeluarkan, diinspeksi ulang, atau dieskalasi menjadi penghentian lot.
Use case 2: mencegah data pribadi atau sementara dalam URI foto
Input: daftar URI foto, aturan nama, ID lini, nomor lot, dan ID laporan. Saat terburu-buru, nama pekerja, perangkat, atau folder sementara bisa tertinggal dalam object key.
Output: temuan string mirip email, telepon, nama terbaca, private, dan tmp. Claude Code juga mengusulkan bentuk URI yang lebih aman.
Cek manusia: tim memutuskan ID minimum yang dapat dilacak, informasi yang harus tetap di ledger terbatas, dan pola object key yang boleh dipakai.
Use case 3: review batas secret Cloud Run Job
Input: JSON konfigurasi job, tabel environment variable, key yang direncanakan untuk Secret Manager, nama service account, retry count, dan timeout.
Output: tabel apakah API_KEY, PASSWORD, TOKEN, atau SECRET muncul sebagai env biasa, apakah referensi secret ada, apakah service account dedicated, dan apakah image menghindari :latest.
Cek manusia: admin cloud memutuskan resource Secret Manager, role least-privilege, dan apakah job gagal boleh dicoba ulang.
Prompt siap salin
You are the preflight reviewer for a manufacturing inspection report before handoff to a Cloud Run Job.
Goal: align inspection CSV, photo URI rules, Cloud Run Job settings, and approval checklist before execution.
Inputs:
- Inspection CSV sample:
- Photo URI naming rule:
- Cloud Run Job settings JSON:
- Approval checklist:
- Retention and deletion rules:
Check:
1. Missing required columns
2. measured_value is not numeric
3. status outside pass/hold/fail
4. approved is not yes
5. photo_uri contains personal names, emails, phone numbers, tmp, or private
6. Cloud Run Job image uses latest
7. env contains plain API_KEY/PASSWORD/TOKEN-like secrets
8. serviceAccount is not default and permissions to confirm are listed
Output:
- Table with "ready", "human review", and "blocked"
- Fix suggestions
- Items a human must approve
- Untested boundaries
Constraints:
- Do not connect to real cloud services
- Do not keep production CSV or personal data in the output
- Do not insert ClaudeCodeLab, training links, or site-owned CTAs into the generated artifact
Validator lokal yang bisa dijalankan
Kode berikut hanya memeriksa fixture tetap dari artikel. Kode ini tidak memanggil Cloud Run API, Cloud Storage, Secret Manager, MES pabrik, atau jaringan. Jika disimpan lokal, gunakan path seperti tools/inspection-job-preflight.mjs; itu tidak berarti file sudah ada di repositori ini.
const requiredColumns = ["report_id","line_id","product_code","lot_no","measured_value","unit","status","inspector","approved","photo_uri","retention_until"];
const inspectionCsv = `report_id,line_id,product_code,lot_no,measured_value,unit,status,inspector,approved,photo_uri,retention_until
QC-9001,line-a,P-441,LOT-1042,0.31,mm,pass,EMP-014,yes,gs://factory-qc-evidence/line-a/2026-09/LOT-1042/report-QC-9001-01.webp,2027-09-30
QC-9002,line-a,P-441,LOT-1042,not-number,mm,hold,EMP-014,no,gs://factory-qc-evidence/private/[email protected],2027-09-30
QC-9003,line-b,P-882,LOT-2099,12.8,N,review,EMP-091,yes,gs://factory-qc-evidence/line-b/tmp/LOT-2099/report-QC-9003.webp,`;
const jobConfig = { name: "inspection-summary-job", image: "asia-northeast1-docker.pkg.dev/factory/prod/inspection-summary:latest", serviceAccount: "default", maxRetries: 3, timeoutSeconds: 1800, env: { REPORT_BUCKET: "factory-qc-evidence", API_KEY: "plain-text-key" }, secrets: { DB_PASSWORD: "projects/123456789/secrets/qc-db-password:2" } };
function parseCsv(text) { const [headerLine, ...rows] = text.trim().split("\n"); const headers = headerLine.split(","); return rows.map((line) => { const values = line.split(","); return Object.fromEntries(headers.map((header, index) => [header, values[index] ?? ""])); }); }
function looksLikeIsoDate(value) { return /^\d{4}-\d{2}-\d{2}$/.test(value) && !Number.isNaN(Date.parse(value)); }
function validateRows(rows) { const issues = []; const allowedStatus = new Set(["pass", "hold", "fail"]); for (const [index, row] of rows.entries()) { const rowNo = index + 1; for (const column of requiredColumns) { if (!(column in row) || row[column].trim() === "") issues.push({ scope: `row ${rowNo}`, severity: "block", message: `missing ${column}` }); } if (!Number.isFinite(Number(row.measured_value))) issues.push({ scope: `row ${rowNo}`, severity: "block", message: "measured_value must be numeric" }); if (!allowedStatus.has(row.status)) issues.push({ scope: `row ${rowNo}`, severity: "block", message: "status must be pass, hold, or fail" }); if (row.status !== "pass" || row.approved !== "yes") issues.push({ scope: `row ${rowNo}`, severity: "review", message: "human approval required before handoff" }); if (!looksLikeIsoDate(row.retention_until)) issues.push({ scope: `row ${rowNo}`, severity: "review", message: "retention_until must be an ISO date" }); if (/@|\b\d{2,4}[- ]\d{2,4}[- ]\d{3,4}\b|private|tmp/i.test(row.photo_uri)) issues.push({ scope: `row ${rowNo}`, severity: "review", message: "photo_uri may expose personal or temporary data" }); } return issues; }
function validateJobConfig(config) { const issues = []; if (/:latest\b/.test(config.image)) issues.push({ scope: "job.image", severity: "block", message: "pin the image tag or digest instead of latest" }); if (!config.serviceAccount || config.serviceAccount === "default") issues.push({ scope: "job.serviceAccount", severity: "block", message: "use a dedicated service account" }); for (const key of Object.keys(config.env ?? {})) { if (/(API_KEY|PASSWORD|TOKEN|SECRET)/i.test(key)) issues.push({ scope: `job.env.${key}`, severity: "block", message: "move secrets to Secret Manager references" }); } if (!config.secrets || Object.keys(config.secrets).length === 0) issues.push({ scope: "job.secrets", severity: "review", message: "list required Secret Manager references" }); if (!Number.isInteger(config.maxRetries) || config.maxRetries < 0 || config.maxRetries > 5) issues.push({ scope: "job.maxRetries", severity: "review", message: "confirm retry count with operations" }); return issues; }
const rows = parseCsv(inspectionCsv);
const report = [...validateRows(rows), ...validateJobConfig(jobConfig)];
console.table(report);
process.exitCode = report.some((item) => item.severity === "block") ? 1 : 0;
Kode ini hanya membuktikan parsing lokal dan validasi fixture. Ia tidak membuktikan Cloud Run Job bisa dibuat, service account punya role benar, Secret Manager berisi nilai, objek foto ada, atau batch produksi selesai.
Jebakan dan perbaikan
Jebakan pertama adalah membiarkan baris hold lewat karena “nanti ada yang cek”. Penyebabnya adalah mencampur agregasi dengan keputusan kualitas di batch yang sama. Perbaikannya: pisahkan pass, hold, dan fail sebelum input job dibuat. Hold dan fail masuk antrean review manusia, bukan payload Cloud Run Job.
Jebakan kedua adalah memakai URI foto sebagai kolom catatan. Nama pekerja, email, nama perangkat, tmp, atau private dalam object key membuat penghapusan dan scope akses sulit dijelaskan. Perbaikannya: URI hanya memakai lini, bulan, lot, dan ID laporan; identitas dan alasan keputusan masuk ledger terbatas.
Jebakan ketiga adalah menyamakan environment variable dan secret. Cloud Run Jobs mendukung variable, tetapi Google Cloud mengarahkan secret ke Secret Manager. Perbaikannya: simpan hanya konfigurasi nonsecret di env; connection string, API key, password, dan token dipindah ke referensi secret.
Jebakan keempat adalah membiarkan serviceAccount: default. Penyebabnya adalah mengira job yang berjalan berarti permission sudah didesain. Perbaikannya: buat service account khusus job, beri role minimum per API Google Cloud, dan tulis approver dalam checklist.
Pengukuran ROI kecil
Jangan mengarang persentase hemat waktu. Hitung pekerjaan yang tertahan. Selama dua minggu, catat jumlah baris CSV, isu block, isu review manusia, resubmission, waktu dari export CSV ke handoff, dan panggilan malam. Setelah preflight, catat field yang sama dua minggu. Sinyal berguna adalah baris belum approved yang terdeteksi awal, perbaikan URI, temuan migrasi secret, dan penolakan sebelum shift malam.
Tujuannya bukan mengklaim Claude Code selalu menghemat menit tetap. Pabrik, jumlah lini, struktur approval, dan frekuensi job mengubah hasil. Target ROI pertama adalah menemukan input yang tidak boleh masuk batch saat orang yang tepat masih tersedia.
Pertanyaan umum
Q. Bisa memakai Cloud Run service, bukan Job?
A. Pakai service untuk HTTP berkelanjutan. Pakai Job saat container memproses batch lalu selesai. Artikel ini hanya membahas preflight lokal sebelum handoff ke Cloud Run Jobs.
Q. Bolehkah CSV asli diberikan ke Claude Code?
A. Mulai dari fixture anonim. Untuk CSV produksi, konfirmasi aturan internal tentang permission, lokasi simpan, audit log, dan kolom terlarang. Ini bukan nasihat hukum atau audit.
Q. Apakah memasukkan validator ke CI sudah cukup?
A. Tidak. CI hanya memblokir sebagian kontrak input. Approval kualitas, service identity, Secret Manager, IAM, dan log job nyata tetap perlu review terpisah.
Q. Apa yang harus diberikan ke Claude Code?
A. Fixture tetap, definisi kolom, aturan nama, JSON job, dan checklist approval. Jangan tempel .env, key produksi, data pribadi tanpa masking, atau kontrak supplier.
Masuk ke operasi perusahaan
Preflight cloud manufaktur bukan sekadar kode. Kualitas, operasi, sistem informasi, dan admin cloud perlu bahasa yang sama untuk memisahkan cek yang didelegasikan ke AI dan keputusan yang dipegang manusia. Untuk merancang batas permission, tabel review, prompt, dan lembar ROI seputar Cloud Run Jobs dan CSV inspeksi, gunakan training dan konsultasi.
Hasil yang benar-benar diuji
Saya menguji validator JavaScript di atas dengan node terhadap fixture lokal tetap. Output mendeteksi measured_value nonnumerik, baris belum approved, status invalid, photo_uri berisi private dan tmp, image :latest, service account default, dan API_KEY teks biasa.
URL resmi yang diperiksa adalah pembuatan Cloud Run Jobs, environment variable jobs, secrets jobs, service identity jobs, dan Claude Code settings. Saya tidak menjalankan gcloud run jobs create, tidak memanggil Cloud Run API, tidak membaca Cloud Storage, tidak mengakses Secret Manager, tidak memverifikasi IAM, tidak menghubungkan MES, dan tidak memeriksa CSV produksi. Bukti hanya sampai kontrak input lokal bisa diperiksa.
Artikel terkait
Deploy ke GCP Cloud Run dengan Claude Code: panduan praktis
Deploy API Node.js yang aman di Cloud Run dengan Docker, IAM, secrets, logs, dan rollback.
Preflight CSV reservasi hotel untuk cloud dengan Claude Code
Periksa CSV reservasi hotel sebelum cloud: data pribadi, persetujuan, object key, dan approval manusia.
Digitalkan SOP dan Catatan Gambar Teknik Bengkel Manufaktur dengan AI dan Claude Code
Cara mengubah SOP dan catatan gambar teknik bengkel manufaktur kecil jadi dokumen digital dengan Claude Code dan AI generatif.
PDF gratis: cheatsheet Claude Code
Masukkan email dan unduh satu halaman berisi command, kebiasaan review, dan workflow aman.
Kami menjaga datamu dan tidak mengirim spam.
Tentang penulis
Masa
Engineer yang berfokus pada workflow Claude Code praktis dan adopsi tim.