テンプレートコンテキスト契約
このページでは、コンパイラが Recipe および FeatureRecipe の Go テンプレートに注入するランタイムビューについて説明します。具体的には、テンプレートコンテキストの形状、コンパイルパイプライン全体にわたるフィールドごとの利用可否、そしてコンポーネント間の状態を利用するテンプレートを記述する上級の作成者が必要とする正規の契約です。テンプレートサイトごとの利用可否(どのフィールドがどの評価サイトで存在するか)は expansion-matrix.md にあります。このページでは、フィールドの形状とそのセマンティクスを説明します。
概要
コンパイラはレンダリング中にノードごとにテンプレートコンテキストを組み立て、そのノードに対してレンダラーが評価するすべての Go テンプレートに注入します。このコンテキストはメモリ上にのみ存在し、ディスクに永続化されることはなく、単一のペイロードとして Wasm ABI を越えることもありません。各テンプレートサイトは同じコンテキストオブジェクトのビューを受け取ります。一部のフィールドは遅れて設定されます(.workload は workload の合成時に、.source はソースの解決時に設定され、.steps は pipeline: の実行中に各ステップが完了するたびに設定されます。言語のステータス → コンパイルパイプラインのフェーズを参照してください)。
ランタイムの形状のスキーマは template-context-v1beta1.schema.json です(Aggrega のスキーマ配布物に同梱されています)。
トップレベルのフィールド
トップレベルのフィールドはテンプレートコンテキストのルートに置かれ、テンプレート内からは .field としてアクセスします。
.values(map)。 Aggregate から渡される、開発者が記述した認知的ペイロードです。コンポーネントごとの値は、このフィールドを通じてレンダリングされた Recipe に渡されます。解決時に Catalog のschema:(Component または Feature の JSON Schema 2020-12 宣言)によって検証されます。フィールドに記述されたゼロ・空・false が、フィールドが存在しないことと意味的に異なる場合は、defaultではなくoptional(sprig-functions.mdを参照)を使用してください。.infra(map)。 Release から渡される、運用担当者が記述した物理的なサイジングです。解決時に Catalog のschema:(Component または Feature の JSON Schema 2020-12 宣言)によって検証されます。.valuesと同じoptionalとdefaultの使い分けの指針が適用されます。記述されたゼロや false が正当な意図である場合(ゼロへのスケール、リトライなし、フィーチャーフラグのオフ)はoptionalを優先してください。.locals(文字列値の map)。 Recipe 専用の状態です。Recipe のlocals:ブロックで宣言された名前で、locals プリアンブルで解決され、ソース解決時にこのピラーに公開されます。エントリは記述順に解決され、エントリはそれより上で定義された兄弟エントリを読み取れるため、あるエントリが別のエントリを読み取る箇所では順序が重要になります。Recipe 自身のテンプレート内からのみアクセスでき、呼び出し元には決して公開されません。.provides(文字列値の map)。 Recipe の公開出力文字列です。呼び出し元のinject:ブロックがfrom:参照を解決する対象となる契約です。provides の評価時に設定されます。.features(アタッチメントの map)。 この Component にアタッチされた Features(5-Tier Onion Model に従い、Aggregate レベル、サブシステムレベル、Release レベル、Manifest のアノテーション駆動のもの)を反復し、作成者がアタッチメントに付けたインスタンス名をキーとします。すべてのエントリは同じフィールドを持ちます。後述のアタッチメントの形状を参照してください。Component の接続の 1 つに記述されたアタッチメントはこれに含まれません。それはその接続の下、.context.uses.<alias>.features.<slot>で読み取られるため、.featuresを range するテンプレートは Component 自身のアタッチメントのみを扱います。.metadata(struct)。 決定的な命名のための Release の識別情報です:release_name、release_version、environment、aggregate_name。すべてのレンダリングで設定され、値は Release のmetadata:ブロックに由来します。.source。 Recipe のsource:で、ソース解決のテンプレート評価によって解決されたものです。ソースを持たない Recipes ではnil、ソース解決の実行前もnilです。FeatureRecipe のテンプレートでは、その FeatureRecipe 自身のsource:であり、ホストコンポーネントのものになることはありません。アタッチメント FeatureRecipe のサーフェスを参照してください。.workload。 パースされた Workload オブジェクトです。レンダリングされたworkload:ドキュメントがデコードされ、それを通過させる検証(Workload スキーマ、コンテナが宣言するすべてのアタッチメントに対する Component のfeaturesSchema、および各アタッチメントが参照するものの解決可能性)に合格した時点で設定されます。合成されない Recipes ではnil、Workload 合成の実行前もnilです。.steps(ステップ出力の map)。 Wasm プラグインの実行に伴いpipeline:の実行によって設定され、完了したステップが返した出力を.steps.<id>.outputsを介して後続のステップに公開します。ステップは先行するステップの出力を自身のwithテンプレートから読み取ります。ステップのoutputsは、そのステップより後に宣言されたステップからのみ参照できます。ノードがパイプラインを宣言しない場合、およびノードの最初のステップが完了する前は空です。
このノードについて何も保持しない最上位フィールド(ワークロードを合成しない Recipe の .workload、ソースのない Recipe の .source、アタッチメントのない Component の .features)は、値テンプレートでは .values の下の未設定のキーとまったく同じように空として読み取られます。{{ .workload }} は何もレンダリングせず、それに対する default はそのフォールバックを与え、それに対する if や with は偽の分岐を取ります。それに対する range は何も反復しません。その下の読み取り({{ .workload.containers }})は、降りていく先が何もないため、やはり停止します。そして、そのようなフィールドを常に実行される場所(すべての if、with、range の外側)で出力し、かつそれを反復するテンプレートは、そのフィールドを示して停止します。これは、何も保持せず両方の方法で読み取られるあらゆるパスと同様です。何も出力せず、かつ何も反復しない値は 1 つもないためです。A template reads and iterates a path that holds nothing (テンプレートが何も保持しないパスを読み取り、かつ反復する) を参照してください。
アタッチメントの形
.features.<name> と .features.<slot> は同じ形です。1 つのアタッチメントを、1 つの読み方で読みます:
.type(string)。 アタッチされた Feature のカタログ URI です。.resolved_version(string)。 Manifest の解決後の、アタッチされた Feature のバージョンです。消費側で改めて記述したピンではなく、このビルドで実際にバインドされたバージョンです。.context.uses.<alias>.resolved_versionと対応します。アタッチメントのtypeがどのカタログエンティティにも解決されない場合は空になります。.labels(文字列値のマップ)。 アタッチされた Feature のカタログラベルで、Feature が宣言した順序のまま、そのまま運ばれます。フィルタリング、名前の変更、プレフィックスの除去は一切行われないため、テンプレートは Feature の作成者が書いたとおりの内容を読みます。.context.uses.<alias>.labelsと対応します。Feature がラベルを宣言していない場合、およびアタッチメントのtypeがどのカタログエンティティにも解決されない場合は存在しません。.values(map)。 アタッチメント自身の開発者意図のピラーで、Aggregate 内のアタッチメント宣言に記述されます。ホストコンポーネントのトップレベルの.valuesとは別のものです。.infra(map)。 アタッチメント自身の運用サイジングのピラーで、Release 内のアタッチメント宣言に記述されます。ホストコンポーネントのトップレベルの.infraとは別のものです。.provides(文字列値のマップ)。 このアタッチメントにバインドされた FeatureRecipe の解決済みの公開コントラクトです。出力されたリソースの名前、そのデータキー、クラウドアイデンティティ、および FeatureRecipe が公開する追加のキーを含みます。.features.<name>.provides.<key>として読み、.context.uses.<alias>.providesと対応します。消費側は、プロデューサーが公開したものを再導出せずに読みます。バインドされた FeatureRecipe が何も公開しないアタッチメントは、空のマップではなくprovidesキー自体を持たないため、個々のキーを参照する前にガードしてください。
.provides は、アタッチメントを単に存在するだけでなく消費可能なものにします。schema.provides コントラクトを宣言する Feature では、それを実現する FeatureRecipe に対してそのコントラクトが強制され(FeatureRecipe は宣言されたすべてのキーを公開する必要があります)、消費側はその結果をここで読みます。そのため、ServiceAccount を出力してその名前を公開するアイデンティティ Feature により、消費側の Recipe はそれにバインドできます:
workload: | serviceAccount: "{{ .features.identity.provides.name }}"出力された名前はプロデューサーによって一度だけ記述され、消費されます。両者が食い違いうる消費側で改めて記述されることはありません。workload-identity-binding の例は、これをエンドツーエンドでレンダリングします。
.labels により、テンプレートは名前で照合したり URI を解析したりせずに、アタッチメントが何であるかに適応できます。コンパイラはそのいずれも読みません。文字列を運ぶだけで、その意味はテンプレートの作成者が決めます。
ラベルを宣言していない Feature は、空のマップではなく .labels 自体を持たないため、個々のラベルを参照する前にガードしてください。存在しないキーを参照するとビルドが停止します。Feature が宣言していない可能性のあるラベルは optional を通じて読んでください。index はマップがキーを持たない場合、そのキーを示してビルドを停止するためです:
{{ if .features.db.labels }}{{ if eq (optional .features.db.labels "feature.aggrega.ai/kind" "") "secret" }}...{{ end }}{{ end }}ラベルはそのまま届くため、カタログ作成者独自の名前空間は変更されずにテンプレートに届き、Recipe は Feature が宣言したものと同じキーを読みます。
.context ブロック
.context は、単一ノードに対してコンパイラが組み立てる実行コンテキストです。レンダラがすべてのテンプレートサイトに渡す、アイデンティティ、トポロジー、デリバリーパイプのデータで構成されます。フィールドは次のとおりです。
.context.instance_id(string)。 名前としてのノードのアイデンティティです。ビルド自体が出力するものの命名とラベル付けに使う値であり、これを使ってリソース名やクラスタ内アドレスを組み立てるテンプレートは、ビルドが実際に生成する名前を予測できます。自身の Aggregate が宣言するノードでは、記述した名前そのものです。インポートされた Aggregate が提供するノードでは、モジュール区切りを書き出した平坦化されたアイデンティティになります(data-layer.main-dbはdata-layer-zdmain-dbになります)。ドットはリソース名に含められない文字であり、クラスタアドレス内ではサービスと名前空間を区切るためです。ドット付きの形式は、ドキュメントやビルドの診断がそのノードを指すときに使う形式です。命名の慣例を参照してください。.context.rendered_name(string)。 ノードの provider が、そのノード用にレンダリングするリソースに付ける名前です。チャートが読むリリース名のように提供したソースに由来する場合と、provider が合成するワークロードのリソースを独自の名前で命名する場合(helmが同じリリース名で行うように)があります。その provider が名前を導出する場合にのみ存在します。Feature アタッチメントのテンプレートでは、そこでの.context.instance_idがホストのアイデンティティであるのと同様に、ホストコンポーネントの名前になります。レンダリングされたリソースの命名を参照してください。.context.labels(文字列値のマップ)。 カタログで記述されたラベルに、トポロジー構築時のlabel-transformによる追加を加えたものです。.context.annotations(3 つのバケット、後述)。 由来ごとにグループ化された、カスケードされたアノテーションです。.context.inject(メカニズムのマップ、後述)。 事前にハイドレートされ、インターセプト済みのデリバリーパイプです。Recipe テンプレートがコンポーネント間の値を読むための標準の面です。.context.uses(接続のマップ、後述)。 外向きのトポロジーエッジに対する JOIN 射影です。.context.self_inject(メカニズムのマップ、後述)。 開発者がコンポーネント自身のinject:ブロックに書いた各名前について、そのエントリが配信する自身の provides キー、またはそのテンプレートが読み取る 1 つの自身の値です。.context.used_by(リスト、後述)。usesエントリがこのコンポーネントを指しているコンポーネントです。コンポーネントにアタッチされた FeatureRecipe が、アタッチメント自身のリソースを生成するテンプレートで読みます。それ以外では空です。.context.render_facts(リストのマップ、後述)。 コンポーネントの provider がレンダリングした出力について報告した内容で、ファクト名をキーとします。コンポーネントにアタッチされた FeatureRecipe が、コンポーネントのレンダリング後に実行されるすべてのテンプレートで読みます。それ以外では存在しません。
.context.annotations — 3 つのバケット
アノテーションは、由来をキーとする 3 つのバケットにカスケードされます。
.context.annotations.release— Release 境界のアノテーション(ドメイン 4)。物理的な実態を管理するために使われ、レンダラは必要に応じてこれらをinfra:フィールドに振り分けます。aggrega.ai/*の既知のアノテーションはこのバケットにあります。.context.annotations.catalog— ドメイン 2 の Component メタデータのアノテーション。Architect が記述する不変の固有特性で、主に Wasm ポリシープラグインが使用します。.context.annotations.aggregate— ドメイン 1 の Aggregate サブシステムのアノテーション。認知的なメタデータで、レンダラは必要に応じてこれらをvalues:ペイロードに振り分けます。
各バケットは平坦な文字列対文字列のマップです。アーキテクチャの分離ルールに従い、バケットはそれぞれ別の用途を想定していますが、エンジンはこの分離を強制しません。そのため、バケットを想定されたセマンティクスに沿わせるのは記述する側の規律です。カスケードアノテーションの設計については 第 6 章 §2 フロー 5 を参照してください。
.context.inject — デリバリーパイプ
このパイプは、コンパイラが事前に解決したデリバリーマップです。ベースレンダリングで Recipe テンプレートが実行される時点で、すべての inject ソース(開発者が記述した self-inject リテラル、自身の provides に対して解決された self-inject の from: 参照、ターゲットの provides に対して解決されたコンポーネント間の uses[].inject 参照、FeatureRecipe の injectMapping によるインターセプト)は最終的な文字列値に解決され、このマップにマージされています。
フィールド:
.context.inject.env— 環境変数名 → 解決済みの値の文字列値マップ。.context.inject.file— ファイルパス → 解決済みの値の文字列値マップ。.context.inject.arg— 引数フラグ → 解決済みの値の文字列値マップ。.context.inject.all—env/file/arg/カスタムのメカニズムを 1 つの平坦な辞書にまとめた文字列値マップ。パイプ全体のシリアライズに便利です({{ toJson .context.inject.all }})。
メカニズムがパイプに存在するのは、それを通じて何かが届けられる場合だけです。何も届けられていないメカニズム(ファイルの配信がない場合の .context.inject.file など)を読むテンプレートは、値テンプレートが存在しないキーを読むのと同様にそれを空として読み、それに対する range は何もレンダリングしません。この読み取りはテンプレート全体に対して空の値を補うため、同じテンプレート内の {{ toJson .context.inject }} は "file": "" を示します。何かがそれを通じて届けられているかどうかは hasKey .context.inject "file" で判定できます。
- カスタムメカニズム(例:
ssm_param)— コアの 3 つと同様に、独自のフィールド名.context.inject.<mechanism>.<key>で読めます。カスタムメカニズムの値は、コンポーネントレベルの self-inject、uses[].injectエッジ、Feature アタッチメントのinject:マッピング、FeatureRecipe のinjectMapping出力からパイプに届きます。コンポーネントレベルの self-inject では、Component のspec.inject許可リストがそのメカニズムを指定している必要があり、許可リストが指定していないメカニズムはビルドを停止させます。カスタムメカニズムのエントリは、コアの 3 つとともに.context.inject.allにも現れます。カスタムメカニズムにはall以外の任意の名前を付けられます。その名前はマージされたビューそのものであるため、その名前のメカニズムは単独では決して読めません。メカニズムallを指定する inject ブロック、およびそれを列挙する Component または Feature の許可リスト(spec.inject、ソケットのinject)は、ドキュメントの読み込み時にビルドを停止させ、その拒否は、その名前がこのマージされたビューに属することを説明します。名前は大文字と小文字を区別するため、ALLは通常のカスタムメカニズムです。
このパイプはインターセプト後の状態です。Recipe テンプレートが読む時点では、FeatureRecipe の injectMapping ブロックが inject マッピングの間にこのパイプへオーバーライドをディープマージ済みです。マッピングは、コンポーネント自身の inject: ブロック、その接続のいずれかの inject: ブロック、または自身のアタッチメントの inject: ブロックが届けたキーを置き換えられます。アタッチされた 2 つの Features が inject: ブロックやマッピングを通じて同じキーを届けた場合は、2 つの値の一方でこのパイプに届くのではなく、ビルドが停止します。Release 境界にアタッチされた Feature も同じ方法でコンポーネントに届きます。つまり、その FeatureRecipe の injectMapping を通じてであり、これは FeatureRecipe の executionScope にかかわらずコンポーネント自身のコンテキストで実行されます。compose ブリッジによるコンシューマーのホスト変数の書き換えもそうしたマッピングの 1 つであり、同じルールに従います。
.context.self_inject — 開発者の各名前がどの自身の値を配信するか
Component が spec.inject を宣言している場合、開発者はコンポーネント自体に inject: ブロックを書き、コンポーネント自身の値と provides を配信する名前を選べます。.context.inject はそれらのエントリが解決された結果を保持し、.inject_raw は書かれたとおりの内容を保持します。.context.self_inject は、各エントリについて、それが配信するコンポーネント自身の provides キー、またはそのテンプレートが読み取る 1 つの自身の値を示します。その形は接続の .context.uses.<alias>.inject と同じで、メカニズム、次に開発者の名前、次にキーという構造であり、キーはコンポーネント自身の provides または値の 1 つを指します:
provides.<key>—from: <key>で書かれたエントリで、コンポーネント自身の provides の 1 つを配信します。values.<key>—value:テンプレートがコンポーネント自身の値をちょうど 1 つだけ読み取り、それ以外は何も読み取らないエントリです。<key>はその値のトップレベルのキーです。読み取りの前後にあるテキストや関数は関係せず、テンプレートが値のどの深さまで読み取るかも関係ありません:'{{ .values.role }}'、'role={{ .values.role | upper }}'、'{{ with .values.role }}{{ . }}{{ end }}'はいずれもvalues.roleに対応し、'{{ .values.config.port }}'、'{{ index .values.config "port" }}'、'{{ (default dict .values.config).port }}'はいずれもvalues.configに対応します。- 空文字列 — その他すべてのエントリです。リテラル、2 つの値を読み取るテンプレート、値以外のもの(
.infra、.metadata、.context)を読み取るテンプレート、そして値の読み取りをテキスト上で 1 つのトップレベルキーに帰属できないテンプレートが該当します。最後のものには、値をルートから関数に渡すもの(index .values "role")、値を丸ごと読み取るもの(toJson .values、または{{ with .values }}の内側や.valuesに束縛された変数を通じてフィールドを読み取るもの)、コンテキスト全体を引き渡すもの(toJson .)があります。
# The developer's block on the component, in the Aggregateinject: env: - { in: SERVICE_HOST, from: host } - { in: AGENT_ROLE, value: '{{"{{"}} .values.role }}' } - { in: MODE, value: batch } - { in: ROLE_AND_GOAL, value: '{{"{{"}} .values.role }}-{{"{{"}} .values.goal }}' } ssm_param: - { in: /app/goal, value: '{{"{{"}} .values.goal }}' }
# What the Recipe reads at .context.self_injectenv: SERVICE_HOST: provides.host AGENT_ROLE: values.role MODE: "" ROLE_AND_GOAL: ""ssm_param: /app/goal: values.goalAggregate では、各 value: テンプレートは {{ ではなく {{"{{"}} で始まります。ブロック自身のテンプレートが評価される前に、パラメーター補間のために Aggregate のテキスト全体が一度テンプレートとして読み込まれるためです。上のリストで引用しているテンプレートは、そのエスケープ後の形で示しています。独自の二重波括弧を含むテキスト を参照してください。
これにより、開発者自身のイメージを実行する Recipe は、コンポーネント自身の値に対する自分の変数名をデフォルトとして扱えます。これは標準ライブラリのカタログの慣例であり、企業のカタログは別の選択をすることもできます。そのような Recipe は、自身の値を自分の名前で配信する前に、開発者のブロックがその値をすでに配信しているかどうかを確認し、配信している場合はデフォルトをスキップします。そのため、1 つの値の名前を変更した開発者も、他のすべてのデフォルトを維持できます:
workload: | containers: main: variables: {{- range $name, $value := .context.inject.env }} {{ $name }}: {{ $value | quote }} {{- end }} {{- $named := dict }} {{- with .context.self_inject.env }}{{ range $name, $key := . }}{{ $_ := set $named $key true }}{{ end }}{{ end }} {{- if not (hasKey $named "values.role") }} APP_ROLE: {{ .values.role | quote }} {{- end }}.context.self_inject はすべてのレンダリングに存在し、開発者がブロックを書いていない場合は空です。メカニズムはブロックがそれを指定した場合にのみ現れるため、ブロックが指定しない可能性のあるメカニズムを読み取るときは、上の with のようにガードします。テンプレートは、他のすべてのマップと同様に、どのように読み取っても名前をソート済みの順序で受け取ります。このマップは開発者が書いたテキストから読み取られます。その中に解決済みの値はなく、コンパイラは名前やキーにいかなる意味も付与しません。
.context.uses — JOIN 射影
.context.uses は、現在のノードから出るすべてのトポロジーエッジに対するコンパイラの拡充ビューです。各マップエントリはローカルのソケットエイリアスをキーとし(例: Aggregate が uses: { databases: { primary: { target: ... } } } と記述した場合、databases.primary は .context.uses.primary になります)、ターゲットの解決済み状態の JOIN 射影と呼び出し側の配信契約を保持します。
.target(string) — ターゲットノードのインスタンス ID。.socket(string) — 呼び出し側のソケット名(usesSchemaのキー)。.provides(文字列値のマップ) — ターゲットの解決済みprovides:キー(provides の評価時にターゲットの Recipe がエクスポートした公開出力文字列)。.inject(メカニズム → キー → 値のマップ) — このエッジに対する呼び出し側の inject ディレクティブ(uses[].inject宣言上のinject:ブロック)。メカニズムのキーはenv/file/arg/カスタムです。メカニズムごとのマップエントリは、ローカルキー → ターゲットの provides キーへの参照です。.labels(文字列値のマップ) — 消費側コンポーネントのものではなく、ターゲットのラベルです。ターゲット自身の.context.labelsが保持する集合、つまりカタログで記述されたラベルと、トポロジー構築時にlabel-transformで追加されたものです。.annotations(3 つのバケット) — ターゲットのrelease/catalog/aggregateアノテーションバケット。.component(string) — ターゲットの Component タイプ URI。.resolved_version(string) — Manifest 解決後のターゲットの Component バージョン。.boundary_path(string) — ターゲットの Release 境界パス。ターゲットが呼び出し側の境界にあるか別の境界にあるかにかかわらず設定されます。.origin_feature(string) — エッジが Feature アタッチメントによって合成された場合に設定されます(例: サイドカー Feature が認証情報 Feature へのusesエッジを提供する場合)。.values(map) — この接続に対する解決済みのエッジごとの開発者設定で、Aggregate のusesエントリに記述されます。エッジがエッジごとの values を持つ場合にのみ存在します。.infra(map) — この接続に対する解決済みのエッジごとのオペレーター設定で、Release のusesエントリに記述されます。エッジがエッジごとの infra を持つ場合にのみ存在します。.origin_release(boolean) — Aggregate が宣言したのではなく Release がこの接続を配線した場合にtrueです。Aggregate が宣言する接続では存在しません。.features(アタッチメントのマップ) — この接続に記述されたアタッチメントで、ソケットが宣言するスロット名をキーとします。後述を参照してください。接続がアタッチメントを持つ場合にのみ存在します。.render_facts(リストのマップ) — ターゲットのレンダリングが出力について報告した内容で、ファクト名をキーとし、.context.used_by上の呼び出し側の.render_factsと同じ形をとります。すべてのファクトはリストで、ターゲット自身のプロバイダー呼び出しが先に、続いてその各 Features がレンダリングされた順に並び、1 つの名前がそれぞれから得たリストは 1 つに結合されます。readsTargetRenderFacts: trueを設定した FeatureRecipe でのみ存在します。そのアタッチメントはすべてのコンポーネントのレンダリング後にレンダリングされるため、すべてのターゲットのレンダリングは完了しています。その場合はすべての接続に存在し、プロバイダーが何も報告しないターゲットでは空です。その FeatureRecipe のvaluesMapping:、workload:、artifacts:でのみ読み取れます。コンポーネント自身の Recipe テンプレート、injectMapping:、pipeline:ステップのwith:とwhen:、およびこのキーを設定しないすべての FeatureRecipe には存在せず、そうした FeatureRecipe のテンプレートがこれを読み取ると、何もレンダリングされる前にビルドが停止します。
どちらのエッジごとの設定マップも消費側スコープです。消費側ノードのレンダリングコンテキストにのみ置かれ、ターゲットのものには置かれません。
提供値は .provides.<name> で読み取ります。提供名はエッジ上に直接置かれるのではなく .provides の下にネストされるため、.context.uses.<alias>.<name> はどのフィールドも指さず、何も返しません。
両端が異なる出力にレンダリングされる接続では、.provides は値ではなく代替物を保持します。 両方の出力が組み立てられた後に provider が独自の参照でそのような接続を配線する場合(たとえば、CloudFormation スタックが別のスタックの値を読む場合)、.context.uses.<alias>.provides が持つ各値は、provider が後でスタック間参照または値そのものに置き換えるプレースホルダーです。これは provider 自身のページで説明しています。このような値は比較せずにコピーします。これは、そのような接続が inject パイプで届ける値が従うのと同じルールであり、その値も同じ種類のプレースホルダーです。値はそのまま全体を書くか、より大きな文字列の中に書くか、quote のように値をそのまま残す関数を通して書いてください。.provides から読んだ値を比較したり、それで分岐したり、長さを測ったり、変更したりするテンプレートは、プレースホルダーに対して判断することになるため、代わりにビルドが停止し、そのテンプレートと読んだ各値を示します。分岐は、消費する側のコンポーネント自身の値で行ってください。この停止は、接続の .provides を読むすべてのテンプレートに及び、アタッチされた FeatureRecipe の injectMapping: や、同じ接続を .boundary の下で読む境界スコープの FeatureRecipe も含みます。両端が 1 つの出力にレンダリングされる接続は、値をそのまま持ちます。
1 つのエイリアスは 1 つの接続を指すため、マップにはコンポーネントが行うすべての接続のエントリがあります。 マップは接続がどのソケットに配線されているかにかかわらずエイリアスのみをキーとし、1 つのコンポーネントの 2 つの接続がエイリアスを共有することはありません。同じソケット上でも 2 つのソケット上でも、どのドキュメントやアタッチメントがそれぞれを記述したかにかかわらずです。ビルドはそのようなペアを、両方の接続とそれぞれの記述場所を示して、何もレンダリングされる前に拒否します。リストのエントリのエイリアスはそのターゲットであるため、1 つのターゲットを 2 回指すリストはそのようなペアです。models ソケット上の local 接続と databases ソケット上の local 接続も同様です。
Recipe テンプレートは、IR グラフをたどらずにターゲット側の状態を参照するためにこの射影を使用します。FeatureRecipe の injectMapping テンプレートは、境界をまたぐルーティングの判断のためにこれを使ってターゲットのアノテーションにアクセスします(entities/featurerecipe.md に記載されている K8s DNS リゾルバーのパターンが代表的な実例です)。
.context.uses を range するテンプレートは、Aggregate が記述した順ではなく、キー順(エイリアスでソート)で接続を参照します。 テンプレートが range するすべてのマップは、.features や接続の .features も含めてこのように走査されるため、マップを range して記述順を復元することはできません。順序に意味がある場合、記述サーフェスはそれをリストとしてモデル化します。いずれの場合も、同じ入力のビルド間でレンダリング出力はバイト単位で同一です。
接続のアタッチメント — .context.uses.<alias>.features
接続に記述されたアタッチメント(Aggregate 内のコンポーネントの uses エントリの features: の下、またはその接続に対する Release のエントリ)は、ソケットが宣言するスロットを埋めます。ビルドがそれに対して行うすべての処理において、これは消費側コンポーネントのアタッチメントです。Manifest がその実現をバインドし、その FeatureRecipe が消費側でレンダリングされ、その provides 契約が適用されます。テンプレートは、それが記述された接続の下でこれを読み取ります。
{{- range $alias, $edge := .context.uses }}- name: {{ $alias }} api_base: {{ $edge.provides.endpoint }} {{- with $edge.features }}{{ with .credential }} api_key_secret: {{ .provides.name }} api_key_key: {{ .provides.key }} {{- end }}{{ end }}{{- end }}- スロットをキーとする。
.context.uses.<alias>.features.<slot>は接続のソケットが宣言するスロット(上の例ではcredential)を指すため、複数のターゲットに接続する消費側は、各ターゲット固有の認証情報をそのターゲットのエイリアスの下で読み取ります。アタッチメントを持たない接続には.featuresがないため、読み取りをガードしています。 - アタッチメントの形。 各エントリは、コンポーネント自身のアタッチメントについて
.features.<name>が保持するものとまったく同じもの(.type、.resolved_version、.labels、.values、.infra、およびバインドされた FeatureRecipe の解決済み.provides)を保持します。アタッチメントの形を参照してください。ここで読み取る provides は、そのアタッチメント自身の FeatureRecipe がレンダリングに使うものであるため、消費側が参照する名前とその FeatureRecipe が出力するリソースの名前は、同じ 1 つの評価値です。 .featuresには含まれない。 コンポーネント自身の.featuresは、そのコンポーネント自身のブロックに記述されたアタッチメントのみを保持します。そのため、.featuresを range してタイプでアタッチメントを選び出す Recipe({{ range $name, $f := (default dict .features) }}{{ if eq $f.type "core/referenced-secret" }}…)は、同じ Feature であっても接続の認証情報には出会いません。テンプレートは接続のアタッチメントにその接続を通じて到達し、.featuresを通じて到達することはありません。assertionsコンテキストを含め、コンポーネントのアタッチメントを示すすべてのサーフェスで同様です。
このコンポーネントを使用するコンポーネント — .context.used_by
.context.uses は外向き、つまりコンポーネントが行う接続を見ます。.context.used_by は内向き、つまり uses エントリがこのコンポーネントを指しているコンポーネントを見ます。これはコンポーネントにアタッチされた FeatureRecipe が読み取るもので、それらの接続を記述または制限するリソースはここに置きます。たとえば、このコンポーネントを呼び出すと宣言されたコンポーネントだけを許可するネットワークポリシーです。
artifacts: callers.yaml: | apiVersion: v1 kind: ConfigMap metadata: name: {{ .context.rendered_name }}-{{ .attachment_name }} data: callers: | {{- range .context.used_by }} - component: {{ .component_id }} socket: {{ .socket }} selector: {{ .provides.selector }} {{- with .source_namespace }} namespace: {{ . }} {{- end }} {{- end }}各エントリは次を持ちます。
.component_id(文字列) — 接続元コンポーネントのインスタンス ID をフラット化した形式(frontend、data-layer.etl)で表したもので、subDirectory:パステンプレートが.component_idとして読み取る値です。.socket(文字列) — 接続元コンポーネント上でその接続が埋めるソケット(そのusesSchemaキー)。.provides(文字列値のマップ) — 接続元コンポーネントが公開するもので、その Component が宣言するキーに絞り込まれます。そのコンポーネントのコンシューマーが.context.uses.<alias>.providesで読み取るのと同じ値です。コンポーネントの Recipe が公開していても、その Component が宣言していないキーは含まれません。.source_namespace(文字列) — 接続元コンポーネントが配置される名前空間です。そのコンポーネントに適用されるaggrega.ai/namespaceアノテーションで、境界を下ってカスケードし、Release 内のそのコンポーネント自身のエントリが優先されます。Release エントリで名前空間を設定するかnullでクリアしたコンポーネントは、境界の設定ではなく自身の設定を持つため、この値はそのコンポーネント自身のリソースがレンダリングされる名前空間を示します。コンポーネントに名前空間が適用されない場合は存在しません。そのまま出力せず、例のようにwithまたはifを通して読み取ってください。.source_boundary_path(文字列) — 接続元コンポーネントを保持する Release 境界のパスで、入れ子の境界は/で連結されます(edge、edge/inner)。.render_facts(リストのマップ) — 接続元コンポーネントのレンダリングが出力について報告した内容で、ファクト名をキーとし、.context.render_factsと同じ形を持ちます。すべてのファクトはリストであるため、エントリが 1 つの場合でもテンプレートは常にそれを range します。エントリは接続元コンポーネント自身のレンダリングと、それにアタッチされた Features のレンダリングから得られます。1 つの名前がそれぞれから得るリストは 1 つに連結され、コンポーネント自身の provider 呼び出しが先に、続いて各 Features がレンダリングされた順に並びます。readsCallerRenderFacts: trueを設定した FeatureRecipe の場合にのみ存在します。そのアタッチメントはすべてのコンポーネントのレンダリング後にレンダリングされるため、すべての呼び出し元のレンダリングが完了しています。その場合はすべてのエントリに存在し、provider が何も報告しない呼び出し元では空になります。このキーを設定しない FeatureRecipe はどのエントリにも.render_factsを見ず、そのテンプレートがこれを読み取ると、何もレンダリングされる前にビルドが停止します。
この 2 つの配置の値は、境界スコープの FeatureRecipe が .boundary エッジリスト内の同じ接続のエントリで source_namespace と source_boundary_path として読み取るものと同じです。どちらのビューもコンポーネントの配置場所を同じ方法で読み取るため、両者が食い違うことはありません。これらのリスト内のエッジは、各エンドポイントのアセンブリパスも持ちます。source_assembly_path と target_assembly_path で、エンドポイントの provider がそれを組み立てる、ビルドの出力ディレクトリ配下のディレクトリです。これは .context.used_by のエントリにはありません。
readsCallerRenderFacts: true を設定した FeatureRecipe は、各呼び出し元のファクトをホストのファクトと同じ方法で読み取ります。各エントリが port を持つ ports という名前のファクトを文書化している provider の場合は次のとおりです。
artifacts: callers.yaml: | callers: {{- range .context.used_by }} - component: {{ .component_id }} ports: {{- range .render_facts.ports }} - {{ .port }} {{- end }} {{- end }}provider が ports を報告しない呼び出し元は、失敗せずに空の ports: をレンダリングします。誰も報告していない名前は何もないものとして読み取られるためです。
このリストの振る舞い:
- 記述された順序。 エントリは接続元コンポーネントが記述された順序に従い、次にそれぞれ自身の
usesエントリの順序に従います。2 回接続するコンポーネントは、接続ごとに 1 回ずつ、計 2 回現れます。マップではなくリストであるため、rangeはその順序で呼び出し元に出会います。ソートは一切行われません。 - アタッチメントが自身のリソースをレンダリングする場所でのみ。 FeatureRecipe の
valuesMapping:、workload:、artifacts:がこれを読み取ります。コンポーネント自身の Recipe テンプレート、injectMapping:、pipeline:ステップのwith:とwhen:では空です。これらが生成するものはコンポーネント自身のレンダリング出力に入る可能性があるためです。injectMapping:はコンポーネントの配信パイプを書き込み、パイプラインステップはコンポーネントのドキュメントを書き換えることがあります。これにより、誰が使用してもコンポーネント自身の出力は同じに保たれます。コンポーネントに呼び出し元を 1 つ追加で配線すると、それにアタッチされ呼び出し元を読み取る Feature の出力は変わりますが、コンポーネント自身がレンダリングするものは何も変わりません。 - 接続自体に関する情報は含まない。 エントリは接続ごとの
valuesやinfraも、接続のアタッチメントも持ちません。それらは消費側コンポーネントの.context.uses.<alias>の下に留まります。 - 何もコンポーネントを使用していない場合は空。 その場合、それに対する
rangeは何もレンダリングしません。 - 受け渡すだけで、解釈しない。 ID、ソケット、公開値、配置はコンパイラがそのまま受け渡す文字列であり、レンダーファクトは各呼び出し元の provider が名前をキーとして報告したものです。コンパイラは名前から何も推論せず、何も取得せず、リソースがどの呼び出し元を許可すべきかについて何も決定しません。決定するのはテンプレートです。
provider がレンダリングについて報告した内容 — .context.render_facts
コンポーネントの provider は、レンダリングした出力に関するファクト、つまり書き込んだドキュメントのうち自身の形式に関する知識でしか見えない特性を報告できます。provider がどのファクトを、どの名前で、各エントリに何を含めて報告するかは、その provider 自身が文書化する契約です。provider 側については Reporting facts about what a guest emitted を参照してください。たとえば helm provider は、出力した Pod テンプレートのラベル、コントローラーと Service のセレクター、コンテナのポートを報告します。その render facts を参照してください。コンポーネントにアタッチされた FeatureRecipe は、コンポーネントの provider が報告した内容を .context.render_facts でファクト名をキーとして読み取ります。各エントリが name と port を持つ ports という名前のファクトを文書化している provider の場合は次のとおりです。
artifacts: ports.yaml: | ports: {{- range .context.render_facts.ports }} - name: {{ .name }} port: {{ .port }} {{- end }}- すべてのファクトはリスト。 provider はエントリが 1 つの場合でもすべてのファクトをリストとして報告するため、テンプレートは常にそれを range します。単独で読み取る単一の値はありません。
- 名前ごとに 1 つのリストで、コンポーネントのレンダリング全体で連結。 コンポーネントのレンダリングでは provider を複数回呼び出すことがあり(たとえばチャートのレンダリングと artifacts の配置)、各呼び出しはそれぞれ報告します。1 つの名前がそれらの呼び出しから得るリストは、呼び出しが実行された順に 1 つに連結されます。コンポーネントにアタッチされた Features がレンダリングしたものはここには含まれません。Feature は、コンポーネントの他の Features が何を出力したかにかかわらず、
.context.render_factsでコンポーネント自身のレンダリングのみを読み取ります。 - アタッチされた FeatureRecipe のすべてのテンプレートで。 その
valuesMapping:、workload:、artifacts:がこれを読み取り、pipeline:ステップのwith:とwhen:も同様です。ファクトはコンポーネント自身のレンダリングから得られるため、これを読み取っても誰がコンポーネントに接続するかに依存するものは生じません。コンポーネント自身の Recipe テンプレートとinjectMapping:には存在しません。これらはコンポーネントのレンダリング前に実行されるためです。 - 欠落ではなく空。 コンポーネントの provider が何も報告しない場合、
.context.render_factsは空のマップであり、誰も報告していない名前は何もないものとして読み取られるため、それに対するrangeは失敗せずに何もレンダリングしません。 - 順序。 リストは provider が報告した順序でエントリを保持します。オブジェクトのエントリはコンテキスト上の他のすべてと同様にキー付きマップであるため、それを range するテンプレートはキーの順序でキーに出会います。
- 受け渡すだけで、解釈しない。 コンパイラは各ファクトの値がリストであることだけを検査します。名前やエントリが何を意味するかは一切読み取らず、それをどう扱うかはテンプレートが決定します。
アサーションの .uses — ソケット、次にエイリアスをキーとする
assertions: テンプレートは、同じ接続をそれ自身のより狭いビューを通して読み取ります。.uses は .context の下ではなくルートにあり、接続のターゲットが公開したものは何も含みません。これは、両方のアサーションフェーズがレンダリングの前に評価されるためです。これはオーサリング形式 uses: <socket>: <alias>: { target: … } を反映しており、ソケットをキーとし、各ソケットの下ではその上のすべての接続のエイリアスをキーとします。リストのエントリとして書かれた接続は、そのターゲットをエイリアスとします。各接続のエントリは target、alias、および Feature のアタッチメントが引いた接続の場合は origin_feature を持ち、さらに .context.uses が持つファクトのうち 3 つを、同じ名前で同じ値を保持して持ちます。.labels はターゲットのラベル、.values は接続に書かれた値、.features は接続に書かれたアタッチメントで、スロットをキーとします。この 3 つはすべてのエントリに存在し、接続が何も持たない場合は空です。.features の下のアタッチメントは type、resolved_version、values のみを持ちます。これは、コンポーネント自身のものも含め、アサーションがすべてのアタッチメントを読み取る形です。アサーションの実行時点では、アタッチメントの FeatureRecipe はまだ provides を解決していないためです。
接続を 1 つ保持するソケットと複数保持するソケットは同じ形を持つため、アサーションはどちらも同じ方法で読み取ります。Aggregate のエントリに uses: { models: { local: { target: llama }, fast: { target: turbo } } } と書かれたコンポーネントの場合:
assertions: two-models-wired: | {{- if lt (len (optional .uses "models" dict)) 2 -}} {{- fail "wire two models to the models socket" -}} {{- end -}} local-is-llama: | {{- if and (hasKey .uses "models") (hasKey .uses.models "local") (ne .uses.models.local.target "llama") -}} {{- fail (printf "the local connection must point at llama; it points at %s" .uses.models.local.target) -}} {{- end -}}hasKey .uses "models" はソケットが接続されているかどうかを確認し、len はその接続数を数え、それに対する range は各接続をエイリアスのアルファベット順に巡回し、.uses.models.local.target は 1 つの接続を読み取ります。.uses.models.target はどの接続も指さず、アサーションの画面の missingkey=error のもとで停止します。レンダーコンテキストのマップと同じ理由で、各接続はそれ自身のエントリを持ちます。1 つのコンポーネントの 2 つの接続がエイリアスを共有することはありません。ビルドがアサーションの実行前にそれを拒否するためです。アサーションコンテキストの全体は assertions-block.md に記載されています。
inject に関連するサーフェス
テンプレートコンテキストには、それぞれ独自の意味を持つ、これらの inject 形式のフィールドがあります。Recipe と FeatureRecipe の作成者は、どのサーフェスを読むべきかを把握しておく必要があります。
| 画面 | 種類 | 設定される条件 | 用途 |
|---|---|---|---|
.context.inject | メカニズムのマップ(常に存在) | すべてのレンダリング | 標準の事前ハイドレート済みデリバリーパイプです。valuesMapping:/workload:/artifacts: テンプレート、およびすべての FeatureRecipe のテンプレートサイトではこれを読みます。 |
.inject(トップレベル) | メカニズムのマップ(null 許容) | アタッチメントが inject: ブロックを記述している場合に、そのアタッチメントの FeatureRecipe をレンダリングするとき | アタッチメント自身の inject: エントリです。そのブロックが指定する各メカニズム(env、file、arg、または vault_ref のようなカスタムのもの)の下に置かれ、各ローカル名はその from: が指定するキーにマッピングされます。そのキーは、FeatureRecipe が自身の provides: で公開するキー(コンパイラはこれをコンポーネントの .context.inject にも配信します)か、.inject を読む FeatureRecipe 自身が消費するキーのいずれかです。FeatureRecipe が公開していないキーを指定するエントリはビルドを停止させます。ただし、FeatureRecipe がこのコンテキストに対して評価するテンプレート(その valuesMapping:、workload:、artifacts:、omits:、またはパイプラインステップの with: や when:)が、テンプレートの指定するパスで .inject を読む場合は除きます。そのパスとは .inject、.inject.env、{{ with .inject }} などであり、toJson . のようにコンテキスト全体を渡すものではありません。その injectMapping: は数えられません。これはコンポーネントのコンテキストに対して評価され、そこには .inject が存在しないためです。アタッチメントのブロックはリテラルを持ちません。そこに value: エントリがあるとビルドが停止し、コンポーネントが必要とするリテラルはコンポーネント自身の inject: ブロックに記述します。カスタムメカニズムは .inject.env とまったく同じように .inject.<mechanism> で読み取られ、そのエントリはコアの 3 つと並んで .inject.all に現れます。アタッチメントが記述していないメカニズムをドット区切りで読むと、未知のキーとして停止します。これは if や with の内部でも同じで、そこでは .context.inject.<mechanism> は空として読まれます。アタッチメントが記述していない可能性のあるメカニズムは {{ with .inject }}{{ if hasKey . "<mechanism>" }}{{ index . "<mechanism>" "<key>" }}{{ end }}{{ end }} を通じて読んでください。これは、アタッチメントがそのメカニズムや何らかの inject: ブロックを記述しているかどうかにかかわらずビルドできます。ベースの Recipe のテンプレートや、inject: ブロックを記述していないアタッチメントには存在しません。 |
.inject_raw(トップレベル) | メカニズムのマップ(null 許容) | 開発者が親 component に inject: ブロックを記述した場合に設定 | inject マッピングによるインターセプトが行われる前の、変更されていない開発者の意図です。ブロックが指定する各メカニズム(env、file、arg、または ssm_param のようなカスタムのもの)はそれぞれ自身の名前の下にあり、書かれたとおりのエントリ(in と、from または value)を書かれた順序で保持します。.inject_raw.ssm_param は、.inject_raw.env がコアのメカニズムを読むのと同じ方法でカスタムのメカニズムを読みます。「開発者は元々このデリバリーキーを要求していたか」というロジックチェックに使用します。FeatureRecipe の injectMapping による書き換えの影響を受けません。開発者が inject: ブロックを省略した場合は nil です。 |
.context.self_inject | メカニズムのマップ(常に存在) | すべてのレンダリング。開発者がコンポーネントに inject: ブロックを書いていない場合は空 | コンポーネント自身の inject: ブロック内の各名前を、そのエントリが配信する自身のキー(provides.<key>、values.<key>、または空)に対応付けたものです。開発者がすでに配信している自身の値について、デフォルトの名前をスキップするために使います。上記を参照してください。 |
インターセプト後に解決されたデリバリーが必要な作成者は .context.inject を読みます。変更不可の元の意図が必要な作成者(たとえば、インターセプトを検出する場合や、開発者が inject ブロックを省略したときのフォールバック動作を出力する場合)は .inject_raw を読みます。開発者がコンポーネント自身の値のうちどれにすでに名前を付けたかを知る必要がある作成者は .context.self_inject を読みます。
アタッチメント FeatureRecipe のサーフェス
レンダラーがアタッチメント FeatureRecipe のテンプレートを評価するとき、トップレベルのフィールドが 1 つ追加で設定されます。
.attachment_name(文字列) — アタッチメントのインスタンス名です。所有エンティティのfeaturesSchema内でそのアタッチメントが埋めるスロット、または作成者が付けた自由な名前を指します。FeatureRecipe のlocals:、provides:、injectMapping:、valuesMapping:、artifacts:はこれを読み取って決定的なリソース識別子を導出し(ホストの provider がレンダリング名を報告する場合、たとえばhelmのように報告する場合は{{ .context.rendered_name }}-{{ .attachment_name | replace "_" "-" }}、報告しない場合は{{ .context.instance_id }}-{{ .attachment_name }})、処理中のアタッチメントに名前を付けます。
ベースの Recipe 自身のテンプレートはアタッチメントを解決しているわけではないため、このフィールドはそのコンテキストに含まれません。これを参照する Recipe の provides:、locals:、source: テンプレートは、空の値をレンダリングするのではなく、その参照を示して停止します。executionScope: boundary を持つ FeatureRecipe は component ごとに 1 回ではなく境界に対して 1 回レンダリングされるため、境界のために実行されるテンプレートでもこのフィールドは利用できません。その injectMapping: はアタッチメントが到達する各コンポーネントについて実行され、そこでこのフィールドを読みます。
アタッチメント自身のリソースを生成するテンプレート(その valuesMapping:、workload:、artifacts:)では、アタッチメントのコンテキストはそのホストを使用する component も .context.used_by に列挙し、その FeatureRecipe が readsTargetRenderFacts: true を設定している場合は、ホストが接続されている各 component がレンダリングした内容を .context.uses.<alias>.render_facts に保持します。これらのテンプレートとその pipeline: ステップは、ホストの provider がホストのレンダリングについて報告した内容も .context.render_facts で読み取ります。境界スコープの FeatureRecipe は、ホスト component なしで、.context もなしにリソースをレンダリングします。代わりに、境界へのすべての接続を .boundary.internal_uses_edges と .boundary.incoming_cross_boundary_uses_edges で読み取ります。その injectMapping: は、それが記述するテンプレートのうちコンポーネントのコンテキスト(アタッチメントが到達する各コンポーネントのもので、.context.* を含む)で実行される唯一のものであり、そこで .boundary を参照するとビルドが停止します。
このフィールドは、アタッチメントのインスタンス名に到達する唯一の経路です。.context.instance_id はアタッチメントが解決の対象としているホスト component です。これは、FeatureRecipe 自身の locals: を含め、コンパイラが評価するすべてのテンプレートサーフェスでホストを表します。そのため、2 つの名前は交換可能ではなく、どちらも他方の代わりにはなりません。
.source はアタッチメント自身のものです。FeatureRecipe の source: テンプレートは、Recipe のものがそれ自身のマッピングより前に評価されるのと同様に、その valuesMapping: より前に評価されます。その結果が、アタッチメントのリソースを生成するテンプレート(その valuesMapping:、omits:、workload:、artifacts:)およびその pipeline: ステップで .source が保持する内容です。ホストコンポーネントのソースになることはありません。source: を宣言していない、またはテンプレートが何も生成しない FeatureRecipe は、ホストの Recipe がソースを宣言していても、そこでは何も読みません。境界スコープの FeatureRecipe は、同じテンプレートで自身のソースを読みます。唯一の例外は injectMapping: で、これはアタッチメントのソースが評価される前に実行され、ホストコンポーネント自身の Recipe と同様に .source を読みます。
.context.rendered_name もホスト component のものです。component ごとのアタッチメントのすべてのテンプレートで、ホスト自身の provider がホストについて報告する名前(ホスト自身の Recipe が読み取る値)を保持します。そのため、アタッチメントは {{ .context.rendered_name }}-{{ .attachment_name }} でホストにちなんだリソース名を付けることができ、ホストの識別子にアンダースコアや大文字が含まれていても、プラットフォームが受け付ける名前が得られます。これはホストの provider が名前を報告する場合に存在し、報告しない場合には存在しません。そのようなホストでこれを読み取ると、FeatureRecipe がインラインで記述する injectMapping: 以外のどのテンプレートからでもビルドが停止します。Naming a Rendered Resource を参照してください。
サイトごとの利用可能性
利用できるフィールドはテンプレートサイトによって異なります。Recipe の provides: テンプレートは provides の評価時に自己完結したコンテキスト(.context.inject/.context.uses なし)で実行されます。Recipe の valuesMapping: はベースレンダリング時に完全なテンプレートコンテキストで実行されます。FeatureRecipe の injectMapping: は inject マッピング時に、インターセプトされる inject パイプを含む完全なテンプレートコンテキストで実行されます。サイトごとの完全な利用可能性の表は expansion-matrix.md にあります。このページでは、マトリクスの「利用可能な参照」列が指すフィールドの形を説明します。
相互参照
05-templates.md— テンプレートの概要。expansion-matrix.md— テンプレートサイトごとの評価マトリクス。sprig-functions.md— テンプレートエンジンに組み込まれた Sprig ヘルパー。../entities/recipe.md— Recipe の記述インターフェース。../entities/featurerecipe.md— FeatureRecipe の記述インターフェース(.context.usesの走査を示す K8s DNS リゾルバーの実例を含みます)。../vocabulary/topology-triad.md— インジェクション契約の仕様(二重状態のコンテキスト、キー衝突のルール、実例を扱います)。../10-status.md#compilation-pipeline-phases— inject マッピング、ベースレンダリング、プラグインパイプラインの各インターフェースの現在の対応状況。