Helmチャートジェネレータ

このスキルはHelmチャートジェネレータタスクの自動化されたアシスタンスを提供します。

前提条件

このスキルを使用する前に、以下を確認してください:

• Helm 3以上がシステムにインストールされていること
• Kubernetesクラスターへのアクセスが設定されていること
• アプリケーションコンテナイメージが利用可能であること
• アプリケーションのリソース要件についての理解があること
• チャートリポジトリへのアクセス権がある場合は、そのアクセス

手順

1. 要件の収集: アプリケーションタイプ、依存関係、設定ニーズを特定します
2. チャート構造の作成: メタデータとバージョン情報を含むChart.yamlを生成します
3. 値の定義: 設定可能なパラメータとデフォルト値を含むvalues.yamlを作成します
4. テンプレートの構築: デプロイメント、サービス、イングレス、コンフィグマップテンプレートを生成します
5. ヘルパーの追加: 再利用可能なテンプレート関数用に_helpers.tplを作成します
6. リソースの構成: リソースリミット、セキュリティコンテキスト、ヘルスチェックを設定します
7. チャートのテスト: helm lintとhelm templateコマンドで検証します
8. ドキュメントの作成: インストール手順と設定オプション付きのREADMEを追加します

出力

完全なHelmチャート構造を生成します:

{baseDir}/helm-charts/app-name/
├── Chart.yaml          # チャートメタデータ
├── values.yaml         # デフォルト設定
├── templates/
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── ingress.yaml
│   ├── configmap.yaml
│   ├── _helpers.tpl    # テンプレートヘルパー
│   └── NOTES.txt       # インストール後のメモ
├── charts/             # 依存関係
└── README.md

Chart.yamlの例:

apiVersion: v2
name: my-app
description: Production-ready application chart
type: application
version: 1.0.0
appVersion: "1.0.0"

values.yamlの例:

replicaCount: 3
image:
  repository: registry/app
  tag: "1.0.0"
  pullPolicy: IfNotPresent
resources:
  limits:
    cpu: 500m
    memory: 512Mi
  requests:
    cpu: 250m
    memory: 256Mi

エラーハンドリング

一般的な問題と解決方法:

チャート検証エラー

• エラー: "Chart.yaml: version is required"
• 解決策: Chart.yamlに有効なapiVersion、name、versionフィールドが含まれていることを確認してください

テンプレートレンダリングの失敗

• エラー: "parse error in deployment.yaml"
• 解決策: helm templateでテンプレート構文を検証し、Goテンプレートのフォーマットを確認してください

依存関係の欠落

• エラー: "dependency not found"
• 解決策: チャートディレクトリでhelm dependency updateを実行してください

値のオーバーライド問題

• エラー: "failed to render values"
• 解決策: values.yamlの構文を確認し、適切なYAMLインデントを確保してください

インストール失敗

• エラー: "release failed: timed out waiting for condition"
• 解決策: タイムアウトを増やすか、アプリケーション起動の問題についてポッドログを確認してください

リソース

• Helmドキュメント: https://helm.sh/docs/
• チャートベストプラクティスガイド: https://helm.sh/docs/chart_best_practices/
• テンプレート関数リファレンス: https://helm.sh/docs/chart_template_guide/
• チャートリポジトリの例: https://github.com/helm/charts
• {baseDir}/docs/helm-testing.mdのチャートテストガイド

概要

このスキルは説明された機能の自動化されたアシスタンスを提供します。

例

使用例パターンはコンテキストの中で説明されます。