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

Aggrega Wasm Provider レンダーソケットスキーマ

自動生成されたリファレンスです。手動で編集しないでください。公開されている JSON Schema から再生成してください。

スキーマ ID: https://aggrega.ai/schemas/wasm-provider-v1beta1.schema.json

Provider のレンダープラグインソケットが受け取り、出力するワイヤ形式です。Provider のゲストは、render_node エクスポートで 1 つの IR ノードを出力ファイルにレンダリングし(RenderNodeInput から RenderNodeOutput へ)、任意で assemble_boundary エクスポートにより、1 つの境界におけるノードごとの出力を単一の組み立て済みアーティファクトにマージします(AssembleBoundaryInput から AssembleBoundaryOutput へ)。AssembleBoundaryOutput は組み立て済みのファイルと診断を運びます。各コントリビュータのファイルがどこに置かれるかは、この応答ではなく、ゲストの describe() 契約で一度だけ宣言されます。ゲストは任意の validate_node_input エクスポートを宣言することもできます。これはレンダーのディスパッチ前にノードの解決済み入力を構造的に検査するもので、render_node が受け取るのと同じ RenderNodeInput の射影を受け取り、診断のみを運ぶ ValidateNodeOutput を返します。halt 重大度の診断はビルドを明示的に停止し、warn 重大度の診断はビルド結果に表示されます。ターゲットが受け入れる名前に上限や制限があるゲストは、任意の name_bound エクスポートを宣言することもできます。ホストはノードのコンポーネント ID を確定する前にこれに問い合わせます。これは提案された名前を 1 つ運ぶ NameBoundInput を受け取り、ゲストがそこから導出する名前の種類ごとに 1 つの判定を運ぶ NameBoundOutput を返します。判定が運ぶのは制約(使用可能、またはより短い長さに制限)であり、ゲストが組み立てた名前ではありません。そのため、ターゲットが何を受け入れるかという知識はゲストの中にとどまります。これとは別に、レンダリングするリソースに対してターゲットが独自の名前を導出するゲスト(作成者が提供したソースから、またはゲストが合成するワークロードから)は、任意の rendered_name エクスポートを宣言できます。ホストはこれに問い合わせ、Recipe の作成者がその名前を読み取り、それをもとに組み立てたアドレスを公開できるようにします。これは、ターゲットが導出元とする ID と、ノードの Recipe が宣言する入力の種類を運ぶ RenderedNameInput を受け取り、ゲスト自身がレンダリングに用いる名前を運ぶ RenderedNameOutput を返します。名前を導出しない場合は名前を返しません。この 2 つのエクスポートは 1 つの主題の逆方向であり、どちらも他方の代わりにはなりません。name_bound はホストが提案する名前の判定をゲストに求め、rendered_name はゲストが組み立てた名前を報告し、ホストはそれを読まずに運びます。ゲストは carve と reassemble を宣言することもできます。前者はパイプラインステップのために自身の出力をアドレス指定可能な単位に切り分け、後者はパッチ適用済みの単位を元に戻してつなぎ合わせます。また、link_publish と link_resolve を宣言することもでき、これらは両端が異なるディスパッチグループに組み立てられる uses エッジを結線します。各ペイロードの形は、そのエクスポートが指定する定義です。x-aggrega-exports テーブルは、ホストがゲストを呼び出すすべてのエクスポート(carve と reassemble を含む)を、その入力の定義と出力の定義に対応付けます。それぞれはこのドキュメントの $defs を指す JSON Pointer であるため、ペイロードを検証するツールはそこで定義を参照します。ドキュメントのルートは独自の形を宣言しません。1 つのドキュメントが複数のエクスポートの有効なペイロードになり得るためです(空のオブジェクトは validate_node_input、name_bound、rendered_name のいずれに対しても有効な応答です)。ゲストは各出力ファイルのシリアライズ済みバイト列を返します。ホストはそれをそのまま書き込み、シリアライザは実行しません。そのため決定性はゲストの責任です。同一の入力は同一のバイト列を生成しなければなりません。Go、Rust、TypeScript のペイロード型はこのスキーマからプラグイン ABI パッケージに生成されるため、3 つの言語は 1 つのワイヤを読み書きします。ゲストはそれらをこれらのパッケージから、またはプラグインキットが再エクスポートしている場合はプラグインキットを通じてインポートします。

エクスポート

スキーマの x-aggrega-exports テーブルは、ホストがゲストを呼び出す各エクスポートを、その入力の定義と出力の定義に対応付けます。ペイロードの形は、そのエクスポートが指定する定義です。

エクスポート入力出力
render_nodeRenderNodeInputRenderNodeOutput
validate_node_inputRenderNodeInputValidateNodeOutput
assemble_boundaryAssembleBoundaryInputAssembleBoundaryOutput
carveCarveInputCarveOutput
reassembleReassembleInputReassembleOutput
name_boundNameBoundInputNameBoundOutput
rendered_nameRenderedNameInputRenderedNameOutput
link_publishLinkPublishInputLinkPublishOutput
link_resolveLinkResolveInputLinkResolveOutput

定義

RenderNodeInput

Provider ゲストが render_node エクスポートで受け取るペイロードです。ゲストがレンダリングするノードごとの IR プロジェクション、レンダリング時のコンテキスト、ノードにバインドされた Recipe が宣言する事前評価済みの入力(取得済みソースの一覧、ワークロード、アーティファクトセット。いずれもその Recipe が宣言する場合にのみ存在します)、そしてゲストがソースのレンダリングから除外するレンダリング単位を指定するエントリを含みます。

プロパティ種類必須説明
nodeIRNodeProjectionはいProvider ゲストがレンダリングするノードごとの IR データです。完全な IR ノードを範囲を限定して射影したもので、ノードごとの ID と、ゲストが出力するすべてのマニフェストに付与する来歴を運びます。具体的には、id、type、解決済みの recipe、values、values マッピングがその values を生成したかどうか、feature のアタッチメント、レンダリングされたキーおよび values 全体に対する機密性マーキング、外向きの uses エッジ、境界パス、sync wave、Recipe の ID、component-id のオーバーライド、派生名の基礎、ビルドの来歴です。ID と派生名の基礎は別々に運ばれます。これらは「リソースが何に属するか」と「作成者自身のソースが何に対してレンダリングされるか」という 2 つの問いに答えるものであり、作成者が書いたソースを届ける Feature アタッチメントでは、2 つの答えが異なるためです。ソースファイルの内容はここでは運ばれず、ソースプロジェクションで別途運ばれます。ここでのすべてのキー集合は固定の順序を持ちます(features と uses は作成者の順序、values と機密性マーキングはキーのソート順)。そのため、同一の入力に対する実行間で、ワイヤペイロードはバイト単位で同一になります。
contextobjectはいホストがゲストに渡すレンダー時のコンテキストで、その JSON ドキュメントのバイト列として運ばれます。このスキーマはこのオブジェクトを宣言しません。これは同じノードのパイプラインステップが受け取るコンテキストにインデント幅を加えたものです。parameters(名前順に並べた Release のパラメーター値で、ない場合は存在しません)、annotations(ノードのアノテーションを、それぞれが記述された場所によって aggregate、release、catalog に分けたもので、空の場合はそれぞれ存在しません)、boundary(ノードが属する境界で、name、path(そのセグメント)、sync_wave(0 の場合は存在しません)、directory、sub_directory(ない場合は存在しません)、annotations(Release の境界がノードまでカスケードする集合で、自身の Release エントリーのものが最後に重ねられます。空の場合は存在しません))、そして yaml_indent(ゲストが出力をシリアライズする際のレンダー全体のインデント幅)です。ホストコンポーネントを持たない境界スコープの FeatureRecipe のレンダーは、そのパイプラインステップが受け取るコンテキストに yaml_indent を加えたものを受け取ります。すなわち parameters、境界自身のアノテーション集合である release バケットのみを持つ annotations、そして name、path を持ち、その同じ集合を annotations とする boundary です。よく知られた aggrega.ai/* アノテーションは、aggregate バケットの上に release バケットを重ねたものから読み取られるため、両方が持つキーは Release の値を取ります。標準ライブラリの provider はその重ねられた集合からそれらを読み取り、catalog バケットからは決して読み取りません。そのため、カタログの値がそれらを決めることはなく、コンテキストに aggregate バケットを持たない境界スコープの FeatureRecipe は、いずれかのコンポーネントの値ではなく、その境界の値によってレンダリングされます。
source_listingSourceListingいいえソースを持つ provider に対してホストがゲストに渡す、取得済みソースの汎用的な列挙です。ソースのルート、そのルートがディレクトリかどうか、およびその下にあるルート相対のエントリのソート済み一覧を含みます。ホストはここでファイルの内容を読み取らず、名前だけを列挙します。ゲストは一覧に対して独自の解決ロジックを適用し、選択したものを pack-source ホスト関数を通じてパックするようホストに依頼します。そのため、provider ごとのソース解決の知能はすべてゲスト側にあります。ソースを持つ provider では存在し、それ以外では存在しません。
workload_projectionWorkloadProjectionいいえホストがゲストに渡す事前評価済みのワークロードで、ゲストはこれから provider ネイティブのマニフェストを合成します。バインドされた Recipe がチャートのソースではなくワークロードを宣言する場合に存在し、それ以外では存在しません。
artifacts_projectionArtifactsProjectionいいえホストがゲストに渡す事前評価済みのアーティファクトセットで、ゲストはこれをノードの出力に配置します。バインドされた Recipe がアーティファクトを宣言する場合に存在します。ホストはすでに各エントリのソースを読み取り、レンダーコンテキストに対して Go テンプレートとして評価し、ビルド来歴のキー集合を計算しています。出力形式、来歴の配置、ディスク上のパス、最終的なバイト列はゲストが決定します。ノードがアーティファクトを宣言しない場合は存在しません。
omitsOmitEntry[]いいえゲストがこのノードの出力から除外するレンダリング単位を指定するエントリで、作成者が宣言した順序で並びます。各エントリは解決済みの状態で届き、そのフィールドはプレーンな文字列です。このビルドに適用されないエントリは運ばれません。エントリの kind、name、namespace、subchart が何を選択するかは、このソケットではなく、この provider 自身が文書化する契約です。ゲストは、自身がレンダリングしたものに対して各エントリを自身の形式の観点で照合し、エントリに一致した各単位を返すものすべて(ファイル、derived_keys で宣言する名前、render_facts で報告する事実)から除外し、各エントリが一致した単位の数を出力の omitted で報告します。エントリはソース一覧にのみ付随し、他の入力には付随しません。合成されたワークロードやアーティファクトセットのレンダリングでは運ばれません。エントリがない場合は存在せず、エントリを渡されなかったゲストは、このフィールドが存在しない場合とまったく同じようにレンダリングします。

追加のプロパティは許可されません。

IRNodeProjection

Provider ゲストがレンダリングするノードごとの IR データです。完全な IR ノードを範囲を限定して射影したもので、ノードごとの ID と、ゲストが出力するすべてのマニフェストに付与する来歴を運びます。具体的には、id、type、解決済みの recipe、values、values マッピングがその values を生成したかどうか、feature のアタッチメント、レンダリングされたキーおよび values 全体に対する機密性マーキング、外向きの uses エッジ、境界パス、sync wave、Recipe の ID、component-id のオーバーライド、派生名の基礎、ビルドの来歴です。ID と派生名の基礎は別々に運ばれます。これらは「リソースが何に属するか」と「作成者自身のソースが何に対してレンダリングされるか」という 2 つの問いに答えるものであり、作成者が書いたソースを届ける Feature アタッチメントでは、2 つの答えが異なるためです。ソースファイルの内容はここでは運ばれず、ソースプロジェクションで別途運ばれます。ここでのすべてのキー集合は固定の順序を持ちます(features と uses は作成者の順序、values と機密性マーキングはキーのソート順)。そのため、同一の入力に対する実行間で、ワイヤペイロードはバイト単位で同一になります。

プロパティ種類必須説明
idstringはいトポロジーグラフ内でのノードの絶対 id です。
typestringはい宣言されていますが、意図的に提供されません。ホストは常にこれを空文字列として出力します。ノードの component-type ラベルは動作の切り替えではなく不透明なメタデータであり、ここで運ぶとゲストがそれに基づいて分岐することを招くだけだからです。ゲストは空文字列を読み取りますが、それを component type が未設定のノードとして解釈してはなりません。(境界アセンブリのノードの形は、別の目的のために独自の type を運びます。)
resolved_recipestringはい宣言されていますが、意図的に提供されません。ホストは常にこれを空文字列として出力します。バインドされた Recipe の ID は、ゲストが来歴に付与する recipe の名前とバージョンとしてすでにゲストに届いているため、解決済みの URI はゲストがレンダリングに使うものを何も追加しません。出力を Recipe に帰属させる必要があるゲストは、代わりにそれらの来歴フィールドを読み取ります。
valuesobjectいいえノードのレンダリング済み values 辞書で、ゲストがレンダリングに使うキー集合です。キーは作成者の順序ではなくソート順で届き、このソートによって同一の入力に対する実行間でペイロードがバイト単位で同一になります。別の順序が必要なゲストは、自身でその順序を適用します。
featuresobjectいいえfeature エイリアスをキーとするノードの feature アタッチメントで、IR が運ぶのと同じノードごとの feature アタッチメントの形を運びます。各エントリは、アタッチメントの values、infra、inject マッピングを、派生した機密性マーキングとともに運びます。そのため、ゲストはアタッチメントが機密と宣言された素材を扱うかどうかをペイロードだけから読み取れます。作成者の順序を保持するため、同一の入力に対する実行間でペイロードはバイト単位で同一になります。このスキーマ層では不透明であり、ゲストは feature エントリの形を IR のワイヤ契約を通じて読み取ります。
sensitive_rendered_keysstring のマップいいえ作成者が機密として宣言したデータからアイデンティティが復元されるレンダリング済みキーで、それぞれがその機密性を継承した宣言にマップされます。レンダリング入力上でホストからゲストへ渡されます。これは、ゲストがレンダリング出力上で宣言する名前とは逆方向です。キーが何を指すかは、このペイロードが運ぶ形に従います。ノードの values を運ぶペイロードではそのマップのキーの 1 つであり、workload を運ぶペイロードでは workload 自身のアタッチメントマップ内のエントリを指し、その場合ノードの values は空です。キーが存在するのは復元が正確な場合のみで、キー自身のテキストから何も読み取らず、ノード単位やアタッチメント単位のマーキングを個々のキーに広げることもなく、宣言をレンダリング済みのアイデンティティに結び付けます。したがって、テンプレートが作り出したキーは、それを指す宣言がないため存在しません。recipe の valuesMapping の出力キーと artifact の内容はテンプレートが作成したものなので、どちらもここにキーを生じません。そのようなペイロードが機密として宣言された値から生成されたかどうかは、代わりに sensitive_values と、artifact エントリ自身の sensitive_content によって運ばれます。したがって、キーがないことは、どのキーのアイデンティティも復元できなかったことを示すのであって、このペイロード上に機密情報を運ぶものが何もないことを示すのでは決してありません。キーがないことを、値を平文で表示または出力してよいという許可と読むゲストは、意味を逆に読んでいます。キーはソート順で届き、これによって同一入力の実行間でペイロードがバイト単位で同一になります。
sensitive_values真偽値いいえこのペイロードが運ぶ values が、作成者が機密として宣言した値、またはそれに由来すると追跡された値を読み取るテンプレートによって生成された場合に true です。そのようなテンプレートとは Recipe または FeatureRecipe の valuesMapping で、出力のキーと値をそれ自身が作り出す単一のテンプレートであるため、その出力のどのキーも由来するデータまで遡って追跡できず、代わりにマップ全体がマークされます。これはテンプレート自身の参照を宣言と照合して判断されます。宣言された値に到達する参照、テンプレートがそのデータ全体を引き渡すこと、またはパースできないテンプレートは、いずれも該当します。値の内容やキーの名前から判断されることは決してありません。人が読むテキスト(拒否や警告)を組み立てるゲストは、これが true の場合、ノードの values のすべての値をそのテキストから除外し、これが true かどうかにかかわらず、sensitive_rendered_keys が指すキーの値を除外します。両者は組み合わせて使うもので、一方はアイデンティティが正確に復元されるキーを指し、こちらはそれができないマップを対象とします。そのようなテンプレートがそのような値を読み取らなかった場合は存在しません。これには、宣言されたリーフそのものである値(代わりに sensitive_rendered_keys でキーごとにマークされます)が含まれ、values を運ばないペイロードでも存在しません。存在しないことが、機密の値がないことを示すことは決してありません。
values_mapped真偽値いいえこのペイロードが運ぶ values が、作成者が書いたまま引き渡されたノードの values ではなく、バインドされた Recipe または FeatureRecipe の valuesMapping の出力である場合に true です。自身の契約によって、ソースが宣言する入力にマッピングが生成した値のみをバインドするゲストはこれを読み取り、Recipe の artifacts など他の用途のために書かれた値は読み取らずに残します。生成方法にかかわらずノードの values をソースにバインドするゲストはこれを読み取りません。これは values がどのように生成されたかを記録するもので、キーの名前や値の内容から導出されることは決してありません。valuesMapping が実行されなかった場合と、values を運ばないペイロードでは存在しません。
usesstring[] のマップいいえ宣言されていますが、意図的に提供されません。ホストはこれを設定しないため、このマップはすべてのレンダリングペイロードに存在しません。外向きのエッジはディスパッチ前に消費されます。エッジの公開された値はノード自身の inject パイプに再水和され、Recipe はそれをゲストが受け取る values と workload にすでに評価しています。境界を組み立てるゲストは、代わりに自身の入力でエッジのリストを受け取ります。仮に設定された場合は、ノードの外向きの uses エッジをソケットエイリアスをキーとして保持し、それぞれがそのソケットの順序付きターゲットノード id を作成者の順序で運びます。
boundary_pathstringいいえノードの境界パスで、metadata ブロックを持つすべての出力マニフェストに aggrega.ai/boundary-path アノテーションとして付与されます。
sync_waveintegerいいえこのノードが、それを含む境界から継承したデプロイウェーブ(デフォルトは 0、負の値も可)で、IR ノードが sync_wave として保持する値を運びます。ゲストがこれをどう扱うかはゲスト自身の選択であり、値を記録することとそれに基づいて順序付けることは択一ではなく独立しています。ゲストはどちらか一方、両方、またはどちらも行わないことができます。標準ライブラリのプロバイダーでは、helm と helm-chart はこれをレンダリングされたすべてのリソースに argocd.argoproj.io/sync-wave アノテーションとして出力し、さらにチャートがすでに Helm フックとしてマークしているリソースには helm.sh/hook-weight としても出力します。compose はこれをサービスラベルとして記録するとともに、レンダリング先のファイルのサービスを、それらの間の depends_on によって順序付けます。cloudformation は組み立てられたスタックのプロビジョニングを順序付け、各ウェーブのすべてのリソースが前のウェーブのリソースに依存するよう宣言します。terraform は境界が組み立てるルート設定の module ブロックを順序付け、各ウェーブのすべての module が前のウェーブの module に依存するよう宣言し、さらにノードのビルド来歴とともにこれを記録します。
recipe_namestringいいえバインドされた Recipe の名前で、recipe_version と組み合わされて aggrega.ai/recipe-uri アノテーションを形成します。いずれかが空の場合、アノテーションは付与されません。
recipe_versionstringいいえバインドされた Recipe のバージョンで、recipe_name と組み合わされて aggrega.ai/recipe-uri アノテーションを形成します。いずれかが空の場合、アノテーションは付与されません。
label_component_idstringいいえKubernetes で安全に使えるコンポーネントのアイデンティティです。このノードが出力するリソースが何に「属する」かを表し、来歴が記録し、セレクタが照会するものです。空でない場合、app.kubernetes.io/name および aggrega.ai/component-id ラベルの値としてノード id を上書きします。空の場合は、ノード id がすでにラベルとして有効であり、そのまま使われることを意味します。Feature アタッチメントが出力するすべてのリソースについて、アタッチメントがどのような方法で提供するかにかかわらず運ばれるため、アタッチメントのリソースはラベルだけでホストコンポーネントのリソースと区別できます。ゲストが自身の名前を導出する元は別の項目 derived_name_basis であり、両者は異なる問いに答えます。
derived_name_basisstringいいえゲストが自身の名前を導出する元となるアイデンティティです。チャートインストーラーのテンプレートが読み取るリリース名であり、そのようなゲストはコンポーネントのために合成するリソースにもこの名前を付けることがあります。またソースレンダリングが出力するファイルの接頭辞でもあります。空の場合はノード id がそのまま使われることを意味し、これは通常のコンポーネントと、コンポーネント単位の Feature アタッチメントの値です。作成者が書いたチャートやフラグメントを提供するアタッチメントは、それを「ホスト」コンポーネントの名前に対してレンダリングします。作成者自身のテンプレートはその名前に基づいてリソースに名前を付けるため、別の名前にするとすでにデプロイ済みのリソースの名前が変わってしまうからです。ターゲットの名前の文字集合が拒否するマーカー構文を id に含むノードは、代わりにこれを明示的に運び、ゲストが導出する名前がターゲットに受け入れられるものに保たれるようにします。これは意図的に label_component_id と分けられています。作成者のソースをレンダリングするのではなく Feature アタッチメントのためにリソースを「構築する」ゲストは、そのリソースにアイデンティティに基づく名前を付けるため、アタッチメント自身のリソースはホストのリソースと衝突せず、一方で作成者のソースがレンダリングされる名前は変わりません。ノードのアイデンティティがそのソースのレンダリング対象でもある場合、両者は同じ値を運びます。
output_labelsstring のマップいいえゲストがビルド識別の来歴とともに出力するすべての manifest に付与する、recipe の作成者が宣言した出力ラベルで、ラベル名をキーとします。作成者が記述する 2 つのブロックがこの 1 つのマップに統合されます。recipe が outputLabels に記述するリテラルのキーと値のペアと、recipe が outputComponentLabels に指定する各キーに対する 1 つのエントリです。後者の値は、レンダリングされる component 自身のラベルにあるそのキーから読み取られます。そのため、昇格された値は recipe 内で繰り返されるのではなく、取得元の component に従います。どちらのブロックもロード時の検証によって来歴のキー空間と重ならないことが保証されるため (aggrega.ai/ や app.kubernetes.io/ のキーは不可)、付与が来歴ラベルと衝突することはありません。component が宣言していない昇格キーは何も付与せず、空のラベルではなく勧告を発生させます。出力が Kubernetes YAML ではないゲストは、これらを自身のラベルの仕組み (Compose のサービスラベル) に変換するか、無視します。
provenanceNodeProvenanceはいゲストが出力するすべての manifest に aggrega.ai ラベルとして付与するビルド識別の来歴です。

追加のプロパティは許可されません。

NodeProvenance

1 つのノードのビルド識別の来歴です。ゲストが出力するすべての manifest に aggrega.ai ラベルとして付与する、コンパイラ、aggregate、環境の識別情報です。各フィールドは空の場合に省略されるため、部分的な識別情報では含まれているラベルのみが付与されます。

プロパティ種類必須説明
compiler_versionstringいいえコンパイラのバージョンです。空でない場合、aggrega.ai/compiler-version ラベルとして付与されます。
aggregate_namestringいいえaggregate の名前です。空でない場合、aggrega.ai/aggregate-name ラベルとして付与されます。
environmentstringいいえ環境の名前です。空でない場合、aggrega.ai/environment ラベルとして付与されます。
provider_namestringいいえprovider の種類そのものです。空でない場合、aggrega.ai/provider ラベルとして付与されます。
provider_versionstringいいえ解決された provider レンダリングプラグインのバージョンです。空でない場合、aggrega.ai/provider-version ラベルとして付与されます。

追加のプロパティは許可されません。

RenderNodeOutput

Provider ゲストが render_node エクスポートから返すペイロードです。ゲストが出力した各出力ファイルのシリアライズ済みバイト列、ゲストが自身の各キー空間に導出した名前、出力内容についてゲストが報告するファクト、渡された各 omit エントリが一致したレンダリング単位の数、そしてレンダリング中にゲストが発行した診断を含みます。ゲストは各ファイルのシリアライズ済みバイト列を返し、ホストはそれをそのまま書き込み、シリアライザは実行しません。決定性はゲストの責任です。同一の入力は同一のバイト列を生成しなければなりません。

プロパティ種類必須説明
filesRenderedFile[]はいゲストが出力した出力ファイルで、出力順に並びます。それぞれがディスク上のパスを示し、ホストがそのまま書き込むシリアライズ済みバイト列を保持します。
derived_keysstring[] のマップいいえこのノードのレンダリング中にゲストが導出した名前で、導出先のキー空間をキーとし、各空間はその名前を導出順に保持します。出力がリソースを参照する際の名前を導出するゲストは、その名前をホストがそのまま書き込むファイルのバイト列の中に入れており、ホストからは見えません。ここで宣言することで、ゲストは 2 つの導出が同じ名前にならなかったことの確認をホストに依頼します。ホストは宣言された 1 つの空間内で宣言された名前の等価性を比較するだけで、それ以外は何もしません。名前を解析せず、空間や名前が何を意味するかを知らず、自ら名前を導出することもありません。同じアセンブル済み出力に寄与する 2 つの寄与元が同じ空間で同じ名前を宣言するとビルドは停止し、その停止では空間、名前、両方の寄与元が示されます。空間名もその中の名前もゲスト自身の語彙です。1 つのアセンブル済み出力より狭い、または広い範囲での一意性を求めるゲストは、宣言する空間名でその範囲を表現します。宣言順を保持するため、同一入力の実行間でペイロードはバイト単位で同一になります。確認を求める名前をゲストが導出しない場合は存在せず、そのゲストについて確認は作動しません。
render_factsRenderFact[]いいえこのノードについてゲストが出力した内容に関して報告するファクトで、ゲストが列挙した順に並びます。各ファクトは名前と値の組であり、どちらもゲスト自身の語彙です。provider がどのファクトを報告するか、各名前が何を意味し、そのエントリが何を保持するかは、このソケットではなくその provider の文書化された契約の一部です。すべてのファクトの値はエントリが 1 つの場合でもリストです。ホストはそれ以外の値を持つファクトを拒否し、provider とファクトを示してビルドを停止します。これがホストが値について知る唯一のことです。ホストはファクトを名前でキー付けし、各リストをそれを読むテンプレートに渡します。同じノードの複数のレンダリングが同じ名前で報告したリストは、それらのレンダリングが実行された順に連結します。名前やエントリが何を意味するかを知ることはなく、自らファクトを導出することもありません。そのため provider は、書き込んだドキュメントのプロパティのように、自身のフォーマット知識でしか見えないものを、ホストがそのフォーマットを知ることなく報告できます。ファクトの報告によって書き込まれる内容が変わることはありません。ファクトが伴うかどうかにかかわらず、ホストが書き込むファイルはゲストが返したファイルです。ゲストはファクトを固定の順序で列挙するため、同一入力の実行間でペイロードはバイト単位で同一になります。ゲストが何も報告しない場合は存在せず、これは欠落ではなく完全な回答です。
omittedinteger[]いいえ入力の omits の各エントリが一致したレンダリング単位の数です。ゲストに渡されたエントリごとに同じ順序で 1 つのカウントがあり、それぞれは、他のエントリも一致したかどうかにかかわらず、そのエントリが一致した単位の数です。カウント 0 は完全な回答であり、そのエントリはゲストがレンダリングしたものに何も一致しなかったことを意味します。除外されたものについてソケットが返すのはこのカウントだけで、単位そのものはゲストが返したものから単に存在しなくなります。ゲストにエントリが渡されなかった場合は存在しません。
diagnosticsDiagnostic[]いいえレンダリング中にゲストが発行した診断です。各要素は共有の Wasm プラグイン診断の形です。
errorstringいいえゲストは実行されたものの操作を完了できなかった場合に設定される失敗メッセージです。成功時には存在しません。出力に含まれる診断とは別のものです。診断は結果を生成した実行中に見つかった問題を報告し、error は操作自体が完了しなかったことを報告します。ホストは error が存在する場合、プラグイン呼び出しの失敗として扱います。
condition_codestringいいえ失敗が示す条件の、記述的で機械的に照合可能な識別子です。これはその条件が登録されているコードであり、コンパイラが自身の停止条件を登録するのと同じ開いた集合に属し、応答エンベロープの hostfunc_error_code が取る閉じたホスト関数エラーコードカタログのメンバーではありません。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。停止するゲストは、メッセージが示す条件の識別子をここに報告します。これにより利用側はメッセージを読んで識別子を復元する代わりに、これに基づいて分岐できます。ホストはこの識別子をコンパイラが宣言する条件に対して解決し、解決した条件自身の識別子を構造化された診断に公開するため、読み手に届くコードは必ず解決できます。該当する条件のない識別子や、番号付けで廃止された識別子はビルドを停止します。示すべき正確な条件がないゲストは、代わりにコンパイラがその目的で宣言している汎用のプラグイン失敗条件のいずれかを使い、詳細は自身のメッセージに含めます。この識別子と condition_short_code は、1 つの条件を 2 つの形で示すため、一緒に報告されます。一方だけを設定したゲストはホストが解決できない条件を示したことになり、その場合ホストは代わりに自身の汎用プラグイン失敗条件を報告し、メッセージは引き続き失敗の全容を伝えます。
condition_short_codestringいいえ同じ条件のコンパクトな識別子で、文字 E と 4 桁の数字からなり、読み手が引用し、検索し、報告に貼り付ける形です。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの失敗について出力する診断の角括弧付きの先頭にこれを表示するため、ゲストが発行する条件もコンパイラが発行する条件とまったく同じように引用できます。ホストはこの値をそのまま信用して運ぶのではなく、コンパイラが宣言する条件に対して解決します。該当する条件のない値、番号付けで廃止された値、または登録にない綴りはビルドを停止し、問題の値を引用します。その際もゲスト自身のメッセージは報告されます。condition_code と一緒に報告されます。理由はそちらに記載したとおりです。

追加のプロパティは許可されません。

ValidateNodeOutput

Provider ゲストが省略可能な validate_node_input エクスポートから返すペイロードです。ノードの解決済み入力に対する構造チェックで発生した診断を含みます。このエクスポートは render_node が受け取るのと同じ RenderNodeInput プロジェクションを消費し、ファイルを出力しません。診断を報告するだけです。halt 重大度の診断は、ノードとプロバイダーを示してビルドを明示的に停止します。warn または info 重大度の診断は、レンダリング出力を変えずにビルド結果に表示されます。診断リストが空であれば、入力は構造チェックに合格したことを意味します。

プロパティ種類必須説明
diagnosticsDiagnostic[]いいえゲストがノードの入力を検証する間に発生させた診断です。各要素は Wasm プラグイン共通の診断形式です。入力が構造チェックに合格した場合は空です。
errorstringいいえゲストは実行されたものの操作を完了できなかった場合に設定される失敗メッセージです。成功時には存在しません。出力に含まれる診断とは別のものです。診断は結果を生成した実行中に見つかった問題を報告し、error は操作自体が完了しなかったことを報告します。ホストは error が存在する場合、プラグイン呼び出しの失敗として扱います。
condition_codestringいいえ失敗が示す条件の、記述的で機械的に照合可能な識別子です。これはその条件が登録されているコードであり、コンパイラが自身の停止条件を登録するのと同じ開いた集合に属し、応答エンベロープの hostfunc_error_code が取る閉じたホスト関数エラーコードカタログのメンバーではありません。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。停止するゲストは、メッセージが示す条件の識別子をここに報告します。これにより利用側はメッセージを読んで識別子を復元する代わりに、これに基づいて分岐できます。ホストはこの識別子をコンパイラが宣言する条件に対して解決し、解決した条件自身の識別子を構造化された診断に公開するため、読み手に届くコードは必ず解決できます。該当する条件のない識別子や、番号付けで廃止された識別子はビルドを停止します。示すべき正確な条件がないゲストは、代わりにコンパイラがその目的で宣言している汎用のプラグイン失敗条件のいずれかを使い、詳細は自身のメッセージに含めます。この識別子と condition_short_code は、1 つの条件を 2 つの形で示すため、一緒に報告されます。一方だけを設定したゲストはホストが解決できない条件を示したことになり、その場合ホストは代わりに自身の汎用プラグイン失敗条件を報告し、メッセージは引き続き失敗の全容を伝えます。
condition_short_codestringいいえ同じ条件のコンパクトな識別子で、文字 E と 4 桁の数字からなり、読み手が引用し、検索し、報告に貼り付ける形です。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの失敗について出力する診断の角括弧付きの先頭にこれを表示するため、ゲストが発行する条件もコンパイラが発行する条件とまったく同じように引用できます。ホストはこの値をそのまま信用して運ぶのではなく、コンパイラが宣言する条件に対して解決します。該当する条件のない値、番号付けで廃止された値、または登録にない綴りはビルドを停止し、問題の値を引用します。その際もゲスト自身のメッセージは報告されます。condition_code と一緒に報告されます。理由はそちらに記載したとおりです。

追加のプロパティは許可されません。

RenderedFile

Provider ゲストが出力した 1 つの出力ファイルです。ノードの出力ルートからの相対的なディスク上のパスと、ゲストが生成したとおりのシリアライズ済みバイト列を持ちます。ホストはこれらのバイト列をそのまま書き込み、シリアライザを実行しないため、ディスク上の出力はゲストが出力したものとバイト単位で同一になります。

プロパティ種類必須説明
pathstringはいノードの出力ルートからの出力ファイルの相対パスです(例: Chart.yaml や templates/deployment.yaml)。
contentstringはいゲストが生成したとおりのファイルのシリアライズ済みバイト列です。ホストはこれらのバイト列をそのまま書き込み、シリアライザを実行しないため、出力はゲストが出力したものとバイト単位で同一になります。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、文字列型であれば base64 エンコードされた形で保持し、ゲストがデコードして元に戻します。生成されたエンコーダが、フィールドとワイヤ上でバイト列を運ぶ形式との間を変換します。
formatstringいいえ出力したファイルがどの形式でレンダリングされたかをゲストが宣言するもので、ホストはこれによりファイルを対応するパーサーに振り分けられます。ゲストが形式を宣言しない場合は存在せず、その場合ホストはファイル拡張子から形式を推定します。

追加のプロパティは許可されません。

RenderFact

Provider ゲストがノードについて出力した内容に関して報告する 1 つのファクトです。名前とエントリのリストから成り、どちらもプロバイダーが定義し文書化します。ホストはゲストが書いたとおりにファクトを運び、値がリストでないものを拒否し、それ以外にはどちらについても何も知りません。

プロパティ種類必須説明
namestringはいファクトの名前です。プロバイダー自身が文書化した語彙に属します。
valuearrayはいファクトの値です。JSON 配列で、エントリが 1 つでも 0 個でも常にリストであり、各エントリはプロバイダーがその名前について文書化した形の任意の JSON 値です。リストであることで、1 つの名前をノードの複数のレンダリングから報告できます。ホストはそれらのリストを 1 つに結合します。値はゲストが書いた JSON ドキュメントとしてバイト単位でそのまま運ばれるため、リストのエントリの順序と各オブジェクトのキーの順序はゲスト自身のものです。

追加のプロパティは許可されません。

OmitEntry

Provider ゲストがノードの出力から除外するレンダリング単位を指定する 1 つのエントリです。各フィールドはすでにプレーンな文字列に解決されており、いずれかが機密と宣言された値から生成された場合はマークされます。ソケットはこれらに意味を付与しません。kind、name、namespace、subchart が各プロバイダーの形式で何を選択するかは各プロバイダーが文書化し、照合もプロバイダー自身が行います。

プロパティ種類必須説明
kindstringはいエントリが指定するレンダリング単位の種類です。プロバイダー自身の語彙で表されます。
namestringはいエントリが指定するレンダリング単位の名前です。プロバイダー自身の語彙で表されます。
namespacestringいいえ指定された単位が属する名前空間です。単位を名前空間に配置する形式を持つプロバイダー向けです。作成者が何も書かなかった場合は存在しません。名前空間のないエントリが何に一致するかは、プロバイダー自身の契約によります。
subchartstringいいえ指定された単位の由来となるネストされたソースで、チャートがそのサブチャートから組み立てられるように、ソースがネストされたソースから組み立てられる provider のためのものです。作成者が記述しない場合は存在しません。subchart を持たないエントリが何に一致するか、またネストされたソースを持たない provider がそれを指定するエントリをどう扱うかは、その provider 自身の契約です。
sensitive真偽値いいえエントリの kind、name、namespace、subchart のいずれかを生成したテンプレートが、作成者が機密と宣言した値、またはそれに由来する値を読み取る場合に true です。これは解決済みの文字列からではなく、宣言に照らした各フィールドのテンプレートから判断されます。宣言された値に到達する参照、データ全体を引き渡すテンプレート、解析できないテンプレートのいずれも該当します。このマークはフィールドを特定せずエントリ全体を対象とするため、ゲストはマークされたエントリを、入力上の他のマークされた値と同様に扱います。つまり、エントリの目的どおりフィールドによって照合・カウントは行いつつ、そのどのフィールドも人が読むテキスト(拒否、警告、ログ行)には含めません。どのフィールドのテンプレートもそのような値を読み取らない場合は存在しません。存在しないことは、どのフィールドも機密でないことを意味しません。

追加のプロパティは許可されません。

SourceFile

事前にパッケージ化されたソースプロジェクションの 1 つのファイルです。ソースルートからの相対パスと、コンパイル時にホストがローカルソースから読み取ったとおりの生のバイト列を持ちます。

プロパティ種類必須説明
pathstringはいソースルートからのファイルの相対パスです(例: Chart.yaml や templates/deployment.yaml)。
contentstringはいホストがローカルソースから読み取ったとおりのファイルの生のバイト列です。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、文字列型であれば base64 エンコードされた形で保持し、ゲストがデコードして元に戻します。生成されたエンコーダが、フィールドとワイヤ上でバイト列を運ぶ形式との間を変換します。

追加のプロパティは許可されません。

SourceProjection

パックされたソースコンテンツ(例:Helm チャートのファイル。それぞれソースルートからの相対パスで名前が付けられ、走査順に並びます)です。ホストが pack-source リクエストに応じて読み取り、ゲストに返すもので、ゲストはこれを使って選択されたソースをメモリ上で再構築し、ファイルシステムには一切触れません。pack-source ホスト関数の成功時のペイロードです。

プロパティ種類必須説明
filesSourceFile[]はいソースファイルです。それぞれソースルートからの相対パスで名前が付けられ、ホストの決定的な走査順に並びます。

追加のプロパティは許可されません。

SourceEntry

ソース一覧の 1 つのエントリです。ソースルートからの相対パスと、それがディレクトリかどうかを持ちます。ホストは名前のみを列挙し、内容は読み取らないため、エントリはバイトを持ちません。

プロパティ種類必須説明
pathstringはいソースルートからのエントリの相対パスで、スラッシュ区切りです(例:Chart.yaml や templates/deployment.yaml)。
is_dir真偽値はいエントリがディレクトリかどうかです。一覧の中からチャートルートや単一のソースファイルを解決するゲストは、これを読み取ることで、ファイルシステムに触れずにディレクトリとファイルを区別します。

追加のプロパティは許可されません。

SourceListing

取得したソースの汎用的な列挙で、ホストがソースを扱うプロバイダーのゲストに渡すものです。ソースルート、そのルートがディレクトリかどうか、およびその下にあるルート相対のソート済みエントリを持ちます。ホストはドメイン知識を持たずに取得したソースを走査し、ファイルの内容は読み取りません。名前のみを列挙します。ゲストは一覧に対して独自の解決ロジックを適用し(チャートルートの特定、単一の compose ドキュメントの選択、モジュールツリーのベンダリングなど)、選んだ選択範囲のパックを pack-source ホスト関数を通じてホストに依頼します。エントリはパスでソートされるため、同一の入力に対する実行間で一覧はバイト単位で同一になります。

プロパティ種類必須説明
rootstringはいホストが列挙した、取得済みソースの場所です。ゲストはソースを解決できない場合にこれを自身の診断に含めるため、解決による停止では作成者が指定したソースが示されます。
root_is_dir真偽値いいえ取得したソースルートがディレクトリかどうかです。単一ファイルのソース(単独の compose ドキュメント、単一のモジュールファイル、アーカイブ)では false となり、その場合 entries は空で、ゲストはルート自体をパックします。
entriesSourceEntry[]はいディレクトリのソースルート配下にあるルート相対のエントリで、パスでソートされています。単一ファイルのソースルートでは空です。

追加のプロパティは許可されません。

SourcePackRequest

ゲストが pack-source ホスト関数を通じて、取得済みソースからのパックをホストに依頼する選択範囲です。op は選択範囲の形を示し、path はソースルートからの相対位置でそれを示します。ホストはソースルート配下でパスを解決し、ルートより上へのエスケープはすべて拒否して、パックしたバイトを SourceProjection として返します。

プロパティ種類必須説明
opstring (enum)はい選択範囲の形です。file は path にある単一のファイルをパックし、dir は path にあるディレクトリの直下のファイルをパックし、tree は path をルートとするサブツリー全体を再帰的に、ホストの決定的な走査順でパックします。許可される値:"file"、"dir"、"tree"
pathstringはいソースルートからの選択範囲の相対位置で、スラッシュ区切りです。空文字列(または「.」)はソースルート自体を示すため、単一ファイルのソースは空のパスでパックされます。

追加のプロパティは許可されません。

SourcePackResponse

pack-source ホスト関数の応答です。成功時はパックされたソース、失敗時はエラーメッセージを持ちます。2 つのフィールドのうち厳密に 1 つだけが設定されます。失敗はトラップではなくインバンドで伝えられるため、ゲストはサンドボックスによる拒否や読み取りの失敗を、決定的なレンダリングの失敗として自身の診断に含めます。

プロパティ種類必須説明
source_projectionSourceProjectionいいえ成功時のパックされたソースです。失敗時には存在しません。
errorstringいいえ失敗時の失敗メッセージで、選択範囲と理由を示します。成功時には存在しません。
hostfunc_error_codestring (enum)いいえ失敗時の機械照合可能な失敗識別子で、閉じたホスト関数エラーコードカタログから取られ、人間向けのエラーメッセージと並べて設定されます。成功時には存在しません。このカタログはホスト関数が失敗し得る方法を名付けた固定の語彙であり、コンパイラが登録する停止条件とは別の語彙です。停止条件の識別子は、ゲストがソケット出力で condition_code および condition_short_code として報告します。キー名によって値がどちらに属するかがわかるため、2 つが 1 つの集合として読まれることはありません。ゲストはメッセージをパースせずにこのコードで分岐し、コードが存在しない場合 (古いホスト) や認識できない場合 (新しいホスト) はメッセージにフォールバックして対処します。許可される値: "fetch_request_unreadable"、"fetch_input_unavailable"、"fetch_failed"、"request_unreadable"、"request_undecodable"、"source_root_unavailable"、"source_read_failed"、"unknown_selection_op"、"source_escape"、"producer_consumption_reentry"、"no_source_parser"、"no_parser_for_format"、"parse_failed"

追加のプロパティは許可されません。

SourceFileRequest

ゲストが read-source-file ホスト関数を通じてホストに依頼する、単一ファイルの内容の読み取りです。何をパックするかを選ぶ前にファイルの内容を調べる必要がある解決ロジックを持つゲスト向けです。ホストはソースルート配下でパスを解決し、ルートより上へのエスケープはすべて拒否して、ファイルのバイトを返します。

プロパティ種類必須説明
pathstringはいソースルートからのファイルの相対位置で、スラッシュ区切りです。

追加のプロパティは許可されません。

SourceFileResponse

read-source-file ホスト関数の応答です。成功時はファイルのバイト、失敗時はエラーメッセージを持ちます。2 つのフィールドのうち厳密に 1 つだけが設定されます。失敗はトラップではなくインバンドで伝えられるため、ゲストはサンドボックスによる拒否や読み取りの失敗を、決定的なレンダリングの失敗として自身の診断に含めます。

プロパティ種類必須説明
contentstringいいえ成功時のファイルの生のバイトです。失敗時には存在しません。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、文字列であれば base64 エンコードされ、ゲストがデコードして復元します。生成されたエンコーダーが、フィールドとワイヤ上でバイトを運ぶ形式との間を変換します。
errorstringいいえ失敗時の失敗メッセージで、ファイルと理由を示します。成功時には存在しません。
hostfunc_error_codestring (enum)いいえ失敗時の機械照合可能な失敗識別子で、閉じたホスト関数エラーコードカタログから取られ、人間向けのエラーメッセージと並べて設定されます。成功時には存在しません。このカタログはホスト関数が失敗し得る方法を名付けた固定の語彙であり、コンパイラが登録する停止条件とは別の語彙です。停止条件の識別子は、ゲストがソケット出力で condition_code および condition_short_code として報告します。キー名によって値がどちらに属するかがわかるため、2 つが 1 つの集合として読まれることはありません。ゲストはメッセージをパースせずにこのコードで分岐し、コードが存在しない場合 (古いホスト) や認識できない場合 (新しいホスト) はメッセージにフォールバックして対処します。許可される値: "fetch_request_unreadable"、"fetch_input_unavailable"、"fetch_failed"、"request_unreadable"、"request_undecodable"、"source_root_unavailable"、"source_read_failed"、"unknown_selection_op"、"source_escape"、"producer_consumption_reentry"、"no_source_parser"、"no_parser_for_format"、"parse_failed"

追加のプロパティは許可されません。

FetchExternalInputResponse

fetch-external-input ホスト関数の応答です。成功時は取得したコンテンツ、失敗時はエラーメッセージとそのコードを持ちます。どちらの失敗フィールドも持たない応答は成功であるため、長さゼロのペイロードはすべてのフィールドが存在しない応答になります。失敗はトラップではなくインバンドで伝えられるため、ゲストは解決できない URL や取得の失敗を、決定的なレンダリング失敗として自身の診断に引き継ぎます。リクエストは構造化されたペイロードではなく単なる URL 文字列であるため、宣言された形を持つのは応答だけです。

プロパティ種類必須説明
contentstringいいえ成功時に取得したペイロードの生のバイト列です。失敗時、およびペイロードが空の場合は存在しません。バイト列はワイヤ上をバイト文字列として渡り、base64 テキストとして渡ることはありません。Go キットはこれをバイトスライスとして保持し、Rust と TypeScript のキットは base64 文字列として保持して、各キットの fetch ラッパーがそれをデコードします。そのため、どのラッパーもペイロードの生のバイト列を返します。
errorstringいいえ失敗時の失敗メッセージで、URL と対処方法を示します。成功時は存在しません。
hostfunc_error_codestring (enum)いいえ失敗時の機械照合可能な失敗識別子で、閉じたホスト関数エラーコードカタログから取られ、人間向けのエラーメッセージと並べて設定されます。成功時には存在しません。このカタログはホスト関数が失敗し得る方法を名付けた固定の語彙であり、コンパイラが登録する停止条件とは別の語彙です。停止条件の識別子は、ゲストがソケット出力で condition_code および condition_short_code として報告します。キー名によって値がどちらに属するかがわかるため、2 つが 1 つの集合として読まれることはありません。ゲストはメッセージをパースせずにこのコードで分岐し、コードが存在しない場合 (古いホスト) や認識できない場合 (新しいホスト) はメッセージにフォールバックして対処します。許可される値: "fetch_request_unreadable"、"fetch_input_unavailable"、"fetch_failed"、"request_unreadable"、"request_undecodable"、"source_root_unavailable"、"source_read_failed"、"unknown_selection_op"、"source_escape"、"producer_consumption_reentry"、"no_source_parser"、"no_parser_for_format"、"parse_failed"

追加のプロパティは許可されません。

WorkloadProjection

ホストが Provider ゲストに渡す事前評価済みのワークロードコンテンツで、ゲストはこれからプロバイダーネイティブなマニフェストをメモリ上で合成します。バインドされた Recipe がチャートソースではなくワークロードを宣言している場合に存在します。決定性はゲストの責任です。同一の入力からは同一のバイト列を生成しなければなりません。

プロパティ種類必須説明
workloadobjectはいゲストが合成する、ホストで評価済みかつ検証後の Workload です。ソケットスキーマが Workload エンティティの契約を再バインドしないよう、このスキーマ層では不透明です。
sensitive_workload真偽値いいえworkload を生成したテンプレートが、作成者が機密と宣言した値、またはそれにさかのぼる値を読み取る場合に true になります。これはどのフィールドの内容からでもなく、宣言に照らしたテンプレート自身の参照から判定されます。宣言された値に到達する参照、データ全体を引き渡すテンプレート、解析できないテンプレートは、いずれも該当とみなされます。レンダリングされたワークロードのフィールドは、テンプレートが読み取ったデータへのリンクを持たないため、これはドキュメント全体を対象とします。人が読むテキスト(拒否や警告)を組み立てるゲストは、これが true の場合、ワークロードが持つすべての値をそのテキストから除外します。一方、ドキュメントの形(キーと値の位置)は読み取り可能なままです。ノード射影の sensitive_rendered_keys が示すアタッチメントのエントリは、これが設定されているかどうかにかかわらず、そちらで示されます。テンプレートがそのような値を読み取らない場合は存在しません。存在しないことは、機密のフィールドがないことを示すものではありません。
attachment_providesobjectいいえノード上のすべてのアタッチメントで、解決済みの provides に射影され、ワークロードのアタッチメント参照が持つアタッチメントインスタンス名をキーとします。ノードがアタッチメントを持たない場合は存在しません。ホストは文字列を解釈せずにそのままコピーするため、ゲストは、アタッチメントが生成したリソースへの参照を解決するのに必要な、そのアタッチメントの provides のエントリを読み取ります。アタッチメントが機密と宣言された素材を扱うかどうかはここでは繰り返されません。それはノード射影の対応する feature エントリに含まれ、ゲストは同じインスタンス名でそれを読み取ります。

追加のプロパティは許可されません。

ArtifactsProjection

ホストが Provider ゲストに渡し、ノードの出力に配置させる事前評価済みのアーティファクトセットです。ホストはすでに各エントリのソース(インラインコンテンツ、またはホストが読み取ったインポートファイル)を解決し、ゲストが宣言したアーティファクトテンプレートの区切り文字ペアを使ってレンダリングコンテキストに対し Go テンプレートとして評価し、ビルド来歴のラベルとアノテーションのキーセットを計算しています。形式の決定、来歴の配置、ディスク上のパス、最終的なバイト列はゲストが担います。エントリは作成者の順序を保持するため、同一の入力に対する実行間で配置された出力はバイト単位で同一になります。

プロパティ種類必須説明
entriesArtifactProjectionEntry[]はいゲストが配置するアーティファクトエントリで、作成者の順序に従います。

追加のプロパティは許可されません。

ArtifactProjectionEntry

ホストが Provider ゲストに渡して配置させる、事前評価済みのアーティファクトエントリ 1 つです。ホストが解決した出力名、その由来、テンプレート評価済みのコンテンツのバイト列、そのバイト列の元のテンプレートが機密と宣言された値を読み取るかどうか、そしてホストがノードに対して計算したビルド来歴のラベルとアノテーションのキーセットを持ちます。来歴の配置方法(マニフェストのメタデータへの埋め込み、コメントとしての先頭への追加、付随ファイルの出力)とファイルの配置先はゲストが決定します。

プロパティ種類必須説明
namestringはいホストが解決したエントリの出力名です。作成者が宣言したマップキーで、ライブラリバンドルが提供するファイルはそのキーの下にネストされます。ゲストはエントリをこの名前、またはそこから導出したプロバイダー固有のサブパスの下に配置します。
originstring (enum)はいエントリがインラインコンテンツとして作成されたか、インポートファイルとして作成されたかを示します。一方の形式を拒否するゲスト(アンブレラチャートのプロバイダーはインラインコンテンツを拒否します)は、これを読み取って明示的に停止します。許可される値: "inline", "import"
contentstringはいホストがエントリのインラインコンテンツまたはインポートファイルから生成した、テンプレート評価済みのコンテンツのバイト列で、ゲストが宣言したアーティファクトテンプレートの区切り文字ペアを使ってレンダリングコンテキストに対して評価されたものです。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、文字列であれば base64 エンコードされ、ゲストがデコードして復元します。生成されたエンコーダーが、フィールドとワイヤ上でバイト列を運ぶ形式との間を変換します。
sensitive_content真偽値いいえこのエントリのコンテンツの評価元となったテンプレートが、作成者が機密と宣言した値、またはそれにさかのぼる値を読み取る場合に true になります。これはコンテンツ自体からではなく、コンテンツの評価に使われた区切り文字ペアを用いて、宣言に照らしたテンプレート自身の参照から判定されます。宣言された値に到達する参照、データ全体を引き渡すテンプレート、解析できないテンプレートは、いずれも該当とみなされます。コンテンツはそのテンプレートの出力であり、その中のどの部分も元のデータまでさかのぼれません。そのため、人が読むテキスト(拒否や警告)を組み立てるゲストは、これが true の場合、コンテンツのどの部分もそのテキストから除外します。コンテンツに関するパーサー自身のメッセージも含みます。これはエントリごとに設定されるため、あるエントリのテンプレートがそのような値を読み取っても、別のエントリについては何も示しません。テンプレートがそのような値を読み取らない場合は存在しません。存在しないことは、コンテンツが機密でないことを示すものではありません。
labelsobjectいいえホストがノードに対して計算した、Kubernetes ラベルとして安全なビルド来歴のキーセットで、ラベル名をキーとします。マニフェストの metadata.labels に来歴を付与するゲストはこれらを埋め込み、出力が Kubernetes YAML でないゲストはこれらを無視します。
annotationsobjectいいえホストがノードに対して計算したビルド来歴のキーセットのうち、Kubernetes ラベルでは表現できないもので、アノテーション名をキーとします。マニフェストの metadata.annotations に来歴を付与するゲストはこれらを埋め込み、出力が Kubernetes YAML でないゲストはこれらを無視します。

追加のプロパティは許可されません。

AssembleBoundaryInput

Provider ゲストが assemble_boundary エクスポートで受け取るペイロードです。このエクスポートは、1 つのディスパッチグループにおけるノードごとのレンダー出力を、単一の組み立て済みアーティファクト(アンブレラチャート、マージされた compose ファイル)にマージします。ペイロードには、マージ済みのアノテーションとデプロイウェーブを伴うノードごとのレンダー出力、組み立て済みアーティファクトの配置先となるディスパッチグループの出力パス、サービスごとの依存関係を推論するためのグラフの uses エッジ、およびレンダー時のコンテキストが含まれます。すべてのプロバイダーがこのエクスポートを宣言するわけではありません。ノードごとのフラットな出力のみを生成するプロバイダーは、これを省略します。

プロパティ種類必須説明
rendered_nodesRenderedNode[]はいこのディスパッチグループに供給されたノードごとのレンダー出力です(ノード順)。
contextobjectはいレンダー時のコンテキストで、その JSON ドキュメントのバイト列として運ばれます。このエクスポートでは、ホストは yaml_indent(組み立て済みファイルをシリアライズする際のレンダー全体のインデント幅)のみを設定します。コンテキストの他のメンバーはここでは何も運びません。組み立てでは、アノテーションや境界が異なるコントリビュータがマージされるためであり、各コントリビュータのアノテーションは代わりにその rendered_nodes エントリで届きます。
boundary_pathstringはい組み立て済みアーティファクトの配置先となる、評価済みのディスパッチグループ出力パスです。バウンダリアセンブラーはこれをバウンダリレベルのフォールバック識別子として使用します(例: namespace アノテーションを持たないノードの compose ネットワーク名)。
edgesRenderEdge[]いいえグラフの有向 uses エッジです。これにより、バウンダリアセンブラーはディスパッチグループのコントリビューター間で、サービスごとの順序や依存関係を推論できます(例: compose の depends_on)。
sub_chartsSubChart[]いいえアンブレラチャートのアセンブラーが、コントリビューターごとに 1 つの依存関係と 1 つの values スコープを生成するために消費する、サブチャートごとのペイロードです。各エントリには、サブチャートの識別子、インスタンスごとの values、およびチャートソースからベンダリングされたサブチャートの場合はそのチャートの Chart.yaml ファイルの元のバイト列が含まれます。アンブレラチャートの組み立て時に存在します。フラットにマージするアセンブラーはこれを省略します。
chart_namestringいいえディスパッチグループに名前が指定されている場合に、アンブレラチャートのアセンブラーが組み立て済みチャートに使用するチャート名です。アセンブラーがディスパッチグループの出力パスから名前を導出する場合は空です。
aggregate_namestringいいえアンブレラチャートのアセンブラーが組み立て済みチャートの導出名に組み込む、トップレベルの aggregate 名です。aggregate の識別子が名前に寄与しない場合は空です。

追加のプロパティは許可されません。

RenderedNode

assemble_boundary の入力に現れる、1 つのノードのレンダリング出力です。ノード ID、その型、マージされたアノテーション、sync wave、コンパイラが供給する立場にある場合にコンパイラがそのノードに対して解決した値と、それらを values マッピングが生成したかどうか、そして render_node エクスポートがそのノードに対して生成したファイルを含みます。これらはレンダリング出力の形で運ばれ、その形のうちファイル以外のメンバーはすべて存在しません。

プロパティ種類必須説明
idstringはいトポロジーグラフ内でのノードの絶対 ID です。グラフのノードではないコントリビューター(コンポーネントではなく境界にアタッチされた Feature)は、代わりにここにコンパイラ自身のディスパッチ ID を持ちます。これは、そのコントリビューターに対する render_node 呼び出しが持っていたものと同じ ID です。この ID はコントリビューター同士を区別するものであり、どのターゲットも受け付ける名前ではありません。そのようなコントリビューターがアセンブルされた成果物内で名前を導出する元は、別の項目 derived_name_basis です。
typestringはいノードのコンポーネント種別ラベルです。ノードごとのレンダリング射影ではこれを渡しませんが、この形では運ばれます。動作を切り替えるものではなく不透明なメタデータです。アセンブラがマージするノードをグループ化しラベル付けできるようにするためにあり、ゲストがこれに基づいて分岐するためのものではありません。
derived_name_basisstringいいえこのコントリビューターがアセンブルされた成果物内で自身の名前を導出する元となる ID です。たとえば、アセンブラがコントリビューターの公開エントリの 1 つに対して発行する論理 ID、マージされたドキュメント内のコントリビューターごとのスコープ、独自の位置に配置される子ユニットの名前です。空の場合は ID がそのまま使われることを意味し、通常のコンポーネントではこの値になります。ID がターゲットの名前のアルファベットで受け付けられないディスパッチ ID であるコントリビューターは、これを明示的に持ちます。これにより、アセンブルされた成果物はターゲットが受け付ける名前でその内容を参照し、作成者が区別できる 2 つのコントリビューターが 1 つの名前に重なることはありません。コントリビューターの内容がアセンブラのマージするドキュメントに取り込まれる場合、これはそのコントリビューターに対する render_node 呼び出しが受け取ったものと同じ項目であり、両方に持たせることで 2 つの答えが一致します。コントリビューターがレンダリング中に宣言した名前と、マージされたドキュメントがその内容を参照する名前は、たまたま一致する 2 つの ID からではなく、1 つの ID から導出されます。コントリビューターが代わりに独自の位置に配置される場合、これはそのコントリビューターのために組み立てられた ID です。コンポーネントにアタッチされた Feature の場合は、そのレンダーが対象としたホストコンポーネントの ID ではなく、Feature 自身の ID です。そのため、ホストの隣に配置される子ユニットはホストとは別にアドレス指定されます。
output_directorystringいいえこのコントリビューターのレンダリング済みファイルが置かれるディレクトリで、アセンブルされた成果物自身の位置からの相対パスであり、末尾の区切り文字を含みません。アセンブルされた成果物内からコントリビューターのファイルを指定する必要があるゲスト(module ブロックの source パスや include ディレクティブなど)は、コントリビューターの ID から位置を組み立てるのではなくここから読み取ります。これにより、アセンブルされた成果物が指すパスはファイルが書き込まれたパスと一致します。両者は常に 1 階層だけ離れているとは限りません。ホストが別のコントリビューターの位置の内部に配置したコントリビューターは、アセンブリの直下に配置されたコントリビューターよりも深い位置にあります。アセンブルする Provider が各コントリビューターをそれぞれ固有の位置に配置する場合にのみ存在します。コントリビューターを 1 つのドキュメントにまとめる Provider はコントリビューターごとのディレクトリを配置せず、これを受け取りません。
renderedRenderNodeOutputはいProvider ゲストが render_node エクスポートから返すペイロードです。ゲストが出力した各出力ファイルのシリアライズ済みバイト列、ゲストが自身の各キー空間に導出した名前、出力内容についてゲストが報告するファクト、渡された各 omit エントリが一致したレンダリング単位の数、そしてレンダリング中にゲストが発行した診断を含みます。ゲストは各ファイルのシリアライズ済みバイト列を返し、ホストはそれをそのまま書き込み、シリアライザは実行しません。決定性はゲストの責任です。同一の入力は同一のバイト列を生成しなければなりません。
annotationsstring のマップいいえノードのマージされたアノテーションです。境界アセンブラがノードごとの配置を割り当てられるようにします(例: aggrega.ai/namespace アノテーションから導出される compose ネットワーク)。
sync_waveintegerいいえこのノードが含まれる境界から継承したデプロイウェーブです(デフォルトは 0、負の値も可)。境界アセンブラがマージするコントリビューターを互いに順序付けられるようにします。ディスパッチグループは複数の境界からコントリビューターをマージでき、それぞれが独自のウェーブを持つため、ウェーブはペイロード全体に対して一度ではなく、ここで各ノードとともに運ばれます。出力の形が順序を表現しないアセンブラはこれを無視します。
valuesobjectいいえコンパイラがこのノードに対して解決した値です。ソースからレンダリングされたノード、つまりそのファイルを生成した render_node 呼び出しが source_listing を持っていたノードに対してのみ存在します。これは、ファイルが別の場所から来ていて値をファイルに書き込めなかった唯一のケースであり、ファイルの外の位置が値を供給する必要があります。境界アセンブラは、存在する辞書をコントリビューター自身のファイルの横ではなく、アセンブルされた成果物そのものの中にそのコントリビューターの入力として配置します。アセンブルされた成果物がターゲットの評価する唯一の位置である場合、これがターゲットが読む入力と決して届かない入力との違いになります。workload_projection または artifacts_projection からレンダリングされたノードは、これらの値を生成したファイルに解決済みであるため、ここには何も持たず、このフィールドは存在しません。値を二重に供給すると、そのノード自身のファイルが宣言していない入力をアセンブルされた成果物に提示することになり、ターゲットはそれを拒否してもかまいません。キーは作成者の順序ではなくソートされた順序で届き、このソートによって同一の入力に対する実行間でペイロードがバイト単位で同一になります。他の順序が必要なゲストは自分で並べ替えます。出力の形がコントリビューターごとの入力を持たないアセンブラはこのフィールドを無視します。
values_mapped真偽値いいえこのノードが持つ値が、作成者が書いたとおりに引き渡されたノードの値ではなく、バインドされた Recipe または FeatureRecipe の valuesMapping(コンポーネントの Recipe、アタッチされた Feature の FeatureRecipe)の出力である場合に true です。このノードに対する render_node 呼び出しがノード射影に持っていたものと同じ印であり、ここでは記述対象の値の横に置かれます。valuesMapping が実行されなかった場合、および values が存在しない場合には存在しません。アセンブラがこれを読むかどうかはそのアセンブラ自身の契約です。render_node がマップされたノードの値をソースが宣言する入力にバインドするアセンブラは、そのバインドがどの名前を埋めたかをこれから知ることができます。一方、生成方法にかかわらずノードの値をその入力として配置するアセンブラはこれを読みません。これは値がどのように生成されたかを記録するものであり、キーの名前や値の内容から導出されることはありません。

追加のプロパティは許可されません。

RenderEdge

グラフの有向 uses エッジの 1 つで、その 2 つのノード ID で示されます。source は消費する側のノード、target は消費される側のノードです。このリストはグラフのすべての uses エッジを運ぶため、どちらの端もこのディスパッチグループ外のノードである場合があります。

プロパティ種類必須説明
sourcestringはい利用する側のノードの ID です。有向の uses エッジの始点です。
targetstringはい利用される側のノードの ID です。有向の uses エッジが指す終点です。

追加のプロパティは許可されません。

SubChart

アンブレラチャートに寄与する 1 つのサブチャートです。そのインスタンス ID、アンブレラが固定するバージョン、アンブレラがサブチャートのエイリアスの下にスコープするインスタンスごとの値、そしてチャートソースからベンダリングされたサブチャートの場合は、そのチャートの Chart.yaml ファイルの元のままのバイト列を含みます。アンブレラチャートのアセンブラは、これらの純粋なデータビューのみからアンブレラの依存関係と値ファイルを構築し、ファイルシステムには一切触れません。

プロパティ種類必須説明
instance_idstringはいディスパッチグループ内でのサブチャートのインスタンス ID です。アンブレラはサブチャートの依存関係エイリアスとその値をこの ID の下にスコープするため、1 つのソースチャートの複数のインスタンスが区別されたまま保たれます。
versionstringいいえアンブレラがサブチャートに対して固定するバージョンです。チャートソースからベンダリングされたサブチャートは、依存関係が正しく結び付くよう、代わりにそのチャートの Chart.yaml ファイルから依存関係の名前とバージョンを取得します。この値は、ベンダリングされたチャートを持たない生成型のサブチャートに適用されます。
valuesobjectいいえアンブレラの values.yaml ファイルにおいて、アンブレラがサブチャートのエイリアスの下にスコープするインスタンスごとの値です。キーは作成者の記述順ではなくソート順で届きます。このソートによって、同一の入力に対する実行間でペイロードがバイト単位で同一になります。他の順序を必要とするゲストは、自身でその順序を適用します。
chart_yamlstringいいえベンダリングされたチャートの Chart.yaml の元のままのバイト列で、コンパイル時にローカルソースから読み取られます。アンブレラはここからサブチャートの依存関係の名前とバージョンを取得します。ベンダリングされたチャートを持たない生成型のサブチャートでは空です。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、ゲストがデコードして復元する文字列であれば base64 エンコードされた形で保持し、生成されたエンコーダがフィールドとワイヤ上でバイトを運ぶ形式との間で変換します。

追加のプロパティは許可されません。

AssembleBoundaryOutput

Provider ゲストが assemble_boundary エクスポートから返すペイロードです。組み立てられた各ファイルのシリアライズ済みバイト列と、組み立て中にゲストが発生させた診断を含みます。組み立てられたグループのノードごとのファイルの配置場所はこの応答には含まれません。それは provider の静的なプロパティであり、describe() コントラクトで一度宣言され、どのノードのレンダリングよりも前に把握されています。ゲストは各ファイルのシリアライズ済みバイト列を返し、ホストはそれをそのまま書き込み、シリアライザは実行しません。決定性はゲストの責任です。同一の入力は同一のバイト列を生成しなければなりません。

プロパティ種類必須説明
filesRenderedFile[]はいゲストが出力した組み立て済みの出力ファイルで、出力順に並びます。それぞれがディスク上のパスを示し、ホストがそのまま書き込むシリアライズ済みバイト列を保持します。
diagnosticsDiagnostic[]いいえ組み立て中にゲストが発生させた診断です。各要素は共通の Wasm プラグイン診断の形式です。
errorstringいいえゲストは実行されたものの操作を完了できなかった場合に設定される失敗メッセージです。成功時には存在しません。出力に含まれる診断とは別のものです。診断は結果を生成した実行中に見つかった問題を報告し、error は操作自体が完了しなかったことを報告します。ホストは error が存在する場合、プラグイン呼び出しの失敗として扱います。
condition_codestringいいえ失敗が示す条件の、記述的で機械的に照合可能な識別子です。これはその条件が登録されているコードであり、コンパイラが自身の停止条件を登録するのと同じ開いた集合に属し、応答エンベロープの hostfunc_error_code が取る閉じたホスト関数エラーコードカタログのメンバーではありません。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。停止するゲストは、メッセージが示す条件の識別子をここに報告します。これにより利用側はメッセージを読んで識別子を復元する代わりに、これに基づいて分岐できます。ホストはこの識別子をコンパイラが宣言する条件に対して解決し、解決した条件自身の識別子を構造化された診断に公開するため、読み手に届くコードは必ず解決できます。該当する条件のない識別子や、番号付けで廃止された識別子はビルドを停止します。示すべき正確な条件がないゲストは、代わりにコンパイラがその目的で宣言している汎用のプラグイン失敗条件のいずれかを使い、詳細は自身のメッセージに含めます。この識別子と condition_short_code は、1 つの条件を 2 つの形で示すため、一緒に報告されます。一方だけを設定したゲストはホストが解決できない条件を示したことになり、その場合ホストは代わりに自身の汎用プラグイン失敗条件を報告し、メッセージは引き続き失敗の全容を伝えます。
condition_short_codestringいいえ同じ条件のコンパクトな識別子で、文字 E と 4 桁の数字からなり、読み手が引用し、検索し、報告に貼り付ける形です。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの失敗について出力する診断の角括弧付きの先頭にこれを表示するため、ゲストが発行する条件もコンパイラが発行する条件とまったく同じように引用できます。ホストはこの値をそのまま信用して運ぶのではなく、コンパイラが宣言する条件に対して解決します。該当する条件のない値、番号付けで廃止された値、または登録にない綴りはビルドを停止し、問題の値を引用します。その際もゲスト自身のメッセージは報告されます。condition_code と一緒に報告されます。理由はそちらに記載したとおりです。

追加のプロパティは許可されません。

CarveInput

Provider ゲストがオプションの carve エクスポートで受け取るペイロードです。FeatureRecipe のステップがその一部を編集する前に、パイプラインがアドレス指定可能な単位に切り分ける、名前付きの 1 つの出力ファイルです。標準の YAML コーデックでは出力形式を直接切り分けられない provider(たとえばテンプレート化されたチャート)は、carve と reassemble を公開し、出力形式に関する自身の知識をゲスト内に置きます。これらのエクスポートを省略した provider は、ホストの標準 YAML コーデックを借用します。

プロパティ種類必須説明
namestringはい出力ファイルの名前です。コーデックが名前にスコープされた切り分けルールを適用できるようにします。
bodystringはいアドレス指定可能な単位に切り分ける出力ファイルのバイト列です。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、ゲストがデコードして復元する文字列であれば base64 エンコードされた形で保持し、生成されたエンコーダがフィールドとワイヤ上でバイトを運ぶ形式との間で変換します。
yaml_indentintegerいいえ新しい構造化テキストを合成する必要がある場合にコーデックが使用するインデント幅です。ゲストの切り分けがレンダリング全体のインデントと一致するように渡されます。

追加のプロパティは許可されません。

CarveOutput

Provider ゲストが carve エクスポートから返すペイロードです。ファイルを切り分けた、順序付きのアドレス指定可能な単位を含みます。構造化された単位はツリー(PATCH の対象)を保持し、不透明な単位はメディアタイプとバイト列のみを保持します。

プロパティ種類必須説明
unitsobject[]はいゲストがファイルを切り分けた、順序付きのアドレス指定可能な単位です。

追加のプロパティは許可されません。

ReassembleInput

Provider ゲストがオプションの reassemble エクスポートで受け取るペイロードです。元のファイルに加えて、その分割済みユニットと、パイプラインのステップが生成したパッチ済みユニットを含みます。ゲストはこれらを使って、変更を元のバイト列に精密に継ぎ戻します。パッチ済みセットに含まれないトークンは元のバイト列からそのまま再結合され、パッチ済みトークンはアドレス指定されたバイト範囲だけが編集されます。

プロパティ種類必須説明
namestringはい出力ファイルの名前です。同じファイルが分割されたときの名前と一致します。
bodystringはい再構成でパッチ済みユニットを継ぎ戻す先となる、元のファイルのバイト列です。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、文字列型であれば base64 エンコードされ、ゲストがデコードして復元します。生成されたエンコーダが、フィールドとワイヤ上でバイト列を運ぶ形式との間で変換します。
segsobject[]いいえファイルが分割されたユニットです。carve が返したとおりの形です。
patchedobject[]いいえパイプラインのステップが変更したユニットです。それぞれがトークン、パッチ済みツリー、および変更を生じさせた操作を保持します。
yaml_indentintegerいいえ操作が新しい構造化テキストを合成する必要がある場合にコーデックが使用するインデント幅です。再構成がレンダリング全体のインデントと一致するように渡されます。

追加のプロパティは許可されません。

ReassembleOutput

Provider ゲストが reassemble エクスポートから返すペイロードです。パッチ済みユニットを継ぎ戻したファイルのバイト列です。再構成はバイト単位で忠実であり、操作が触れなかったすべてのバイトはそのまま残ります。

プロパティ種類必須説明
bodystringはいホストがそのまま書き出す、再構成されたファイルのバイト列です。各キットはこれを独自のフィールド型で保持します。その型がバイト型であれば生のまま、文字列型であれば base64 エンコードされ、ゲストがデコードして復元します。生成されたエンコーダが、フィールドとワイヤ上でバイト列を運ぶ形式との間で変換します。

追加のプロパティは許可されません。

NameBoundInput

Provider ゲストがオプションの name_bound エクスポートで受け取るペイロードです。ホストがノードの component identity として使用しようとする名前を 1 つ含み、ゲストはその identity から自身のターゲット向けに導出するすべての名前に照らしてそれを判定します。identity がノードのワークロードの解決後に確定する場合は、それらの名前の一部が依存する、解決済みワークロードの情報も併せて含みます。ゲストは自身の名前ではなく制約で応答します。導出された名前を返すと、ホストが何も知らないターゲットの名前を組み立てる役割を負うことになり、まさにこの問いを発することでそれを避けているからです。ターゲットが受け入れる名前を制限するプロバイダはこのエクスポートを公開します。ターゲットが任意の名前を受け入れるプロバイダはこれを省略し、問い合わせを受けることはなく、そのレンダリングは変わりません。

プロパティ種類必須説明
proposedstringはいホストがノードの component identity として提案する名前です。ゲストはこれから、component identity から導出するすべての名前をメモリ上で導出し、それぞれがターゲットの受け入れる名前かどうかを報告します。判定はノードではなく「提案」について述べるものです。ホストは identity を組み立てるたびに 1 つの問いを発しますが、この identity がそのノードのどの名前の基礎になるかは伝えないため、ゲストはそれらすべての基礎になるものとして応答します。ホストは応答に基づいて短縮するのみで延長することはないため、これは保守的な方向です。そのため、実際には別の値から導出される名前は、緩すぎるよりも厳しすぎる方向で判定されます。
authored真偽値いいえ提案された名前が、コンパイラが作成済みの部品から組み立てたものではなく、人が書いたものかどうかです。対処できる読み手に向けてゲストが理由を表現できるよう渡されます。拒否の結果を決めるものではありません。作成された名前は拒否され、組み立てられた名前は短縮され、その判断はホストが行います。
workload_formstringいいえノードの Recipe または FeatureRecipe が解決されるワークロードの形式で、そのワークロードテンプレートが生成したとおりのものです。identity がそのワークロードの解決後に確定し、かつワークロードが形式を示している場合に含まれます。書かれたとおりに含まれ、ホストはそれを解釈しません。1 つの形式に対して出力する名前にのみターゲットが制限を課すゲストは、その名前を判定するためにこれを読みます。たとえばスケジュールされたジョブでは、実行ごとにサフィックスが付加されるため、ターゲットはその名前を他の名前より短く制限します。存在しない場合、ホストはこの問いに対して形式を含めていないことを意味します。ノードがワークロードを宣言していない、ワークロードが形式を示していない、または identity がいずれかのワークロードの解決前に確定している場合です。その場合ゲストは形式に依存する名前を判定せず、このフィールドが存在しない場合とまったく同じように応答します。
service_keysstring[]いいえノードの解決済みワークロードが宣言する Service のキーで、ワークロードが宣言した順序で並びます。identity がそのワークロードの解決後に確定し、かつワークロードが Service を宣言している場合に含まれます。ノード向けに出力する各 Service の名前を component identity と Service のキーから付けるターゲットを持つゲストは、そうした各名前を判定するためにこれらを読みます。キーは identity を書いた人ではなく Recipe または FeatureRecipe の作成者が書くものなので、ゲストはキーが原因の拒否をその作成者に向けた文言でも記述します。存在しない場合、ホストはこの問いに対してキーを含めていないことを意味します。ノードがワークロードを宣言していない、ワークロードが Service を宣言していない、または identity がいずれかのワークロードの解決前に確定している場合です。その場合ゲストは Service キーから組み立てられる名前を判定せず、このフィールドが存在しない場合とまったく同じように応答します。

追加のプロパティは許可されません。

DerivedNameVerdict

提案された identity に対する、1 つの名前の種類についての判定です。ゲストがその種類について導出する名前がターゲットに受け入れられるかどうか、そして、より短い identity なら受け入れられる場合はその最大長を示します。制約と理由を保持し、ゲストが組み立てた名前は決して含みません。

プロパティ種類必須説明
kindstringはいこの判定が対象とする名前の種類について、ゲスト自身が付けた名前です。コンパイラの語彙ではなくターゲットの語彙で書かれます(チャートインストーラのリリース名、コンテナオーケストレータのサービス名など)。拒否時にそのまま読み手に届くため、ターゲットを知る人に向けて書かれます。
usable真偽値はい提案された identity からゲストがこの種類について導出する名前が、ターゲットに受け入れられるかどうかです。
boundintegerいいえこの種類の導出名がターゲットに受け入れられるために、提案される identity が持てる最大の文字数です。より短い identity で満たせる拒否の場合にのみ存在します。存在しない場合、ターゲットが問題にしたのは長さではないことを意味します。長さの制限がまったくないか、ターゲットの文法がその位置で拒否する文字のように、短縮では解決できない問題であるかのいずれかです。したがって、存在しないことは上限 0 とは異なります。上限 0 は長さを示すもので、どの長さの identity でもこの種類の受け入れ可能な名前にならないことを意味します。ホストは存在する上限まで短縮して再度問い合わせます。上限が存在しない場合は、試すことが残っていないため停止します。
reasonstringいいえターゲットが導出名を受け入れない理由を、代わりに何を書くかを決める読み手に向けて、ターゲット自身の用語で示します。判定が使用可能な場合は空です。

追加のプロパティは許可されません。

NameBoundOutput

Provider ゲストが name_bound エクスポートから返すペイロードです。提案された識別子から導出する名前の種類ごとに 1 つの判定を含みます。すべての判定が受け入れ可能であれば、提案は使用できます。受け入れられない判定がある場合、ホストは拒否した判定が持つ上限のうち最小のものまで提案を短縮して再度問い合わせ、拒否した判定が上限を持たない場合は停止します。判定のリストが空であれば、ゲストはコンポーネントの識別子から名前を導出しないことを意味し、これは提案を受け入れるのと同じ回答です。

プロパティ種類必須説明
namesDerivedNameVerdict[]いいえゲストがコンポーネントの識別子から導出する名前の種類ごとに 1 つのエントリで、順序はゲスト自身の順序です。ゲストは拒否した種類だけでなく導出するすべての種類を報告します。これにより、読み手はどの名前が判定されたかを確認でき、エントリを読むホストは残りを知るために 2 回目の呼び出しを必要としません。
errorstringいいえゲストが実行されたものの操作を完了できなかった場合に設定される失敗メッセージです。成功時には存在しません。これは拒否の判定とは異なります。判定はターゲットが受け入れない名前を報告するのに対し、error は問い自体に答えられなかったことを報告します。ホストは、存在する error をプラグイン呼び出しの失敗として表面化させます。
condition_codestringいいえ失敗が示す条件の、記述的で機械的に照合可能な識別子です。これはその条件が登録されているコードであり、コンパイラが自身の停止条件を登録するのと同じ開いた集合に属し、応答エンベロープの hostfunc_error_code が取る閉じたホスト関数エラーコードカタログのメンバーではありません。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。停止するゲストは、メッセージが示す条件の識別子をここに報告します。これにより利用側はメッセージを読んで識別子を復元する代わりに、これに基づいて分岐できます。ホストはこの識別子をコンパイラが宣言する条件に対して解決し、解決した条件自身の識別子を構造化された診断に公開するため、読み手に届くコードは必ず解決できます。該当する条件のない識別子や、番号付けで廃止された識別子はビルドを停止します。示すべき正確な条件がないゲストは、代わりにコンパイラがその目的で宣言している汎用のプラグイン失敗条件のいずれかを使い、詳細は自身のメッセージに含めます。この識別子と condition_short_code は、1 つの条件を 2 つの形で示すため、一緒に報告されます。一方だけを設定したゲストはホストが解決できない条件を示したことになり、その場合ホストは代わりに自身の汎用プラグイン失敗条件を報告し、メッセージは引き続き失敗の全容を伝えます。
condition_short_codestringいいえ同じ条件のコンパクトな識別子で、文字 E と 4 桁の数字からなり、読み手が引用し、検索し、報告に貼り付ける形です。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの失敗について出力する診断の角括弧付きの先頭にこれを表示するため、ゲストが発行する条件もコンパイラが発行する条件とまったく同じように引用できます。ホストはこの値をそのまま信用して運ぶのではなく、コンパイラが宣言する条件に対して解決します。該当する条件のない値、番号付けで廃止された値、または登録にない綴りはビルドを停止し、問題の値を引用します。その際もゲスト自身のメッセージは報告されます。condition_code と一緒に報告されます。理由はそちらに記載したとおりです。

追加のプロパティは許可されません。

RenderedNameInput

Provider ゲストが省略可能な rendered_name エクスポートで受け取るペイロードです。ターゲットが自身の名前を導出する元となる 2 つの識別子と、ノードの Recipe が宣言する入力の種類(作成者が提供したソース、ゲストが合成するワークロード)を含みます。ゲストは、そのノードのためにレンダリングするリソースにターゲットが付ける名前で応答します。提供されたソースの場合は、チャートが読み取るリリース名のように、作成者自身のテンプレートがレンダリングの基準とする名前です。合成されたワークロードの場合は、ノードの識別子をそのまま書くのではなく名前を導出する場合に、ゲストが構築するリソースに付ける名前です。そのような名前を導出しないゲストは何も報告しません。これは、リソース名を Recipe がそのまま書くターゲットや、名前がノードではなくファイルの配置場所によって決まるターゲットにとって正直な回答です。このエクスポートはゲスト自身が構成する名前を報告するものであり、ホストが提案する名前の判定をゲストに求めるやり取りではありません。これらは別の問いであり、それぞれ専用のエクスポートを持ちます。

プロパティ種類必須説明
node_idstringはい作成されたとおりのノード自身の識別子です。エンコードされずに渡されます。ターゲットは独自のアルファベットによってこれを絞り込むため、先にエンコードするとエスケープの中にエスケープが入り、recipe の作成者が予測する名前とは異なる綴りになってしまいます。
derived_name_basisstringいいえコントリビューター自身のソースがレンダリングの基準とする識別子で、ノード自身の識別子と異なる場合のものです。ターゲットの名前アルファベットが識別子を拒否するコントリビューターに対して設定され、それ以外では存在しません。ゲストは、他のすべての箇所と同じ方法でこの組を解決します。この値が存在すればこの値を、存在しなければノード ID を使用します。
sourced真偽値いいえノードにバインドされた Recipe が作成者の提供したソースを宣言しているかどうかで、作成者が書いたテキストから読み取られます。synthesized とともに渡されるため、任意のノードについてこの問いを投げて正しく答えることができます。どちらも宣言せず、出力がアーティファクトセットのみであるノードについては、ゲストは名前を報告しません。そのようなセット内のリソースは、ゲストが導出する名前ではなく、作成者が書いたアーティファクトによって名前が付けられるためです。
synthesized真偽値いいえノードにバインドされた Recipe がゲストに合成させるワークロードを宣言しているかどうかで、sourced と同様に作成者が書いたテキストから読み取られます。ターゲットが合成するリソースに、書かれたとおりのノードの識別子ではなく導出した名前を付けるゲストは、そのようなノードについてその名前を報告します。これにより、Recipe がそれらのリソースの 1 つに対して公開するアドレスを、リソースが持つ名前から構築できます。

追加のプロパティは許可されません。

RenderedNameOutput

Provider ゲストが rendered_name エクスポートから返すペイロードです。ターゲットがそのノードに対してレンダリングするリソースに付ける名前(ノードの作成者が提供したソースから、または合成するワークロードから)を返すか、名前をまったく返しません。名前が存在しない、または空であることは失敗ではなく肯定的な回答であり(このターゲットはそのような名前を導出しないことを意味します)、ホストは伝えられた内容を読まずにそのまま使用するため、ターゲットの命名に関する知識が境界を越えることはありません。

プロパティ種類必須説明
namestringいいえゲストがこのノードの作成者提供ソースをレンダリングする際の名前、またはノードのために合成するリソースに付ける名前で、ターゲットがその位置で受け付けるアルファベットですでに書かれています。空または存在しない場合、ゲストはそのような名前を導出しないことを意味します。
errorstringいいえゲストが実行されたものの操作を完了できなかったときに設定される失敗メッセージです。成功時には存在しません。名前を報告しないこととは別物です。名前がないことはターゲットについての回答であり、error は問いそのものに回答できなかったことを報告します。ホストは error が存在する場合、プラグイン呼び出しの失敗として表面化します。
condition_codestringいいえ失敗が示す条件の、説明的で機械照合可能な識別情報です。条件が登録されているコードであり、コンパイラが自身の停止条件を登録するのと同じ開かれた集合に属します。人間向けのエラーメッセージと並べて設定されます。成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの識別子をコンパイラが宣言する条件に照らして解決し、解決された条件自身の識別子を構造化された診断に公開するため、読み手に届くコードは必ず解決されます。そのような条件を示さない識別子、または採番から廃止された識別子はビルドを停止させます。示すべき正確な条件を持たないゲストは、代わりにコンパイラがその目的のために宣言している汎用のプラグイン失敗条件のいずれかを使用し、詳細は自身のメッセージに記述します。この識別子と condition_short_code は一緒に報告されます。両者は一つの条件を二つの形式で示すためです。一方だけを設定したゲストはホストが解決できない条件を示したことになり、その場合ホストは代わりに自身の汎用のプラグイン失敗条件を報告し、メッセージは引き続き失敗の全体を伝えます。
condition_short_codestringいいえ同じ条件のコンパクトな識別子で、文字 E と 4 桁の数字からなり、読み手が引用し、検索し、報告に貼り付ける形です。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの失敗について出力する診断の角括弧付きの先頭にこれを表示するため、ゲストが発行する条件もコンパイラが発行する条件とまったく同じように引用できます。ホストはこの値をそのまま信用して運ぶのではなく、コンパイラが宣言する条件に対して解決します。該当する条件のない値、番号付けで廃止された値、または登録にない綴りはビルドを停止し、問題の値を引用します。その際もゲスト自身のメッセージは報告されます。condition_code と一緒に報告されます。理由はそちらに記載したとおりです。

追加のプロパティは許可されません。

LinkEndpoint

境界をまたぐリンクの一方のエンドポイントです。ノード、そのレンダリング出力が組み立てられる境界パス、およびそれをレンダリングしたプロバイダーを表します。リンクの二つのエンドポイントは、両端が異なるディスパッチグループに組み立てられる uses エッジの消費側と被消費側を示します。

プロパティ種類必須説明
nodestringはいトポロジーグラフ内でのエンドポイントノードの絶対 id です。
boundarystringはいエンドポイントの境界パスです。そのレンダリング出力が組み立てられるディスパッチグループを表します。
providerstringはいエンドポイントをレンダリングしたプロバイダーです(プロバイダー名のみ)。配線されたリンクの両エンドポイントは同じプロバイダーを示します。ホストは、エンドポイントが異なるプロバイダーを示すリンクをルーティングしません。
releasestringいいえエンドポイントのレンダリング出力が属する Release です。組み立てられたアーティファクトが命名されるスコープを表します。ホストはビルドが解決した Release からこれを組み立ててそのまま渡し、値から意味を推測しません。プロバイダーはこれを読んで、クロスリファレンス名を Release にスコープします。値が存在しない場合は空文字列となり、プロバイダーはそれをスコープなしの名前として扱います。

追加のプロパティは許可されません。

LinkEdge

消費側と被消費側の両端が異なるディスパッチグループに組み立てられる uses エッジに対して、ホストが組み立てる汎用的でドメインに依存しないエッジごとのペイロードです。両エンドポイント、ホストが解釈しない不透明なスカラーマップとしての両エンドポイントの配置アノテーション、被消費エンドポイントの provides 出力、およびエッジが配線するソケットと inject マッピングを含みます。プロバイダーはこれを読んで、両端に必要なプロバイダーネイティブのクロスリファレンス配線を生成します。ホストはこれを組み立て、アノテーションマップを不透明なスカラーとして渡し、いかなる値からも意味を推測しません。

プロパティ種類必須説明
sourceLinkEndpointはい消費側エンドポイントです。有向の uses エッジのソース端であり、その組み立てられた出力に消費側の配線が注入されます。
targetLinkEndpointはい被消費側エンドポイントです。uses エッジが指すターゲット端であり、その組み立てられた出力を生産側の配線が公開します。
target_annotationsstring のマップいいえ被消費側(ターゲット)エンドポイントの配置アノテーションで、アノテーション名をキーとする不透明なスカラーマップです。ホストはターゲットの解決済みアノテーションからこれらを組み立ててそのまま渡し、いかなる値からも意味を推測しません。プロバイダーはこれらを読んで、クロスリファレンスの形を決定します(たとえば両端が配置を共有するか、配置をまたぐ参照が必要か)。キーはソート順でシリアライズされるため、同一の入力に対する実行間でペイロードはバイト単位で同一になります。
source_annotationsstring のマップいいえ消費側(ソース)エンドポイントの配置アノテーションで、アノテーション名をキーとする不透明なスカラーマップです。ホストはソースの解決済みアノテーションからこれらを組み立ててそのまま渡し、いかなる値からも意味を推測しません。プロバイダーはこれらを読んで両端の配置を比較します。たとえばソースとターゲットが配置を共有するか、異なる配置にあるかです。キーはソート順でシリアライズされるため、同一の入力に対する実行間でペイロードはバイト単位で同一になります。
socketstringはいuses エッジがバインドされているソケットエイリアスです。
providesstring のマップはい被消費側エンドポイントの provides 出力で、ターゲットの宣言済み出力を公開する作成者順のキー集合です。作成者の順序を保持するため、同一の入力に対する実行間でペイロードはバイト単位で同一になります。
injectobjectはい消費側エンドポイントの inject マッピングで、配信メカニズムをキーとし作成者順のキー集合に対応付けられ、消費側の端が被消費側エンドポイントの出力をどのように受け取るかを記述します。作成者の順序を保持するため、同一の入力に対する実行間でペイロードはバイト単位で同一になります。
read_provides_keysstring[]いいえ消費される側のエンドポイントの provides 出力のキーのうち、消費する側のエンドポイントのテンプレートが .context.uses を通じて直接読むものです。inject マッピングがそれらも届けるかどうかにかかわらず、provides の作成者順に並びます。各エントリは provides が持つキーのいずれかです。このリストはエッジに載って運ばれるため、プロデューサー側の publish とコンシューマー側の resolve は 1 つのリストを読みます。消費する側のエンドポイントがどの provides キーも直接読まなかった場合は存在せず、リストを渡されなかった provider は、このフィールドが存在しない場合とまったく同じようにリンクを接続します。

追加のプロパティは許可されません。

LinkPatch

プロバイダーがアーティファクト配線として返す、ファイルごとの構造的パッチ一つです。出力ファイルと、それに適用する順序付きの構造的操作を表します。後続のホストパスが指定されたファイルを分割し、操作を適用し、バイト単位で忠実に再組み立てします。操作の形は共有パイプラインのパッチ操作の語彙であり、このスキーマ層では不透明です。そのため、ゲストは各操作をそのまま運び、ホストがパイプラインの適用する型付き操作を実現します。

プロパティ種類必須説明
filestringはい操作を適用する出力ファイルで、プロバイダーが出力したとおりの名前で示されます。
opsany[]はいファイルに適用する順序付きの構造的操作で、適用順に並びます。

追加のプロパティは許可されません。

LinkPublishInput

provider が link_publish エクスポートで受け取るペイロードです。消費される側のエンドポイントの出力が境界を越えて参照される 1 つのクロス境界リンクと、そのエンドポイントのアセンブル済みファイルを含みます。このエクスポートは、消費側が解決の基準とする公開済みアイデンティティと、消費される側のエンドポイントの出力が必要とするプロデューサー側のアーティファクト配線を返します。

プロパティ種類必須説明
edgeLinkEdgeはい公開されるクロス境界リンクです。消費される側(ターゲット)のエンドポイントの側から読み取られます。
producer_filesRenderedFile[]いいえ消費される側のエンドポイントのアセンブル済みファイルです。provider はこれにより、そのエンドポイントがすでに宣言している内容を読み取り、これから公開する名前をそれと照合できます。各ファイルはディスク上のパスを示し、アセンブル済みのバイト列を保持します。ホストが公開処理に渡すアセンブル済みのプロデューサー出力を持たない場合は存在しません。配線の作成にドキュメントを必要としない provider はこれを無視します。

追加のプロパティは許可されません。

LinkPublishOutput

provider が link_publish エクスポートから返すペイロードです。消費側が解決の基準とする公開済みアイデンティティハンドルと、消費される側のエンドポイントのアセンブル済み出力に適用するプロデューサー側のアーティファクト配線を含みます。

プロパティ種類必須説明
handlestring のマップはい消費される側のエンドポイントが、消費側の解決の基準として公開するアイデンティティです。フィールド名をキーとする不透明な決定論的ポインタ文字列のマップです(例:エクスポート名、スタック名、リージョン、ロール参照)。値はコンパイラが受け渡すだけで決して解決しない決定論的ポインタ文字列であり、ランタイム環境がデプロイ時に解決します。キーはソート順でシリアライズされるため、同一の入力に対する実行間でペイロードはバイト単位で同一になります。
patchesLinkPatch[]いいえプロデューサー側のアーティファクト配線です。公開処理が編集する必要のある、消費される側のエンドポイントの出力ファイルごとに 1 つの構造的パッチがあります。消費される側のエンドポイントの出力がリンクのために変更を必要としない場合は空です。
errorstringいいえゲストが実行されたもののリンクを公開できなかった場合に設定される失敗メッセージです。成功時は存在しません。ホストは存在するエラーをプラグイン呼び出しの失敗として表面化します。続行できない公開処理(たとえば、スタックがすでに別のエントリで宣言しているエクスポート名)は、クラッシュとしてだけでなくここで報告されるため、その背後にある条件を名指しできます。
condition_codestringいいえ失敗が示す条件の、記述的で機械的に照合可能な識別子です。これはその条件が登録されているコードであり、コンパイラが自身の停止条件を登録するのと同じ開いた集合に属し、応答エンベロープの hostfunc_error_code が取る閉じたホスト関数エラーコードカタログのメンバーではありません。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。停止するゲストは、メッセージが示す条件の識別子をここに報告します。これにより利用側はメッセージを読んで識別子を復元する代わりに、これに基づいて分岐できます。ホストはこの識別子をコンパイラが宣言する条件に対して解決し、解決した条件自身の識別子を構造化された診断に公開するため、読み手に届くコードは必ず解決できます。該当する条件のない識別子や、番号付けで廃止された識別子はビルドを停止します。示すべき正確な条件がないゲストは、代わりにコンパイラがその目的で宣言している汎用のプラグイン失敗条件のいずれかを使い、詳細は自身のメッセージに含めます。この識別子と condition_short_code は、1 つの条件を 2 つの形で示すため、一緒に報告されます。一方だけを設定したゲストはホストが解決できない条件を示したことになり、その場合ホストは代わりに自身の汎用プラグイン失敗条件を報告し、メッセージは引き続き失敗の全容を伝えます。
condition_short_codestringいいえ同じ条件のコンパクトな識別子で、文字 E と 4 桁の数字からなり、読み手が引用し、検索し、報告に貼り付ける形です。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの失敗について出力する診断の角括弧付きの先頭にこれを表示するため、ゲストが発行する条件もコンパイラが発行する条件とまったく同じように引用できます。ホストはこの値をそのまま信用して運ぶのではなく、コンパイラが宣言する条件に対して解決します。該当する条件のない値、番号付けで廃止された値、または登録にない綴りはビルドを停止し、問題の値を引用します。その際もゲスト自身のメッセージは報告されます。condition_code と一緒に報告されます。理由はそちらに記載したとおりです。

追加のプロパティは許可されません。

LinkResolveInput

provider が link_resolve エクスポートで受け取るペイロードです。1 つのクロス境界リンク、その消費される側のエンドポイントが公開したアイデンティティハンドル、および消費する側のエンドポイントのアセンブル済みファイルを含みます。このエクスポートは、消費する側のエンドポイントのアセンブル済み出力に参照を注入する、消費側のアーティファクト配線を返します。

プロパティ種類必須説明
edgeLinkEdgeはい解決されるクロス境界リンクです。消費する側(ソース)のエンドポイントの側から読み取られます。
handlestring のマップはい消費される側のエンドポイントの link_publish が返した公開済みアイデンティティハンドルで、消費側はこれを基準に参照を解決します。フィールド名をキーとする不透明な決定論的ポインタ文字列であり、コンパイラはこれを受け渡すだけで決して解決しません。キーはソート順でシリアライズされるため、同一の入力に対する実行間でペイロードはバイト単位で同一になります。
consumer_filesRenderedFile[]いいえ消費する側のエンドポイントのアセンブル済みファイルです。provider はこれにより、ホストが消費側の出力に刻印したプレースホルダーを見つけ、プレースホルダーの実際のパスにその置換を作成できます。各ファイルはディスク上のパスを示し、アセンブル済みのバイト列を保持します。ホストが解決処理に渡すアセンブル済みの消費側出力を持たない場合は存在しません。配線の作成にドキュメントを必要としない provider はこれを無視します。

追加のプロパティは許可されません。

LinkResolveOutput

provider が link_resolve エクスポートから返すペイロードです。消費する側のエンドポイントのアセンブル済み出力に適用するコンシューマー側のアーティファクト配線であり、消費される側のエンドポイントの公開済み ID への参照を注入します。

プロパティ種類必須説明
patchesLinkPatch[]はいコンシューマー側のアーティファクト配線です。resolve が編集する必要のある、消費する側のエンドポイントの出力ファイルごとに 1 つの構造的パッチがあります。
errorstringいいえゲストが実行されたもののリンクを解決できなかった場合に設定される失敗メッセージです。成功時には存在しません。ホストは、存在するエラーをプラグイン呼び出しの失敗として報告します。続行できない resolve(たとえば、ターゲットがスカラー全体としてしか保持できない参照が、より大きな文字列の内部で見つかった場合)は、単なるクラッシュとしてではなくここで報告されるため、その背後にある状態に名前を付けることができます。
condition_codestringいいえ失敗が示す条件の、記述的で機械的に照合可能な識別子です。これはその条件が登録されているコードであり、コンパイラが自身の停止条件を登録するのと同じ開いた集合に属し、応答エンベロープの hostfunc_error_code が取る閉じたホスト関数エラーコードカタログのメンバーではありません。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。停止するゲストは、メッセージが示す条件の識別子をここに報告します。これにより利用側はメッセージを読んで識別子を復元する代わりに、これに基づいて分岐できます。ホストはこの識別子をコンパイラが宣言する条件に対して解決し、解決した条件自身の識別子を構造化された診断に公開するため、読み手に届くコードは必ず解決できます。該当する条件のない識別子や、番号付けで廃止された識別子はビルドを停止します。示すべき正確な条件がないゲストは、代わりにコンパイラがその目的で宣言している汎用のプラグイン失敗条件のいずれかを使い、詳細は自身のメッセージに含めます。この識別子と condition_short_code は、1 つの条件を 2 つの形で示すため、一緒に報告されます。一方だけを設定したゲストはホストが解決できない条件を示したことになり、その場合ホストは代わりに自身の汎用プラグイン失敗条件を報告し、メッセージは引き続き失敗の全容を伝えます。
condition_short_codestringいいえ同じ条件のコンパクトな識別子で、文字 E と 4 桁の数字からなり、読み手が引用し、検索し、報告に貼り付ける形です。人間向けのエラーメッセージと並べて設定され、成功時には存在せず、ゲストがそのような条件を示さない場合にも存在しません。ホストはこの失敗について出力する診断の角括弧付きの先頭にこれを表示するため、ゲストが発行する条件もコンパイラが発行する条件とまったく同じように引用できます。ホストはこの値をそのまま信用して運ぶのではなく、コンパイラが宣言する条件に対して解決します。該当する条件のない値、番号付けで廃止された値、または登録にない綴りはビルドを停止し、問題の値を引用します。その際もゲスト自身のメッセージは報告されます。condition_code と一緒に報告されます。理由はそちらに記載したとおりです。

追加のプロパティは許可されません。