製造業のCloud Run検査ジョブ投入前チェックをClaude Codeで作る: CSV、写真、承認、環境変数の事故を防ぐ
検査CSVと写真メタデータをCloud Run Jobsへ渡す前に、Claude Codeで契約違反を見つける手順。
夜勤明けの品質担当者が、検査CSVと外観写真の一覧をクラウド処理へ渡そうとした瞬間に、ライン長から「このロットはまだ承認していない」と止められる。CSVには合格品と保留品が混ざり、写真の保存先には作業者名らしい文字列が入り、環境変数の表にはAPIキーのような値が平文で残っている。ジョブを実行すれば処理は進むかもしれないが、後で不良解析、監査、取引先報告のどこかで説明できなくなる事故になる。
この記事では、製造業の検査報告をCloud Run Jobsへ投入する前に、Claude Codeで「投入してよい形か」を点検するワークフローを作ります。Cloud Run Jobsは、HTTPリクエストを待ち受けるサービスではなく、コンテナを起動して処理を終えたら終了するバッチ処理の仕組みです。ここではGoogle Cloudへ接続しません。タイトルもライブ連携ではなく、投入前のプリフライト、つまり実行前の契約チェックに限定しています。
参考にした一次情報は、Cloud Run Jobsが既存コンテナイメージから作成・更新され、タスクを実行して終了するというGoogle Cloud公式ドキュメント、Cloud Run Jobsの環境変数とSecret Managerの扱い、サービスIDの説明、そしてClaude Codeのsettingsと権限設定です。実装判断では、Cloud Run Jobsの作成、ジョブの環境変数、ジョブのシークレット、ジョブのサービスID、Claude Code settingsを確認しました。
この記事の要点
- 検査CSV、写真URI、Cloud Run Job設定、承認チェックリストを一つの投入前レビューにまとめます。
- Claude Codeには、CSVの列、値の型、承認状態、保存先命名、環境変数とシークレットの境界を読ませます。
- 人は、ロットを止める判断、取引先への説明、保管期間、品質責任者の承認、クラウド権限を判断します。
- コードはローカル固定フィクスチャだけを検査します。Cloud Run、Cloud Storage、Secret Manager、社内MESには接続しません。
- 主CTAは、会社でこの運用境界を設計するための研修・相談に絞ります。
ワークフロー: 検査報告をCloud Run Jobに渡す前の契約をそろえる
対象は、外観検査、寸法検査、設備点検のように、検査CSVと写真メタデータを夜間バッチで集計する現場です。よくある入力は、inspection_results.csv、写真URI一覧、Cloud Run Jobの環境変数表、品質担当者の承認チェックリストです。MESは製造実行システムのことで、製造指示、工程進捗、検査結果を扱う社内システムを指します。
最初に決めるのは、AIに「正解」を決めさせるのではなく、投入前の契約をそろえることです。たとえば、CSVにはreport_id、line_id、product_code、lot_no、measured_value、unit、status、inspector、approved、photo_uri、retention_untilを必須にします。statusはpass、hold、failだけにし、approvedがyesでない行はジョブへ渡しません。
次に、写真URIの命名を人が読める範囲に留めます。gs://factory-qc-evidence/line-a/2026-09/LOT-1042/report-QC-9001-01.webpのように、ライン、年月、ロット、報告IDで表します。作業者名、メール、電話番号、フルネームをキーに入れません。既存記事では製造業の品質トラブル報告で報告文の整え方を扱い、GKEマニフェストの公開前レビューで本番反映前の確認表を扱いました。今回はその間にある「クラウドバッチ投入前」の契約に集中します。
最後に、Cloud Run Job設定をレビューします。Google Cloud公式ドキュメントでは、環境変数はコンテナから参照できるキーと値として注入されますが、シークレットを環境変数に直接置かないよう注意が示されています。ジョブがGoogle Cloud APIへアクセスする場合はサービスID、つまりジョブが使うサービスアカウントに必要なロールを与える考え方も確認します。
flowchart TD
A[検査CSVをローカルで用意] --> B[写真URIと保管期限を点検]
B --> C[Cloud Run Job設定の環境変数とsecret境界を確認]
C --> D[Claude Codeで差分とレビュー表を作る]
D --> E[品質責任者がhold/failと承認を判断]
E --> F[承認後に人がgcloudまたはCIへ渡す]
Claude Codeに任せる範囲と人が判断する範囲
Claude Codeに任せる範囲は、機械的に確認できる入力契約です。列が足りない、数値であるべき値が文字列になっている、approvedがyesでない、photo_uriにメールらしい文字列が入っている、imageが:latestのまま、serviceAccountが既定値のまま、envにPASSWORDやAPI_KEYが平文である、といった確認です。Claude Codeはコード、CSV、JSON、チェックリストを並べて、レビュー表と修正案を作るのが得意です。
人が判断する範囲は、品質責任と事業判断です。holdのロットをいつ再検査するか、取引先へ何を説明するか、写真の保管期間が契約や社内規程と合っているか、サービスアカウントにどこまで権限を与えるか、夜間ジョブを止める基準は何かを人が決めます。Claude Codeの出力は判断材料であって、法的結論、品質保証の最終判断、Google Cloud上の権限確認を自動で完了するものではありません。
権限面では、Claude Codeのsettingsで読み取り範囲やBash実行を制限します。たとえば.envや本番CSVの読み取りを避け、固定フィクスチャで検証してから、レビュー表だけを本番手順へ移します。Claude Codeに「アップロードして」と頼むのではなく、「アップロードしてよい形かを点検して」と頼むのが境界です。
3つのUse case
Use case 1: 検査CSVの投入可否を判定する
入力: 検査CSV、列定義、許可するstatus、承認欄、保管期限です。行ごとにpass、hold、failが混在していることがあります。
出力: 不足列、日付形式エラー、未承認行、数値化できない測定値、保管期限の不足を表にします。ジョブへ渡してよい行と、人が確認する行を分けます。
人の確認: holdとfailを投入対象から外すだけでよいか、再検査するか、ロット全体を止めるかを品質責任者が判断します。
Use case 2: 写真URIに個人名や余計な情報が混ざらないようにする
入力: 写真URI一覧、命名ルール、ラインID、ロット番号、報告IDです。現場では、急いで保存した写真に作業者名や端末名が残ることがあります。
出力: メール、電話番号、スペースを含む名前らしい文字列、privateやtmpのような保管場所を疑う文字列を検知します。推奨URIの例も出します。
人の確認: URIから消してよい情報、追跡に必要な最小ID、監査で見せるべき台帳の粒度を決めます。
Use case 3: Cloud Run Job設定のsecret境界を確認する
入力: Cloud Run Job設定JSON、環境変数表、Secret Managerへ置く予定のキー、サービスアカウント名、リトライ回数です。
出力: API_KEY、PASSWORD、TOKENが平文環境変数にないか、secretsに移す項目があるか、serviceAccountが既定値でないか、imageが:latestでないかを表にします。
人の確認: どのSecret Managerシークレットを参照するか、ジョブのサービスIDに必要な最小権限は何か、失敗時に再実行してよい処理かを判断します。
コピペで使えるプロンプト
あなたは製造業の検査報告をCloud Run Jobへ渡す前のプリフライト担当です。
目的は、検査CSV、写真URI、Cloud Run Job設定、承認チェックリストを投入可能な形にそろえることです。
入力:
- 検査CSVのサンプル:
- 写真URIの命名ルール:
- Cloud Run Job設定JSON:
- 承認チェックリスト:
- 保管期間と削除ルール:
確認してほしいこと:
1. 必須列が足りない行
2. measured_valueが数値ではない行
3. statusがpass/hold/fail以外の行
4. approvedがyesではない行
5. photo_uriに個人名、メール、電話番号、tmp/privateが含まれる行
6. Cloud Run Jobのimageがlatestではないか
7. envにAPI_KEY/PASSWORD/TOKENなどのsecretが平文でないか
8. serviceAccountが既定値ではなく、確認すべき権限が列挙されているか
出力:
- 「投入可」「人の確認」「投入不可」の3分類表
- 修正案
- 人が承認すべき項目
- 未検証の境界
制約:
- 実クラウドへ接続しない
- 本番CSVや個人情報を出力に残さない
- ClaudeCodeLabや自社サイトのCTAを生成物に入れない
ローカルで動く検査コード
次のコードは、記事用の固定フィクスチャだけを検査します。Cloud Run API、Cloud Storage、Secret Manager、社内MES、ネットワークには接続しません。保存する場合のパス例はtools/inspection-job-preflight.mjsです。このリポジトリにそのファイルが存在するという意味ではなく、読者の環境で試すための完全な内容です。
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;
このコードが証明するのは、ローカル文字列の入力契約だけです。Cloud Run Jobが作成できること、サービスアカウントが正しいこと、Secret Managerに値があること、Cloud Storageへ写真があること、夜間ジョブが本番で完走することは証明しません。
Pitfall: よくある原因と具体的な直し方
一つ目の落とし穴は、pass以外の行も「後で人が見るから」と投入してしまうことです。原因は、CSVの集計と品質判断を同じバッチに混ぜることです。直し方は、pass、hold、failを先に分け、holdとfailをCloud Run Jobの入力ではなく、人のレビューキューへ送ることです。
二つ目は、写真URIを便利なメモ欄のように使うことです。作業者名、端末名、メール、tmpが入ると、後で削除や共有範囲の説明が難しくなります。直し方は、URIをライン、年月、ロット、報告IDだけにし、作業者や判断理由は別の権限付き台帳に置くことです。
三つ目は、環境変数とシークレットを同じものとして扱うことです。Google Cloudの公式ドキュメントは、Cloud Run Jobの環境変数を設定できますが、秘密情報はSecret Managerを使うよう注意しています。直し方は、非秘密の設定だけをenvに置き、接続文字列、APIキー、パスワード、トークンはSecret Manager参照へ移すことです。
四つ目は、serviceAccount: defaultのまま進めることです。原因は、ジョブが動けば権限設計も終わったと考えることです。直し方は、ジョブ専用サービスアカウントを作り、必要なGoogle Cloud APIごとに最小権限を確認し、承認者をチェックリストに書くことです。
小さく測るROI
ROIは、架空の削減率ではなく、投入前レビューの詰まりを数えます。まず2週間だけ、検査CSVの行数、ブロック件数、人の確認件数、再提出件数、ジョブ投入までの待ち時間、夜間呼び出し件数を記録します。次に、プリフライト後の2週間で同じ項目を記録します。見るべき指標は、未承認行の事前検知率、写真URIの修正件数、secret移行件数、投入前の差し戻し回数です。
大切なのは、「Claude Codeで何分短縮」と決め打ちしないことです。検査内容、ライン数、承認者の人数で変わります。最初の目標は、夜間ジョブの成功率ではなく、投入してはいけない入力を昼間のうちに見つけることです。
よくある質問
Q. Cloud Run JobsではなくCloud Runサービスでもよいですか。
A. 常時HTTPで受ける処理ならサービスが向きます。検査CSVをまとめて読み、集計して終了するだけならJobsが候補になります。この記事はJobs投入前のローカル契約チェックに絞っています。
Q. 実際のCSVをClaude Codeに読ませてもよいですか。
A. まず匿名化したサンプルで列とルールを固めます。本番CSVを扱う場合は、権限、保存場所、監査ログ、持ち出し禁止列を社内ルールで確認してください。この記事は個別の法務・監査助言ではありません。
Q. このコードをCIに入れれば十分ですか。
A. 十分ではありません。CIは入力契約の一部を止めるだけです。品質責任者の承認、Cloud Run JobのサービスID、Secret Manager参照、Google Cloud上のIAM、ジョブ実行履歴は別に確認します。
Q. Claude Codeには何を渡せばよいですか。
A. 固定フィクスチャ、列定義、命名ルール、設定JSON、承認チェックリストです。.env、本番鍵、未匿名化の個人情報、取引先契約書そのものを貼り付けないでください。
会社の運用に入れるなら
製造業のクラウド投入前チェックは、コードだけでは終わりません。現場、品質保証、情シス、クラウド管理者が同じ言葉で「AIに任せる確認」と「人が止める判断」を分ける必要があります。Cloud Run Jobs、Secret Manager、サービスアカウント、検査CSVの境界を自社向けに整理したい場合は、研修・相談で、権限境界、レビュー表、プロンプト、ROI測定表まで一緒に設計できます。
実際に試した結果
この記事で実際に試したのは、上のJavaScript検査コードをnodeで実行した構文チェックとローカル固定フィクスチャの検査です。出力では、measured_valueの非数値、未承認行、statusの不正値、photo_uriのprivateやtmp、:latestのイメージ、defaultサービスアカウント、平文API_KEYが検出されることを確認しました。
確認したURLは、Cloud Run Jobs作成、Jobsの環境変数、Jobsのシークレット、JobsのサービスID、Claude Code settingsの公式ドキュメントです。実行していないことは、gcloud run jobs create、Cloud Run API呼び出し、Cloud Storage参照、Secret Manager参照、IAM権限確認、MES連携、本番CSVの検査です。したがって、この記事の証拠は「ローカル入力契約を検査できた」までであり、本番クラウド連携が成功した証拠ではありません。
まず今日できる次の一歩は、実データではなく3行の匿名CSVを並べ、必須列、approved、photo_uri、envの4点だけを確認する小さなチェック表に移すことです。
次に読む記事
Cloud Run入門:gcloud run deployでコンテナを公開し、0までスケールさせる
ExpressのDockerイメージをCloud Runへ。PORT待受の必須ルール、gcloud run deployの手順、0スケールと料金、Cloud Buildでの自動ビルドを、コピペで動くコード付きで説明します。
製造業の見積もり依頼フォームをClaude Codeで改善する: 図面・納期・材質の抜け漏れ防止
製造業の見積もりフォームを、図面、材質、数量、納期、NDA、CTAまで整理する手順です。
製造業のGKEマニフェストをClaude Codeでレビューする: 本番反映前の確認表
製造業向けにGKEマニフェスト、probes、resources、権限、公開範囲を公開前に点検します。
無料PDF: Claude Code はじめてのチートシート
まずは無料PDFで基本コマンドと最初の使い方をまとめて確認してください。登録後はそのままテンプレート集や導入相談にも進めます。
スパムは送りません。登録情報は厳重に管理します。
Claude Codeを仕事で使える形にしませんか?
まず無料PDFで基本を固め、繰り返し使う作業はGumroad教材へ、チーム導入や権限設計は導入相談へ進めます。
この記事を書いた人
Masa
Claude Codeの実務活用、導入設計、収益導線改善を検証しているエンジニア。10言語の技術メディアを運営中。
関連書籍・参考図書
この記事のテーマに関連する書籍を楽天ブックスで探せます。
※ 当サイトは楽天市場のアフィリエイトプログラムに参加しています。上記リンクから商品をご購入いただくと、運営者に紹介料が支払われる場合があります。