kubernetes-helm

Kubernetes と Helm のワークフロー

テスト環境と本番環境の Kubernetes で、一貫性のある Helm パターンを適用します。

このスキルを使う場面

• Helm の values ファイルを更新する
• 環境変数を追加または変更する
• リソース、プローブ、Ingress、セキュリティ、ジョブ、CronJob を設定する
• Kubernetes のシークレット、名前空間、Pod、環境 URL を扱う

次のワークフローに従う

1. kubernetes/helm/ で対象のチャートを特定し、変更が特定の環境だけに適用される場合を除き、values.test.yaml と values.prod.yaml の両方を編集します。
2. 機密情報を含まない変数は、直接の value を指定して extraEnvVars の下に追加し、アルファベット順に並べます。
3. 機密情報を含む変数は valueFrom.secretKeyRef を使って追加します。values ファイルにシークレットを直接記述しないでください。
4. フック／ジョブのシークレットは、チャートの values キー hooks.secretName（values.*.yaml 内）で定義し、フックのテンプレート（例：マイグレーション／同期ジョブ）で使用します。
5. リポジトリでローカルの環境ファイルを使用している場合は、新しい変数を .env.example と .env にも安全なプレースホルダーのデフォルト値で追加します。
6. デプロイする前に、チャート固有のシークレット命名規則と名前空間の規則を確認します。
7. ランタイムチェックには、前提条件を満たした後にのみ k8s-tool を使用します。k8s-tool は環境のショートカットを備えた kubectl のプロジェクト用ラッパーであり、インストール済みの CLI と、有効な kubeconfig／クラスターへのアクセスが必要です。

参考資料

具体的なスニペットと YAML の例については、以下を参照してください。

• references/chart-structure.md
• references/helm-examples.md

主なルール

1. extraEnvVars はアルファベット順に並べる
2. シークレットをコミットしない — secretKeyRef を使って K8s シークレットを参照する
3. テスト用の値は控えめにする — 本番より少ないリソースを指定する
4. 適切なプローブパスを使う — ライブネスには /api/alive、レディネスには /api/health を使う
5. CronJob には、重複実行を防ぐため concurrencyPolicy: Forbid を設定する