つまり解消方法

1) まず Pod 状態を確認（これが最優先）

kubectl -n portal-dev get pods -l app=portal-api -o wide
kubectl -n portal-dev get rs -l app=portal-api --sort-by=.metadata.creationTimestamp -o wide

ここで、portal-api-xxxxx のうち 新しい方が Pending / ImagePullBackOff / CrashLoopBackOff / Running(0/1) どれかを見ます。

2) “詰まってる Pod” を特定して describe（原因はここに出ます）

まず Pod 名を取ってから：

POD_BAD=$(kubectl -n portal-dev get pods -l app=portal-api \
  --sort-by=.metadata.creationTimestamp -o jsonpath='{.items[-1].metadata.name}')
echo $POD_BAD
kubectl -n portal-dev describe pod "$POD_BAD" | sed -n '/Events:/,$p'

これでほぼ原因が確定します。

3) パターン別：次に打つコマンド

A) Pending の場合（スケジュールできてない）

describe の Events にこういうのが出ます：Insufficient cpu/memory / node(s) had taint / pod has unbound immediate PersistentVolumeClaims など。

kubectl -n portal-dev describe pod "$POD_BAD" | egrep -n 'FailedScheduling|Insufficient|taint|unbound|PVC|preemption' || true

→ ここで資源不足なら一旦 replicas: 1 に落として通すのが早いです（後で戻す）。

B) ImagePullBackOff / ErrImagePull の場合（イメージ取れない）

kubectl -n portal-dev describe pod "$POD_BAD" | egrep -n 'ErrImagePull|ImagePullBackOff|pull|Failed to pull' || true
kubectl -n portal-dev get deploy portal-api -o jsonpath='{.spec.template.spec.containers[?(@.name=="api")].image}{"\n"}'

→ patch-api-image.yaml の image 名/タグ/レジストリ認証あたりが原因です。

C) Running だけど 0/1 Ready（readiness probe 失敗 or アプリ落ちてる）

kubectl -n portal-dev describe pod "$POD_BAD" | egrep -n 'Readiness probe failed|Liveness probe failed|Startup probe failed' || true

# api コンテナのログ
kubectl -n portal-dev logs "$POD_BAD" -c api --tail=200

# CrashLoop なら previous も見る
kubectl -n portal-dev logs "$POD_BAD" -c api --previous --tail=200 || true

# initContainer があるならそれも
kubectl -n portal-dev logs "$POD_BAD" -c sa-patch --tail=200 || true

ここで ImportError / 設定不足 / env不足 / DB接続失敗 がほぼ出ます。

4) いまの変更で起きがちな “ありがち原因”

今回 patch-api-env.yaml で env を置き換えているので、base で必要だった env（例：PYTHONPATH、JWT_SECRET、OPENAI_API_KEY の参照先など）が消えると新Podだけ起動しません。

なので、ログにそれっぽいのが出たら次で確認します：

kubectl -n portal-dev get deploy portal-api -o yaml \
  | sed -n '/name: api/,/envFrom:/p' \
  | sed -n '/env:/,/image:/p'

Comments