Troubleshooting

Troubleshooting Guide

Common Issues

1. SSL証明書がプロビジョニングされない

• 原因: DNS未設定 or 時間不足（発行まで15〜60分）
• 確認:

# 証明書の状態確認
gcloud compute ssl-certificates describe job-recommender-cert-nipio --global \
  --format="value(managed.status,managed.domainStatus)"
# PROVISIONING=発行中, ACTIVE=完了, FAILED_NOT_VISIBLE=DNS検証失敗

• 対処: ACTIVEになるまで待機。nip.ioドメインならDNS設定不要

2. LB経由で403 Forbidden

• 原因: Cloud Runのinvoker権限がない
• 確認: 現在のIAM設定を確認

gcloud run services get-iam-policy job-recommender --region=asia-northeast1

• 対処: 一般公開する場合はallUsersにinvoker権限を付与

gcloud run services add-iam-policy-binding job-recommender \
  --region=asia-northeast1 \
  --member="allUsers" \
  --role="roles/run.invoker"

3. Cloud Runにアクセスできない (502/503)

• 原因: LBからCloud Runへの接続問題、NEG設定ミス
• 確認: Backend ServiceとNEGの設定

gcloud compute backend-services describe job-recommender-backend --global

• 対処: terraform applyで権限付与、または再デプロイ

4. Streamlitが起動しない

• 原因: ポート設定ミス、依存関係不足
• 確認: container_portが8501か、Dockerfileの起動コマンド
• 対処: --server.port=8501 --server.address=0.0.0.0を指定

5. Vertex AI エラー

• 原因: 認証エラー、API未有効化
• 確認:

gcloud services list --enabled | grep aiplatform

• 対処: APIを有効化、サービスアカウント権限を確認

6. GitHub API レート制限

• 原因: GITHUB_TOKEN未設定 or 無効
• 確認: Secret Managerのgithub_tokenを確認

gcloud secrets versions access latest --secret=github_token

• 対処: 新しいPATを生成してSecret Managerを更新

7. Perplexity API エラー

• 原因: PERPLEXITY_API_KEY未設定 or クォータ超過
• 確認: Secret Managerのperplexity_api_keyを確認

gcloud secrets versions access latest --secret=perplexity_api_key

• 対処: https://www.perplexity.ai でAPIキー確認、クォータ確認
• 注意: 初回JSON Schemaリクエストは10-30秒かかる可能性あり

8. Terraform初回: Cloud Runイメージが見つからない

• 原因: Artifact Registryにイメージがない状態でterraform apply
• エラー: Image '...app:latest' not found
• 対処: 先にイメージをビルド&プッシュ

# 1. Artifact Registryだけ先に作成
terraform apply -target=google_artifact_registry_repository.app

# 2. イメージをビルド&プッシュ
gcloud builds submit --tag asia-northeast1-docker.pkg.dev/${PROJECT_ID}/job-recommender/app:latest

# 3. 残りのリソースを作成
terraform apply

9. Secret Manager更新後も反映されない

• 原因: Cloud Runは起動時にシークレットを読み込むため、version = "latest"でも再デプロイが必要
• 対処:

# 新しいリビジョンを強制デプロイ
gcloud run deploy job-recommender --region=asia-northeast1 \
  --image=asia-northeast1-docker.pkg.dev/${PROJECT_ID}/job-recommender/app:latest

10. Green環境にアクセスできない (403)

• 原因: Green環境はIAM制限付き
• 確認:

gcloud run services get-iam-policy job-recommender-green --region=asia-northeast1

• 対処: terraform.tfvarsでcloud_run_invoker_membersにユーザーを追加

cloud_run_invoker_members = ["user:your-email@gmail.com"]

11. Green環境でOAuth認証が失敗

• 原因: Green用のOAuth Appが未設定、または callback URLが不正
• 確認: GitHub OAuth App設定で callback URL が http://localhost:8080 か確認
• 対処:
  1. GitHub Developer Settings で Green用 OAuth App 作成
  2. Callback URL: http://localhost:8080（ローカルプロキシ用）
  3. Secret Manager に登録:

echo -n "GREEN_CLIENT_ID" | gcloud secrets create green_github_oauth_client_id --data-file=-
echo -n "GREEN_CLIENT_SECRET" | gcloud secrets create green_github_oauth_client_secret --data-file=-

12. デプロイ後に問題発生、ロールバックしたい

• 対処: 前リビジョンにトラフィックを切り替え

./scripts/rollback.sh
# または手動で
gcloud run services update-traffic job-recommender \
  --region=asia-northeast1 \
  --to-revisions=<previous-revision>=100

Useful Commands

# Cloud Runログ (Blue)
gcloud logging read "resource.type=cloud_run_revision AND resource.labels.service_name=job-recommender" --limit=50

# Cloud Runログ (Green)
gcloud logging read "resource.type=cloud_run_revision AND resource.labels.service_name=job-recommender-green" --limit=50

# LBログ
gcloud logging read "resource.type=http_load_balancer" --limit=50

# Green環境にローカルプロキシ
./scripts/proxy-green.sh  # http://localhost:8080 でアクセス

# ロールバック
./scripts/rollback.sh

# リビジョン一覧確認
gcloud run revisions list --service=job-recommender --region=asia-northeast1

# ローカルテスト
uv run streamlit run app.py

Converted and distributed by TomeVault — claim your Tome and manage your conversions.