fabric-builder

Fabric Builder

このスキルは、確立されたベストプラクティスと規約に従い、Cloud Foundation Fabric（CFF）モジュールを使用した慣用的な Terraform コードを生成します。

基本的なワークフロー

1. リクエストを理解する： ユーザーが求める GCP リソースとその関係を特定します。
2. モジュール情報を取得する： GitHub の modules/ フォルダー（GoogleCloudPlatform/cloud-foundation-fabric）から、関連する CFF モジュールを特定します。
3. Terraform を生成する： conventions.md に従って、CFF モジュールを使用する慣用的な Terraform ルートモジュールを出力します。

重要なガイダンス

• 規約とベストプラクティス： Fabric モジュールの利用方法や、質の高い慣用的な Terraform コードの記述方法（モジュールソース、バージョン制約、プロバイダー設定など）については、conventions.md を参照してください。
• モジュールの取得： モジュールの入力値や出力値を創作してはいけません。特定のモジュールを使用する前に、fabric.py スクリプトを使って GitHub から正確な情報（README、変数、サンプル）を取得してください。
  • 利用可能なモジュールを一覧表示するには：python3 scripts/fabric.py modules
  • モジュールの詳細（README）を取得するには：python3 scripts/fabric.py fetch readme <module_name>
  • 変数ファイルを取得するには：python3 scripts/fabric.py fetch variables <module_name>
  • 出力ファイルを取得するには：python3 scripts/fabric.py fetch outputs <module_name>
  • スキーマファイルを取得するには（ファクトリーで役立ちます）：python3 scripts/fabric.py fetch schemas <module_name>
  • 最新のリリースバージョンを取得するには：python3 scripts/fabric.py release
  • SSL 証明書の検証： ホストマシンで SSL 証明書の問題が発生した場合は、--no-ssl-verify フラグを使用してください（例：python3 scripts/fabric.py --no-ssl-verify fetch readme <module_name>）。

出力のガイドライン

• ルートモジュールの出力： 出力は、ユーザーの要件を満たすために適切な CFF モジュールを呼び出す、完全な Terraform ルートモジュールである必要があります。
• 規約に従う： モジュールソース、バージョン制約、プロバイダー設定、コーディングスタイルについて、conventions.md を厳守してください。
• Fabric モジュールを使用する： 可能な限り、google_ リソースを直接使用せず、CFF モジュールを利用してください。
• サンプルを参考にする： 正しい使用例を確認するため、必ず scripts/fabric.py で取得したモジュールの README を参照してください。
• フォーマットと検証： 生成したコードが適切にフォーマットされていることを確認してください。可能であれば、terraform fmt、terraform validate、terraform plan を実行してコードをチェックしてください。