背景
suno-api をCloud Run上でビルド・デプロイしたところ、一部のAPIが500エラーを返す事象に遭遇。
調べてみると、環境変数で渡している SUNO_COOKIE がうまく渡っていないことが原因らしい。でも、Cloud Run側の環境変数としては設定済み。
「あれ？おかしいぞ？」ってなったので、Dockerfileをチェックしてみたら、発見しました。
ARG SUNO_COOKIE
こいつかーーー！！！（犯人確定）
Cloud Runの環境変数はランタイムでしか見えないので、ビルド時には見えてないのが原因でした。
ゴール
-
SUNO_COOKIEを安全にDocker Build時に渡す - Gitに載せない
- なるべくGCP標準機能（Cloud Buildのsubstitutions）で解決する
そもそもCloud Buildで環境変数を渡すには？
| 方法 | 説明 | Gitに秘密は載る？ |
|---|---|---|
| ① cloudbuild.yamlのsubstitutions | ビルド時にGUIから変数注入 | 乗らない✨ |
| ② Dockerfileに直書き | Dockerfileに直接ベタ書き | 乗る💀 |
迷わず①を採用。Cloud BuildのGUIから「代入変数（substitutions）」を定義して、毎回注入する形に。
cloudbuild.yaml での設定例
以下のように--build-argを仕込んで、GUI側のsubstitutionsと連携します。
cloudbuild.yaml
steps:
- name: gcr.io/cloud-builders/docker
args:
- build
- '--no-cache'
- '-t'
- >-
$_AR_HOSTNAME/$_AR_PROJECT_ID/$_AR_REPOSITORY/$REPO_NAME/$_SERVICE_NAME:$COMMIT_SHA
- '-f'
- Dockerfile
- '--build-arg'
- 'SUNO_COOKIE=$_SUNO_COOKIE' # ここで代入変数を取得
- .
id: Build
substitutions
substitutions:
_AR_PROJECT_ID: xxxxx
_TRIGGER_ID: xxxxx
_PLATFORM: managed
_SERVICE_NAME: xxxxx
_DEPLOY_REGION: xxxx
_AR_HOSTNAME: xxxx
_AR_REPOSITORY: xxxxx
_SUNO_COOKIE: 'dummy' # GUI上から取得した代入変数が毎回セットされる。
実際のビルドログ
Before（渡せてない）
---> 6bbde929d339
Step 12/19 : RUN if [ -z "$SUNO_COOKIE" ]; then echo "Warning: SUNO_COOKIE is not set. You will have to set the cookies in the Cookie header of your requests."; fi
---> Running in e14c5e9401c6
Warning: SUNO_COOKIE is not set. You will have to set the cookies in the Cookie header of your requests.
Removing intermediate container e14c5e9401c6
After（substitutionsで渡せた）
---> 529fb246c51c
Step 12/19 : RUN if [ -z "$SUNO_COOKIE" ]; then echo "Warning: SUNO_COOKIE is not set. You will have to set the cookies in the Cookie header of your requests."; fi
---> Running in 5019523db1b0
Removing intermediate container 5019523db1b0
学びポイント
- Cloud Runの環境変数はランタイムの話。ビルド時には渡らない。
- Cloud Buildのsubstitutionsを活用すれば、Gitに秘密を載せずに安全に渡せる。
-
cloudbuild.yamlは、GCPのCloud Buildでデフォルト生成されるので、それをちょっと編集すればOK。 -
Dockerfileで
ARG受けして、ENVに流し込むのもポイント。
まとめ
本家のIssueでも議論されてたけど、なかなかスッキリした答えがなかったので、ビルド時とデプロイ後の環境変数の違いを理解して一発解決できたのは大きな学びでした。
Cloud Build＆Cloud Runの連携で環境変数ハマったら、まずは「ビルド時のsubstitutions」をチェック！これだけでだいぶ事故防げるのでオススメです。