Cloud Run Jobs Preflight für Fertigungsprüfungen mit Claude Code
Prüfen Sie Prüf-CSV, Fotos, Freigaben, Variablen und Secrets vor der Übergabe an Cloud Run Jobs.
Am Ende der Nachtschicht will die Qualitätsverantwortliche eine Prüf-CSV und eine Fotoliste an den Cloud-Batch übergeben. Der Linienleiter stoppt den Vorgang: Der Los ist noch nicht freigegeben. In der CSV stehen pass, hold und fail gemischt, ein Foto-URI wirkt wie ein Mitarbeitername, und in der Umgebungsvariablen-Tabelle liegt noch ein Wert, der wie ein API-Key im Klartext aussieht. Der Job könnte starten, aber später wird es schwer, diesen Datenfluss gegenüber Kunde, Audit oder Fehleranalyse zu erklären.
Dieser Artikel zeigt, wie Sie mit Claude Code einen Preflight bauen, bevor Fertigungsprüfberichte an Cloud Run Jobs übergeben werden. Cloud Run Jobs sind für Batch-Arbeiten gedacht, bei denen ein Container startet, Aufgaben ausführt und beendet wird. Sie sind kein dauerhaft lauschender HTTP-Service. Hier verbinden wir uns nicht mit Google Cloud. Der Titel verspricht eine lokale Vertragsprüfung vor der Ausführung, keine Live-Integration.
Zeitabhängige technische Aussagen wurden mit offiziellen Quellen abgeglichen: Cloud Run Jobs erstellen, Umgebungsvariablen für Jobs, Secrets für Jobs, Service Identity für Jobs und Claude Code settings. Der lokale Test beweist nur den lokalen Eingabevertrag; er beweist keine Authentifizierung, kein IAM, keinen Storage-Zugriff und kein Produktionsverhalten.
Kernaussagen
- Fassen Sie Prüf-CSV, Foto-URI-Regeln, Cloud-Run-Job-Konfiguration und Freigabe-Checklist in einer Vorabprüfung zusammen.
- Lassen Sie Claude Code Spalten, Werttypen, Freigabestatus, Namensregeln, Umgebungsvariablen und Secret-Manager-Grenzen lesen.
- Menschen entscheiden über Los-Sperren, Kundenerklärung, Aufbewahrung, Service-Account-Rechte und finale Qualitätsfreigabe.
- Beginnen Sie mit fiktiven lokalen Fixtures. Dieser Artikel ruft weder Cloud Run, Cloud Storage, Secret Manager noch ein Fertigungs-MES auf.
- Die einzige Haupt-CTA ist Training und Beratung für den Entwurf dieser Grenze im Unternehmen.
Workflow: Prüfberichte in einen Cloud-Job-Vertrag verwandeln
Der Workflow passt zu Sichtprüfung, Maßprüfung, Anlagenprüfung oder Qualitätszusammenfassung am Schichtende. Übliche Eingaben sind inspection_results.csv, eine Liste von Foto-URIs, eine Tabelle der Job-Umgebungsvariablen und eine Qualitätsfreigabe. MES bedeutet Manufacturing Execution System, also das interne System für Fertigungsaufträge, Prozessstand und Prüfergebnisse.
Der erste Schritt ist nicht, die KI entscheiden zu lassen, ob der Los gut ist. Definieren Sie zuerst, welche Form eine Eingabe haben muss, bevor sie in den Job darf. In diesem Beispiel braucht die CSV report_id, line_id, product_code, lot_no, measured_value, unit, status, inspector, approved, photo_uri und retention_until. status darf nur pass, hold oder fail sein. Eine Zeile mit approved ungleich yes wird nicht an den Job übergeben.
Foto-URIs dürfen kein verstecktes Notizfeld werden. Besser ist gs://factory-qc-evidence/line-a/2026-09/LOT-1042/report-QC-9001-01.webp mit Linie, Monat, Los und Report-ID. Namen, E-Mails, Telefonnummern und volle Namen gehören nicht in Objekt-Keys. Verwandte Workflows sind Qualitätsproblemberichte in der Fertigung und GKE-Manifest-Reviews für Fertigung. Dieser Artikel konzentriert sich auf den Vertrag dazwischen: vor dem Cloud-Batch.
Danach wird die Cloud-Run-Job-Konfiguration geprüft. Google Cloud dokumentiert, dass Umgebungsvariablen als Key-Value-Paare in den Container injiziert werden und im Code zugänglich sind. Gleichzeitig wird davor gewarnt, Secrets dort zu speichern; dafür sind Secret-Manager-Referenzen gedacht. Wenn der Job Google-Cloud-APIs nutzt, prüfen Sie die Service Identity, also den Service Account des Jobs. Claude Code kann daraus eine Tabelle machen, aber Konto und Rollen werden menschlich freigegeben.
flowchart TD
A[Prüf-CSV lokal vorbereiten] --> B[Foto-URI und Aufbewahrung prüfen]
B --> C[Env/Secret-Grenze des Cloud Run Jobs prüfen]
C --> D[Claude Code erstellt Abweichungstabelle]
D --> E[Qualität entscheidet hold/fail]
E --> F[Nach Freigabe Übergabe an gcloud oder CI]
Was Claude Code übernimmt und was Menschen entscheiden
Claude Code übernimmt wiederholbare Vertragsprüfungen. Es kann fehlende Spalten, nicht numerische Messwerte, nicht freigegebene Zeilen, verdächtige photo_uri-Muster, Images mit :latest, serviceAccount auf default und Variablen mit Namen wie PASSWORD, TOKEN oder API_KEY erkennen. Es eignet sich auch dafür, CSV, Job-JSON und Checklist nebeneinander zu lesen und eine Review-Tabelle zu erstellen.
Menschen entscheiden Qualitätsverantwortung und Betriebsrisiko. Eine Person entscheidet, ob ein hold-Los erneut geprüft, eine Lieferung gestoppt, ein Kunde informiert, eine Foto-Aufbewahrung akzeptiert, ein Service Account berechtigt oder ein Nachtjob gestoppt wird. Claude-Code-Ausgaben sind Entscheidungsunterlagen, keine Rechtsberatung, keine Qualitätsgarantie und kein IAM-Nachweis.
Bei Berechtigungen begrenzen Sie über Claude-Code-settings Datei- und Bash-Zugriff. .env, Produktions-CSV und unmaskierte personenbezogene Daten bleiben außerhalb des Prompts. Arbeiten Sie zuerst mit festen Fixtures und übertragen Sie nur die Review-Tabelle in das echte Verfahren. Die Anfrage lautet nicht “lade hoch”, sondern “prüfe, ob eine menschlich freigegebene Übergabe möglich ist”.
Drei Anwendungsfälle
Use case 1: Entscheiden, welche CSV-Zeilen in den Job dürfen
Eingabe: Prüf-CSV, Spaltendefinition, erlaubte status-Werte, Freigabefeld und Aufbewahrungsdatum. Eine Datei kann pass, hold und fail mischen.
Ausgabe: Tabelle zu fehlenden Spalten, ungültigen Daten, nicht freigegebenen Zeilen, nicht numerischen Messwerten und fehlender Aufbewahrung. Die Ausgabe trennt bereit, menschliche Prüfung und blockiert.
Menschliche Prüfung: Die Qualitätsverantwortlichen entscheiden, ob eine hold- oder fail-Zeile ausgeschlossen, erneut geprüft oder zur Los-Sperre eskaliert wird.
Use case 2: Personen- oder temporäre Daten aus Foto-URIs heraushalten
Eingabe: Foto-URI-Liste, Namensregel, Linien-ID, Losnummer und Report-ID. Unter Zeitdruck bleiben Mitarbeitername, Gerätename oder temporärer Ordner schnell im Objekt-Key.
Ausgabe: Funde für E-Mail-ähnliche Strings, Telefonnummern, lesbare Namen, private und tmp. Claude Code schlägt zusätzlich eine sicherere URI-Form vor.
Menschliche Prüfung: Das Team entscheidet die minimal nachverfolgbare ID, Inhalte des eingeschränkten Registers und erlaubte Key-Muster.
Use case 3: Secret-Grenze des Cloud Run Jobs prüfen
Eingabe: Job-Konfigurations-JSON, Variablentabelle, geplante Secret-Manager-Keys, Service-Account-Name, Retry-Zahl und Timeout.
Ausgabe: Tabelle, ob API_KEY, PASSWORD, TOKEN oder SECRET als Klartextvariablen vorkommen, ob Secret-Referenzen existieren, ob der Account dediziert ist und ob das Image :latest vermeidet.
Menschliche Prüfung: Cloud-Admins entscheiden Secret-Manager-Ressourcen, minimale Rollen und ob fehlgeschlagene Jobs gefahrlos wiederholt werden.
Prompt zum Kopieren
Du bist Preflight-Verantwortliche/r vor der Übergabe eines Fertigungsprüfberichts an einen Cloud Run Job.
Ziel ist, Prüf-CSV, Foto-URI-Regeln, Job-Konfiguration und Freigabe-Checklist vor der Ausführung abzugleichen.
Eingaben:
- Beispiel der Prüf-CSV:
- Namensregel für Foto-URIs:
- Cloud-Run-Job-Konfiguration als JSON:
- Freigabe-Checklist:
- Aufbewahrungs- und Löschregeln:
Prüfe:
1. Fehlende Pflichtspalten
2. measured_value ist nicht numerisch
3. status außerhalb pass/hold/fail
4. approved ist nicht yes
5. photo_uri enthält Namen, E-Mails, Telefonnummern, tmp oder private
6. Job image nutzt latest
7. env enthält API_KEY/PASSWORD/TOKEN als Klartext
8. serviceAccount ist nicht default und zu bestätigende Rechte sind gelistet
Ausgabe:
- Tabelle "bereit", "menschliche Prüfung", "blockiert"
- Korrekturvorschläge
- Punkte für menschliche Freigabe
- Nicht geprüfte Grenzen
Grenzen:
- Keine Verbindung zu echten Cloud-Diensten
- Keine Produktions-CSV oder personenbezogenen Daten in der Ausgabe behalten
- Keine ClaudeCodeLab-, Trainings- oder Website-CTA in das Artefakt schreiben
Ausführbarer lokaler Validator
Der folgende Code prüft nur feste Fixtures des Artikels. Er ruft keine Cloud Run API, kein Cloud Storage, keinen Secret Manager, kein MES und kein Netzwerk auf. Wenn Sie ihn speichern, verwenden Sie etwa tools/inspection-job-preflight.mjs; das bedeutet nicht, dass diese Datei im Repository existiert.
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;
Dieser Code beweist nur lokales Parsing und Fixture-Prüfung. Er beweist nicht, dass ein Job erstellt werden kann, Rollen korrekt sind, ein Secret existiert, ein Fotoobjekt vorhanden ist oder der Batch in Produktion endet.
Fallstricke und Korrekturen
Der erste Fehler ist, hold-Zeilen weiterzugeben, weil “später jemand schaut”. Ursache ist die Vermischung von Aggregation und Qualitätsentscheidung. Korrektur: pass, hold und fail vor dem Job-Input trennen; hold und fail gehen in eine menschliche Review-Queue.
Der zweite Fehler ist, Foto-URIs als Notizfeld zu nutzen. Mitarbeiternamen, E-Mails, Gerätenamen, tmp oder private erschweren spätere Löschung und Zugriffserklärung. Korrektur: URI nur mit Linie, Monat, Los und Report-ID bilden; Identität und Begründung in ein eingeschränktes Register schreiben.
Der dritte Fehler ist, Umgebungsvariablen und Secrets gleichzusetzen. Cloud Run Jobs unterstützen Variablen, aber Google Cloud verweist für Secrets auf Secret Manager. Korrektur: Nur nicht geheime Einstellungen in env, Verbindungsstrings, API-Keys, Passwörter und Tokens als Secret-Referenzen.
Der vierte Fehler ist serviceAccount: default. Ursache ist die Annahme, ein laufender Job bedeute saubere Berechtigungen. Korrektur: Dedizierten Job-Service-Account erstellen, minimale Rollen je Google-Cloud-API vergeben und Freigebende in der Checklist nennen.
Kleine ROI-Messung
Erfinden Sie keine Einsparquote. Zählen Sie blockierte Arbeit. Zwei Wochen lang erfassen Sie CSV-Zeilen, blockierende Probleme, menschliche Review-Punkte, Neueinreichungen, Zeit vom CSV-Export bis zur Übergabe und Nachtanrufe. Nach dem Preflight messen Sie dieselben Felder erneut. Sinnvolle Signale sind früh erkannte nicht freigegebene Zeilen, URI-Korrekturen, Secret-Migrationsfunde und Rückgaben vor der Nachtschicht.
Ziel ist nicht die Behauptung, Claude Code spare immer feste Minuten. Werk, Linienzahl, Freigabestruktur und Job-Frequenz verändern das Ergebnis. Das erste ROI-Ziel ist, falsche Batch-Eingaben zu finden, solange die richtigen Menschen erreichbar sind.
Häufige Fragen
Q. Kann es ein Cloud Run Service statt eines Jobs sein?
A. Für dauerhaftes HTTP passt ein Service. Wenn ein Container einen Stapel verarbeitet und endet, passt ein Job. Dieser Artikel behandelt nur den lokalen Preflight vor Cloud Run Jobs.
Q. Darf Claude Code die echte CSV sehen?
A. Beginnen Sie mit anonymisierten Fixtures. Bei Produktions-CSV prüfen Sie interne Regeln für Rechte, Speicherort, Audit-Logs und verbotene Spalten. Dies ist keine Rechts- oder Auditberatung.
Q. Reicht der Validator in CI?
A. Nein. CI blockiert einen Teil des Eingabevertrags. Qualitätsfreigabe, Service Identity, Secret Manager, IAM und reale Job-Logs brauchen eigene Prüfung.
Q. Was gebe ich Claude Code?
A. Feste Fixtures, Spaltendefinition, Namensregeln, Job-JSON und Freigabe-Checklist. Keine .env, Produktionskeys, unmaskierte personenbezogene Daten oder Lieferantenverträge einfügen.
In den Betrieb bringen
Ein Cloud-Preflight in der Fertigung ist nicht nur Code. Qualität, Betrieb, IT und Cloud-Administration müssen gemeinsam trennen, was KI prüft und was Menschen stoppen. Für Berechtigungsgrenze, Review-Tabelle, Prompt und ROI-Blatt rund um Cloud Run Jobs und Prüf-CSV nutzen Sie Training und Beratung.
Was ich tatsächlich getestet habe
Ich habe den JavaScript-Validator oben mit node gegen feste lokale Fixtures ausgeführt. Die Ausgabe erkennt nicht numerisches measured_value, nicht freigegebene Zeilen, ungültigen status, photo_uri mit private und tmp, Image mit :latest, default-Konto und Klartext-API_KEY.
Geprüfte offizielle URLs waren Cloud Run Jobs erstellen, Job-Umgebungsvariablen, Job-Secrets, Service Identity und Claude Code settings. Nicht ausgeführt wurden gcloud run jobs create, Cloud Run API, Cloud Storage, Secret Manager, IAM-Prüfung, MES-Verbindung und Produktions-CSV. Der Nachweis endet beim lokalen Eingabevertrag.
Ähnliche Artikel
Mit Claude Code zu GCP Cloud Run deployen: Praxisleitfaden
Eine sichere Node.js-API mit Docker, IAM, Secrets, Logs und Rollback auf Cloud Run bereitstellen.
Hotel-Buchungs-CSV vor Cloud-Übergabe mit Claude Code prüfen
Prüfen Sie Hotel-CSV vor der Cloud-Übergabe auf Personendaten, Einwilligung, Objekt-Keys und Freigabe.
Produkttexte und Allergen-Prüfung in der Lebensmittelproduktion mit KI beschleunigen
QS und Vertrieb in der Lebensmittelproduktion: Produkttexte und Allergenangaben mit Claude Code prüfen. Mit Prompt und Prüfskript.
Kostenloses PDF: Claude-Code-Cheatsheet
E-Mail eintragen und eine Seite mit Befehlen, Review-Gewohnheiten und sicheren Workflows herunterladen.
Wir schützen Ihre Daten und senden keinen Spam.
Über den Autor
Masa
Engineer für praktische Claude-Code-Workflows und Team-Einführung.