コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Provider リファレンス索引

Aggrega の標準ライブラリのプロバイダーは、それぞれ Recipe の 3 種類の入力(sourced、synthesized、artifacts)のうち異なるサブセットを受け付けます。正式な機能マトリクスは ../../architecture/16-recipe-input-composition.md の「Provider Capability Matrix」にあります。権威ある一覧表はそのセクションを、各プロバイダーが入力種別のどの組み合わせを受け付けるかはその下のプロバイダーごとの説明を参照してください。一覧表は各種別を個別に示すものであり、2 つの種別を同時に宣言できることは表現できません。

このページは道標です。標準ライブラリの各プロバイダーが何を生成するかを示し、それを扱うページへ案内します。プロバイダーがどの入力種別を、どの組み合わせで受け付けるかは、上記のリンク先のセクションで説明しています。

標準ライブラリのプロバイダー

  • helm — フラットな Kubernetes マニフェストを生成します。helm.md を参照してください。
  • helm-chart — バウンダリのコンポーネントを単一のアンブレラ Helm チャートにパッケージ化します。helm-chart.md を参照してください。
  • compose — Docker Compose のサービスを生成し、バウンダリごとに 1 つの compose ファイルにマージします。compose.md を参照してください。
  • terraform — Terraform の設定を生成します。設定を出力するだけで、Terraform を実行することはありません。terraform.md を参照してください。
  • cloudformation — CloudFormation のスタックテンプレートをバウンダリごとに 1 つ生成します。設定を出力するだけで、CloudFormation を実行することはありません。cloudformation.md を参照してください。

バウンダリの syncWave が各プロバイダーで行うこと

Release のバウンダリの syncWave: の値は標準ライブラリのすべてのプロバイダーが読み取りますが、何をどのような意味で順序付けるかはプロバイダーによって異なります。helm-chart では、そのアノテーションを持つリソースだけを順序付けます。

Providerウェーブが行うこと
helmGitOps コントローラーまたは Helm が適用するリソースを順序付けます。ウェーブが 0 でない場合、レンダリングされるすべてのリソースが argocd.argoproj.io/sync-wave を持ち、チャートのテンプレートによるフックリソースはさらに helm.sh/hook-weight を持ちます。
helm-chartアノテーションを持つリソースを順序付けます。ソースチャートのテンプレートは作成者が記述したとおりにコピーされるため、argocd.argoproj.io/sync-wave を持つのはチャートがそれを記述している場合だけです。プロバイダーが追加する、$import: で読み込まれた artifact はそれを持ち、helm.sh/hook-weight は持ちません。helm-chart.md を参照してください。
composeバウンダリのレンダリング先の compose ファイル内のサービスを、サービス間の depends_on によって順序付けます。さらに、出力される各サービスにその値を aggrega.ai/sync-wave ラベルとして記録します。2 つの compose ファイルにまたがる順序付けは表現できません。compose.md を参照してください。
terraformバウンダリの組み立て先のルート設定の module ブロックを、ブロック間の depends_on によって順序付けます。これは準備完了の順序ではなく Terraform がアクションを実行する順序です(設定にはリソースが利用可能であるという概念がありません)。また、削除の順序は保証されません。2 つのルート設定にまたがる順序付けは表現できず、値はノードのビルドの来歴にも記録されます。terraform.md を参照してください。
cloudformationバウンダリの組み立て先のスタックのプロビジョニングを、リソース間の DependsOn によって順序付けます。これは準備完了の順序ではなく作成の順序であり、逆順が削除の順序です(スタックテンプレートにはリソースが利用可能であるという概念がありません)。2 つのスタックにまたがる順序付けは表現できません。cloudformation.md を参照してください。

バウンダリごとの syncWave: の記述方法は Release エンティティのページで説明しています。各プロバイダーが出力する正確なラベルとアノテーションは well-known-annotations.md にあります。

どこを見ればよいか

知りたいこと…参照先
どのプロバイダーがどの入力種別をサポートするか../../architecture/16-recipe-input-composition.md の Provider Capability Matrix セクション
プロバイダーが入力種別のどの組み合わせを受け付けるか、および拒否時に何が出力されるか../../architecture/16-recipe-input-composition.md 「What each provider accepts, in full」
プロバイダーのプラグインソケットが入力を受け取り出力を返す仕組みarchitecture.md
プロバイダーごとの記述形式(チャート構造、compose のトップレベルキー、Terraform の本体、CloudFormation のフラグメント)対応するプロバイダーごとのページ(helm.md、helm-chart.md、compose.md、terraform.md、cloudformation.md)
各プロバイダーが使用するバウンダリのアノテーションとそのデフォルト値well-known-annotations.md
バウンダリの syncWave が各プロバイダーで行うこと上記の表
プロバイダーがレンダリングするリソースに付ける名前を報告するかどうか、および報告しない場合に何を参照するか../templates/rendered-resource-names.md
Workload 種別の記述項目../entities/workload.md
3 種類の入力によるコンポジションモデルの概念../../architecture/16-recipe-input-composition.md