よくある問題

頻繁に発生する問題の解決策

​

インストールの問題

​

Pod が Pending 状態のまま

症状: Pod が Pending 状態のままになる。

診断:

kubectl describe pod -n jitera <pod-name>

よくある原因と解決策:

1. リソース不足

   # ノードリソースの確認
   kubectl describe nodes | grep -A 5 "Allocated resources"
   

   解決策: ノードをスケールアップするか、リソースリクエストを削減してください。

2. PVC がバインドされていない

   kubectl get pvc -n jitera
   

   解決策: ストレージクラスが存在し、十分な容量があることを確認してください。

3. ノードセレクターの不一致 解決策: ノードラベルが Pod セレクターと一致していることを確認してください。

---

​

Pod が CrashLoopBackOff 状態

症状: Pod が繰り返しクラッシュして再起動する。

診断:

kubectl logs -n jitera <pod-name> --previous
kubectl describe pod -n jitera <pod-name>

よくある原因:

1. 設定エラー

   • 環境変数を確認してください
   • シークレットが正しいことを確認してください

2. データベース接続の失敗

   kubectl exec -n jitera <pod> -- nc -zv jitera-postgresql 5432
   

3. 依存関係の不足

   • init コンテナが完了していることを確認してください
   • 必要なサービスが実行中であることを確認してください

---

​

ImagePullBackOff

症状: Pod がコンテナイメージをプルできない。

診断:

kubectl describe pod -n jitera <pod-name> | grep -A 5 "Events"

解決策:

1. レジストリ認証情報の確認

   registryCredentials:
     server: jiteradockerimage.azurecr.io
     username: <correct-username>
     password: <correct-password>
   

2. シークレットの存在確認

   kubectl get secret -n jitera regcred
   

3. シークレットの再作成

   kubectl delete secret regcred -n jitera
   helm upgrade jitera ./charts/jitera -f values.yaml -n jitera
   

---

​

認証の問題

​

セッションの期限切れが早すぎる

症状: ユーザーが頻繁にログアウトされる。

解決策: JWT 設定を確認してください:

jwt:
  secret: <must-be-64-characters>
  expiry: 86400  # 24時間

---

​

データベースの問題

​

データベース接続の失敗

症状: 「Connection refused」またはタイムアウトエラー。

診断:

# PostgreSQL Pod の確認
kubectl get pod -n jitera -l app.kubernetes.io/name=postgresql

# 接続テスト
kubectl exec -n jitera deploy/jitera-automation-rails -- nc -zv jitera-postgresql 5432

解決策:

1. データベース Pod が実行中であることを確認

   kubectl logs -n jitera -l app.kubernetes.io/name=postgresql
   

2. 認証情報の確認

   kubectl get secret jitera-postgresql -n jitera -o yaml
   

3. 外部データベースの場合: ネットワーク接続と認証情報を確認してください。

---

​

マイグレーションの失敗

症状: 「Migration error」またはデータベーススキーマの不完全。

診断:

kubectl exec -it -n jitera deploy/jitera-automation-rails -- rails db:migrate:status

解決策:

# マイグレーションの再試行
kubectl exec -it -n jitera deploy/jitera-automation-rails -- rails db:migrate

# スタックしている場合、ロックを確認
kubectl exec -it -n jitera $PG_POD -- psql -U jitera -c "SELECT * FROM pg_locks WHERE NOT granted;"

---

​

ストレージの問題

​

S3/Azure ストレージのアクセス拒否

症状: 「Access Denied」または「Forbidden」エラー。

診断:

kubectl logs -n jitera -l app=jitera-automation-rails | grep -i storage

解決策:

1. 認証情報の確認

   # AWS S3 のテスト
   aws s3 ls s3://your-bucket
   
   # Azure のテスト
   az storage container list --account-name your-account
   

2. バケット/コンテナ名が設定と一致していることを確認してください

3. IAM 権限に必要なアクションが含まれていることを確認してください

---

​

PVC ストレージの容量不足

症状: 「No space left on device」エラー。

診断:

kubectl exec -n jitera <pod> -- df -h

解決策:

1. PVC の拡張（サポートされている場合）:

   kubectl edit pvc <pvc-name> -n jitera
   # spec.resources.requests.storage を増加
   

2. 古いデータのクリーンアップ

3. 追加ストレージの追加

---

​

パフォーマンスの問題

​

レスポンスが遅い

症状: ページの読み込みが遅い、またはタイムアウトする。

診断:

# リソース使用量の確認
kubectl top pods -n jitera

# スロットリングの確認
kubectl describe pod -n jitera <pod> | grep -i throttl

解決策:

1. リソースの増加

   automation:
     resources:
       limits:
         cpu: 2
         memory: 4Gi
   

2. 水平スケーリング

   automation:
     replicas: 3
   

3. データベースパフォーマンスの確認

---

​

メモリ使用量が高い

症状: Pod が OOMKilled される。

診断:

kubectl describe pod -n jitera <pod> | grep -i oom

解決策:

1. メモリ制限の増加

   automation:
     resources:
       limits:
         memory: 8Gi
   

2. メモリリークの確認（ログを参照）

3. ワークロード分散の最適化

---

​

ネットワークの問題

​

外部サービスに接続できない

症状: GitHub、AI プロバイダーなどへの接続がタイムアウトする。

診断:

kubectl exec -n jitera <pod> -- curl -v https://api.github.com

解決策:

1. エグレスルールの確認（ネットワークポリシー、ファイアウォール）

2. DNS 解決の確認

   kubectl exec -n jitera <pod> -- nslookup api.github.com
   

3. プロキシ設定の確認（必要な場合）

---

​

ロードバランサーがプロビジョニングされない

症状: サービスが外部 IP なしでスタックしている。

診断:

kubectl describe svc -n jitera -l app.kubernetes.io/name=kong

解決策:

1. AWS: ロードバランサー作成のための IAM 権限を確認してください
2. Azure: Azure リソースクォータを確認してください
3. オンプレミス: MetalLB の設定を確認してください

---

​

証明書の問題

​

TLS 証明書が無効

症状: ブラウザに証明書の警告が表示される。

診断:

# 証明書の確認
kubectl get certificate -n jitera
openssl s_client -connect app.example.com:443 -servername app.example.com

解決策:

1. cert-manager: イシュアーのステータスを確認してください

   kubectl describe clusterissuer letsencrypt-prod
   kubectl describe certificate -n jitera
   

2. 手動証明書: シークレットに有効な証明書が含まれていることを確認してください

   kubectl get secret jitera-tls -n jitera -o yaml
   

---

​

AI 機能の問題

​

AI が応答しない

症状: AI 機能がタイムアウトする、またはエラーを返す。

診断:

kubectl logs -n jitera -l app=jitera-ultron --tail=50

解決策:

1. API キーが有効でクォータがあることを確認してください

2. AI プロバイダーへの接続を確認してください

   kubectl exec -n jitera deploy/jitera-ultron -- curl https://api.openai.com/v1/models
   

3. AI 設定を Helm values で確認してください

---

​

関連ドキュメント

• トラブルシューティング概要 — インシデント対応フローとサポート窓口
• メンテナンス — バックアップ、リストア、定期作業