helm-chart-scaffolding

Helm チャートのスキャフォールディング

Kubernetes アプリケーションをパッケージ化してデプロイするための Helm チャートの作成、整理、管理に関する包括的なガイダンスです。

目的

このスキルは、本番環境で使用できる Helm チャートを構築するための手順を段階的に提供します。チャートの構造、テンプレートのパターン、values の管理、検証戦略などが含まれます。

このスキルを使用する場面

次のような場合にこのスキルを使用します。

• 新しい Helm チャートをゼロから作成する
• 配布用に Kubernetes アプリケーションをパッケージ化する
• Helm を使用して複数環境のデプロイを管理する
• 再利用可能な Kubernetes マニフェストのためのテンプレートを実装する
• Helm チャートリポジトリをセットアップする
• Helm のベストプラクティスと規約に従う

詳細なパターンと実例

詳細なパターンのドキュメントは references/details.md にあります。上記のナビゲーション階層では不十分な場合は、そのファイルを参照してください。

ベストプラクティス

1. チャートとアプリのバージョンにはセマンティックバージョニングを使用する
2. values.yaml 内のすべての values をコメント付きで文書化する
3. 繰り返し使用するロジックにはテンプレートヘルパーを使用する
4. パッケージ化する前にチャートを検証する
5. 依存関係のバージョンを明示的に固定する
6. オプションのリソースには条件を使用する
7. 命名規則に従う（小文字、ハイフン）
8. 使用方法の手順を含む NOTES.txt を含める
9. ヘルパーを使用してラベルを一貫して追加する
10. すべての環境でインストールをテストする

トラブルシューティング

テンプレートのレンダリングエラー:

helm template my-app ./my-app --debug

依存関係の問題:

helm dependency update
helm dependency list

インストールの失敗:

helm install my-app ./my-app --dry-run --debug
kubectl get events --sort-by='.lastTimestamp'

関連スキル

• k8s-manifest-generator - ベースとなる Kubernetes マニフェストを作成するためのスキル
• gitops-workflow - Helm チャートのデプロイを自動化するためのスキル