Webアプリを動かすには、データベースのパスワードや外部APIのキーなど、公開してはいけない値(秘密情報)が必要になります。
手軽さから、ソースコードやリポジトリ内の設定ファイル、デプロイ設定の環境変数に直接書いてしまうことがあります。
しかし、この方法では、リポジトリを閲覧できる人や、設定画面を開ける人に値が見えてしまい、漏えい時の差し替えも大変です。
この記事では、Google CloudのSecret Managerに秘密情報を置き、Cloud Runから安全に受け取る方法を整理します。
秘密情報をコードや環境変数に直書きしない理由
直書きには、次のような問題があります。
- Gitの履歴に残り、あとから消しても過去のコミットから読める。
- サービスの設定を見られる人全員に、値が見える。
- 値を変えるたびに、コードや設定の変更とデプロイが必要になる。
- 開発・検証・本番で、同じ値を使い回しがちになる。
Secret Managerは、秘密情報を保管するためのGoogle Cloudのサービスです。
値そのものに加えて、版(バージョン)の管理、IAM(アクセス権限の管理)による利用者の制限、アクセスの記録(監査ログ)を使えます。
コードやリポジトリには「どのシークレットを使うか」という名前だけを置き、値は置きません。
Cloud Runの環境変数に値を直接書くのではなく、シークレットへの参照を書く点が、直書きとの違いです。
基本の流れ
構成は、次の3ステップです。
- Secret Managerにシークレット(入れ物)を作り、値をバージョンとして登録する。
- Cloud Runサービスが使うサービスアカウントに、そのシークレットを読む権限を付ける。
- Cloud Runサービスに、シークレットを環境変数またはファイルとして渡す設定をする。
1. シークレットの作成
次のコマンドは、db-password というシークレットを作る例です。
値は read -rs で画面に表示せずに入力し、標準入力から渡します。
こうすると、シェルの履歴やファイルに値が残りません。
コマンドはbashを前提としています。
登録後は変数を消します。
read -rs DB_PASSWORD
gcloud secrets create db-password --replication-policy=automatic
printf '%s' "$DB_PASSWORD" | gcloud secrets versions add db-password --data-file=-
unset DB_PASSWORD
登録するたびに、バージョン番号(1、2、3…)が増えていきます。
2. 読み取り権限の付与
Cloud Runのサービスが使うサービスアカウントに、Secret Manager Secret Accessor(roles/secretmanager.secretAccessor)を付けます。
gcloud secrets add-iam-policy-binding db-password \
--member="serviceAccount:APP_SA@PROJECT_ID.iam.gserviceaccount.com" \
--role="roles/secretmanager.secretAccessor"
ここでは、プロジェクト全体ではなく、シークレット単位で付けています(理由は後述)。
なお、デプロイを行う側には、Cloud Runサービスに対するCloud Run管理者(roles/run.admin)と、サービスアカウントに対するサービスアカウントユーザー(roles/iam.serviceAccountUser)のロールが必要です。
3. Cloud Runへの設定
環境変数として渡す場合は、--update-secrets に「環境変数名=シークレット名:バージョン」を指定します。
gcloud run deploy my-app \
--image IMAGE \
--service-account APP_SA@PROJECT_ID.iam.gserviceaccount.com \
--update-secrets=DB_PASSWORD=db-password:3
ファイルとして渡す場合は、パスを / から始めて指定します。
gcloud run services update my-app \
--update-secrets=/etc/secrets/db/password=db-password:3
アプリ側は、普段の環境変数やファイルと同じように読むだけです。
Pythonなら、環境変数は os.environ["DB_PASSWORD"]、ファイルは Path("/etc/secrets/db/password").read_text() で取得できます。
Cloud Runはデプロイの時点で、サービスアカウントが参照先のシークレットにアクセスできるかを確認します。
環境変数とファイルの使い分け
| 観点 | 環境変数 | ファイル(ボリュームのマウント) |
|---|---|---|
| 値を読むタイミング | インスタンスの起動時に解決される | ファイルを読むときに、Secret Managerから取得される |
| 取得に失敗したとき | インスタンスが起動しない | 起動はするが、読み込み時に失敗する |
| 新しいバージョンの反映 | 新しいインスタンスから | latest なら、再デプロイなしで反映される |
| 向いている用途 | パスワード、APIキーなど短い値 | 証明書、設定ファイルなど |
環境変数は、実装が簡単で、既存のアプリも変えずに使えます。
一方で、値の入れ替えを実行中のインスタンスに反映したい場合は、ファイルとして渡す方法が向いています。
ファイルとして渡すときは、既存のディレクトリに重ねず(中身が見えなくなるため)、新しいサブディレクトリを使います。
/dev、/proc、/sys とその配下にはマウントできません。
運用で気を付けたいポイント
バージョンの固定
latest を指定すると、常に最新のバージョンが使われます。
便利ですが、誤った値を登録したときに、そのまま本番へ影響する可能性があります。
Google Cloudのドキュメントでも、環境変数として使う場合は、latest ではなく特定のバージョンを指定することが勧められています。
バージョンを固定しておけば、値の切り替えを通常のリリースと同じ手順で確認し、戻すことができます。
ファイルとして latest を使う場合は、反映が即時になる代わりに、誤った値もそのまま届きます。
登録前の確認と、誤った値を登録したときに、正しい値を新しいバージョンとして登録し直す手順を決めておきます。
シークレット単位の権限設定
1つのプロジェクトで多数のサービスを動かしていると、プロジェクト全体にSecret Accessorを付けたくなります。
その場合、あるサービスが侵害されると、ほかのサービスの秘密情報まで漏れます。
サービスごとに専用のサービスアカウントを用意し、シークレット単位の権限で自分の分だけを読めるようにします。
本番と検証で、プロジェクトを分ける方法も有効です。
ローテーションと旧バージョンの扱い
秘密情報は、定期的に更新(ローテーション)します。
漏えいしたときの被害を限定でき、不要になった人からのアクセスを断てるためです。
更新の流れは、次の順番が安全です。
- 新しい値をバージョンとして登録する。
- Cloud Runの設定を新しいバージョンに切り替えて、デプロイする。
- 動作を確認する。
- 旧バージョンを無効化(disable)する。
- 問題がないまま一定期間が過ぎたら、破棄(destroy)する。
無効化は、あとで有効に戻せます。
いきなり破棄せず、一度無効化して様子を見ると、その値を使い続けているサービスが残っていても気付けます。
ログや画面への値の出力の防止
アプリのデバッグ出力やエラーメッセージに、環境変数の中身をそのまま出さないようにします。
Cloud Loggingに残った値は、ログを閲覧できる人に見えてしまうためです。
アクセスの記録
シークレットの値の取得(AccessSecretVersion)は、監査ログのうち、データアクセス監査ログの「データ読み取り」(DATA_READ)に分類されます。
監査ログの設定で、Secret Manager APIのデータ読み取りのログを有効にすると、値の取得をログエクスプローラで確認できます。
漏えいが疑われるときの調査に役立ちます。
まとめ
秘密情報は、コードや設定に書かず、Secret Managerに置いて、Cloud Runが実行時に受け取る形にします。
押さえておきたい点は、次の4つです。
- サービスごとにサービスアカウントを分け、必要なシークレットだけにSecret Accessorを付ける。
- 環境変数で渡すときは、バージョンを固定する。
- ローテーションは、新バージョンの登録、切り替え、旧バージョンの無効化、破棄の順に行う。
- 値をログに出さず、アクセスの記録を残す。
最初に権限とバージョンの扱いを決めておけば、ローテーションも決まった手順で進められ、漏えい時の影響を小さくできます。
仕様は変わることがあるため、導入時には最新のドキュメントを確認してください。
情報は2026年11月15日時点のものです。