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

致命的な停止

致命的な停止とは、出力が生成される前にビルドを止めるコンパイル時エラーです。各停止は、問題のあるファイル、エンティティ、フィールドを示し、コンパイラが解決できなかった内容を説明し、それを修正する具体的な記述の変更を指し示します。コンパイラは入力を暗黙に修復したり書き換えたりすることはありません。何かが誤っていれば、ビルドは停止し、その場所を示します。

このカタログは、各停止が発生するコンパイルの段階ごとに構成されています。

以下の各エントリは、そのエントリが説明する条件に対してビルドが出力するメッセージを引用しています。メッセージは、条件を述べる固定の文と、その発生時に与えられた内容から成ります。ターミナルでは、このメッセージは枠の中に表示されます。枠は、カテゴリと条件の短いコードを含む角括弧付きの見出し、問題のあるファイルとキーへのポインタとそれに続く (instance <name>) という形の失敗の対象インスタンス(ファイルが該当しない場合は instance <name> という形のインスタンスのみ)、そしてその下の行のメッセージから成ります。そのため、ビルドから貼り付けた行全体はここのエントリと一致しませんが、その中のメッセージは一致します。枠の詳細は error-translation.md で説明しています。

ビルドから短いコード(診断の角括弧付き見出しにある、文字 E と 4 桁の数字)を手にしてここに来た場合は、このページ末尾のビルドが出力した短いコードから停止を探すから始めてください。そこには、ここに掲載したすべての条件が、ビルドが出力する短いコードとともに一覧されています。

ファイルの読み込み時

コンパイラは、ビルドが参照するすべての Aggregate、Manifest、Component、Feature、Recipe、FeatureRecipe、Plugin、Release を読み込み、それぞれをスキーマに照らして検証し、Release の型付きパラメータを Aggregate に補間します。

YAML anchor aliased inside its own content(YAML アンカーが自身の内容の内部でエイリアスされている)

ドキュメントが &name でノードにアンカーを付け、そのアンカーが覆う内容のどこかで *name によってそれをエイリアスしています。エイリアスを展開するとアンカーが再現され、その内容には再びエイリアスが含まれるため、ドキュメントは終わりのない構造を記述することになります。読み取れる有限のものがなく、検証などなおさらできないため、終了しない走査を始める代わりにビルドが停止します。

YAML をツリーとして読み込む処理はエイリアスを展開しないため、この形のドキュメントは問題なく読み込まれ、何かがそれを走査したときに初めて失敗します。そのため拒否は読み込みと走査の間に位置します。また、ビルドは記述された YAML を複数の時点で読み込むため、同じ条件に複数の時点で遭遇する可能性があります。4 つの時点がこれを報告し、いずれも同じ説明を、その面でドキュメントの位置を示す情報で囲みます。

  • エンティティファイルの読み込み時。 そのエンティティがスキーマに照らしてチェックされる前にビルドが停止するため、この停止はフィールドではなくアンカーを示し、行と列を含みません。その時点では、ドキュメントには診断が有用に指し示せる位置がないためです。
  • スキーマ本体のコンパイル時。 spec.schema: ピラーは、ファイルが読み込まれた後にコンパクト形式から JSON Schema ドキュメントへコンパイルされるため、この停止はコンパイルの前ではなくコンパイル中に発生し、行を含みます。それ以前の読み込みで検出できない形は $jsonschema: エスケープ本体です。エスケープ本体は、周囲のファイルが読み込まれる間はブロックスカラー(アンカーを持たないプレーンテキスト)であり、そのアンカーは、そのテキスト自体が 1 段下でパースされたときに初めてアンカーになります。循環がそのようなブロックの内部にあった場合、停止はその本体に循環を含んでいたキーワードとして $jsonschema も示します。
  • provider Plugin のワークロードスキーマ、Plugin のロード時。 spec.provider.workloadSchema はブロックスカラーとして記述されます。Plugin ファイル自体が読み込まれる間はプレーンテキストであり、その時点ではアンカーを持たず、そのアンカーは、そのテキストが 1 段下で独立したドキュメントとしてパースされたときに初めてアンカーになります。そのパースと続くコンパイルはどちらも Plugin のロード時に行われるため、この停止はファイルの読み込み時ではなくそこで発生し、行を含みます。循環がスキーマ本体内の $jsonschema: エスケープの内部にあった場合、停止はその本体に循環を含んでいたキーワードとして $jsonschema も示します。このフィールドの記述方法については ../entities/plugin.md を参照してください。
  • レンダリングされた CloudFormation フラグメント、provider による読み込み時。 cloudformation の Recipe はフラグメントを記述し、artifacts: 本体はテンプレートです。そのため provider が読み込むのはそのテンプレートがレンダリングされたテキストであり、ファイルの読み込み中には存在しなかった内容です。したがってこの停止は、すべてのスキーマチェックが通過した後、出力のレンダリング中に発生します。フラグメントの記述方法については ../providers/cloudformation.md を参照してください。

拒否されるのは再帰であり、再利用や深さではありません。共有内容にアンカーを付けて複数の場所から参照することはサポートされた記述パターンです(../entities/aggregate.md の「YAML anchor patterns (defs: block)」と ../entities/manifest.md の「YAML anchors for DRY manifests」を参照)。展開されて終了する参照は、何回現れても、ドキュメントがどれほど深くネストしていても、正常にロードされます。深さそれ自体がこの停止の理由になることはありません。停止するのは、ビルドがまだアンカーの内部にいる間にそのアンカーに到達した場合で、その下で宣言された 2 つ目のアンカーを経由して間接的に到達した場合も含みます。メッセージはループが戻り着くアンカーを示し、それは必ずしもドキュメント内の最も外側のアンカーではありません。

出力されるメッセージ。 4 つすべてが同じ説明を含むのは意図的です。これは 4 つの時点で遭遇する 1 つの条件であり、一度読み方を覚えた作成者が再び覚え直す必要があってはなりません。異なるのはドキュメントの位置を示す枠だけです。

anchor &<anchor> is aliased by *<anchor> inside its own content, so the document expands without end; point that alias at content declared outside &<anchor>, or write the content out in full(アンカーが自身の内容の内部でエイリアスされているため、ドキュメントが際限なく展開されます。そのエイリアスをアンカーの外側で宣言された内容に向けるか、内容を省略せずに書き出してください)

エンティティファイルは、それを読み込んでいたエンベロープチェックと、読み込み元のパスで囲まれます。

document envelope validation failed: envelope: parse <path>: <the explanation above>(ドキュメントエンベロープの検証に失敗しました)

スキーマ本体は、スキーマ内での位置と、循環が $jsonschema: ブロックの内部にあった場合はエスケープキーワードで囲まれます。ビルドはこれを CATALOG_ERROR タグの下で報告し、このタグはファイル、エンティティ、および本体のコンパイルに失敗したピラーも示します。

compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above>

provider Plugin のワークロードスキーマも同じコンパクト形式の枠を持ちます。異なるのはその周囲の CATALOG_ERROR タグで、エンティティとそのピラーの代わりに Plugin と spec.provider.workloadSchema を示します。

レンダリングされたフラグメントは、それを読み込んだ provider で囲まれます。

cloudformation-provider: parse fragment: <the explanation above>

修正方法: エイリアスを、現在それが内部にあるアンカーの外側で宣言された内容に向けるか、繰り返される内容を使用箇所ですべて書き出してください。Aggregate または Manifest では、ルートレベルの defs: ブロックが共有アンカーの自然な置き場所です。このブロックはそれを参照するすべてのブロックの外側にあるため、そこで宣言されたアンカーに自身の内部から到達することはありません。defs: ブロックを持たない他のエンティティ種別では、参照するブロックがその子孫とならない場所に共有内容のアンカーを置いてください。アンカーはいくつの場所からでも、どの深さからでも参照できます。唯一取れない形は、アンカーが覆う内容の内部に戻り着く参照です。

停止にどこで遭遇したかにかかわらず同じ対処が適用され、枠がどのドキュメントを開くべきかを示します。エンティティファイル自体、スキーマピラー内の $jsonschema: ブロック、provider Plugin 内の workloadSchema 本体、または provider がレンダリング出力を読み込んだ artifacts: 本体です。最後の場合、アンカーはレンダリングされたテキストではなく記述したテンプレート内にあります。レンダリングはそれを忠実に再現しただけです。

Parameter type mismatch / contract violation(パラメータの型の不一致/契約違反)

Release が、Aggregate がそのパラメータに宣言した内容と型または形状が一致しない値を指定しました。パラメータ契約バリデータは、テンプレートの補間が実行される前に、型の不一致、enum 違反、範囲違反、パターン違反、宣言された format の有効なインスタンスではない文字列、validate: 述語の失敗、および必須パラメータの欠落を検出します。format に指定できる名前と、それぞれが検査する内容は、名前付きフォーマットに一覧があります。

出力されるメッセージ — 状態を述べる文に続き、問題のあるエンティティ、フィールドパス、制約の詳細が示されます。

parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>)(パラメーター契約違反: パラメーターは宣言された型を期待しましたが、異なる型の値を受け取りました)

required: true と宣言され、default: も Release が指定する値もないパラメータについては、レポートは別の状態と別の短縮コードを示します。

required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release)(必須パラメーターが指定されていません: このパラメーターは必須ですが、Release が指定していません)

満たされなかった制約に応じて変わるのは、フィールドパスの後の詳細だけです。 文とそれを囲む括弧付きの枠は毎回同じであるため、文が照合に使う部分、詳細が読む部分になります。ビルドが出力する詳細は、制約の種類ごとに次のとおりです。

parameter "<parameter>" value <value> not in enum [<members>](パラメーターの値が列挙に含まれていません) parameter "<parameter>" value "<value>" does not match pattern "<pattern>"(パラメーターの値がパターンに一致しません) parameter "<parameter>" value "<value>" is not a valid <format>: <reason>(パラメーターの値が有効な形式ではありません) parameter "<parameter>" value <value> above max <max>(パラメーターの値が最大値を超えています) parameter "<parameter>" failed validate predicate(パラメーターが validate 述語を満たしませんでした) parameter "<parameter>" validate predicate error: <detail>(パラメーターの validate 述語でエラーが発生しました)

フォーマット違反の <reason> は、値の何が誤っているかをそのフォーマット自身の用語で示します。ネストされた契約内の値はそのパスで示されるため、items: 契約が宣言する format はすべての要素に対して検査され、レポートは失敗した要素を示します。hosts パラメータの 2 番目の要素は .spec.parameters.hosts.1 として報告され、その詳細は "hosts.1" を示します。

validateMessage: を宣言したパラメータは、その詳細全体を独自のテキストで置き換えるため、レポートは parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>) となります。枠は変わらず、制約の詳細が入る位置に記述した文が入ります。

記述されたままでは何も制約できない契約も、同じ状態に含まれます。有効な正規表現ではない pattern: は、Release の値が検査される前、Aggregate のパラメータ契約が読み込まれる時点で拒否されるため、Release がそのパラメータを指定するかどうかにかかわらずビルドを停止します。レポートはキー(.spec.parameters.<parameter>.pattern、または .spec.parameters.<parameter>.items.pattern のようなネストされた契約を通るパス)を指し、その詳細は宣言、パターン、理由を示します。

parameter "<parameter>" pattern "<pattern>" does not compile: <reason>(パラメーターのパターンをコンパイルできません)

サポートされる集合の外にあるフォーマットを指定する format: も何も制約できず、同じ時点、つまり Release の値が検査される前に拒否されるため、これも Release がそのパラメータを指定するかどうかにかかわらずビルドを停止します。ネストされた契約内(items:、properties:、valuesType: の下)では、これを拒否するのはこの状態です。レポートは .spec.parameters.<parameter>.items.format のようなキーを指し、その詳細は宣言、記述されたフォーマット、およびサポートされるすべての名前を示します。

parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date(この形式はサポートされていません。サポートされる形式は email、uri、hostname、ipv4、ipv6、uuid、date-time、date です)

パラメータ自身の宣言では、同じ名前はその 1 段階前に、format がサポートされる名前のみを許容する Aggregate のスキーマによって拒否されます。この拒否は、ドキュメントがその種類のスキーマを満たさないという別の状態であり、独自の短縮コード E0215 を持ちます。aggrega pull と aggrega validate --release は、その名前を持つ Aggregate が読み込まれなかったため、Release の aggregate: 参照を解決不能(E0170)として報告した後にこれを列挙します。

document envelope validation failed (Aggregate, at <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> does not equal any of: [email uri hostname ipv4 ipv6 uuid date-time date]. correct the document to match its kind’s schema(ドキュメントのエンベロープ検証に失敗しました: format の値がサポートされる名前のいずれとも一致しません。ドキュメントを種別のスキーマに合うよう修正してください)

述語エラーの詳細は、validate: 述語が判定を出せない 2 つの場合の両方を扱います。サーフェスが登録していない関数と、.value 以外のものへの参照です。いずれも値ではなく述語に対して報告され、解決できなかったものを示します。

validate: 述語は検証対象の値を .value として読み取り、それが定義する唯一の名前です。それ以外のものを指定する述語は実行前に拒否されるため、誤って入力された参照は、何にも解決されずに検証に失敗した値として現れるのではなく、本来の名前の誤りとして報告されます。

修正方法: Release の値をパラメータの宣言された type / enum / min / max / pattern / format 制約に合わせて変更する、欠落している必須パラメータを指定する、コンパイルできない pattern: を修正する、サポートされないフォーマットを指定する format: を名前付きフォーマットのいずれかに置き換えるか削除する、.value 以外のものを指定する、または true か false 以外を出力する validate: 述語を修正する、あるいは実際に必要な形状を受け入れるよう Aggregate の宣言を広げてください。

Recipe shape rules(Recipe の形状ルール)

Recipe は、sourced、synthesized、artifacts の 3 つの入力種別から出力を構成します。これらは ../../architecture/16-recipe-input-composition.md で説明されています。有効な Recipe の形状は、以下の構成ルールによって制約されます。各ルールはチェックされるタイミングが異なります(Recipe の読み込み時、ノードのレンダリング時、または出力の書き出し時)。そのため、各項目でその条件がどの時点でチェックされるかを確認してください。

各ルールは、制約する対象によって命名されています。番号付けはなく、予約された番号もありません。名前は Recipe のどの部分を開くべきかを示し、以下のリストが増えても並べ替えられても、その意味は変わりません。CI ゲート、issue、ランブックなどで条件を永続的に記録する必要がある場合は、そのコードを使用してください。これは sentinels.md がその条件について掲載している識別子で、周囲のパッケージが進化しても固定されたままです。

Recipe 形状の停止も同じ方法で構成されます。まずルールを述べる文で始まり、次にこの Recipe が指定した内容を示し、最後にその Recipe 固有の詳細が続きます。

<the rule's sentence> (Recipe <name>:<version>, rule <rule-name>, at <position>). <rule-specific detail>

先頭の文はルールごとに固定されています。どの段階で検出されたかにかかわらず、そのルールで停止するたびに同じテキストになります。そのため、これが出力の中で照合に使うべき部分であり、sentinels.md がそのルールの条件について掲載しているテキストです。それ以降はすべて、問題のある Recipe によって異なります。括弧内の値はどのドキュメントか、名前によるどのルールか、どこかを示し、最後の文はその発生に対する助言です。位置は、ルールがドキュメント全体に関するものであれば Recipe の読み込み元ファイルであり、ルールがその中の 1 つの要素に関するものであれば記述したキーへのドット区切りのパス(.spec.outputComponentLabels.hosting)です。キー自体にドットが含まれる場合、それを 1 つのセグメントとして表記すると 2 つのセグメントとも読めてしまうため、パスはそのキーを保持するブロックで止まり、代わりに助言がそのキーを引用します。

ビルドは行全体を CATALOG_ERROR タグの下に出力します。このタグは、失敗の原因が Aggregate や Release ではなく、カタログエンティティ(Recipe、またはそれがバインドするプロバイダー)にあることを示します。Recipe の読み込み元ファイルがタグの横に出力されるため、キーに位置付けられたルールでも、どのファイルを開けばよいかがわかります。

valuesMapping requires source(valuesMapping には source が必要です)

Recipe が valuesMapping を宣言していますが、source を宣言していません。オーバーレイ先のソースがなければ、マッピングされた値を受け取るものがありません。このルールは Recipe の読み込み時にチェックされます。

出力されるメッセージ:

Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended)

修正方法: valuesMapping と並べて source: ポインター(チャート、モジュール、または compose ファイルへの参照)を追加するか、valuesMapping を削除して別の入力種別(合成出力には workload:、マニフェストの直接出力には artifacts:)を採用します。

workload: requires a provider that can synthesize(workload: には合成が可能な provider が必要です)

Recipe が、Workload の合成を実装していないプロバイダーに対して workload:(合成モード)を宣言しています。合成モードのサポートはプロバイダーの特性です。標準ライブラリのカタログは慣例により合成可能なプロバイダーに workloadSchema を宣言しますが、チェックはそのフィールドの有無ではなく、プロバイダーの機能に基づいて行われます。

これを報告する箇所は 2 つあり、ビルドを決定するのはそのうち 1 つだけです。 停止はレンダリング時、ノードのプロバイダーがバインドされ、その Recipe が宣言する入力種別が読み込まれた後に発生するため、その報告はノードを示します。aggrega validate は、ノードがバインドされる前に Recipe 単体を読み込んで同じ検出結果をより早く報告するため、その報告は代わりに Recipe とそのバージョンを示します。両者が読み込む Recipes の集合は同じではありません。早期の報告は workload: を宣言するすべての Recipe に対して発生しますが、停止はノードが宣言する入力種別のうちプロバイダーが対応できないすべてに対して発生します。そのため、workload: と source: を組み合わせた Recipe も停止し、workload を理由に停止します。プロバイダーがレンダリングできる入力種別を宣言しても、サポートされない種別がゲートを通過するわけではありません。

これには 1 つの制限があります。artifacts: は、それがノードで唯一宣言された種別である場合にのみ、スタンドアロン artifacts のサポートに対してチェックされます。source: や workload: と併用される場合、そのファイルは構成された出力として通過し、その機能の管轄外となります。

レンダリング時に出力されるメッセージ。失敗が帰属するカテゴリは、メッセージ内ではなく診断の角括弧付きの先頭部分で示されます。メッセージは条件を述べる固定の文で始まり、次にノード、プロバイダー、拒否された宣言済みの種別、そのプロバイダーがサポートする種別を示します。ノードがプロバイダーの対応できない種別を 2 つ宣言している場合は、source → workload → artifacts の順で最初のものが報告されるため、検出結果は Recipe の 1 行に関するものに留まります。

provider does not support the node’s input kind (node "<node-id>"). provider "<provider-name>" does not support <mode> recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports <mode>

先頭部分にはカテゴリとこの条件の短いコード E0265 が含まれます。これは、継続的インテグレーションのゲート、issue、ランブックなどでこの停止を永続的に記録する必要がある場合に使う識別子です。番号は一度割り当てられると固定されるため、周囲の文言が改善されても変わりません。すべての条件の表で番号を引くことができ、識別子ではなくテキストから作業する場合は、上記の冒頭の文で照合します。

早期の報告も同じ条件であるため、aggrega validate は同じ内容を、そのブロックを持つ Recipe の下に、読み込んだ箇所を接頭辞として付け、この条件のショートコードを先頭に置いて報告します:

input-kind: [E0265] Recipe "<name>:<version>": provider "<provider-name>" does not support synthesized recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports synthesized(入力種別:このプロバイダーは合成型のレシピをサポートしていません。サポートされている入力種別のいずれかを宣言するか、合成をサポートするプロバイダーを対象にしてください)

カタログ全体に対しては 1 行になります。--release を指定した場合は、ヘッドが条項の上の独立した行に置かれます。同じ検出結果に対するエディターの診断は、コードとして E0265 を持ちます。

修正方法: Recipe を合成可能なプロバイダー(最も一般的には helm または compose)にバインドするか、Recipe を別の入力種別(マニフェストの直接出力には artifacts:、チャートやモジュールが存在する場合は source: + valuesMapping:)に移行します。

プロバイダーごとの Workload 内容の検証。 現在、プロバイダーの workloadSchema はドキュメント用途のみであり、Workload 本体を検証しません。本体はプラットフォームが所有する組み込みの Workload スキーマに対して検証されます。Wasm ベースの Workload シンセサイザーがリリースされると、workloadSchema はシンセサイザーが Workload 本体を検証する際のプロバイダーごとの契約になります(別個の、内容レベルの停止)。

The provider does not support omits (プロバイダが omits をサポートしていません)

Recipe または FeatureRecipe が omits: を宣言しているにもかかわらず、それをレンダリングするプロバイダが、レンダリング済みドキュメントを除外することを宣言していません。ソースがレンダリングするものからドキュメントを除外できるのはプロバイダだけです。ソースがどのドキュメントをレンダリングし、それぞれが何という名前かを知っているのはプロバイダだけだからです。そのため、除外を行わないプロバイダは、エントリが指定するすべてのドキュメントをレンダリングし、成功を報告してしまいます。ビルドはその代わりに何かがレンダリングされる前に拒否するため、このキーが黙って何もしないことはありません。

プロバイダがドキュメントを除外するかどうかは、コンパイラが保持するプロバイダのリストからではなく、サポート内容に関するプロバイダ自身の宣言から読み取られます。when: が何をレンダリングするかにかかわらず、すべてのエントリが対象になります。プロバイダがキーに対応できるかどうかは、ビルドがどのエントリを残すかに依存しないためです。helm、compose、cloudformation プロバイダはこのキーに対応します。helm-chart と terraform はソースをデプロイ時にレンダリングされるよう引き渡すため、ビルド時に除外すべきレンダリング済みドキュメントが存在せず、どちらも拒否されます。

拒否の判定は、すべてのコンポーネントの Recipe とすべてのアタッチメントの FeatureRecipe がバインドされ、各プロバイダが自身を記述した時点で行われます。これは最初のコンポーネントがレンダリングされる前、かつどのエントリも評価される前であるため、ここで拒否されたビルドは何もレンダリングしません。この判定は、ソースをレンダリングするすべてのドキュメントに対して行われます。つまり、コンポーネントの Recipe、アタッチメントがコンポーネント上でバインドする FeatureRecipe(そのアタッチメントを持つコンポーネントごとに 1 回)、そしてバウンダリに対して一度だけ生成する FeatureRecipe(それを宣言するバウンダリで 1 回)です。問題のあるドキュメントはすべて 1 回のビルドで報告され、複数ある場合、検出結果は documents declaring omits whose provider does not honour them の下にまとめられます。ビルドが解決できないプロバイダにバインドされたドキュメントはここでは報告されません。そのビルドはプロバイダが選択される箇所で停止し、そのバインディングを示します。

出力されるメッセージの位置は、Recipe のエントリについては components: 配下のコンポーネント自身のキー(サブシステム内に記述されたコンポーネントは、まずそのサブシステムのキーの配下に位置付けられます)、コンポーネント上の FeatureRecipe のエントリについてはそれを記述した features: ブロック内のアタッチメントのキー、バウンダリに対して一度だけ生成する FeatureRecipe については Release 内の .spec.boundaries.<boundary>.features.<attachment> です。カテゴリは角括弧で囲まれたヘッドで示されます。メッセージはまずプロバイダを示し、次にドキュメントのレンダリング対象のコンポーネントを示します。

provider does not support omits ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it leaves rendered documents out; remove the omits key, or render the source through a provider whose contract declares it(provider は omits をサポートしていません。この provider の契約は、レンダリングされたドキュメントを除外することを宣言していません。omits キーを削除するか、それを宣言する契約を持つ provider を通してソースをレンダリングしてください)

FeatureRecipe の検出結果は、コンポーネントの後にアタッチメントを示します(node "<node-id>", attachment "<attachment>")。バウンダリに対して一度だけ生成するものは、コンポーネントの代わりにバウンダリとアタッチメントを示します: boundary "<boundary>", attachment "<attachment>"。

ヘッドにはこの条件の短縮コード E0335 が含まれます。

修正方法: omits: キーを削除するか、このキーに対応するプロバイダでソースをレンダリングしてください。helm-chart または terraform の Recipe がローカルのチャートやモジュールをソースとする場合は、代わりに Recipe の隣にある .aggregaignore に 1 行追加すると、次に Recipe をピン留めした時点から、そのソースのファイルが除外されます。aggrega pin を参照してください。

The provider does not support boundary artifacts (プロバイダがバウンダリアーティファクトをサポートしていません)

Recipe が spec.boundary.artifacts(それがレンダリングされるバウンダリの共有出力向けのファイル)を宣言しているにもかかわらず、それをレンダリングするプロバイダが、そのようなファイルを受け付けることを宣言していません。コンパイラはこれらのファイルを、プロバイダがバウンダリ向けに組み立てるものの隣に自ら書き出し、プロバイダには一切渡しません。そのため、そこに置かれたファイルが意味を持つかどうかは、プロバイダのターゲットの性質によります。それを読まないターゲットはファイルを含めて出荷するだけで無視し、そのファイルが持つ設定は決して反映されません。ビルドはその代わりに何かがレンダリングされる前に拒否します。

プロバイダがこれらのファイルを受け付けるかどうかは、コンパイラが保持するプロバイダのリストからではなく、サポート内容に関するプロバイダ自身の宣言から読み取られます。何にレンダリングされるかにかかわらず、どのエントリも対象になります。terraform プロバイダはこれらを受け付け、それぞれをバウンダリのルート設定の隣に書き出します。helm、compose、helm-chart、cloudformation は受け付けず、拒否されます。

拒否の判定は、すべてのコンポーネントの Recipe がバインドされ、各プロバイダが自身を記述した時点で行われます。これは最初のコンポーネントがレンダリングされる前、かつどのエントリも評価される前であるため、ここで拒否されたビルドは何もレンダリングしません。問題のある Recipe はすべて 1 回のビルドで、レンダリングするコンポーネントごとに 1 回ずつ報告されます。検出結果が複数ある場合は Recipes declaring boundary artifacts whose provider does not accept them の下にまとめられます。ビルドが解決できないプロバイダにバインドされた Recipe はここでは報告されません。そのビルドはプロバイダが選択される箇所で停止し、そのバインディングを示します。

出力されるメッセージは、編集箇所である Recipe 内の .spec.boundary に位置付けられます。カテゴリは角括弧で囲まれたヘッドで示されます。メッセージはまずプロバイダを示し、次に Recipe のレンダリング対象のコンポーネントを示します。

provider does not support boundary artifacts ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it accepts files written to a boundary’s shared output; remove the boundary block, or render the Recipe through a provider whose contract declares it(provider は境界アーティファクトをサポートしていません。この provider の契約は、境界の共有出力に書き込まれたファイルを受け入れることを宣言していません。boundary ブロックを削除するか、それを宣言する契約を持つ provider を通して Recipe をレンダリングしてください)

ヘッドにはこの条件の短縮コード E0351 が含まれます。

修正方法: boundary: ブロックを削除するか、それを受け付けるプロバイダで Recipe をレンダリングしてください。バウンダリではなくコンポーネントに属するファイルは、代わりに artifacts: のエントリとします。

At least one input kind must be present (少なくとも 1 つの入力種別が必要です)

Recipe が入力種別を 1 つも宣言していません。valuesMapping と組み合わせた source も、workload: も、artifacts: もありません。このような Recipe は出力を生成せず、レンダリング対象を持ちません。このルールは Recipe の読み込み時にチェックされます。

この形の Recipe ファイルは、まず Recipe スキーマで判定されます。スキーマはすべてのプロバイダーで source、valuesMapping、workload、artifacts のいずれかを要求するため、このルールが実行される前に、ドキュメントエンベロープのチェックが E0215 でファイルを拒否し、キーごとに 1 つのブランチを示します:

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec: no anyOf branch matched: branch[0]: validation: required: missing properties: [“source”]; branch[1]: validation: required: missing properties: [“valuesMapping”]; branch[2]: validation: required: missing properties: [“workload”]; branch[3]: validation: required: missing properties: [“artifacts”]. correct the document to match its kind’s schema(ドキュメントエンベロープの検証に失敗しました(Recipe)。spec: どの anyOf ブランチにも一致しません。ブランチ 0 には必須プロパティ “source” がありません。ブランチ 1 には必須プロパティ “valuesMapping” がありません。ブランチ 2 には必須プロパティ “workload” がありません。ブランチ 3 には必須プロパティ “artifacts” がありません。ドキュメントをその種類のスキーマに合うように修正してください)

出力されるメッセージ:

Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts(Recipe:少なくとも 1 つの入力種別が必要です。source(valuesMapping と併用)、workload、artifacts のいずれかを宣言してください)

修正方法: Recipe の記述意図に合った入力種別を追加します。ビルドがプロビジョニングしないサービス(すでに別の場所で稼働しているデータベースや API)のための Recipe は、endpoint(および省略可能な port)を持つ form: reference の workload: を宣言し、他の Recipe と同様に接続値を provides: の下に公開します。helm はこれを ExternalName Service としてレンダリングし、compose はこれに対して何もレンダリングしません。どちらの場合も、利用側は公開された値を読み取ります。

artifacts: entry keys must be unique(artifacts: のエントリキーは一意でなければならない)

Recipe が artifacts: 配下に同じキーを持つエントリを 2 つ以上宣言しています。キーは出力されるファイル名を決定します(エントリの本体がインラインで記述されているか、エントリごとの $import: で読み込まれるかにかかわりません)。キーが重複すると、同じバウンダリディレクトリに同じ名前のファイルが出力されてしまいます。

ビルドは、ドキュメントを型付きの形式にデコードする際にその Recipe を拒否し、重複したキーとそれが再出現する行を示します。この処理はエンベロープのスキーマチェックの後、形状ルールの前に実行されます。そのため、artifacts: のキーが重複する Recipe はスキーマが有効であると報告された後にこの停止を報告し、残りの形状ルールはそれについて報告しません。

修正方法: 衝突しているエントリキーのいずれかを名前変更し、各 artifacts: エントリが一意のファイル名を持つようにしてください。

Emission-time filename collision across input kinds(出力時の入力種別間でのファイル名衝突)

Recipe と FeatureRecipe は、それぞれファイルを生成する入力種別を宣言します。provider がレンダリングする source:、provider が合成する workload:、artifacts: エントリ、そしてステップが出力を行う可能性のある pipeline: です。これらはそれぞれ互いに独立して出力名を選び、それらの名前が異なることを宣言するものはありません。そのため、2 つが同じ名前でファイルを生成することがあり、その場合 2 つのうち一方しか残りません。ビルドは停止し、その出力名と、それを生成したすべてのブロックを示します。

このチェックは、出力を行うドキュメントごとに 1 回、そのドキュメント自身の出力が完了した直後、その出力がいずれかのアセンブリに加わる前に実行されます。出力を行うドキュメントは 3 つあり、それぞれ個別にチェックされます。component 自身の Recipe、attachment が component 上でバインドする FeatureRecipe、そして boundary スコープの attachment がバインドする FeatureRecipe です。これらを分けておくことで、診断が正しいドキュメントを示せます。attachment のファイルはホスト component の識別子のもとでレンダリングされるため、attachment の FeatureRecipe での衝突はホストではなくその FeatureRecipe に対して報告されます。

衝突した名前はそれぞれ別々に報告されるため、ブロックが 2 つの名前で衝突したドキュメントは両方を報告します。検出結果は、修正のために編集するドキュメントの位置で示されます。Recipe の場合は component インスタンス、attachment の場合は FeatureRecipe 自体であり、後者の検出結果は attachment も示します。component や boundary は複数の attachment をバインドすることがあるためです。

1 つのブロックが 1 つの名前で複数のファイルを出力する場合は、この停止には該当しません。それは 2 つのブロックの衝突ではなく単一の寄与元であり、1 つのブロック内での artifacts: キーの重複は、ドキュメントのデコード中に拒否されます。

出力されるメッセージ:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (入力種別間のファイル名の衝突: 2 つの入力種別ブロックが 1 つの出力名でファイルを生成しました)

FeatureRecipe での衝突には attachment も含まれます。

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>, attachment <instance>) (入力種別間のファイル名の衝突: 2 つの入力種別ブロックが 1 つの出力名でファイルを生成しました。アタッチメントも示されます)

修正方法: 管理している方の入力種別で、衝突しているファイルの名前を変更します。衝突が Workload から変換されたファイル名と artifacts: エントリの間で起きている場合、Workload から変換された名前は provider の変換の慣例に従います(例: helm では <release-name>-deployment.yaml、release 名は {{ .context.rendered_name }})。artifacts: のファイル名を、provider が合成しない名前に変更してください。

An output-label key uses a reserved namespace(出力ラベルのキーが予約済みの名前空間を使用している)

Recipe が aggrega.ai/ または app.kubernetes.io/ 配下のラベルキーを指定しています。指定箇所は、レンダリング出力にリテラルのラベルを付与するブロックである outputLabels:、または値が出力に昇格される component ラベルのキーを指定するブロックである outputComponentLabels: です。どちらのプレフィックスもプラットフォーム自身の来歴キー空間に属します。これらはビルド自身が付与するキーであり、Recipe がそれを付与すると、リソースの出所を示す空間に書き込むことになります。これらを予約することで、Recipe のラベル集合が来歴の集合と重ならないようにもなり、両者をマージする際に調整が不要になります。このルールは Recipe の読み込み時にチェックされます。

予約されるのは裸のルートのみです。独自の名前空間の内側に予約済みのルートを含むだけのキー(たとえば component.aggrega.ai/hosting)は、プラットフォームが所有しない別のキー空間であり、引き続き記述できます。

出力メッセージ。1 つの条件で両方のブロックを扱うため、その文ではどちらのブロックに記述されたかを示せません。その後のアドバイスで、入力したキーと、それを入力したブロックを引用してブロックを示します。

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-labels, at .spec.outputLabels). key "<key>" in outputLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Recipe の output-labels 制約: キーが予約済みの名前空間を使用しています。outputLabels 内のキーが予約済みの名前空間を使用しており、これらのプレフィックスはプラットフォームの来歴情報用に予約されています)

昇格ブロックに記述されたキーは、そのブロックのルール名で報告され、アドバイスでもそのブロックが示されます。

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels). key "<key>" in outputComponentLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (Recipe の output-labels 制約: キーが予約済みの名前空間を使用しています。outputComponentLabels 内のキーが予約済みの名前空間を使用しており、これらのプレフィックスはプラットフォームの来歴情報用に予約されています)

リテラルブロックのキーはソート順に、昇格ブロックのキーは記述した順にチェックされます。そのため、複数箇所でルールに違反している Recipe は、常に同じものを最初に報告します。

修正方法: キーを自身が所有する名前空間(独自のドメイン、または component.aggrega.ai/… のようなサブプレフィックス付きの名前空間)に移すか、求めている値がビルドによってすでに付与されているものであれば削除します。レンダリングされたリソースが持つ来歴キーは ../providers/well-known-annotations.md に記載されています。それらを読み取る際に Recipe での宣言は不要です。

A promoted component label is also declared literally(昇格された component ラベルがリテラルとしても宣言されている)

Recipe が 1 つのキーを outputComponentLabels: と outputLabels: の両方で指定しています。この 2 つのブロックは、異なるソースから同じラベル面に値を付与します。前者は component が持つ値を昇格し、後者は Recipe の作成者が入力した値を書き込みます。そのため、両方で指定されたキーには候補となる値が 2 つ届き、どちらが優先されるかを示すものがありません。このルールは Recipe の読み込み時、上記の予約済み名前空間のルールの後にチェックされます。そのため、両方に違反している Recipe は予約済み名前空間を先に報告します。その問題の修正は、もう一方のブロックの内容に依存しないためです。

出力されるメッセージ:

recipe output-component-labels constraint: key is also declared in outputLabels (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels.<key>). key "<key>" is promoted through outputComponentLabels and also declared literally in outputLabels; keep whichever source the label should come from and drop the other (Recipe の output-component-labels 制約: キーが outputLabels にも宣言されています。このキーは outputComponentLabels で昇格され、outputLabels にもリテラルとして宣言されています。ラベルの取得元とすべき方を残し、もう一方を削除してください)

修正方法: ラベルの値をどこから取得するかを決め、もう一方の宣言を削除します。値を component が持つものに追従させたい場合、つまり 1 つの Recipe にバインドされた 2 つの component がそれぞれ自身の値を付与するようにしたい場合は、outputComponentLabels: のエントリを残します。値が Recipe 自身のものであり、Recipe がどこにバインドされても同じである場合は、outputLabels: のエントリを残します。

FeatureRecipe shape rules(FeatureRecipe の形状ルール)

FeatureRecipe は Recipe と同じ入力種別から出力を構成し、以下の構成ルールは Recipe と同じように FeatureRecipe も制約します。このルールは FeatureRecipe の読み込み時にチェックされ、Recipe の形状に関する停止と同じ形式(ルールの文、続いて問題のあるドキュメント、ルール名、その発生箇所に対するアドバイス)で、CATALOG_ERROR タグのもとに報告されます。

ここには意図的に、少なくとも 1 つの入力種別を求めるルールはありません。これが Recipe との違いです。provider と実装対象のみを宣言する FeatureRecipe は、正当な純粋配線の attachment です。何もレンダリングせず、その効果は実装する Feature が担う接続です。injectMapping: のみを宣言するものも、同様に正当です。

A FeatureRecipe’s valuesMapping requires source(FeatureRecipe の valuesMapping には source が必要です)

FeatureRecipe が valuesMapping を宣言していますが、source を宣言していません。values mapping はオーバーレイであるため、オーバーレイ先となるチャート、モジュール、ファイルがなければ、マッピングされた値の届く先がありません。

出力されるメッセージ:

FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended)(FeatureRecipe: valuesMapping には source が必要です。valuesMapping と並べて source: ポインタを宣言してください。オーバーレイを意図しない場合は valuesMapping を削除してください)

修正方法: オーバーレイの対象として書かれた source: ポインタを追加するか、valuesMapping を削除して、アタッチメントに別の方法で処理させます。独自のファイルを出力するなら artifacts:、配信する内容を整形し直すなら injectMapping:、純粋な配線のみのアタッチメントならどちらも不要です。

A pipeline declares one step id twice (パイプラインが 1 つのステップ id を 2 回宣言している)

Recipe または FeatureRecipe が、その spec.pipeline の 2 つのステップで同じ id を宣言しています。ステップは返した出力を自身の id のもとで公開し、同じパイプラインの後続ステップはそれを .steps.<id>.outputs として読み取ります。そのため、2 つのステップが id を共有すると、後続ステップは意図したステップではなく、2 つのうち最後に公開したほうを読み取ることになります。

この規則が対象とするのは、1 つのドキュメント自身のパイプラインです。コンポーネントの Recipe と、そのコンポーネントにアタッチされた FeatureRecipes は、それぞれ別々にパイプラインを実行し、各パイプラインはステップの出力がない状態から始まります。そのため、Recipe のステップとアタッチされた FeatureRecipe のステップが同じ id を持つことは可能です。

この規則はどのスキーマでも表現できません。JSON Schema には、エントリがそのフィールドの 1 つについて一意であるリストを表すキーワードがないためです。そのため、スキーマ対応のエディタはこのようなドキュメントを受け入れ、チェックはドキュメントの読み込み時、スキーマチェックの直後に実行されます。Recipe または FeatureRecipe を読み込むすべてのサーフェスがこれを報告します。ファイル単体またはカタログ全体に対する aggrega validate、カタログを読み込むビルド、取得したエンティティを受け入れる pull、エディタの診断、そして書き込まれずに拒否されるドキュメント編集です。スキーマにも違反しているドキュメントは、まずスキーマの検出結果を報告し、それらが修正された後にこの拒否を報告します。

重複のそれぞれが個別の検出結果となり、重複した id の位置に置かれ、その id を最初に宣言したステップを行と列とともに示します。ある id が 3 回現れる場合、後の 2 つのステップはどちらも最初のステップを示します。

2 番目のステップが最初のステップの id を繰り返している FeatureRecipe に対して出力されるメッセージです。カテゴリとこの条件の短いコード E0370 は、角かっこで囲まれた先頭部分に示されます:

a pipeline declares one step id twice (FeatureRecipe, at <path>); <line>:<column>: spec.pipeline[1].id: step id "<id>" is already declared at spec.pipeline[0].id (line <line>, column <column>). give each step of the pipeline its own id, and point every .steps.<id> reference a later step makes at the step it means (パイプラインが 1 つのステップ id を 2 回宣言しています。spec.pipeline[1].id のステップ id はすでに spec.pipeline[0].id で宣言されています。パイプラインの各ステップにそれぞれ固有の id を付け、後続ステップが行う各ステップ参照を、意図したステップに向けてください)

修正方法: 2 つのステップのいずれかの名前を変更し、各 id が 1 回だけ宣言されるようにします。次に、後続の各ステップの with: と when: のテンプレートで、残した id を指す .steps.<id> 参照を確認し、それぞれを本来その出力を意図していたステップに向けます。名前の変更によって、2 つのステップの出力をそれぞれ別々に参照できるようになります。

A document declares an API version this compiler no longer reads(このコンパイラが読み取らなくなった API バージョンをドキュメントが宣言している)

ドキュメントの apiVersion 行が aggrega.ai/v1alpha1 を宣言しています。apiVersion 行を持つすべてのドキュメント種別は aggrega.ai/v1beta1 を宣言します。これはこのコンパイラが読み取る唯一のバージョンであり、以前のバージョンからの変換は行われません。ドキュメントは読み取り時に、ほかの何かがチェックされる前に拒否されます。ほかのどの検出結果も、コンパイラが読み取らないバージョンのドキュメントに関するものになるためです。

ドキュメントを読み取るすべてのサーフェスがこれを報告します。aggrega validate、ビルド、取得したエンティティを受け入れる pull、エディタの診断、そしてドキュメントの編集です。コンパイラが一度も読み取ったことのないバージョンを宣言するドキュメントは、代わりにその種別のスキーマによって E0215 で拒否されます。

Component に対して出力されるメッセージです。カテゴリとこの条件の短縮コード E0373 は、角かっこで囲まれた先頭部分に示されます:

a document declares an API version this compiler no longer reads (Component, at <path>); 1:1: apiVersion: the document declares aggrega.ai/v1alpha1, and this compiler reads aggrega.ai/v1beta1. change the apiVersion line to apiVersion: aggrega.ai/v1beta1(このコンパイラが読み取らなくなった API バージョンをドキュメントが宣言している(Component);1:1: apiVersion:ドキュメントは aggrega.ai/v1alpha1 を宣言しており、このコンパイラは aggrega.ai/v1beta1 を読み取ります。apiVersion 行を aggrega.ai/v1beta1 に変更してください)

**修正方法:**ドキュメントの apiVersion 行を apiVersion: aggrega.ai/v1beta1 に変更します。各種別のフィールドは 2 つのバージョン間で変わらないため、この行の変更だけで済みます。

A plugin declares a plugin ABI version this compiler no longer speaks(このコンパイラがサポートしなくなったプラグイン ABI バージョンをプラグインが宣言している)

プラグインがプラグイン ABI v1alpha1 を宣言しています。このコンパイラはプラグイン ABI v1beta1 のみをサポートし、ほかはサポートしないため、以前の ABI に対してビルドされたプラグインは実行されずに拒否されます。プラグインは ABI を 2 か所で示しており、いずれもこの 1 つの条件で拒否されます。ロード時にゲストが返す describe() レポートと、Plugin エンティティの spec.abiVersion で、後者はエンティティの読み取り時に、ほかの何かがチェックされる前に拒否されます。このコンパイラが一度もサポートしたことのない ABI バージョンを宣言するプラグインも、記述子チェック(E0085)または Plugin スキーマ(E0215)によって拒否されます。

ロード時のゲストに対して出力されるメッセージです。カテゴリとこの条件の短縮コード E0374 は、角かっこで囲まれた先頭部分に示されます:

plugin "<plugin>" declares abi_version “v1alpha1”, and this compiler speaks “v1beta1”; rebuild the plugin against the current plugin kit and publish it again: a plugin declares a plugin ABI version this compiler no longer speaks(プラグインが abi_version “v1alpha1” を宣言しており、このコンパイラは “v1beta1” をサポートします。現在のプラグインキットでプラグインを再ビルドし、もう一度公開してください:このコンパイラがサポートしなくなったプラグイン ABI バージョンをプラグインが宣言している)

Plugin エンティティに対して出力されるメッセージです:

a plugin declares a plugin ABI version this compiler no longer speaks (Plugin, at <path>); <line>:<column>: spec.abiVersion: the Plugin declares abiVersion v1alpha1, and this compiler speaks v1beta1. rebuild the plugin against the current plugin kit and publish it again; its Plugin entity then declares abiVersion: v1beta1(このコンパイラがサポートしなくなったプラグイン ABI バージョンをプラグインが宣言している(Plugin);spec.abiVersion:Plugin は abiVersion v1alpha1 を宣言しており、このコンパイラは v1beta1 をサポートします。現在のプラグインキットでプラグインを再ビルドし、もう一度公開してください。そうすると Plugin エンティティは abiVersion v1beta1 を宣言します)

**修正方法:**プラグインキットの現在のバージョンでプラグインを再ビルドし、もう一度公開します。このバージョンはゲストの describe() レポートに v1beta1 を書き込むため、その横に生成されるエンティティも abiVersion: v1beta1 を宣言するようになります。エンティティの行だけを編集しても十分ではありません。ゲスト自体は以前の ABI を報告し続け、ロード時に拒否されます。

An artifact carries a media type this compiler no longer reads(このコンパイラが読み取らなくなったメディアタイプをアーティファクトが持っている)

レジストリから取得したアーティファクトが、以前のバージョンが公開に使用していたメディアタイプを持っています。つまり、マニフェストのアーティファクトタイプ、その設定、またはそのレイヤーのいずれかにある、サフィックス付きの application/vnd.aggrega.<kind>.v1alpha1 です。このコンパイラは v1beta1 のメディアタイプを公開および読み取るため、アーティファクトはマニフェストの読み取り時に、その内容が何も取り込まれる前に名前を挙げて拒否されます。カタログエンティティ、プラグインとその実行可能ファイル、ドキュメントバンドルのいずれも同様です。レジストリのインデックス作成では、このようなアーティファクトは理由を示してスキップされます。Aggrega 独自の application/vnd.aggrega. 名前空間の外にあるメディアタイプがこの条件に該当することはありません。

以前のバージョンによって公開された Component に対して出力されるメッセージです。カテゴリとこの条件の短縮コード E0375 は、角かっこで囲まれた先頭部分に示されます:

"<reference>" carries media type “application/vnd.aggrega.component.v1alpha1+yaml”, and this compiler reads “application/vnd.aggrega.component.v1beta1+yaml”; publish the artifact again with the current release: oci: artifact carries a media type this compiler no longer reads(メディアタイプ “application/vnd.aggrega.component.v1alpha1+yaml” を持っており、このコンパイラは “application/vnd.aggrega.component.v1beta1+yaml” を読み取ります。現在のバージョンでアーティファクトをもう一度公開してください:oci: このコンパイラが読み取らなくなったメディアタイプをアーティファクトが持っている)

修正方法:aggrega の現在のバージョンでアーティファクトをもう一度公開します。現在のバージョンは v1beta1 のメディアタイプを書き込みます。ほかの人が公開するアーティファクトは、その人が再公開する必要があり、それまでは読み取ることができません。

A file cannot be read, or its bytes do not parse(ファイルを読み取れないか、そのバイト列を解析できない)

ビルドが読み取る必要のあったファイル、またはカタログ全体のチェックがカタログディレクトリ配下で読み取った Aggrega ドキュメントから、それを指定した、あるいは読み取ったサーフェスが利用できるものが何も得られませんでした。ディスクから読み取れなかったか、バイト列が解析されたものの正しく解析できなかったかのどちらかです。スキーマに照らして検査する内容も、配置するコンポーネントも、レンダリングするテンプレートもないため、後続の処理はこのファイルに対して一切実行されません。

この条件は形式を名指ししませんが、これは意図的です。対象となるファイルの大半は YAML として読み取られますが、Recipe の workload、values-mapping、artifact の本体は Go テンプレートのソースとして読み取られ、解析はまったく行われません。YAML を前提とする文にすると、テンプレートファイルに関する診断の冒頭で、そのファイルの形式について誤った主張をすることになります。2 つの失敗のどちらが起きたのか、どの種類のファイルで起きたのかは、文の後に続く節が示します。

ビルドの起点となるドキュメント、つまり Aggregate、Release、Manifest が最もよくある対象であり、この 3 つのいずれかが読み取られるすべての箇所でこの停止が発生します。診断は、どのドキュメントを読み取っていたか、およびその読み取り元のパスを示します。ファイルが存在しないのか不正な形式なのかは、このパスで見分けます。読み取りの失敗ではオペレーティングシステム自身の理由が引用され、解析の失敗では YAML パーサーの理由が引用されます。後者にはパーサーが処理を断念した行が含まれます。

ファイルを読み取れなかった場合に出力されるメッセージ:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>)(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。Aggregate、ファイルの読み取りに失敗)

テキストを解析できなかった場合:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>)(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。Aggregate、YAML のアンマーシャルに失敗)

読み取り中のドキュメントが Release または Manifest の場合は、Aggregate の代わりにそれが表示されます。同じ条件は、Aggregate で宣言された parameters: ブロックから読み取られるパラメーター契約も対象とします。これは、何かが補間される前に Aggregate 自身のテキストから読み取られます。

ビルドが取得できないファイルを指定する Release の parameters: { $import: … } もここで報告されます。これは両方の場合に当てはまります。パスがビルドで読み取れるファイルを指していない場合と、ファイルは読み取れたもののバイト列を解析できない場合です。対象は Release であり、節にはファイルを指していたキーが示されます:

file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to read file: <underlying reason>)(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。Release、ファイルの読み取りに失敗) file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to unmarshal YAML: <underlying reason>)(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。Release、YAML のアンマーシャルに失敗)

相対パスは、コマンドの実行場所にかかわらず、それを記述した Release(コマンドが指定した Release、またはその extends: チェーンの一つ)を含むディレクトリを基準に解決されます。そのため、コマンドラインとエディターは同じファイルを読み取ります。絶対パスはそれ自身の場所を指します。ビルドが対象とするチェックアウトのその場所にファイルがあることを確認してください。手元のマシンには存在するがバージョン管理から除外されているパラメーターファイルは、継続的インテグレーションの実行時には存在せず、これがこのエラーに遭遇する典型的なケースです。ワークスペースの外へ出るパス(ワークスペース外で指定された Release の場合は、その Release 自身のディレクトリの外へ出るパス)はまったく読み取られず、後述の「A reference to another file leads out of the directory it must stay inside(別のファイルへの参照が、留まるべきディレクトリの外へ出ている)」として報告されます。

ビルドが取得できないファイルを指定するスキーマの $import: もここで報告されます。障害が同じだからです。ディレクティブ自体は正しい形式であり、指定されたファイルからドキュメントが得られなかったということです。この場合の対象は 3 つのドキュメントのいずれかではなくカタログエンティティであるため、節には解決中だったスキーマサーフェス(spec.schema、spec.schema.values のようなその柱、または usesSchema ソケットの valueSchema)が示され、ソースポインターはディレクティブが記述された行を指します:

file load failed: the file could not be read, or its bytes did not parse. <surface>: read imported schema <value>: <the operating system's reason>(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。インポートされたスキーマの読み取り)

エンティティ自身のディレクトリをそもそも確定できないというまれな失敗の場合は read の代わりに resolve imported schema path が、ファイルは読み取れたもののそのテキストが整形式の YAML でない場合は parse imported schema が表示されます。記述したディレクティブ自体の誤り(隣に兄弟キーがある、値がパスでない、インポートした内容が解析できてもマップでない)は別の状態であり、後述の「A schema $import: cannot be applied(スキーマのインポートを適用できない)」として報告されます。

Recipe または FeatureRecipe の valuesMapping:、workload:、artifacts.<name>: のインポートもここで報告されます。理由も対処法も同じです。ディレクティブは正しい形式であり、指定されたファイルから内容が得られなかったということです。これら 3 つの本体はドキュメントではなく Go テンプレートのソースであるため、失敗し得るのは読み取りだけです。この時点では何も解析しません。節にはエンティティとパスを指定したキーが含まれ、ソースポインターはインポートされたファイル自身のパスです:

file load failed: the file could not be read, or its bytes did not parse (Recipe <name> valuesMapping file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。Recipe の valuesMapping ファイルのインポート。ファイルではなくライブラリエントリを意図した場合、参照にはフラグメントが必要です。フラグメントのない $import: はファイルパスとして読まれ、引用符のない値は # の前の空白でコメントが始まる位置で終わるため、参照全体を引用符で囲んでください) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> workload file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。Recipe の workload ファイルのインポート。ファイルではなくライブラリエントリを意図した場合、参照にはフラグメントが必要です。フラグメントのない $import: はファイルパスとして読まれ、引用符のない値は # の前の空白でコメントが始まる位置で終わるため、参照全体を引用符で囲んでください) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> artifact <key> file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、そのバイト列を解析できませんでした。Recipe の artifact ファイルのインポート。ファイルではなくライブラリエントリを意図した場合、参照にはフラグメントが必要です。フラグメントのない $import: はファイルパスとして読まれ、引用符のない値は # の前の空白でコメントが始まる位置で終わるため、参照全体を引用符で囲んでください)

ライブラリ参照とパスを見分けるのはフラグメントです。<Library>#/mappings/<entry> はライブラリに対して解決され、フラグメントを除いた同じテキストは通常の相対パスになります。プレーンな YAML の値は # の前のスペースがコメントを始める位置で終わるため、フラグメントは気付かないうちに失われがちです。そのため $import: LibBeta:1.0.0 #/workloads/Web はビルドに LibBeta:1.0.0 として届き、ビルドは Recipe の隣にその名前のファイルを探します。フラグメントを保持するには、参照全体を引用符で囲んでください。

FeatureRecipe の同じ 3 つのキーも同じ条件を報告し、同じように読み取られます。artifacts のインポートは Release のライフサイクル中に 2 回読み取られます。aggrega pull がコンテンツのピンを固定するときと、エントリがレンダリングされるときです。そのため、同じファイルが存在しない場合、2 つのうち先に到達した方でこの条件が報告されます。$import: の隣の兄弟キーや、ホストを含む oci:// 参照など、ディレクティブ自体の形の誤りは別の条件であり、それぞれの項目で報告されます。

カタログ全体に対する aggrega lint と aggrega validate もここで報告します。対象は、カタログディレクトリ配下にあって Aggrega の apiVersion(インデントなしの apiVersion: で始まり、値が aggrega.ai/ で始まる行)を宣言し、かつ読み取れない、解析できない、またはチェックが読み取るエンベロープにデコードできない(リストとして書かれた metadata など)ドキュメントです。これを指すパスを書いた作成者はいません。カタログディレクトリにあるため、チェックがそれを読み取ったのです。各チェックは停止する前にすべてのファイルを読み取るため、1 回の実行でそのようなドキュメントがすべて示され、それ以外は何もチェックせず、サマリーも出力しません。Aggrega の apiVersion を宣言していない YAML(Helm チャートのテンプレートを含む)は読み飛ばされます。ヘッダーにはドキュメントの数とそのファイルが示され、その下に各ドキュメントが、読み取りまたはパーサー自身の理由とともに列挙されます。

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path>(カタログディレクトリ配下の複数のドキュメントが Aggrega の apiVersion を宣言していますが読み込めなかったため、何もチェックされませんでした) file load failed: the file could not be read, or its bytes did not parse (catalog document, failed to unmarshal YAML: <the parser's reason>)(ファイルの読み込みに失敗しました: ファイルを読み取れなかったか、バイト列を解析できませんでした(カタログドキュメント、YAML のアンマーシャルに失敗))

解析はできるがデコードできないドキュメントでは、末尾が failed to decode the envelope: とその行、およびデコーダーがそこで見つけたもの(リストとして書かれた metadata なら line 4 (metadata): a list is written where a map is expected)になり、読み取れなかったファイルでは failed to read file: とオペレーティングシステムの理由になります。読み込めても、どのカタログも保持しない種類を宣言しているドキュメントは、同じ停止によって示され、同じ先頭部分で数えられ、それ自身の条件のもとで挙げられます。後述の「A catalog document declares a kind a catalog does not hold (カタログドキュメントが、カタログが保持しない種類を宣言している)」を参照してください。

対処法: ドキュメント名ではなく、メッセージ内のパスを確認してください。参照が予期しない場所に解決された場合、この 2 つは異なります。読み取りの失敗の場合は、そのパスにファイルが存在すること、パスが参照元のドキュメントの記述どおりに綴られていること、ビルドにそのファイルの読み取り権限があることを確認してください。ローカルには存在し、ビルドエージェントのチェックアウトには存在しないファイルがよくあるケースです。解析の失敗の場合は、パーサーが示した行でファイルを開いてください。コロンを含む引用符なしの値、インデントに使われたタブ、誤ったキーの下にインデントされたリスト項目の 3 つが、その大半の原因です。

A catalog document declares a kind a catalog does not hold (カタログドキュメントが、カタログが保持しない種類を宣言している)

カタログディレクトリ配下のドキュメントが、Aggrega の apiVersion(インデントなしで apiVersion: から始まり、値が aggrega.ai/ で始まる行)と、どのカタログも保持しない kind を宣言しています。たとえば Componnent のような綴りの誤り、component のように大文字・小文字が誤っている種類、あるいは kind がまったくない場合です。カタログは各ドキュメントを、それが宣言する種類のもとに収めるため、このようなドキュメントはどのカタログにも入りません。ビルド、inspect、そしてカタログを読み込むその他すべてのコマンドはこれを読み飛ばし、そのドキュメントが宣言するはずだったエンティティへの参照は何にも解決されません。

カタログが保持するのは、Component、Feature、Recipe、FeatureRecipe、SchemaLibrary、MappingLibrary、WorkloadLibrary、ArtifactLibrary、Aggregate、Plugin のドキュメントです。それ以外に 3 つの種類が正当にそのディレクトリに置かれることがあり、ここで報告されることはありません。エンティティと並べて置かれた Manifest と Release、そしてそれをインポートする Recipe または FeatureRecipe のディレクトリにある Workload です。

カタログ全体を対象とする aggrega validate と aggrega lint、および同じディレクトリをたどる Release スコープの lint がこれを報告します。いずれも停止する前にすべてのファイルを読み込むため、1 回の実行で、そのようなドキュメントすべてを、まったく読み込めないドキュメントとともに、それらを数えてファイルを挙げる 1 つの先頭部分の下に示します。何も検査されず、サマリーも出力されません。各ドキュメントは宣言している種類とともに挙げられ、その行はカタログが保持する種類で締めくくられます:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (カタログディレクトリ配下の複数のドキュメントが Aggrega の apiVersion を宣言していますが読み込めなかったため、何も検査されませんでした) catalog document declares a kind a catalog does not hold (kind “Componnent”). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directories (カタログドキュメントが、カタログが保持しない種類を宣言しています。カタログは Component、Feature、Recipe、FeatureRecipe、SchemaLibrary、MappingLibrary、WorkloadLibrary、ArtifactLibrary、Aggregate、Plugin のドキュメントを保持し、Workload、Manifest、Release は読み飛ばします。種類を修正するか、ファイルをカタログディレクトリの外に移動してください)

種類を何も宣言していないドキュメントでは、kind "<kind>" の代わりに no kind となります。

ビルドはこのようなドキュメントで停止しません。すべての読み込みと同様にそれを読み飛ばし、どの Release からも到達されないドキュメントがビルドを失敗させることはありません。Release がそのエンティティに実際に到達する場合、ビルドはその参照の時点で、後述の「A reference names no entity the catalog holds (参照がカタログの保持するどのエンティティも指していない)」として停止し、そのファイルが参照の求める名前を宣言していれば、その失敗の下の注記がそのファイルを示します。該当する項目を参照してください。

修正方法: メッセージが示すファイルを開き、その kind を、そのドキュメントの実際の種類に修正します。綴りと大文字・小文字はどちらも区別されます。そもそもカタログエンティティではないファイルは、カタログディレクトリ配下に置くべきではありません。外に移動するか、別のツールのドキュメントであれば Aggrega のものではない apiVersion を付けてください。

A path names content outside the entity’s own directory(パスがエンティティ自身のディレクトリ外のコンテンツを指している)

エンティティのコンテンツはエンティティ自身のディレクトリに置かれます。エンティティのパブリケーションが運ぶすべてのファイルはそこから取得されるためです。そこから出るパスは、エンティティと一緒に運ばれないファイルを指します。そのため、エンティティを受け取った人にとってそのファイルは存在せず、それに対して記録されたピンは、受け取った人が入手できないバイト列を保証することになります。

そのため、エンティティが自身の運ぶコンテンツのために書くすべてのパスは、エンティティのファイルを含むディレクトリを基準に読まれ、その内側にとどまる必要があります。対象となるのは、Recipe および FeatureRecipe の source:(単純なパス、または構造化形式の url:)、各 valuesMapping:、workload:、artifacts: エントリが $import: でインポートするファイル、そして Component または Feature がインポートするすべてのスキーマ(全体、ピラーごと、または usesSchema ソケットの valueSchema と infraSchema 用)です。ディレクトリから出る形は 3 つあります。ディレクトリより上へ遡るパス、絶対パス(書かれたマシン上の場所を指します)、そしてディレクトリ内に書かれていても途中のシンボリックリンクによってディレクトリ外へ運ばれるパスです。最後のものは、パス上のディレクトリ、またはパス末尾のファイルが、エンティティのディレクトリ外へ通じるリンクである場合を指します。遡ってから内側に戻るパス(./charts/../values.tmpl)はディレクトリ内の通常のパスであり、ディレクトリ内の別の場所へ通じるリンクを経由するパスも同様です。ディレクトリ自身の名前で再び入る遡り(1.0.0 というディレクトリ内で書かれた ../1.0.0/values.tmpl)は拒否されます。ディレクトリの名前は運ばれるものに含まれないためです。公開されたエンティティは、利用者のキャッシュが名前を付けたディレクトリから読まれ、そこではその名前では何も見つかりません。外へ通じるリンクを経由するパスが拒否されるのは、そうしなければパブリケーションが、リンクの指すバイト列を、指す先がどこであってもエンティティ内の名前のもとで運んでしまうためです。

エンティティが読まれる場所ではどこでも拒否されます。 カタログ全体に対する aggrega validate、エンティティ自身のファイルに対する aggrega validate、aggrega pull、aggrega build は、エンティティのファイルを読む時点でこれを拒否します。Recipe または FeatureRecipe に対する aggrega pin と、4 種類いずれかに対する aggrega push も同様に、何かを取得、書き込み、公開する前に拒否します。テンプレートとして書かれた source: はビルドが評価するまで何も指さないため、ディレクトリ外のパスを生成するテンプレートは、値が存在する時点でビルドによって拒否されます。

Release は異なり、エンティティ参照も異なります。 Release は他のエンティティ(その Aggregate、その Manifest、拡張元の Release)を指し、公開されることはないため、Release が読むものはどこにも運ばれません。それらのパスと、Release の parameters: がインポートするファイルは、書かれたとおりに読まれます。Aggregate の type は、Aggregate が運ぶコンテンツではなく、識別子によって別のエンティティを指すものであり、これも独自の規則で解決されます。解決はカタログディレクトリ、キャッシュ、レジストリを通じて行われ、ファイルパスとして扱われることはありません。

出力されるメッセージ(書かれたとおりのパスを示します):

a path names content outside the entity’s own directory ("<path>"). remediation: move the file into the directory holding the entity, or a directory beneath it, and name it with a path relative to that directory. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a path that leaves it points at a file that would not travel with the entity(パスがエンティティ自身のディレクトリ外のコンテンツを指しています。対処:ファイルをエンティティを含むディレクトリ、またはその配下のディレクトリに移動し、そのディレクトリからの相対パスで指定してください。エンティティのコンテンツはエンティティ自身のディレクトリに置かれます。パブリケーションが運ぶすべてのファイルはそこから取得されるためです。そこから出るパスは、エンティティと一緒に運ばれないファイルを指します)

また、リンクによってディレクトリ外へ運ばれるパスの場合は、リンクとその行き先を示します:

a path names content outside the entity’s own directory ("./frag/fragment.yaml", the link <entity-directory>/frag leads to <elsewhere>/frag). remediation: replace the link with a copy of what it leads to, placed inside the directory holding the entity. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a link leading out of it would carry the bytes it points at under a name inside the entity(パスがエンティティ自身のディレクトリ外のコンテンツを指しています。対処:リンクを、その行き先のコピーに置き換え、エンティティを含むディレクトリ内に配置してください。エンティティのコンテンツはエンティティ自身のディレクトリに置かれます。パブリケーションが運ぶすべてのファイルはそこから取得されるためです。外へ通じるリンクは、その指すバイト列をエンティティ内の名前のもとで運んでしまいます)

読み取り元のフィールドは、メッセージの上の行に示されます:resolve Recipe source …、resolve Recipe artifact "<key>" $import target …、spec.schema.values: imported schema …、またはテンプレート化された source の場合は node "<name>" source。

修正方法: ファイルをエンティティのディレクトリ、またはその配下のディレクトリに移動し、そのディレクトリからの相対パスを書きます。リンクによってパスが外へ出る場合は、リンクを、その行き先のコピーに置き換えてエンティティのディレクトリ内に置きます。複数の Recipes が共有するチャートは、各 Recipe が個別に公開されるため、各 Recipe のディレクトリにコピーします。複数の Components が共有するスキーマは SchemaLibrary に置き、各 Component がそれを ID で参照します。複数の Recipes が共有するマッピング、ワークロード、アーティファクトの本体は、対応するライブラリの種類に置きます。

Recipe の source: が、取得方法を誰も知らない種類を指定している

Recipe の source: は、それが指すものの種類(チャート、モジュール、compose プロジェクトなど)を示し、各種類はその種類を扱うソースアダプターによって取得されます。この条件は、どのソースアダプターも扱わない種類を報告します。そのため、このプログラムに含まれるものはどれもそのソースを取得できません。FeatureRecipe の source: にも同じルールが適用されます。

これはドキュメントの読み込み時、何かが取得される前に拒否されます。Recipe 単体のチェックでも拒否され、それに到達するすべての Release でも拒否されます。試行できるものが何もなかったため、何も試行されていません。この点が、実行されたうえで失敗した取得との違いです。

ドキュメント、記述された種類、扱われる種類を示す、出力されるメッセージ:

no source adapter serves the source kind (Recipe <name>:<version>, rule source-kind, at <file>). the source names kind "<kind>"; name a kind a source adapter serves (<the served kinds>), or write the source as a single URI whose shape names its kind(このソース種別を扱うソースアダプターがありません(Recipe、ルール source-kind)。ソースはこの種別を指定しています。ソースアダプターが扱う種別を指定するか、形から種別がわかる単一の URI としてソースを記述してください)

修正方法: source: の種類を、ツールチェーンが扱えるものに修正してください。綴りの誤りと、本当にアダプターのない種類は同じメッセージになり、メッセージには記述された種類が扱われる種類と並べて引用されます。そのため、まずその一覧と照らして綴りを確認してください。この一覧は Recipe のページ にも記載されています。意図どおりに綴られている場合、その種類はこのビルドが取得できるものではなく、Recipe の記述をどう変えても取得できるようにはなりません。代わりに、扱われる形式を source: に指定するか、形から種別がわかる単一の URI として記述してください。

No source adapter is registered in this program for a source kind(このプログラムにはソース種別に対応するソースアダプターが登録されていない)

ソースは、その種類に対して登録されたアダプターによって取得されます。この条件は、アダプターが登録されていない種類に対してディスパッチされた取得を報告します。どのアダプターも扱わない記述上の種類は、その Recipe の読み込み時に拒否されるため(前述の「A Recipe’s source: names a kind nothing knows how to acquire(Recipe のソースが取得方法の存在しない種類を指定している)」を参照)、作成者が書くものはここには到達しません。この条件が報告するのは、扱う種類のアダプターを含めずに組み立てられたプログラム、または Aggrega の Go パッケージ上に構築され、自ら組み立てた種類をディスパッチするプログラムです。

種類を示す、出力されるメッセージ:

kind "<kind>": no source adapter is registered in this program for the source kind(このプログラムにはこのソース種別に対応するソースアダプターが登録されていません)

修正方法: エンティティファイルの内容が原因ではありません。実行しているバイナリをビルドした人に報告してください。

A source URL carries a credential(ソース URL に認証情報が含まれている)

ソースの url は、書かれたとおりに記録されます(Release のロックファイル、Recipe の横にある entity.lock、ソースキャッシュ)。また Recipe 自体もコミットし、公開することもあるファイルです。そのため URL に書かれた認証情報は、URL が渡るあらゆる場所に運ばれてしまいます。この条件は、Recipe の source: の url がホストの前にユーザーを書いている場合を報告します。https://user:token@host/… や、https://token@host/… のようにトークンだけを書いた場合です。HTTP 経由で到達するサービスは、ユーザーの位置にトークンを受け取ることが一般的だからです。http と https では、そこに書かれたユーザーはすべて対象になります。それ以外のスキームではパスワードのみが対象です。そこに単独で書かれたユーザーはアカウントを示すからです。ssh://git@github.com/… は受け入れられ、SSH エージェントが鍵を提供します。FeatureRecipe の source: にも同じルールが適用されます。

これはドキュメントの読み込み時、何かが取得される前に拒否されます。Recipe 単体のチェックでも拒否され、検証、pull、pin、ビルドのいずれにおいても、それに到達するすべての Release で拒否されます。メッセージはホストを示しますが、認証情報は決して示しません。チェックは URL のうちホストより前に書かれた部分だけを読み取るため、クエリ文字列やパスに含まれるトークンは検出されず、URL の他の部分と同様に書かれたとおりに記録されます。

http または https の場合に出力されるメッセージ。ドキュメント、キー、ホストを示し、続いて認証情報を置くべき場所を示します:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a user or password for host <host>; remove it from the URL and write the credential in the netrc file instead, as an entry “machine <host> login <user> password <secret>” (the file NETRC names, else .netrc in your home directory, or _netrc in %USERPROFILE% on Windows)(ソース URL に認証情報が含まれています(Recipe、ルール source-url)。spec.source.url がこのホストのユーザーまたはパスワードを指定しています。URL から削除し、代わりに machine、login、password のエントリとして netrc ファイルに認証情報を書いてください(NETRC が指すファイル、なければホームディレクトリの .netrc、Windows では %USERPROFILE% の _netrc))

それ以外のスキームでは、対処はパスワードの削除です:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a password for host <host>; remove it from the URL, which is written into the lockfile and the cache as authored(ソース URL に認証情報が含まれています(Recipe、ルール source-url)。spec.source.url がこのホストのパスワードを指定しています。URL は記述どおりにロックファイルとキャッシュに書き込まれるため、URL から削除してください)

修正方法: url からユーザーとパスワードを削除し、ホストを示す URL だけを残します。http または https で取得するソースの場合は、netrc ファイルにそのホストの machine エントリとして認証情報を記述します。このファイルは、従来型の Helm チャートリポジトリ、compose フラグメント、HTTP または HTTPS 経由の Git リポジトリを取得するたびに読み取られます。どのファイルのどのエントリかは 認証 で説明しています。SSH 経由の Git リポジトリでは SSH エージェントが鍵を提供し、ユーザーはそのまま残してかまいません。認証情報を含んだまま Recipe をすでにコミットまたは公開している場合、認証情報はその履歴に残っています。サーバー側でも認証情報を変更してください。

A {{ .parameters.* }} reference cannot be interpolated (このパラメータ参照を補間できない)

Aggregate のテキストはドキュメントとして読み込まれる前にテンプレートとして評価され、{{ .parameters.<key> }} 参照は Release がそのキーに指定した値に置き換えられます。この停止は、その評価を完了できない場合に発生します。つまり、テキストがテンプレートとしてパースできない場合、またはパースできても実行中に失敗した場合です。

補間は Aggregate が YAML としてパースされる前に行われます。そのため、ここでの不具合は Aggregate 内のキーではなく Aggregate 全体に対して報告されます。この時点では、ドキュメントにはまだキーが存在しないからです。参照を引用符で囲まずに書けるのも同じ理由です。置換は生のバイト列に対して行われ、その後 YAML 自身の引用規則が値の型を決めるため、引用符なしの参照は値本来の型になり、引用符付きの参照は文字列になります。

Release が指定していないキーを指す参照は、この停止には該当しません。存在しないキーはここでは空の値に解決され、その型と契約は上記の「Parameter type mismatch / contract violation(パラメータの型不一致/契約違反)」で説明するパラメータチェックによって検出されます。この停止が報告するのは、テンプレートエンジンがまったく処理できなかったテキストです。閉じられていない {{、綴りを誤った関数名、ステージどうしが噛み合わないパイプラインなどがこれにあたります。Release が該当するパラメータを指定していないときに index でパラメータを読み取る場合({{ index .parameters "db_size" }})は実行中の失敗であり、この停止がそのキーを示して報告します。下記の「A template indexes a map with a key the map does not hold(テンプレートがマップに存在しないキーでマップを参照する)」で説明するとおり、index はどのテンプレートサーフェスでも、マップに存在しないキーに対して停止します。

まったくパースできないテキストは、Aggregate 自身のパスを示して拒否されます。そのファイルは、何かが読み込む前から手元にあるためです。コンポジションがインポートするモジュールも、1 段階内側で同じように評価されます。その場合、モジュールのテキストはビルドに渡されるのではなくカタログから読み込まれます。どちらの場合もこの停止は同じ条件であり、同じコードを持ちます。モジュールの場合は、たどっていたインポートと、モジュールのテキストを読み込んだファイルも示されます。また、停止が含むメッセージは種類だけを示すため、そのメッセージが示す位置はモジュール自身のテキスト内の位置であり、起点とした Aggregate 内の位置ではありません。

出力されるメッセージ。パースできないテンプレートの場合、コンポジションがインポートするモジュールで同じ不具合が起きた場合、実行中に失敗したテンプレートの場合の順です。

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>)

Aggregate のテキストのルートは .parameters の 1 つだけです。そのため、それ以外を通じた参照({{ .values.app_token }} や {{ $.values.app_token }})は何も読み取らず、実行中に失敗します。このとき、理由の冒頭には読み取った参照が示されます:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, the template reads <reference>, and an Aggregate’s text defines no root but .parameters; template execution error: <underlying reason>)(無効なパラメータ参照です: parameters の式が宣言済みのパラメータを指し、Go テンプレートとして解析できることを確認してください(Aggregate、テンプレートがこの参照を読み取っていますが、Aggregate のテキストには .parameters 以外のルートがありません。テンプレート実行エラー))

修正方法: Aggregate を開き、根本原因を確認します。根本原因には、テキスト内の位置と失敗した構文が示されています。すべての {{ に対応する }} があること、呼び出した関数がそのサーフェスで提供されているものであること(パラメータ補間で提供されるのは Sprig の関数だけであり、optional ヘルパーはここでは使用できません)、そしてパイプラインの各ステージが前のステージの出力を受け取れることを確認します。根本原因に index が見つけられなかったキーが示されている場合は、未設定の可能性があるパラメータをドット({{ .parameters.db_size }})で読み取るか、Sprig の get または hasKey で読み取ります。別のルートを通じた参照が示されている場合は、その値を Aggregate のパラメータとして宣言し、{{ .parameters.<key> }} として読み取ります。n8n の式に由来する undefined variable "$json" や、Flowise のノード名を持つ関数など、テンプレートとして意図していないものが示されている場合は、テキスト自体が(コメント内も含めて)二重波括弧を含んでいます。独自の二重波括弧を含むテキストで説明するとおり、その中の各 {{ を {{"{{"}} と書きます。

The Release directory declares one Aggregate or Manifest twice(Release ディレクトリで 1 つの Aggregate または Manifest が 2 回宣言されている)

aggregate: または manifest: の参照が素のアイデンティティである Release は、まず Release 自身のディレクトリを走査して解決されます。この走査で、同じ metadata.name を持つ 2 つの Aggregates(または 2 つの Manifests)が見つかりました。素のアイデンティティによる参照はその名前でエンティティを指定するため、2 回宣言された名前に対してディレクトリは答えを出せません。

走査は、参照が求めた名前だけでなく、ディレクトリ全体を拒否します。 走査は Release と同じ場所にあるすべての Aggregate とすべての Manifest を読み込むため、どちらの参照も指していない衝突ペアでもビルドは停止します。この Release がそのエンティティを読み込もうとしていたかどうかにかかわらず、ディレクトリが曖昧だからです。パスとして書かれた参照(./aggregate.yaml、../shared/manifest.yaml)はエンティティではなくファイルを指し、走査なしで解決されます。そのため、aggregate: と manifest: の両方がパスである Release では走査は実行されません。

これはカタログの識別子重複による拒否に対応する、同一ディレクトリ版です。2 つは別々に報告されるため、メッセージは意識していなかったかもしれないカタログ階層ではなく、作業中のディレクトリを示します。

出力されるメッセージ:

duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory>

2 つの Manifests が衝突する場合は、Aggregate の代わりに Manifest が表示されます。

修正方法: 2 つのエンティティのどちらかに別の metadata.name を付けるか、Release のディレクトリの外へ移動します。同じ名前の異なる Aggregates を実際にデプロイする 2 つの Releases は、それぞれ専用のディレクトリに置くべきです。Release を兄弟ファイルにコピーし、その内容の名前を変更しないままにすることが、この問題が起きる典型的な原因です。

A Release’s aggregate: or manifest: reference resolves to nothing (Release の参照が何にも解決されない)

Release が裸の識別子で Aggregate または Manifest を指していますが、裸の識別子を検索するどのサーフェス(Release 自身のディレクトリ、カタログ、レジストリ)でも、その名前のエンティティが見つかりませんでした。

どこにも一致するものがなかった場合に出力されるメッセージ:

aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry

Release のディレクトリにインデックス化できなかったファイルがある場合、報告内容が変わります。正直に主張できる内容が変わるためです。そのようなファイルが目的のエンティティだった可能性があるため、メッセージは確認できない不在を断言せず、その旨を述べ、読み込みを妨げたパース失敗を含めます。

aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure>

また、参照が直接指しているファイルがパースできないファイルである場合:

aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure>

修正方法: 参照先が実際に存在しない場合は、綴りを修正します(識別子はエンティティの metadata.name であり、ファイル名ではありません)。あるいは、Release のディレクトリまたはビルドが読み込むカタログにエンティティを追加します。メッセージがパースできないファイルを示している場合は、まずそのファイルを修正します。パース失敗はメッセージに引用されており、それを修正すると同じ編集で参照も解決されることがよくあります。./ または ../ で始まる参照は識別子ではなくパスであり、パスとして解決されます。そのため、先頭のドットの有無によって、どちらの誤りを探すべきかが変わります。

A component is placed in more than one boundary(コンポーネントが複数のバウンダリに配置されている)

Release のバウンダリツリーが、1 つのコンポーネントを 2 つの異なるバウンダリに配置しています。2 つの配置はマージも順位付けもされず、それは原理的に不可能です。コンポーネントのバウンダリは、その出力の書き込み先、配置されるサブディレクトリ、参加する sync wave、継承するバウンダリアノテーションとバウンダリインフラを決定しますが、エッジごとの uses: サーフェスは別の走査で読み取られます。2 回指定されたコンポーネントは、出力場所を一方の配置から、エッジごとの設定をもう一方の配置から取ることになってしまいます。

バウンダリがコンポーネントを配置する方法は 3 つあり、そのすべてが対象になります。 components: の直下で、コンポジション完了後に持つ id によってコンポーネントを指定すると、そのコンポーネントが配置されます。ルーティングエントリ自身の components: の中で、そのサブモジュール内で持つローカル名によって指定しても配置されます。さらに、aggregates: の下でサブモジュール全体をルーティングすると、そのモジュールに含まれるすべてのコンポーネントが配置されます。したがってこの停止は、1 つのサブモジュールが 2 つのバウンダリにルーティングされる場合、あるモジュールが 1 つのバウンダリに、その中にネストされたモジュールが別のバウンダリにルーティングされる場合、そしてコンポーネントがあるバウンダリで指定され、それを含むモジュールが別のバウンダリにルーティングされる場合も対象とします。

モジュールをあるバウンダリにルーティングし、さらにその 同じ バウンダリの下でそのコンポーネントの 1 つを指定することは競合ではなく(両方の配置がコンポーネントの所属先について一致しているため)、ビルドは成功します。ただし、1 つのバウンダリの下で同じ id を 2 回書くことは、その場合でも競合です。バウンダリの components: 内のエントリと、そのバウンダリのルーティングエントリ内にある同じコンポーネントのエントリは、1 つのコンポーネントに対して設定を持つ 2 つのエントリであり、どちらを選ぶかの根拠がありません。

違反しているすべての配置が報告されます。 複数のコンポーネントを二重に配置している Release は、1 回のビルドで違反エントリごとにこの停止を 1 つずつ出し、それぞれが対象エントリのキーの位置で報告されます。したがって、複数の報告は同じ不具合が何度も書き出されたものではなく、1 回のビルドが見つけたものをすべて挙げているものです。

メッセージが既に有効な配置として報告するものは、必ずしもファイル内で最初に書かれたものとは限りません。バウンダリ自身の components: エントリは、そのルーティングエントリが指定するコンポーネントやルーティングするサブモジュールより先に読み取られ、バウンダリはその中にネストされたバウンダリより先に読み取られます。並列に書かれたバウンダリは出現順に読み取られます。先行する配置が複数競合する場合は、最初に読み取られたものが示されます。どちらの順序であっても両方の箇所が示され、どちらかが優先されることはありません。

出力されるメッセージです。文はルールを述べ、その後に違反エントリ、2 つの配置それぞれが属するバウンダリ、それぞれが書かれたブロック、両方を含むファイルが示されます。あるバウンダリの components: 下のエントリが、別のバウンダリの同ブロック下の先行エントリと衝突する場合:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, "<component>", named in the components block of boundary "<boundary-b>", while it is already named in the components block of boundary "<boundary-a>", that earlier entry naming "<component>", both declared in "<path>")(コンポーネントが複数のバウンダリで宣言されています: 各コンポーネントはちょうど 1 つのバウンダリで宣言してください)

バウンダリを示す 2 つの節は、各エントリが書かれたブロックに応じた文言になります。違反エントリには次のいずれかが使われます:

  • named in the components block of boundary "<boundary>" — バウンダリ自身の components: マップ。
  • named inside a routing entry in boundary "<boundary>" — そのバウンダリの aggregates: 下にあるルーティングエントリの components: マップ。
  • routed as a sub-module into boundary "<boundary>" — ルーティングエントリそのもの。

先行する配置には、同じ文の続きとして次のいずれかが使われます:

  • while it is already named in the components block of boundary "<boundary>"。
  • while it is already named inside a routing entry in boundary "<boundary>"。
  • while it is already placed by a sub-module routed into boundary "<boundary>"。

2 つの節は独立に選ばれるため、どの組み合わせも現れ得ます。また that earlier entry naming には、先行する配置が指していたもの、つまりコンポーネントの id、あるいはルーティングされたサブモジュールが配置した場合はそのサブモジュールのプレフィックスが入ります。

違反エントリがルーティングエントリそのものである場合、それが指すのは単一のコンポーネントではなくサブモジュールであり、メッセージはモジュールプレフィックスをコンポーネント名として示すのではなく、そのことを明示します。以下は、別のバウンダリにルーティングされた先行サブモジュールと衝突する例です:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, sub-module "<module>", routed as a sub-module into boundary "<boundary-b>", while it is already placed by a sub-module routed into boundary "<boundary-a>", that earlier entry naming "<module>", both declared in "<path>")(コンポーネントが複数のバウンダリで宣言されています: 各コンポーネントはちょうど 1 つのバウンダリで宣言してください)

修正方法: 2 つの配置のうち、意図していない方を削除します。メッセージは両方を示すので、選択はコンパイラではなく作成者に委ねられます。直接の宣言とルーティングされたモジュールが食い違う場合は、コンポーネントをモジュールと一緒に置くか単独で置くかを決めます。モジュールをルーティングするとモジュールに含まれる他のすべてと一緒に配置され、直接指定するとそれらから切り離されます。2 つのルーティングエントリが 1 つのモジュールを指定している場合は、意図していないルーティングを削除します。モジュールをバウンダリにルーティングすると、含まれるすべてのコンポーネントがそこに配置されるため、そのようなエントリが 2 つあると同じコンポーネント群を指定することになります。

A Manifest annotation binding claims the reserved aggrega.ai/ prefix(Manifest のアノテーションバインディングが予約済みのプレフィックスを使用しています)

Manifest が、素の aggrega.ai/ プレフィックスで始まるキーでアノテーションバインディングを宣言しています。このプレフィックスはビルドが自ら出力するキーを付与する場所であるため、その中のキーを使うバインディングは、作成者のルーティングとプラットフォーム自身の出力を 1 つのキー空間に置き、同じ名前を奪い合わせることになります。

これは停止であり、警告にはなり得ません。 この予約こそが、そのキー空間をプラットフォームのものにしている唯一の要素です。バインディングを受け入れて後から指摘するだけでは、衝突がビルドに残ってしまいます。

このルールは作成されたバインディングが使用するキー空間に関するものなので、提示された Manifest がバインディングを宣言していないキーは報告されずに読み飛ばされます。違反となるバインディングが存在しないためです。

出力されるメッセージです。違反キーは文の主題であるため先頭に置かれ、その後の値はそれぞれ何であるかを示す語で導入されます:

manifest annotation binding uses reserved prefix (Manifest, at <field-path>, "<key>", reserved prefix "aggrega.ai/", routing to Feature "<feature-uri>", author the binding under a domain of your own such as "feature.<your-domain>/")(Manifest のアノテーションバインディングが予約済みプレフィックスを使用しています)

修正方法: バインディングキーを、自分が管理する名前空間に変更します。サブプレフィックス付きのキーはサポートされた形式であり、予約されていません。標準ライブラリのショートカットには feature.aggrega.ai/…、エンタープライズ用には独自ドメイン(acme.aggrega.ai/…、compliance.example.com/…)を使用します。キー名を変更すると、バインディングを発動させるために作成者がコンポーネントに書く内容が変わるため、それを使用しているアノテーションも同じ編集で更新してください。素のプレフィックス下にあるプラットフォーム自身のキーは ../providers/well-known-annotations.md に一覧があります。

Two Manifest annotation bindings compete for one routing slot(2 つの Manifest アノテーションバインディングが 1 つのルーティングスロットを奪い合う)

1 つの Manifest 内の 2 つのアノテーションバインディングが、同じ Feature へ、同じピラーを通じて、同じパスでルーティングしています。バインディングの役割はアノテーションの値がどこに配置されるかを示すことであり、1 つの宛先を指す 2 つのバインディングがあると、値には 2 つのルートがあり、展開時にどちらかを選ぶ手段がありません。

対象の Feature ごとに、特定のパスとピラーの組を宣言できるバインディングは 1 つだけです。同じ Feature を異なるパスで対象とする 2 つのバインディングは通常の記述であり、ビルドされます。同じパスを 2 つの異なる Features へルーティングする 2 つのバインディングも同様です。

バインディングは Manifest が宣言した順に走査されるため、メッセージが最初に挙げるバインディングは常にドキュメント内で先に書かれたものです。

出力されるメッセージ:

manifest annotation bindings collide on same Feature path+pillar (Manifest, at <path>, annotation bindings "<first-key>" and "<second-key>" both target Feature "<feature-uri>" with path "<path>" routing to pillar "<pillar>"; only one binding may declare a given (path, pillar) pair per Feature)(Manifest アノテーションバインディングが同じ Feature のパスとピラーで衝突しています)

修正方法: どちらのバインディングが宛先を所有するかを決め、もう一方の maps.infra または maps.values リストからそのパスを削除するか、2 つ目のバインディングを完全に削除します。2 つのアノテーションキーを 1 つの Feature フィールドに届けたくて 2 つのバインディングがある場合は、バインディングを 1 つ残し、両方のアノテーションキーをそれを通じてルーティングします。2 つの異なる値を 2 か所に配置するつもりだった場合は、誤って書いたほうのパスを修正します。

A Release reached resolution without passing through the load path(Release がロードパスを経由せずに解決に到達した)

Release が、空でないトップレベルの components: サーフェスと、合成された default バウンダリの両方を持ったまま解決に到達しました。この組み合わせは、通常どおりロードされた Release からは生じません。ロードパスはトップレベルの components: ブロックをデフォルトバウンダリに畳み込んでクリアし、両方を明示的に記述したドキュメントはここに至る前にスキーマによって拒否されます。

したがって、この停止は記述した内容について報告するものではありません。何かがロードパスを迂回して解決に到達したこと、最も多いのは、ファイルから読み込まれたのではなく組み込みプログラムによってメモリ上で構築された Release であることを報告し、2 つのコンポーネントサーフェスが食い違うドキュメントでビルドを続行させずに、そこで停止します。どちらの順で読んでも、コンポーネントを暗黙に欠落させるか重複させる出力が生じ、しかもバウンダリの走査とエッジごとの走査とでは、どれがそうなるかについて互いに一致すらしません。

出力されるメッセージ:

release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary): construct releases through the normalization core (types.NormalizeRelease via the load path), not a hand-built literal(Release が正規化されないまま解決に到達しました(空でないルートの components と合成されたデフォルトバウンダリが併存):手作業で組んだリテラルではなく、正規化コア(ロードパス経由の types.NormalizeRelease)を通じて Release を構築してください)

修正方法: YAML を記述している場合は何もする必要はありません。aggrega build、aggrega validate またはエディタからこの停止に至った場合はコンパイラに報告すべき不具合があることを意味し、ビルドしていた Release に問題はありません。コンパイラを組み込み、独自のコードで Release の値を構築している場合は、構造体を直接組み立てるのではなくロードパスを通じて構築し、ルートのコンポーネントをデフォルトバウンダリに畳み込む正規化が実行されるようにします。

A library reference expands into itself(ライブラリ参照が自分自身に展開される)

ドキュメント間の参照チェーンが、すでに到達したドキュメントに戻ってくるため、展開が終わりません。2 つの記述サーフェスがこの状態に至り、どちらも 1 つのファイル内のものではなくライブラリエンティティ間のチェーンです。スキーマピラーから SchemaLibrary のエントリへの $ref: で、そのエントリが参照をたどって戻ってくるもの、および MappingLibrary または WorkloadLibrary のエントリへの $import: で、同じことをするものです。

チェーンは正規化されたキー、つまりレジストリホストやバージョン表記を除いたライブラリの識別子とエントリ名で比較されるため、経路上で同じエントリを 2 通りの方法で指定しても循環がチェックを逃れることはありません。展開されて終了する参照は、何回現れても、チェーンがどれだけ深くても問題ありません。深さだけでこの停止が起きることはなく、1 つのライブラリエントリを多くの場所から再利用することこそライブラリが存在する目的のパターンです。

$import: チェーンの場合に出力されるメッセージです。ループ全体を走査した順に示すため、どのステップがループを閉じているかがわかります:

circular reference expansion: <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> -> <Library>#/mappings/<entry>(循環参照の展開)

$ref: チェーンは代わりにコンパクト形式コンパイラによって報告され、読み込んでいたドキュメントとキーワードが付記されます:

compactform at <consumer-file> (keyword "$ref"): circular cross-document $ref expansion: <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> -> <Library>#/schemas/<entry>(ドキュメント間の $ref の循環展開)

修正方法: メッセージ内のチェーンを読み、意図していなかったステップで断ち切ります。循環は通常、2 つのライブラリエントリがそれぞれ相手を拡張するように書かれていることを意味します。共有部分を両方が参照する 3 つ目のエントリにまとめるか、どちらか一方にインライン化します。最後に示されたステップがループを閉じたものですが、それが誤りとは限りません。どのリンクを切るかは利用者が決めることだからこそ、チェーン全体が出力されます。

同じ条件は、上記の「YAML anchor aliased inside its own content(YAML アンカーが自身の内容の中でエイリアスされている)」で説明しているアンカー再帰の拒否の基盤にもなっています。あちらは単一ドキュメント自身のテキスト内のループであり、こちらはドキュメント間のループです。メッセージ内のチェーンを見れば両者はすぐに区別できます。ドキュメント間のループはライブラリエントリを示し、ドキュメント内のループはアンカーを示します。

A declared schema cannot be resolved(宣言されたスキーマを解決できない)

スキーマが何かの検証に使われる段階に達したものの、そもそもスキーマとして組み立てられませんでした。最も多い原因は、解決可能なものを何も指していない $ref: です。JSON Schema のメタスキーマを満たさないスキーマも同じ停止に至り、条件キーワード配下の then: または else: ブランチが単独で解決できない場合も同様です。

拒否はスキーマに対して何かが検証される前に行われ、この順序こそが要点です。読み取れないスキーマを読み飛ばすと、ビルドが成功を報告する一方で、そのスキーマが対象とするものはすべて検証されないままになります。停止したことを知らせる手段のないまま、チェックが動かなくなるのです。

出力されるメッセージです。スキーマ内の位置、解決できなかったキーワード、解決処理が報告した内容を示します:

validator/jsonschema: schema resolution failed (at <path-inside-the-schema>, keyword "<keyword>", <what resolution reported>)(スキーマの解決に失敗しました)

失敗がスキーマ内のキーワードではなくスキーマのルートで起きた場合、位置とキーワードは省略され、報告された理由だけが示されます。

修正方法: メッセージが示す位置でスキーマを開きます。通常の原因は $ref: です。参照先が存在すること、ドキュメント内の参照がその #/$defs/… パスを正確に綴っていること、ドキュメント間の参照がビルドの依存関係クロージャに実際に含まれる SchemaLibrary エントリを指していることを確認します。メッセージが then: または else: ブランチを示している場合、そのブランチはそれ自体が 1 つのスキーマであり、単独で解決できる必要があります。

x-aggrega-when: または x-aggrega-validate: の述語を評価できない

スキーマがテンプレート値を取る 2 つの拡張キーワードのいずれかを宣言しており、そのテンプレートを使用できませんでした。文字列でない、テンプレートとしてパースできない、実行中に失敗した、または true か false 以外のものをレンダリングした、のいずれかです。

x-aggrega-when: はスキーマの条件分岐が適用されるかどうかを決定し、x-aggrega-validate: はスキーマ自身のキーワードでは表現できないルールを値が満たすかどうかを決定します。どちらも判定として読まれるため、判定でない結果は解釈されずに拒否されます。空文字列をレンダリングする述語は false と読まれ、強制するために書かれたルールを暗黙のうちに無効にしてしまうからです。

出力されるメッセージ:

validator/jsonschema: x-aggrega extension evaluation failed (at <path-inside-the-schema>, keyword "x-aggrega-validate", <what evaluation reported>) (validator/jsonschema: x-aggrega 拡張の評価に失敗しました。スキーマ内の位置、キーワード、評価が報告した内容を示します)

条件の述語が原因である場合はキーワードの位置に "x-aggrega-when" が入り、報告される理由はテンプレートの不具合(パース位置、存在しない関数、またはテンプレートが生成した非ブール値)を示します。

修正方法: メッセージが示す位置でスキーマを開き、報告された理由を読みます。キーワードの値が文字列であること、テンプレートがパースできること、そしてテンプレートがたどるすべてのパスが検証対象の値に実際に存在することを確認します。述語は値を .value として読み、それ以外のものを参照するのが最もよくある誤りです。理由に index が見つけられなかったキーが示されている場合は、hasKey でキーの有無を調べるか、代わりに get で読みます。後述の「A template indexes a map with a key the map does not hold(テンプレートがマップに存在しないキーでマップをインデックスする)」で説明するとおり、index はマップに存在しないキーで停止します。テンプレートが最終的に true または false を生成するようにします。比較はこれを満たしますが、値を単にレンダリングするだけのテンプレートは満たしません。

Workload が Workload スキーマを満たしていない

Recipe または FeatureRecipe の workload: ブロックが読み込まれて Workload スキーマに照らして検査され、1 つ以上のフィールドがそれを満たしていません。キーのスペルミス、誤った型の値、必須フィールドの欠落、宣言された範囲や列挙の外にある値などです。

報告はグループ化されます。1 回の停止で問題のあるすべてのフィールドが示されるため、誤りが 4 つある Workload では、ビルドごとに 1 つずつではなく 1 回のビルドで 4 つすべてが報告されます。ヘッダーには Workload、それを宣言する Recipe、ファイルが示され、その下の各指摘には Workload 内のフィールドパス、スキーマがそこで要求した内容、そして示せる場合は修正方法が示されます。

出力されるメッセージ:

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .containers.<name>.<field>: <what the schema required> — <the fix, where one can be stated> .initContainers[<i>].<field>: <what the schema required> — <the fix, where one can be stated>

フィールドごとの詳細がない失敗(ブロックが読み込まれて不備が見つかったのではなく、そもそも読み込めなかった場合)では、代わりに理由全体が単一の指摘として示されます。

**workload: テンプレートが sensitive と宣言された値を読む場合、どの指摘も値を引用しません。**レンダリングされたドキュメントのどのフィールドがその値に由来するかを判別できないため、値を含みうるテキストを持つ指摘はすべて、値の位置に <redacted> を置いてスキーマの制約を示し、理由を述べる通知で締めくくられ、値から導かれる修正方法は含みません。

.containers.main.imagePullPolicy: against /$defs/container: enum: <redacted> does not satisfy enum ["Always","Never","IfNotPresent"] (the value is withheld because the template that rendered this document reads a value declared sensitive)

値を引用しない指摘(キーの欠落、Workload が受け付けないキーなど)は、他のテンプレートの場合と同じように表示されます。vocabulary/compact-form-authoring.md の「What a refusal says about a declared value」を参照してください。

workload: ブロックは Aggregate や Release ではなく Recipe の作成者が記述するものであるため、ビルドはこの停止を CATALOG_ERROR タグで報告します。

修正方法: 列挙されたフィールドパスで Recipe を開き、それぞれを修正します。パスは Workload 自身のルートから示されるため、.containers.main.health.ready は main コンテナの health キーの下にある ready ブロックです。名前付きコンテナはキーで、init コンテナは位置で指定されるため、両者の表記は異なります。各フィールドが受け付ける内容は Workload のオーサリングリファレンスにあります。

スキーマがテキストを求めるフィールドが、値が数値またはブール値であるために拒否された場合、ほぼ必ず引用符のないテンプレート式が原因です。workload: ブロックは検査の前にレンダリングされるため、引用符なしで書かれた式は裸のテキストに展開され、YAML はそのテキストを見た目どおりの型として読みます。整数コア数のサイジング量、数字だけのバージョン、ポート、そして yes、no、on、off という語は、いずれもテキスト以外として読まれます。指摘には YAML がどの型として読んだかが示され、対処法は Recipe 内で式を引用符で囲むことです(cpu: {{ .infra.compute.cpu }} ではなく cpu: "{{ .infra.compute.cpu }}")。これにより、オペレーターが何を指定しても値はテキストのままになります。なお、ここではオペレーター自身の値に問題はなく、Release でそれを引用符で囲んでも何も変わりません。引用符は Recipe 内で式を囲む必要があります。

A Workload attachment names a slot the entity does not declare, or a delivery the slot forbids(Workload のアタッチメントが、エンティティが宣言していないスロット、またはスロットが禁止している配信方法を指定している)

workload: ブロック内のコンテナの attachments: エントリがアタッチメントスロットを参照していますが、その参照が Component または Feature の featuresSchema で宣言されたスロットと一致していません。また、connection: で接続を指定するエントリの場合は、その接続のソケットが宣言するスロットと一致していません。接続を指定する envFrom エントリにも同じ接続の規則が適用されます。検出結果には、これらのどの形に該当するかが示されます。

  • スロットが宣言されていない。 エントリの from: が、エンティティの featuresSchema に存在しないスロットを指定しています。綴りの誤りか、一方の側でのみ名前が変更されたスロットです。
  • スロットがブラックボックスである。 スロットが空の inject: 許可リストを宣言しており、配信は Recipe 自身の内部処理に予約されています。このようなスロットは内部で充填・消費されるため、Workload から参照することはできません。
  • 配信方法がスロットの許可リストに含まれていない。 エントリの as: が、スロットの inject: リストで許可されていない方式を指定しています。
  • コンポーネントが引いていない接続である。 エントリの connection: が、コンポーネントのどの接続にも使われていないエイリアスを指定しています。
  • 接続のソケットがスロットを宣言していない。 エントリの from:(envFrom の場合は secret:)が、その接続が経由するソケットで宣言されていないスロットを指定しています。
  • スロットが合成名で書かれている。 エントリの from:(または secret:)が、接続のアタッチメントがコンポーネント上で取る名前、つまりエイリアス、ドット、スロットを並べた名前で、connection: なしに書かれています。接続のスロットには、接続を指定することでのみ到達できます。

すべてのコンテナにわたる問題のあるエントリがまとめて報告されるため、1 回のビルドですべてが示されます。検出結果は、Workload、その Recipe、ファイルを示す 1 つのヘッダーの下にまとめられます。

出力されるメッセージ:

workload featuresSchema cross-check failed (Workload in Recipe <name>:<version>, at <path>, featuresSchema stage): .containers.<name>.attachments.<KEY>.from: references slot "<slot>" which is not declared in the Component’s featuresSchema — either declare the slot in the Component (or Feature) featuresSchema, or rename the reference to an existing slot .containers.<name>.attachments.<KEY>.from: slot "<slot>" is blackbox (no inject: allowlist) and cannot be referenced from a Workload attachments entry — blackbox slots are delivered by Recipe-internal plumbing; remove the Workload-side reference, or widen the slot’s inject allowlist if Workload-side delivery is intended .containers.<name>.attachments.<KEY>.as: delivery mechanism "<as>" is not permitted by slot "<slot>" (inject allowlist: [<mechanisms>]) — use one of the allowlisted delivery mechanisms ([<mechanisms>]), or widen the slot’s inject allowlist in the Component/Feature featuresSchema .containers.<name>.attachments.<KEY>.connection: names connection "<alias>" for slot "<slot>", but the component draws no connection under that alias — name a connection the component draws (<aliases>), or remove connection to read a slot the Component declares for its own attachments .containers.<name>.attachments.<KEY>.from: names slot "<slot>" of connection "<alias>", which socket "<socket>" does not declare — name a slot socket "<socket>" declares (<slots>), or declare the slot in that socket’s featuresSchema .containers.<name>.attachments.<KEY>.from: names "<alias>.<slot>", the name the compiler composes for slot "<slot>" of connection "<alias>"; a slot a connection’s socket declares is named by naming the connection — write connection: <alias> beside from: <slot>

envFrom エントリの場合、同じ検出結果は .containers.<name>.envFrom[<i>].connection および .containers.<name>.envFrom[<i>].secret に示されます。

修正方法: 各検出結果には両側が示されるため、どちらの側を変更するかを選びます。宣言されていないスロットの場合は、from: の綴りを修正するか、エンティティの featuresSchema でスロットを宣言します。フィールドパスの .from 接尾辞が参照を指しています。ブラックボックスのスロットの場合は、Workload 側の参照を削除して Recipe に素材を配信させます。ただし、Workload 側での配信が本当に必要な場合は、スロットに inject: 許可リストを与えます。拒否された方式の場合は、as: を許可リストにある方式に切り替えるか、使いたい方式を許可リストに追加します。コンポーネントが引いていない接続の場合は、エイリアスを検出結果に列挙されたものに修正するか、Aggregate または Release で接続を引きます。ソケットが宣言していないスロットの場合は、検出結果に列挙されたスロットのいずれかを指定するか、Component 上のソケットの featuresSchema でスロットを宣言します。合成名の場合は、検出結果に示されているとおり、接続とスロットを分けて書きます。

A Workload references a slot whose fill publishes no locator(Workload が、充填がロケーターを公開していないスロットを参照している)

コンテナの attachments: エントリがスロットを参照で指定していますが、そのスロットを充填するアタッチメントが、こうした参照が読み取る provides キーを公開していません。スロットを名前で参照することは、そのスロットが表すリソースを、リソースの名前とその中のフィールドによって、レンダリングされた出力内で指し示すよう求めることを意味します。どちらも公開しない充填には指し示すロケーターがないため、参照を何にも変換できません。

必要なキーはエントリによって異なり、検出結果にはどれが必要だったかが示されます。独自の key: を指定するエントリはフィールドを自ら与えるため、公開が必要なのはリソースの name だけです。これにより、複数キーを持つリソースを参照できます。key: を指定しないエントリはスロットが公開する単一のフィールドを読み取るため、name と key の両方が必要です。

このチェックはキーの有無のみを確認し、その値は検査しません。問題のあるエントリはすべて、1 つのヘッダーの下にまとめて報告されます。

出力されるメッセージ:

workload attachment slot is not referenceable (Workload in Recipe <name>:<version>, at <path>, slotReferenceability stage): .containers.<name>.attachments.<KEY>.from: slot "<slot>" is not referenceable: its resolved provides does not expose "<key>" (a workload attachment reference reads the provides keys name and key) — reference a slot filled by an attachment whose schema.provides declares the keys this reference reads, or deliver it through the slot’s inject pipe rather than a workload reference

修正方法: 方向は 2 つあり、どちらが正しいかは意図によって異なります。参照が正しい場合は、スロットを充填するアタッチメントを変更します。schema.provides が name(エントリが独自に指定しない場合は key も)を宣言する Feature をアタッチし、指し示すロケーターが存在するようにします。素材を出力内で名前によって指し示すつもりがなかった場合は、参照を削除し、代わりにスロットの inject: パイプを通して配信します。このパイプは、値の所在へのポインターではなく値そのものを運びます。

A container gives one environment variable two values(コンテナが 1 つの環境変数に 2 つの値を与えている)

workload: ブロックの 1 つのコンテナが、同じ環境変数を 2 回指定しています。1 回は variables のキーとして、もう 1 回は as: env で配信される attachments エントリのキーとしてです。メインコンテナと init コンテナはそれぞれチェックされ、component の Recipe がレンダリングする Workload でも、FeatureRecipe がレンダリングする Workload(component にアタッチされたものと boundary で宣言されたもの)でも同様です。チェックは、テンプレートがレンダリングした状態の Workload を読みます。

どちらかを選ばずに停止する理由。 コンテナの環境は、この 2 つのコレクションから決まった順序で書き出されます。helm および compose の provider は、アタッチメントから読むエントリをすべて先に書き、通常の variables をその後に書きます。そのため、両方の方法で書かれた名前は、その順序で勝つ側の値でプロセスに届くことになります。これは記述した内容ではなく 2 種類の配置先によって決まる結果であるため、ビルドはそれをレンダリングせずにこの組を拒否します。チェックは、どの provider が Workload をレンダリングする場合でも 1 回だけ、Workload の他のチェックの後、artifacts: エントリが評価される前、およびいずれかの provider に Workload が渡される前に実行されるため、拒否された組がレンダリングされることはありません。as: file で配信される attachments エントリは、環境に設定されるのではなくファイルとしてマウントされるため、組を形成することはありません。

チェックは名前のみを比較し、値を読むことはないため、どの検出結果も値を引用しません。比較の対象外となる環境エントリが 2 種類あります。envFrom エントリは指定した ConfigMap または Secret のキーを設定しますが、それらはビルド実行時には分かりません。また、パイプラインのステップがレンダリング済みドキュメントに書き込むエントリは、チェックが読む Workload の一部ではありません。

各組はそれぞれ独立した検出結果となり、Workload を宣言する Recipe または FeatureRecipe の workload: キーの位置に示され、変数とコンテナを指定します。メインコンテナはそのキーで、init コンテナは initContainers リスト内の位置で指定されます。検出結果は、まずメインコンテナが記述順に、次に init コンテナが位置順に並び、1 つのコンテナ内では attachments エントリの記述順に並びます。

Recipe の Workload のメインコンテナ上の組に対して出力されるメッセージです。カテゴリとこの条件の短いコード E0345 は角括弧で囲まれた先頭部分に示され、位置は <path> at .spec.workload となります。

a container declares one environment variable twice ("<NAME>", container "<container>"). Rename one of the two, or write them under complementary template conditions so that only one of them renders(コンテナが 1 つの環境変数を 2 回宣言しています。どちらか一方の名前を変更するか、一方のみがレンダリングされるよう相補的なテンプレート条件の下に記述してください)

init コンテナ上の組では、代わりにリスト内の位置(init container "initContainers[<i>]")が示されます。また FeatureRecipe の検出結果では、コンテナの後にそれをバインドするアタッチメント attachment "<attachment>" が示されます。component は複数のアタッチメントを持つことができ、それぞれの FeatureRecipes は別々のドキュメントであるためです。

1 つの Workload に複数の組がある場合、検出結果はドキュメントを示す行の下にまとめられます。containers of the Workload this Recipe renders name one environment variable twice、または FeatureRecipe の場合は containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice です。

workload: ブロックは Aggregate や Release ではなく Recipe または FeatureRecipe の作成者が記述するものであるため、ビルドはこの停止を CATALOG_ERROR タグの下に報告します。

修正方法: コンテナがどちらを受け取るべきかを決めます。両方が必要な場合は、一方の名前を変更し、プロセスから 2 つの変数として見えるようにします。両者が代替関係にある場合(たとえば、認証情報がアタッチされていないときの通常のフォールバック)は、ちょうど一方だけがレンダリングされるよう相補的な条件で囲みます。変数を {{ if not (hasKey (default dict .features) "<slot>") }} の下に、attachments エントリを {{ if hasKey (default dict .features) "<slot>" }} の下に記述するか、1 つの {{ if }}/{{ else }} の 2 つの分岐の下に記述します。このように囲まれた組は、レンダリングされた Workload に一方しか含まれないため、チェックに到達することはありません。

A Release’s parameters: block is written in neither of its two shapes(Release の parameters: ブロックが 2 つの形のどちらでも書かれていない)

Release は、Aggregate が宣言したパラメータを 2 つの方法のいずれかで満たし、ブロックはその形式によって読まれます。パラメータ名からその場で記述した値へのマッピングであるか、またはちょうど 1 つのキー $import: を持ち、その値がそれらの値を保持する YAML ファイルのパスであるマッピングです。どちらでもないブロックは、値を Aggregate の宣言と照合する前の、読み込み時点で拒否されます。

拒否される形式は 3 つです。マッピングではない parameters: の値(スカラーやリスト)。$import: を他のキーと並べて持つマッピング。これはインポートした値と記述した値を同時に求め、それらを結合する規則を与えません。そして、値がプレーンな文字列ではなくファイルを指定しない $import: です。

Release のスキーマも同じ 2 つの形を宣言しているため、この 3 つのいずれかを含む Release ファイルは、まず E0215 としてドキュメントのエンベロープチェックに引っかかります。このチェックは両方の形を試し、それぞれが失敗した理由を示します。以下はリストの場合です:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.parameters: no oneOf branch matched (2 branches tried): branch[0]: type: expected object, got array; branch[1]: type: expected object, got array. correct the document to match its kind’s schema(ドキュメントのエンベロープ検証に失敗しました(Release)。spec.parameters: 一致する oneOf ブランチがありません(2 つのブランチを試行): branch[0]: 型: オブジェクトが必要ですが配列でした。branch[1]: 型: オブジェクトが必要ですが配列でした。種類のスキーマに合うようにドキュメントを修正してください)

$import: が別のキーと並んでいる場合、2 つ目のブランチは additionalProperties: unexpected property: "<key>" で終わり、$import: が文字列ではなくリストとして書かれている場合は validation: type: array has type "array", want "string" で終わります。

値がマッピングでない場合に出力されるメッセージです。そこに書かれたもの(たとえば a list)が示されます:

parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected(parameters: 形はインラインのオブジェクトか $import だけのマッピングでなければなりません: マップが必要な位置に別の形が書かれています)

また、$import: がマッピングを他の何かと共有している場合、またはパスではないものを指定している場合は次のとおりです。

parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line>($import: は唯一のキーである必要があります) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line>($import の値は文字列スカラーである必要があります)

修正方法: メッセージが示す行で Release を開きます。parameters: の下に値をその場で記述するか、ブロック全体を、値が引用符付きのパスである単一の $import: エントリに置き換えます。記述した値と共有デフォルトをインポートしたファイルの両方が必要な場合は、記述した値を、インポートを持つ Release を extends: する Release に移します。複数のパラメータソースを重ねることは extends: チェーンの役割であり、このキーは設計上、単一のソースから読まれます。

An inline-or-import field is written in neither shape(インラインまたはインポートのフィールドがどちらの形にもなっていない)

Recipe または FeatureRecipe が記述する 3 つのフィールド(artifacts.<name>: エントリ、valuesMapping:、workload:)は、同じ 2 つの形を受け付けます。本体をその場に文字列スカラーとして記述する(複数行のものには | ブロックが通常の書き方です)か、値を $import: というちょうど 1 つのキーを持つマッピングにして、本体の所在を代わりに指定するかのいずれかです。$import: で指定できるものはフィールドによって異なります。artifacts エントリはローカルパスまたは ArtifactLibrary のバンドルをインポートし、valuesMapping: と workload: はローカルパスまたは識別子によるライブラリのエントリをインポートします。

3 つすべてを 1 つのリーダーが検査するため、どのフィールドに問題があっても拒否されるのは同じ 3 つです。複数のキーを持つマッピング、唯一のキーが $import ではないマッピング、そして値がプレーンな文字列ではない $import: です。スカラーでもマッピングでもない値(多くの場合はリスト)は、その形だけで拒否されます。

Recipe と FeatureRecipe のスキーマは 3 つのフィールドそれぞれに同じ 2 つの形を宣言しているため、これらのいずれかを含むファイルは、まず E0215 としてドキュメントのエンベロープチェックに引っかかります。このチェックはフィールドを示し、それぞれの形が失敗した理由を示します。1 つ目のブランチはその場で記述する形、2 つ目は $import: の形です:

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec.artifacts.<name>: no oneOf branch matched (2 branches tried): branch[0]: validation: type: object has type “object”, want “string”; branch[1]: additionalProperties: unexpected property: “<key>”. correct the document to match its kind’s schema(ドキュメントのエンベロープ検証に失敗しました(Recipe)。spec.artifacts のこのエントリに一致する oneOf ブランチがありません(2 つのブランチを試行): branch[0]: 検証: 型がオブジェクトですが文字列が必要です。branch[1]: additionalProperties: 想定外のプロパティです。種類のスキーマに合うようにドキュメントを修正してください)

これは $import: の横にキーを持つマッピングの場合です。$import ではない単一のキーは required: missing required property: $import, additionalProperties: unexpected property: "<key>" で終わり、リストは type: expected object, got array で終わります。文字列でない $import: は、type: array has type "array", want "string" のように、文字列が必要な位置で見つかった型を示します。

出力されるメッセージ。それぞれ問題のあるフィールドの文で始まり、続いてリーダーが何をどこで見つけたかを示します。

artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line>

3 つのフィールドのいずれも、これらのどの末尾でも報告し得ます。どちらの形でもない値は line <line>: <shape> is written where text or a map is expected で終わり、書かれたもの(最も多いのは a list)を示します。

修正方法: メッセージが示す行でエンティティを開きます。本体をその場にブロックスカラーとして記述するか、値全体を単一の $import: エントリに置き換えます。$import: とそれ以外のものを持つマッピングは 2 つの形のどちらでもありません。余分なキーをインポートされるファイル内へ移すか、本体をその場に記述してください。$import の綴り誤り(多くの場合 $ の欠落)は通常のキーとして読まれ、$import ではない唯一のキーとして報告されます。

A reference to a library entry carries whitespace(ライブラリエントリへの参照に空白が含まれている)

ライブラリ内のエントリを指す参照は、途切れのない 1 つのトークンとして記述します。ライブラリ、省略可能な :<version> の下限、続いて # とエントリのパスです(BaseWorkloads:1.0.0#/workloads/StatelessService)。どの部分にも空白は許されません。ライブラリ名とエントリ名はどちらもライブラリのスキーマによって識別子の綴りに制約され、バージョンはバージョンであるため、参照内のどこにあるスペース、タブ、改行も 3 つのいずれにも属しません。

この拒否は、識別子によってライブラリエントリを指すすべての箇所に適用されます。$import: として記述された valuesMapping:、workload:、artifacts.<name>: エントリ、およびスキーマの $ref: です。$import: として記述されたローカルパスは # を持たず、ライブラリエントリへの参照ではないため、スペースを含むパスは影響を受けません。

整えるのではなく拒否する価値があるのは、そのような値の先頭部分が通常それ自体で参照として成立しているためです。空白で切り詰めるとその参照が解決され、作成者が書いた残りの部分が黙って破棄されます。しかもビルドの 2 つの半分が同じ量を破棄するとは限らないため、一方が他方の知らない依存関係を記録する可能性があります。拒否することで、値の意味が 1 つに保たれます。

この拒否は、参照が読み取られたドキュメントの行で報告されます。

library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line>

参照がビルドに届く場所はもう 1 つあります。ビルドがすでに解決したライブラリエントリの本体で、1 行目のフィールドルートの $import: が別のライブラリのエントリを指している場合です。この参照はビルドが開いたドキュメントから読み取られたものではないため、行なしで報告されます。

library reference: a reference to a library entry carries no whitespace or line break: "<reference>"

修正方法: メッセージが示す行でエンティティを開き、参照を詰めて 1 つのトークンにします。よくある原因は # の前の改行です。列幅に収めるために 2 行に折り返した参照は、YAML には 1 つの値として読まれますが、ここでは壊れた参照になります。どれほど長くても 1 行で記述してください。もう 1 つの原因は閉じ引用符の前の末尾スペースです。これはバージョンの下限の中に入り、公開されたどのアーティファクトも持たないバージョンを指すことになります。2 つ目の形の場合、参照はメッセージ内でその直前に示されたライブラリの中にあります。そのライブラリがエントリを宣言している箇所で修正してください。

A library entry’s body is not the shape that library holds(ライブラリエントリの本体がそのライブラリの保持する形になっていない)

ライブラリは、他のエンティティがインポートするための名前付きの本体を公開し、ライブラリの種類ごとに 1 つの形を保持します。MappingLibrary のエントリと WorkloadLibrary のエントリはそれぞれ 1 つのテンプレート本体を保持するため、エントリの値はスカラー(実際には | ブロック)です。ArtifactLibrary のエントリはバンドル、つまり 1 つの名前のもとにまとまるファイル群を保持するため、エントリは出力ファイル名からそのファイルの本体へのマッピングであり、その下の各本体はスカラーです。

本体は記述されたとおりに取り込まれ、ライブラリのロード時には解析されません。本体内のテンプレートはインポートされる場所で解析されます。そのため、ここで検査されるのは形だけです。テンプレートですらない本体も問題なくロードされ、何かがそれをレンダリングする時点で失敗します。

出力されるメッセージです。それぞれ行と、そこに書かれたもの(たとえば a list)を示します:

mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected(mappinglibrary: エントリ本体は文字列スカラーでなければなりません: テキストが必要な位置に別の形が書かれています) workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected(workloadlibrary: エントリ本体は文字列スカラーでなければなりません: テキストが必要な位置に別の形が書かれています) artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected(artifactlibrary: エントリはファイル名から文字列本体へのマッピングでなければなりません: マップが必要な位置に別の形が書かれています)

また、エントリはマッピングであるもののファイルの 1 つがスカラーではないバンドルの場合は、そのファイルを示して次のように出力されます。

artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected(artifactlibrary: エントリはファイル名から文字列本体へのマッピングでなければなりません: このファイルでテキストが必要な位置に別の形が書かれています)

ビルドはこれらを、読み取っていたファイルを示す CATALOG_ERROR タグのもとで報告し、その下に上記の文を示します。

修正方法: 本体をそのキーの下にブロックスカラーとして記述します。1 行目が YAML キーのように見える本体(YAML を生成するテンプレートは通常そうなります)は、ブロックスカラーがない限りネストしたマッピングとして読まれ、これがよくある原因です。ArtifactLibrary の場合は、出力ファイル名ごとに 1 つのキーを記述し、各本体をそれぞれ独立したブロックスカラーにします。バンドルを単一の本体として記述することも、よくある形の誤りです。

A $instantiate: reference cannot be resolved(インスタンス化の参照を解決できない)

SchemaLibrary は spec.templates の下に再利用可能な形を宣言でき、それぞれが独自の $params を持ちます。スキーマエントリは $instantiate: の下でその名前を指定し、$args: の下でパラメータを与えることでインスタンス化します。置換はリテラルです。テンプレート本体内の $<name> スカラーが引数の値に置き換えられます。式の評価、条件分岐、ループはなく、置換された値はそのまま挿入され、さらなるマーカーを探して走査されることはありません。

インスタンス化を拒否する誤りは 3 つあります。$instantiate: の下の名前がライブラリで宣言されていない場合。テンプレートが default: なしで宣言したパラメータに対して $args: の下にエントリがない場合。あるいは、引数の値がそのパラメータの宣言した型でない場合です。宣言されたパラメータを指さない $args: キーも、無視されずに同じ形で報告されます。そのため、引数名のスペルミスは、黙ってデフォルト値が使われるパラメータではなく、拒否になります。

出力されるメッセージ:

schemalibrary: template not found: "<template-name>" not declared in spec.templates(テンプレートが見つかりません:spec.templates で宣言されていません) schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>")(テンプレートパラメータがありません) schemalibrary: template parameter type mismatch: <what the type check found>(テンプレートパラメータの型が一致しません) schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params(テンプレートパラメータの型が一致しません:引数がテンプレートの $params で宣言されていません)

対処方法: テンプレートが見つからない場合は、ライブラリが spec.templates の下で宣言している名前に修正し、意図したライブラリをインポートしているかも確認します。パラメータがない場合は、$args: に追加するか、呼び出し側が省略できるようテンプレート内でパラメータに default: を与えます。型の不一致の場合は、引数を宣言された型に変更するか、パラメータの type: を広げます。メッセージが宣言されていない引数を指している場合は、そのスペルを修正するか削除します。

A schema uses a JSON Schema keyword the library does not admit(スキーマがライブラリで許可されていない JSON Schema キーワードを使用している)

$dynamicAnchor と $dynamicRef は SchemaLibrary のコンテンツでは許可されません。これらは、参照がどのスキーマに解決されるかを値の検証時まで遅延させるため、ライブラリエントリの意味が、その記述内容ではなくインポート元に依存することになります。一方、コンパイラはあらゆる検証に先立ってライブラリの形を解決するため、遅延された参照が解決の対象とするものが存在しません。

この拒否は 3 か所で適用され、それらが合わさってキーワードが入り込みうる両方の経路を塞ぎます。スキーマエントリはライブラリの読み込み時に走査されます。テンプレート本体もライブラリの読み込み時に走査されるため、キーワードをリテラルに含むテンプレートは、最初にそれをインスタンス化するビルドではなく、その時点で失敗します。さらに、インスタンス化の後に置換済みの本体が再度走査されるため、キーワードを引数の値として与えても最初の 2 つをすり抜けることはできません。

出力されるメッセージ:

schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line>(禁止された JSON Schema キーワードです)

対処方法: 遅延された参照を、$defs エントリを直接指す $ref に置き換えます。形が本当に用途ごとに異なる場合は、その違いを $params を持つテンプレートとして表現し、用途ごとにインスタンス化します。これがこの仕組みの提供する置換であり、結果に対して何かが検証される前に解決されます。

A document nests deeper than the reader will descend(ドキュメントのネストがリーダーの降りる深さを超えている)

記述されたマッピングはすべて、キーが書かれた順序を保持する構造に読み込まれます。その順序はレンダリング出力に反映され、ビルドを実行間でバイト単位で同一にする要素の一部だからです。このリーダーが降りる階層数には上限(100)があり、それより深くは降りずに拒否します。そのため、本来ならリーダー自身のスタックを使い果たすような入力は、拒否として報告されます。

出力されるメッセージ:

a document nests too many levels deep: it is read at most 100 levels deep(ドキュメントのネストが深すぎます: 読み取られるのは最大 100 階層までです)

対処方法: 実際に記述されるドキュメントのネストは数階層なので、100 階層に達するドキュメントは、生成されたもの、機械翻訳されたもの、または誤って自己参照になっているものです。自身に展開された値を探します。自身が含まれる内容を参照する YAML アンカーは上記の専用の停止で拒否されますが、同じ形を繰り返し出力するジェネレータは拒否されません。深さが本当に必要な場合は、深い枝を独立したエンティティに切り出し、名前で参照します。

A provider declares a well-known annotation at a scope it does not render(プロバイダが、レンダリングしないスコープで既知のアノテーションを宣言している)

プロバイダを提供する Plugin は、自身について一致すべき 2 つのことを述べます。spec.provider.wellKnownAnnotations の下では、扱うアノテーションを、それぞれを読み取るスコープとともに列挙します。contract.inputKinds の下では、そもそもどの入力種別をレンダリングするかを述べます。同じエンティティが要求していない入力種別のスコープで宣言されたキーは、1 つのファイル内でこの 2 つの記述が矛盾していることを意味するため、エンティティは読み込み時に拒否されます。

このチェックはエンティティをそれ自身と比較するものです。そのためプラグインのバイナリを必要とせず、エンティティが読み込まれる場所であればどこでも発生します。アーティファクトを一度も取得していないマシン上でのカタログ走査も含みます。

2 種類のエントリは意図的に比較されません。境界スコープのエントリは入力種別を指定しません。いずれかのノードのレンダリング経路ではなく、境界全体に対して一度だけ解決されるからです。スコープをまったく宣言しないエントリは、経路ごとの主張をしません。プラグインがそのキーをどこかで読み取ることを述べるだけです。

この拒否が保証しないのは、残った宣言が正しいということです。プロバイダを提供するプラグインが、読み取ると述べたキーを実際に読み取ることは何によっても証明できません。記述された 2 つのフィールドの比較にできるのは、両方が同時に真ではありえない組み合わせを拒否することです。プロバイダがレンダリングするスコープで宣言されたキーは、そのプラグインがそこで何も読み取らなくても、ここでは通過します。

出力されるメッセージ:

provider "<plugin-name>" declares well-known annotation "<key>" at scope "<scope>", but its contract.inputKinds.<field> is not claimed; declare the key only at a scope the provider renders, or claim the input kind: wellKnownAnnotations: a key is declared at a scope the provider’s contract does not render(プロバイダがスコープで既知のアノテーションを宣言していますが、その contract.inputKinds が要求されていません。キーはプロバイダがレンダリングするスコープでのみ宣言するか、入力種別を要求してください:wellKnownAnnotations:プロバイダの contract がレンダリングしないスコープでキーが宣言されています)

対処方法: メッセージは両方を示します。アノテーションの scope: リストからそのスコープを削除してプロバイダが実際にレンダリングするスコープだけを残すか、プロバイダが実際にその入力種別をレンダリングする場合は contract.inputKinds の下でそれを要求します。

A compact-form schema uses a keyword the compact form does not know(コンパクト形式のスキーマが、コンパクト形式の知らないキーワードを使用している)

コンパクト形式で書かれたスキーマに、コンパクト形式のキーワードでも、この形式がそのまま通す JSON Schema キーワードでも、この形式が予約する 3 つのマーカー($jsonschema:、$mode:、$ref:)でもないキーが含まれています。未知のキーは破棄されるのではなく、スキーマの読み込み時に拒否されます。誤入力された制約が無視されると制約がまったくないのと同じになり、強制されているように見えて何も強制しないスキーマは、失敗するスキーマよりも悪いためです。

この拒否は、スキーマがコンパイルされる場所であればどこでも発生します。SchemaLibrary のエントリはカタログのロード時にコンパイルされます。Component の spec.schema、ソケットごとの valueSchema と infraSchema、および Feature とプロバイダの Plugin が宣言するスキーマはカタログの読み込み時にコンパイルされます。Component または Feature の spec.schema はこの条件自体を報告し、エンティティとフィールドを示します。ソケットの valueSchema または infraSchema は、後述の「A declared schema contract cannot be read as a schema(宣言されたスキーマ契約をスキーマとして読み取れない)」の中で報告され、ここで引用した文をその詳細として含みます。

コンパクト形式コンパイラ自身の文は、スキーマ内の位置、ソース行、認識できなかったキーを示します。

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword

ドキュメント間の $ref: の横に書かれたキーも、独自の文とともに同じ条件で報告されます。このような参照に添えられる兄弟キーは 3 つだけだからです。

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description)

また、その兄弟キーがマージされた形を再び開こうとしていた場合、文には代わりの方法が含まれます。

compactform at <path-inside-the-schema>:<line> (keyword "additionalProperties"): cross-document $ref sibling not allowed (allowed: properties, required, description); use $jsonschema: to embed an open-object schema if the merged shape must accept arbitrary properties

記録される条件は compactform: unknown keyword で、短いコードはこれに解決されます。

修正方法: 文が示す位置のキーを、compact-form-authoring.md のキーワード語彙と照らし合わせて修正します。最も多い原因はスペルミスです。コンパクト形式が持たない JSON Schema キーワードが本当に必要な形の場合は、その断片を $jsonschema: の下に書きます。これは JSON Schema をそのまま埋め込みます。ドキュメント間参照の横には properties:、required:、description: だけを置きます。それ以外のものは、参照先のライブラリエントリに書きます。

A compact-form schema declares a field literally named type(コンパクト形式のスキーマが、文字どおり type という名前のフィールドを宣言している)

コンパクト形式は、マッピングの意味をその内容の形から判断します。type: キーは制約のリーフを、構造的な JSON Schema キーワードはそのまま通す断片を、単純な名前のマッピングは子がスキーマであるオブジェクトを示します。type という名前のフィールドを宣言するスキーマは、これらの読み方で区別できない唯一の形です。制約のリーフのように見えますが、意図は 1 つのフィールドを持つオブジェクトです。そのためこの形式では、compact または jsonschema に設定した $mode: キーで、どちらなのかを作成者が示す必要があります。

この条件は、$mode: がそれ以外の値で書かれた場合に報告されます。このマーカーは曖昧さを解消するために存在するため、何も解消しない値は推測されず、拒否されます。

コンパクト形式コンパイラ自身の文:

compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema

記録される条件は compactform: ambiguous dispatch — $mode required で、短いコードはこれに解決されます。

修正方法: マッピングが、たまたま type というフィールドを含むコンパクト形式のオブジェクトである場合は $mode: compact を、書かれたとおりに扱う JSON Schema の断片である場合は $mode: jsonschema を設定します。どちらの読み方も意図していなかった場合は、フィールド名を変更すれば、マーカーなしで曖昧さが解消されます。

A $jsonschema: escape carries content that is not a schema($jsonschema: エスケープがスキーマではない内容を持っている)

$jsonschema: キーは、コンパクト形式で表現できない形のために JSON Schema の断片をそのまま埋め込みます。埋め込まれたものは書かれたとおりに扱われ、変換されることはないため、それ自体がスキーマでなければなりません。つまり、YAML としてパースできるブロックスカラー、またはネストしたマッピングです。どちらでもない内容は、検証に渡されるのではなくここで拒否されます。渡されると、失敗がスキーマではなくスキーマの利用側に対して報告されてしまうためです。

この条件では 4 つの形が報告され、文はそのどれに当たるかを示します。エスケープ本体が YAML としてパースできない。エスケープの値がブロックスカラーでもマッピングでもない。properties: キーが、名前からスキーマへのマッピングではないものを保持している。そして最も外側のレベルで、コンパイラに渡されたドキュメントが空であるか、リーダーが扱う規則を持たないノードを含んでいる。

コンパクト形式コンパイラ自身の文:

compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas compactform: unsupported YAML node kind

記録される条件は compactform: $jsonschema content invalid で、短いコードはこれに解決されます。

修正方法: エスケープ本体を $jsonschema: の下にブロックスカラーとして書きます。そうしないと、最初の行が YAML キーとして読める本体は周囲のマッピングに吸収されてしまい、これがよくある原因です。また、保持している内容がそれ単体で有効な JSON Schema であることを確認します。断片がコンパクト形式で表現できるほど小さい場合は、エスケープをなくすほうが簡単です。

A compact-form constraint does not apply to the type it was written on(コンパクト形式の制約が、書かれた型に適用されない)

コンパクト形式の制約は、フィールドの宣言された型によって振り分けられます。min: と max: は、数値では数値の範囲、文字列では長さの範囲、配列では要素数の範囲になります。そのため、制約はそれを受け付ける型のフィールドに置く必要があり、振り分けの答えが出るには型が単一の値である必要があります。

この条件では 4 つの形が報告されます。type: がないか共用体を示す場所に書かれた制約で、どの範囲を意図したかを決めるものがない。その種類の範囲を取らない型(オブジェクトやブール値)に書かれた制約。値がスカラーの名前でも名前のシーケンスでもない type:。そして、スカラーの名前以外が与えられた valuesType:。

コンパクト形式コンパイラ自身の文:

compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to a single declared type (integer/number/string/array); type: is unresolved (union or absent) — narrow type: to a single value or remove this constraint compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> compactform at <path-inside-the-schema>:<line> (keyword "type"): expected a scalar type name or a sequence of type names (JSON Schema 2020-12 array-of-types); got unsupported node kind compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name

記録される条件は compactform: constraint not valid for declared type で、短いコードはこれに解決されます。

修正方法: 文は両方、つまり制約とそれが当たった型を示します。type: が共用体を保持している場合は単一の名前に絞り、ない場合は追加し、フィールドが本当に複数の型のいずれかを取る場合は制約を削除します。型によって変わる必要がある範囲は、$jsonschema: の下に選択肢の集合として表現し、各分岐にそれぞれの型と範囲を持たせます。

A $ref: is not written in a form the compiler can resolve($ref: がコンパイラで解決できる形式で書かれていない)

スキーマは $ref: を使って別の形状を参照します。参照先は同じドキュメント内の場合と、ドキュメントをまたいだ SchemaLibrary のエントリの場合があります。参照が失敗する 2 つのケースはそれぞれ別の条件として扱われ、どちらに該当するかはメッセージの文が示します。参照がコンパイラの読める形式で書かれていない場合と、形式は正しいものの存在しないターゲットを指している場合です。

参照が読み取れない場合。 値が空である、ドキュメント間の形式が <Library>#/schemas/<Entry> になっていない、またはバージョンを @ で区切っている場合です。最後のケースは、この形式で最も起こりやすい誤りであるため、一般的なエラーではなく修正後の綴りとともに報告されます:

compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written>

これらが記録される条件は compactform: $ref unresolvable です。

ターゲットが存在しない場合。 参照は正しく読み取れますが、ライブラリまたはその中のエントリが存在しないか、解決に使うライブラリカタログがそもそも提供されていません。

compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written>

これらが記録される条件は compactform: cross-document $ref target not found です。

この 2 つを区別することで、報告から次の対処がわかります。前者は参照しているドキュメント内で書き直すべき値であり、後者はビルドから何が見えるかという問題です。自分自身に展開される参照はさらに別の問題であり、上記の「A library reference expands into itself(ライブラリ参照が自分自身に展開される)」として報告されます。

修正方法: 読み取れない参照の場合は値を書き直します。ドキュメント間参照では <Library>#/schemas/<Entry>、同じドキュメント内の参照では #/$defs/<name> とし、バージョンの下限の前には @ ではなく : を使います。ターゲットが存在しない場合は、エントリ名をそれを公開しているライブラリと照合し、そのライブラリが Release の依存関係の閉包から到達可能であることを確認します。どこからも依存が宣言されていないライブラリは読み込まれないため、その中への正しい参照であっても何にも解決されません。

ライブラリがアーティファクトキャッシュにしかない場合。 キャッシュには取得処理が置いたものが保持され、キャッシュされたライブラリがカタログの内容として扱われるのは、Release のロックファイル内のエントリがそのダイジェストを保証している場合に限られます。どのロックファイルエントリも固定しておらず、どのカタログディレクトリも提供していない SchemaLibrary がキャッシュにある場合、レポートの後に remediation: 行が続き、そのような各ライブラリと、それを報告したコマンドに有効な対処が示されます:

  • aggrega build と aggrega validate --release は Release のロックファイルを読み込むため、その行は、ライブラリを解決してそのエントリを記録する aggrega pull --release <release> か、カタログディレクトリの下でライブラリを作成することを示します。
  • 引数なしの aggrega validate、およびエンティティパスを指定した aggrega validate(--release の有無にかかわらず)は、カタログディレクトリからのみライブラリを読み込み、ロックファイルは読み込まないため、記録されたエントリがあっても判定は変わりません。その行はそのことを述べ、カタログディレクトリの下でライブラリを作成するか、aggrega pull --release <release> を実行してから aggrega validate --release <release> を実行するよう案内します。後者は、Release のロックファイルが固定しているライブラリに照らしてその Release を検査します。

このようなライブラリが見つからないプルは、A reference names no entity the catalog holds(参照がカタログにないエンティティを指している)のもとで、独自の行とともにそれを報告します。

A $ref: addresses a library by registry location($ref: がレジストリの場所でライブラリを指定している)

ドキュメント間の $ref: は、ライブラリをその識別子で指定します。すなわち、ライブラリの名前のみに続けて # とエントリのパスを書き、公開先のレジストリでは指定しません。名前がどのレジストリを通じて解決されるかはワークスペースの設定で決まり、どのバージョンが使われるかはロックファイルが決めます。そのため、ホストを含む参照は、本来ビルドが決めるべき 2 つのことをスキーマ内に固定してしまい、スキーマを別のワークスペースに移すと壊れた参照になります。

ホストを含む値がライブラリとエントリとして解析できる場合、メッセージには代わりに使うべき識別子形式の綴りが含まれます。

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity (use <Library>#/schemas/<Entry>): <the value as written>

解析できない場合、メッセージは値の後で終わります。

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written>

これが記録される条件は compactform: cross-document $ref carries a registry host; reference the library by identity であり、短いコードはこの条件に解決されます。

修正方法: ホストとライブラリ名より前の部分をすべて削除し、<Library>#/schemas/<Entry> の形にします。バージョンの下限が必要な場合は、ライブラリ名の後に :<version> として記述します。同じ規則は Recipe と FeatureRecipe の $import: フィールドにも適用され、こちらは後述の「A library $import: addresses its library by registry location(ライブラリのインポートがレジストリの場所でライブラリを指定している)」として別途報告されます。

A schema $import: cannot be applied(スキーマのインポートを適用できない)

Component または Feature の spec.schema(ブロック全体またはその 1 つのピラー)と、usesSchema ソケットの valueSchema: または infraSchema: は、それぞれエンティティと同じ場所にあるファイルを指定する $import: として記述できます。インポートはエンティティの読み込み時に適用されるため、以降のすべての読み手はポインタではなくインポートされたコントラクトを参照します。この条件は、記述した内容に問題がある場合、つまりディレクティブ自体、またはそれが指定するファイルの中身の形状に問題がある場合に発生します。

これらの問題が 1 つの条件にまとめられているのは、いずれも同じ箇所を使用不能にし、対処も同じ(ディレクティブか、それが指定するファイルを修正する)だからです。診断メッセージは固定の文で始まり、続いてどの問題かを示します。そのため、照合に使うのは文の部分で、対処の手がかりとなるのはその後の節です。

a schema $import: could not be applied. <surface>: <the clause for this occurrence>

節には、読み取った箇所(spec.schema、spec.schema.values のようなそのピラー、またはソケットの valueSchema)と、それに続く具体的な問題が示されます。各問題とその意味は次のとおりです。

  • $import: must be the only key when a schema is imported from a file.(ファイルからスキーマをインポートする場合、このディレクティブが唯一のキーでなければならない) ディレクティブが、記述されたスキーマ内容とマッピングを共有しています。$import: は値全体を置き換えるため、兄弟キーには結合する相手がありません。
  • $import: value must be a path to a file.(このディレクティブの値はファイルへのパスでなければならない) 値が空であるか、単一の文字列ではありません。
  • $import: takes a file path beside this entity, not a registry location <value>.(このディレクティブが受け取るのはこのエンティティと同じ場所にあるファイルパスであり、レジストリの場所ではない) 値がレジストリを指しています。名前がどのレジストリを通じて解決されるかはワークスペースの設定であるため、スキーマのサーフェスがレジストリを持つことはありません。メッセージには、代わりに使用する参照形式が示されます。
  • $import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead.(このディレクティブが受け取るのはこのエンティティと同じ場所にあるファイルパスである。SchemaLibrary のエントリは代わりに参照キーワードで参照すること) 値がライブラリのエントリを指しています。ライブラリのエントリはインポートするのではなく参照するものであり、それを解決するキーワードは $ref: です。
  • imported schema <value> must be a YAML map of schema content; it is not.(インポートされたスキーマはスキーマ内容の YAML マップでなければならないが、そうなっていない) ファイルは見つかり、読み込まれ、解析されましたが、解析結果がスカラーまたはシーケンスであるため、置き換えるスキーマ内容がありません。

先頭部分にはカテゴリとこの条件の短いコード E0266 が含まれます。継続的インテグレーションのゲート、Issue、ランブックなどでこの停止を永続的に識別する必要がある場合は、このコードを記録します。番号は一度割り当てられると固定され、周囲の文言が改善されても変わりません。全条件の表でこのコードを引けます。

形式が正しく、ビルドが取得できないファイルを指定しているディレクティブは、別の場所で別のコードとして報告されます。 解決できないパス、存在しないか読み込めないファイル、YAML として解析できないバイト列は、記述した内容の問題ではありません(判断すべきインポート済みドキュメントがありません)。そのため、これらは読み込みの問題として、上記の「A file cannot be read, or its bytes do not parse(ファイルを読み込めない、またはバイト列を解析できない)」で報告されます。そこには各ケースが含む節が記載されています。存在しないか読み込めないインポートファイルを検出したい場合は、その条件で照合し、そのコードを記録します。

パスは、エンティティファイルを含むディレクトリを基準に解決されます。これはインポートを伴う他のすべてのフィールドと同じ基準です。インポートされた内容自体が $import: を宣言している場合はそれも辿られ、処理中のファイルに戻る連鎖は、ここではなく上記の「A library reference expands into itself(ライブラリ参照が自分自身に展開される)」として報告されます。インポートによって取り込まれたファイル内に書かれたディレクティブは、そのファイルとその中の行で報告されます。修正すべき場所はそこだからです。エンティティに書かれたディレクティブは、エンティティで報告されます。

修正方法: $import: をそのマッピング内の唯一のキーにし、エンティティと同じ場所にある、最上位がスキーマ内容のマップである YAML ファイルへの相対パスを指定します。SchemaLibrary が公開する形状を利用するには、代わりに $ref: <Library>#/schemas/<Entry> を使います。ライブラリのエントリはインポートではなく参照するものです。

A schema block names a key that is not a data pillar(スキーマブロックがデータピラーではないキーを指定している)

Component または Feature の spec.schema ブロックはエンティティのデータピラーを保持し、使用できるキーは次の 3 つだけです。開発者がインスタンスごとに記入する形状である values、オペレーターが提供する物理的なサイジングである infra、そしてエンティティがその利用者に公開するキーである provides です。この条件は、ブロックの最上位にそれ以外のキーがある場合に発生します。

この集合は開いたものではなく閉じたものです。これは各ピラー自体の内容が閉じた形で検証されるのと同じ理由によります。正当な範囲を列挙するブロックでは、その範囲外のものはすべてエラーになります。どこからも認識されないキーは、何にもコンパイルされず、検証にも使われず、利用者にも渡されないコントラクトを保持することになります。そのため、その下に書いた内容は宣言されているように見えても何の効果もありません。これはコントラクトをまったく書かなかった場合よりも気づきにくいため、余分なキーを無視するのではなくブロックを拒否します。

診断メッセージは固定の文で始まり、続いてエンティティ、ルール、キーが書かれた位置、代わりに書くべき内容を示します。

a schema block declares a key that names no data pillar (<Kind> <name>, rule schema-pillars, at .spec.schema.<key>). rename "<key>" to one of the pillar keys, or remove it and the contract beneath it; allowed: values, infra, provides. See vocabulary/data-pillars.md for the canonical pillar set.

先頭部分にはカテゴリとこの条件の短いコード E0267 が含まれます。継続的インテグレーションのゲート、Issue、ランブックなどでこの停止を永続的に識別する必要がある場合は、このコードを記録します。番号は一度割り当てられると固定され、周囲の文言が改善されても変わりません。全条件の表でこのコードを引けます。

その位置に書かれる次の 2 つはこの集合のキーではなく、どちらもここでは報告されません。 エンティティと同じ場所のファイルを指定する $import: は、ブロックが読み込まれる前にそのファイルの内容に置き換えられます。そのため、この条件が検査するのはインポートされたドキュメント自体の最上位であり、インポートされたファイルの中にある余分なキーはここで報告されますが、ディレクティブ自体が報告されることはありません。また、extends を宣言する Component はブロックの代わりに文字列 inherited のみを書きますが、これはキーをまったく持たないスカラーです。

修正方法: メッセージには検出したキーと使用できる 3 つのキーが示されるため、最もよくある原因(綴りの誤りや、複数形のピラー名を単数形で書いた場合)は診断メッセージだけでわかります。余分なキーの下の内容がいずれかのピラーに属する場合は、その所有関係に従って values:、infra:、provides: のいずれかの下に移動します。どのピラーが何を所有するかは data-pillars.md に記載されています。それ自体をスキーマ内容として意図していた場合は、ピラーと並べるのではなく、1 段深いピラーの中に置きます。SchemaLibrary が公開する形状は、ブロックではなくピラーの中に書いた $ref: <Library>#/schemas/<Entry> で参照します。

A plugin asks the host to parse a source while a parse is already running for it(プラグインが、自身のためのパースがすでに実行中であるのに、ホストにソースのパースを依頼する)

プラグインはホストにソースのパースを依頼し、その結果を受け取ることができます。これにより、ある形式のドキュメントを必要とするプラグインが、その形式のリーダーを自前で持つ必要がなくなります。ホストはパースを生成するプラグインを実行し、生成された結果を返します。この状態は、そのようにして呼び出されたプラグインが自らパースを依頼した場合に発生します。その依頼は、すでに内部で実行されている同じ仕組みに再び入ることになるため、ホストはさらに深く降りる代わりに拒否します。この仕組みが提供するのは 1 段階までであり、拒否によってそれが 1 段階に保たれます。

拒否はビルドではなくプラグインに届きます。 ホストはその場で停止して巻き戻すことはしません。以下の文と拒否を示すコードを含む失敗エンベロープでその呼び出しに応答し、依頼したプラグインはそれを自身の依頼への応答として受け取ります。その後ビルドがどうなるかは、そのプラグインが応答をどう扱うかによります。これを致命的として扱うプラグインはビルドを終了させ、報告して処理を続けるプラグインは終了させません。拒否そのものはどちらの場合も同じです。

これはどちらか特定のプラグインの不具合ではありません。このガードは特定の組み合わせではなく、依頼が経由したあらゆるプラグインの組に適用されるため、仕組みに再び入る箇所ではどこでも同じ拒否が発生します。

プラグインが受け取る出力メッセージ:

aggrega_parse_source: producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call(aggrega_parse_source: producer-consumption の再入が拒否されました: ホスト経由で到達した producer は、さらに producer-consumption の呼び出しを行うことはできません)

修正方法: 自身のファイルに原因はなく、オーサリングの変更で解消することもできません。これはビルドに設定されているプラグインの性質です。修正すべきなのは、パースの内部からパースを依頼するプラグインです。メッセージを引用して、その公開者にこの状態を報告してください。そのプラグインが自作のものである場合は、自身がパースを処理している最中にホストへ別のパースを依頼するのではなく、渡されたソースを直接読み取るようにしてください。

The workspace configuration is invalid(ワークスペース設定が無効です)

ワークスペースは、そのルートにある .aggrega-config.yaml によって記述されます。どのレジストリに公開し、どのレジストリから取得するか、アーティファクトキャッシュをどこに置くか、どのプラグインをどのソケットに接続するか、各レジストリの署名方針は何か、といった内容です。このファイルは、エンティティファイルを開く前に読み込まれ、スキーマに照らして検査されます。以降の処理はすべてこのファイルから読み取った内容に基づくためです。

ファイルが存在しないことは失敗ではありません。 設定ファイルのないワークスペースには文書化されたデフォルトが適用されるため、この停止が存在しないファイルを名指しすることはありません。名指しされるのは値を記述していたファイルです。ただし、環境変数が上書きし、スキーマが目にすることのない設定の場合は、その変数が名指しされます。

この検査は、ドキュメントが型付きの設定に変換される前に実行されます。この順序により、メッセージはスキーマが異議を唱えたフィールドパスを示すことができます。後段のどこかで、指し示すフィールドのない型の不一致として報告されることはありません。

単純なスキーマの異議に加えて、次の形もここで報告されます。いずれも、スキーマだけでは対処に使えないほど一般的なことしか言えないためです。配下に何も書かれていない workspace: キー、本来トップレベルに置くキーを workspace: の配下に書いたもの、ファイルが使わない名前の下に書かれた cache: ブロック、レジストリホストの書き方に従っていないレジストリホスト、そしてスキーマは値を受け入れるもののワークスペースでは使えない 3 つの設定、すなわち絶対パスであるかワークスペースルート自体を指す artifact_cache_dir、公開可能なアーティファクト種別ではないものを指す signing.kinds のエントリ、そして uri が oci:// で書かれたレジストリの場所である plugins.providers または providers_append のエントリです。プロバイダーのバインディングはプラグインをその識別子、すなわち provider/<name> と省略可能な :<version> で指定します。capability を解決するときにバインディングが照合されるのはこの識別子だからです。レジストリの場所はプラグインがどこで公開されているかを示すもので、それがどのプラグインかを示すものではないため、そのように書かれたエントリは何も選択できません。function: でエントリ関数を指定していて uri: を指定していないエントリも、それが plugins.linter または linter_append のエントリであるか、判定ロール(ir-verdict または render-verdict)の plugins.governance または governance_append のエントリである場合は、ここで報告されます。これらのアタッチメントは uri でプラグインを選択するため、そのようなエントリはプラグインを何もアタッチせず、指定された関数が呼び出されることはありません。リントはそのエントリが存在しないかのように実行を続け、ビルドはそのエントリが一度も指定していないプラグインを解決する段階になって初めて停止することになります。

設定が列挙するカタログディレクトリ(workspace.catalog_dirs または catalog_dirs_append の下、あるいは workspace.releases の下にある Release 自身のエントリ内に、設定の読み込み元となるどのファイルで書かれていてもかまいません)は、ディレクトリでない場合にもここで報告されます。つまり、そのパスに何も存在しないか、ファイルまたはどこにもつながらないリンクがそこにある場合です。この判定はカタログがそのディレクトリを通じて読み込まれようとするときに行われるため、カタログを読むすべてのコマンドは何かを読み書きする前にそれを拒否し、カタログを読まないコマンドはそのまま実行されます。それを無視して読み進めると、列挙したよりも少ないカタログに対してビルドすることになり、どれが欠けているかを示すものは何もありません。AGGREGA_CATALOG_DIRS が列挙するディレクトリにも同じ規則が適用され、拒否はファイルの代わりにその変数を示します。

レジストリホスト、すなわち registries エントリの host、または default_registry の先頭にあるホスト(それがいずれかのエントリを name: で指していない場合。指している場合はそのエントリのホストを表します)は、ホストそのものとして書きます。小文字で、ドットを含むもの、localhost、ポートを伴う単一の名前、または IP アドレス(IPv6 の場合は角括弧で囲む)のいずれかで、それぞれ省略可能な :port を付けられ、スキームや認証情報は含みません。registries エントリのホストはパスを持ちません。default_registry はホストの後に / とリポジトリパスを続けられます。リポジトリパスは / で連結された小文字のセグメントで、タグ、ダイジェスト、末尾の / は付けません。別の綴りでホストを指す値は、書くべき綴り(default_registry の場合はパスを含む場所全体)を示して拒否されます。これは、そのホストの下に保持されている信頼ポリシーが適用されるようにするためです。HTTPS で到達するホストのポート 443 もこれに含まれます。それがそのホストのデフォルトポートだからです。リポジトリパスではないパスは、それが続くホストを示して拒否されます。また、エントリの name: の後にパスを続けたものは、代わりに書くべき 2 つの綴り、つまり名前のみ、またはエントリのホストの後にパスを続けたものを示して拒否されます。名前はそのエントリのホストを表すものであり、その配下の場所を表すものではないためです。ホストをまったく指さない値、たとえばどのエントリも持たないポートなしの単一の名前や、空白や波括弧を含むテキストは、ホストではないとして拒否されます。default_registry の場合、その拒否ではエントリの名前でもよいことが示されます。AGGREGA_DEFAULT_REGISTRY も同じ解釈に従い、同じ方法で、その変数を示して拒否されます。

出力されるメッセージ。 スキーマの異議は、ファイル、フィールドパス、スキーマの指摘内容を示します:

workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid(ワークスペース設定が無効です)

修正案を示す形はファイルから始まり、フィールドパスとスキーマの異議の代わりに、その具体的な形についての文を述べます。ワークスペースルートを指す artifact_cache_dir の場合:

<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid(artifact_cache_dir の値がワークスペースルートそのものを指しています。この場合、ワークスペースルートにあるカタログディレクトリがキャッシュとして読み飛ばされ、読み込むものがなくなります。キャッシュには専用のサブディレクトリを指定してください。ワークスペース設定が無効です)

使用できない signing.kinds エントリの場合。このメッセージは、すべての種別を対象とするワイルドカードも示します:

<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid(signing.kinds のエントリが署名可能なアーティファクトの種類ではありません。カタログエンティティまたはプラグインの種類を使うか、すべての種類を対象にするワイルドカードを使ってください。ワークスペース設定が無効です)

レジストリの場所として書かれたプロバイダーのバインディング。エントリ、capability、書くべき形を示します:

<path>: plugins.providers[<n>] binds capability "<capability>" to "oci://<registry>/<repository>", which is where a plugin is published rather than which plugin it is; a provider binding names its plugin by its identity — write uri: provider/<name>, with an optional :<version>: workspace configuration is invalid(plugins.providers のエントリが capability をレジストリの場所にバインドしています。これはプラグインがどこで公開されているかであり、どのプラグインかではありません。プロバイダーのバインディングはプラグインをその識別子で指定します。uri にはプラグインの識別子を、省略可能なバージョンとともに書いてください: ワークスペース設定が無効です)

エントリ関数を指定していてプラグインを指定していない、リンターまたは判定ロールのガバナンスのアタッチメント。リスト、エントリ、関数が示されます。ここでは plugins.linter の例です:

<path>: plugins.linter[<n>] names the entry function "<function>" but no plugin uri; an attachment on this list selects its plugin by uri, so this one attaches no plugin and "<function>" is never called — add the uri of the plugin that exports it: workspace configuration is invalid(plugins.linter のエントリがエントリ関数を指定していますが、プラグインの URI がありません。このリストのアタッチメントは URI でプラグインを選択するため、このエントリはプラグインを何もアタッチせず、その関数は呼び出されません。その関数をエクスポートするプラグインの URI を追加してください:ワークスペース設定が無効です)

別の綴りで書かれたレジストリホストの場合。ここでは HUB.AGGREGA.AI です:

<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid(default_registry の値が、指しているレジストリホストの表記で書かれていません。小文字で、スキーム、パス、認証情報、デフォルトポートを含まない表記で書いてください。これがそのホストのトラストポリシーが保持されている表記です。ワークスペース設定が無効です)

リポジトリパスの前のホストが別の綴りで書かれたデフォルトレジストリの場合。ここでは GHCR.io/acme で、書くべき場所全体が示されます:

<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid(default_registry の値が、指しているレジストリの場所の表記で書かれていません。レジストリホストを小文字で、スキーム、認証情報、デフォルトポートを含めずに書き、その後にリポジトリパスを続けてください。これにより、そのホストのトラストポリシーが引き続き適用されます。ワークスペース設定が無効です)

エントリの名前の後にパスを続けた場合。ここでは local/acme で、local という名前のエントリは 127.0.0.1:5000 を表します:

<path>: default_registry "local/acme" is the name of the registries entry "local" followed by a path, and an entry’s name stands for that entry’s host alone; write "local" to use the entry, or its host followed by the path, "127.0.0.1:5000/acme": workspace configuration is invalid(default_registry の値は registries エントリの名前にパスを続けたものですが、エントリの名前はそのエントリのホストだけを表します。エントリを使うには名前だけを書くか、そのホストの後にパスを続けて書いてください。ワークスペース設定が無効です)

ホストを指さない値の場合。その文はホストが取りうる形を列挙します:

<path>: registries[<n>].host "<value>" is not a registry host; write a lowercase host name containing a dot (registry.example.com), localhost, a single name followed by a port (registry:5000), or an IP address, an IPv6 one in brackets — each with an optional :port and nothing else: workspace configuration is invalid(レジストリホストではありません。ドットを含む小文字のホスト名(registry.example.com)、localhost、ポートを伴う単一の名前(registry:5000)、または IP アドレス(IPv6 の場合は角括弧で囲む)を書いてください。いずれも省略可能な :port のみを付けられます:ワークスペース設定が無効です)

何も存在しない列挙済みのカタログディレクトリ。ファイルと行、リスト、記述どおりのエントリ、解決先のパスを示します。リストは workspace.catalog_dirs、workspace.catalog_dirs_append、または `catalog_dirs` of the `workspace.releases` entry "release.yaml" のような Release エントリのリストです:

<path>:<line>: the `workspace.catalog_dirs` entry "<entry>" names <directory>, which does not exist; create that directory, or remove the entry: workspace configuration is invalid(このエントリが指定するディレクトリは存在しません。そのディレクトリを作成するか、エントリを削除してください:ワークスペース設定が無効です)

そして、空の workspace: マーカーの場合:

workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid(workspace はマッピングでなければなりません。カタログディレクトリを持たないワークスペースルートを示すには、空のマッピングを書いてください。ワークスペース設定が無効です)

さらに 2 つは、誤った場所に書かれたキーを示します。default_registry、offline、auto_pull、artifact_cache_dir はいずれも workspace: の配下ではなくトップレベルに置くものであり、パースキャッシュのブロックは parse_cache: です。それぞれ、どのキーを意図しているか、そのキーをどこに置くべきかを示します。

修正方法: メッセージが示すファイルを開き、引用されているフィールドパスに移動します。メッセージに修正案の文が含まれている場合は、正しい綴りや配置が直接示されているので、それ以上調べる必要はありません。代わりにスキーマの異議が含まれている場合は、フィールドパスが問題のキーで、異議はスキーマがそこで何を求めていたかを示します。エンティティのページはこのファイルを扱わないため、エンティティの契約を探すのではなく異議を読んでください。artifact_cache_dir はワークスペースルートからの相対パスで書き、専用のサブディレクトリが必要です。これにより、ワークスペースルートのカタログディレクトリがキャッシュと誤認されて読み飛ばされることがなくなります。レジストリの場所として書かれたプロバイダーのバインディングは、手作業でプラグインの識別子に書き換えます。oci://hub.aggrega.ai/plugin/provider/compose は provider/compose になります。書き換えるまでは、aggrega plugin remove を含め、このファイルを読むすべてのコマンドがそれを拒否するためです。aggrega plugin add provider は識別子の形を自ら書き込みます。関数を指定していてプラグインを指定していないリンターまたは判定ロールのガバナンスのエントリには、その関数をエクスポートするプラグインの uri を追加します。エクスポートするプラグインがない場合はエントリを削除します。リンターのリストでは、その後、リンターが設定されていない場合と同様に標準のリンターが実行されます。ディレクトリではない列挙済みのカタログディレクトリは、拒否が示すパスに作成するか、拒否が示す行からそのエントリを削除します。列挙している隣接チェックアウトを含めずに取得したプロジェクトのコピーでは、そのエントリを削除します。

A plugin binding sets a key the socket it attaches to does not read(プラグインのバインディングが、接続先のソケットが読み取らないキーを設定している)

ワークスペース設定のソケットは 2 つの異なる方法でプラグインを接続し、一方の方法に属するキーはもう一方では意味を持ちません。そのキーを受け入れて黙って無視するのではなく、設定が拒否されます。これにより運用者は、後になって設定が効かなかった理由に悩むのではなく、その設定が無効であることを知ることができます。

2 つの不一致は互いに鏡像の関係にあります。

  • capability でバインドされた横断的ソケット。 governance、linter、importer の各ソケットは、uri: によってプラグインを直接接続します。governance プラグインや linter プラグインは capability を提供しないため、そこに capability: バインディングを書いても何も参照されず何にも一致しません。決して解決されない接続になります。importer は自身が扱うフォーマットを公開しますが、どのフォーマットが必要かを決めるのは接続ではなくインポートです。importer の接続は uri: によって importer を指定し、インポートが求めるフォーマットを公開する importer の中からそれを選ぶのはこの指定です。
  • 参照先のないキーを設定するプロバイダーソケット。 プロバイダーのバインディングは capability とそれを提供するプラグインを指定します。プラグインは選択可能な 1 つのエントリではなく固定されたエクスポートの集合を駆動するため、function: はそこでは何も指しません。with: は別の理由で拒否されます。プロバイダーのレンダリング設定は Recipe に書くものであり、ワークスペースのバインディングに置くと、開発者と運用者の分担の誤った側に置くことになるためです。

出力されるメッセージ。 横断的ソケット上の capability:

workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri(workspaceconfig: このソケットは capability でバインドされていますが、横断的ソケットは uri でアタッチします。そのプラグインは capability を提供しないため、capability の検索は何にも一致しません。代わりに uri: でアタッチしてください: 横断的ソケットが capability でバインドされていますが、uri でアタッチします)

プロバイダーのバインディング上の無効な function::

workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket(workspaceconfig: この capability の provider ソケットバインディングが function: を設定していますが、provider は選択可能な単一のエントリではなく、フェーズをキーとする固定のエクスポート群を駆動するため、function: はそこで何も指しません。削除してください: provider ソケットバインディングが、そのソケット上で参照先のないフィールドを設定しています)

そして無効な with:。同じ形式で報告され、代わりに設定を置くべき場所を示します:

workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket(workspaceconfig: この capability の provider ソケットバインディングが with: を設定していますが、provider のレンダリング設定はワークスペースの provider バインディングではなく Recipe に属します。削除してください: provider ソケットバインディングが、そのソケット上で参照先のないフィールドを設定しています)

.aggrega-config.yaml に書かれた function: は、上記の文には到達しません。ワークスペース設定のスキーマはプロバイダのバインディングにそのようなキーを宣言していないため、ファイルが先に E0224 として拒否されます。対処は同じで、キーを削除します:

workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid(workspaceconfig: plugins.providers のエントリの function: /$defs/FixedEntryPluginRef に対して想定外のプロパティ “function” です: ワークスペース設定が無効です)

修正方法: 修正箇所は .aggrega-config.yaml で、各メッセージが正確な編集内容を示します。governance、linter、importer の接続では、capability: を接続するつもりだったプラグインの uri: に置き換えます。プロバイダーのバインディングでは、示されたキーを削除します。それが with: だった場合は、その設定を、そのプロバイダーを通じてレンダリングする Recipe に移します。Recipe がその設定を読み取る場所です。

A capability is bound to more than one provider plugin(1 つの capability が複数のプロバイダープラグインにバインドされている)

capability は workload をアーティファクトに変換する 1 つの方法を指し、解決済みのワークスペースではちょうど 1 つのプラグインがそれを提供します。1 つの capability に 2 つのバインディングがあると、どちらがレンダリングするのか答えが出ません。また、ワークスペース設定は複数の層(共有ファイル、ワークスペースファイル、それぞれが提供しうる追記用の付属ファイル)から組み立てられるため、2 つ目のバインディングは、1 つ目を見ることができなかった作成者の層から提供されることがよくあります。

拒否することで、それが可視化されます。一方のバインディングを黙って優先させると、レンダリング結果がどの層がたまたま最後に読まれたかに左右されることになります。

capability と規則を示す、出力されるメッセージ:

workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin(workspaceconfig: この capability が複数の provider プラグインにバインドされています。capability ごとに plugins.providers エントリをちょうど 1 つだけ残してください: capability が複数の provider プラグインにバインドされています)

修正方法: メッセージが示す capability について plugins.providers エントリを 1 つ残し、もう一方を削除します。2 つが異なる設定層から来ている場合は、自分が管理する層を編集します。自分のエントリを削除すれば共有層が提供するエントリが採用され、自分のエントリを残す場合は共有層のエントリを取り除く必要があります。本当に両方がワークスペースに必要な 2 つのプラグインは 2 つの異なる capability を提供するものなので、両方が必要なら、1 つを二重にバインドするのではなく、それぞれに独自の capability を与えてください。

An importer is attached by more than one plugins.importer entry(importer が複数の plugins.importer エントリによってアタッチされています)

plugins.importer エントリは、その uri が指す importer を接続します。その importer がインポートの求めるフォーマットを公開している場合、エントリはどのバージョンを実行するかを決め、エントリの with.sources と with.settings を渡します。1 つのエントリが 1 つの importer についてこれを行うため、同じ importer(同じ ID で、同じバージョンまたは別のバージョン)を指す 2 つ目のエントリは何にも読まれず、その with は何の通知もなくどの importer にも届きません。そのため、どのコマンドが読み込む場合でも、設定は読み込み時に拒否されます。

ワークスペース設定は複数のファイル(グローバルファイル、プロジェクトルートからコマンドを実行するディレクトリまでの各 .aggrega-config.yaml、それぞれが持ちうる importer_append 付属ファイル、パイプラインの .aggrega-config-append-ci.yaml)から組み立てられるため、2 つ目のエントリは 1 つ目とは別のファイルに書かれていることがよくあります。メッセージは importer と両方のエントリを、先に現れたものから順に示します。各エントリは、記述されているキーと位置、記述されたファイル、そこに書かれた uri によって示されます。

判定されるのは importer のリストだけです。governance と linter のリストは、1 つのプラグインを複数回接続することを受け入れ、各接続がそれぞれの with を持ちます。uri がファイルシステムのパスであるエントリは importer を指さないため、比較されません。

出力されるメッセージ:

importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry(importer が、あるファイル内のエントリによってアタッチされ、さらに別のエントリによって再度アタッチされています。importer ごとに plugins.importer エントリをちょうど 1 つだけ残し、その uri で必要なバージョンを指定してください: importer が複数の plugins.importer エントリによってアタッチされています)

修正方法: メッセージが示す importer について、エントリを 1 つ残します。uri が必要なバージョンを指し、その importer に渡したい with を持つものを残し、もう一方を削除します。2 つが異なるファイルにある場合は、自分が管理するファイルを編集します。自分のエントリを削除すればもう一方のファイルのエントリが採用され、自分のエントリを残す場合はもう一方のファイルのエントリを取り除く必要があります。

A provider binding names a capability containing a colon(プロバイダーのバインディングがコロンを含む capability を指定している)

Recipe の capability: は、最後のコロンまでが capability 名、その後がバージョン固定として読まれます。helm:1.0.0 はバージョン 1.0.0 の capability helm を求めます。plugins.providers エントリはその名前で検索されるため、バインディングが指定する capability がコロンを含むことはなく、capability にコロンを含むエントリにはどの Recipe も到達できません。それを読まれないまま設定に残しておくのではなく、どのコマンドが読み込んだ場合でも、設定は読み込み時に拒否されます。

判定されるのはプロバイダーのリストだけです。importer のリストは同じエントリ形式を共有しますが、そのプラグインは uri: で接続され、フォーマットを import:<format> という名前で示し、そこではコロンが名前の一部です。バインディングの uri: は :<version> で終わっていてもかまいません。それはこの規則が読み取る部分ではありません。

capability を示す、出力されるメッセージ:

the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select(この capability の provider ソケットバインディング: Recipe の capability 参照は、最後のコロンまでが capability、その後がバージョン固定として読まれるため、バインディングが指定する capability にはコロンが含まれません。capability 名のみをバインドし、各 Recipe に必要なバージョンを固定させてください: provider ソケットバインディングがコロンを含む capability を指定しており、どの Recipe もそれを選択できません)

修正方法: エントリには capability 名だけを書き(capability: helm)、バージョンは本来の場所で固定します。Recipe は必要なプロバイダーのバージョンを自身の capability: で固定し、プラグインの特定のバージョンを選択すべきバインディングは、それをプラグインの ID に書きます(uri: provider/helm:1.0.0)。

A governance attachment declares no role, or one that is not a known role(governance のアタッチメントがロールを宣言していない、または既知のロールではないロールを宣言している)

governance のアタッチメントはロールを持ち、プラグイン自身が宣言する種類ではなくそのロールによって、アタッチメントがどこで実行され何をしてよいかが決まります。つまり、ビルドを受理または拒否するか、そしてグラフを読むかレンダリングされた成果物を読むかです。アタッチメントはそのロールを読んでディスパッチされるため、ロールを持たないアタッチメントや誰も認識しないロールを持つアタッチメントは何にもアタッチされず、何も告げられないまま素通りされてしまいます。

この拒否が防ぐのは、その沈黙です。設定されているのに一度も参照されない governance プラグインは、governance を一切受けなかったビルドとまったく同じ出力を生成し、結果のどこにも、手元にあるのがどちらなのかは示されません。

出力されるメッセージ。どちらもアタッチメントを示し、存在するロールを列挙します。ロールがない場合:

workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role(workspaceconfig: governance アタッチメントがロールを宣言していません。role: を既知のロールのいずれかに設定してください: governance アタッチメントがロールを宣言していないか、未知のロールを宣言しています)

認識されないロールの場合:

workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role(workspaceconfig: governance アタッチメントが不明なロールを宣言しています。既知のロールのいずれかを使用してください: governance アタッチメントがロールを宣言していないか、不明なロールを宣言しています)

修正方法: plugins.governance の下のアタッチメントに、メッセージが列挙するロールのいずれかを role: として設定します。どれを選ぶかは、プラグインそのものではなく、プラグインに何をさせたいかについての判断です。受理または拒否するロールはビルドを読んで判定を返し、変換するロールは、与えられたものをプラグインが変更することを許す明示的な指示です。メッセージには完全な一覧が示されるため、使うべき綴りはメッセージ自体にあります。

A registry alias matches more than one host(レジストリのエイリアスが複数のホストに一致する)

ワークスペース設定ではレジストリに短いエイリアスを付けることができ、コマンドや参照はホストを書き出さずにそのレジストリを指定できます。エイリアスはちょうど 1 つのホストを選択します。この状態は、トークンが 2 つのレジストリエントリのエイリアスに一致したときに報告されます。どのホストが意図されたのか答えがなく、一方を選ぶと、作成者が指定していないレジストリへ成果物を黙って送ったり、そこから取得したりすることになるためです。

出力されるメッセージ。エイリアス、それを主張したエントリの数、それらがどのホストかを示します:

registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host(レジストリエイリアスが複数のホストに一致します。ホストでレジストリを指定するか、重複したエイリアスを削除してください: レジストリエイリアスが複数のホストに一致します)

修正方法: .aggrega-config.yaml を開き、メッセージが列挙するホストのいずれか 1 つにエイリアスを付けるか、レジストリをホストで指定して参照からエイリアスを外します。メッセージはエイリアスを持つすべてのホストを示すため、確認すべきエントリはメッセージにあります。エントリが異なる設定レイヤーから来ている場合は、自分が管理するレイヤーを編集してください。

The lockfile does not satisfy its schema(lockfile がそのスキーマを満たしていない)

release の lockfile は、ビルドが何に解決されたかを記録します。到達するすべてのエンティティ、ライブラリ、プラグインについて、選択されたバージョンと、そのバージョンのバイト列のダイジェストです。lockfile は型付きのピンに変換される前に読み込まれてスキーマと照合されるため、適合しないドキュメントは、穴のあいたピンを黙って生成するのではなく、失敗したフィールドパスとともに拒否されます。

lockfile は機械が書き込むものです。 release を解決する pull によって生成され、後で同じビルドが同じように解決されるようコミットされます。そのため、スキーマの失敗はほぼ常に、意図的に書かれたものではなく、手作業での編集、ドキュメントを解決途中のまま残したマージ、またはファイルの以前の形に合わせて書かれた lockfile(たとえば entities が kind を持たないもの)によるものです。

lockfile が存在しない場合は別の状態であり、報告のされ方も異なります。lockfile は必須であるため、その欠如はビルドが lockfile を探す箇所で、それを作成する pull を実行するよう指示とともに報告されます。

出力されるメッセージ。ファイル、フィールドパス、スキーマ自身の指摘を示します:

lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation(lockfile: ファイルがスキーマ検証に失敗しました)

ビルドと aggrega pull --verify は、lockfile を再度書き込むコマンドを追加します:

…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release(lockfile: ファイルがスキーマ検証に失敗しました。このコマンドを実行して Release から書き直してください)

完全に空のドキュメントは、示すべきフィールドがないため、別に報告されます:

lockfile: <path>: document is empty(lockfile: ドキュメントが空です)

修正方法: lockfile を手作業で修復しないでください。release の pull を再実行すると、実行した解決結果からドキュメントが書き直されるので、その結果をコミットします。再解決することで、ピンが release の実際の到達先と一致するドキュメントが生成されます。失敗がマージの後に起きた場合は、編集ではなく再 pull によって競合を解決することで、パースはできても誤ったバージョンをピン留めするドキュメントを避けられます。メッセージのフィールドパスはまず読む価値があります。損傷が 1 つのエントリにあるのか、ドキュメント全体の形にあるのかがわかります。

カタログの解決時

読み込みの後、コンパイラは Manifest の 2 つの階層(型マップ、次に名前マップ)をたどって各 Component の Recipe を選び、Manifests、Components、Features にある extends チェーンをたどります。Release 自身の extends チェーンも同じ走査で、一段階早くたどられます。Release の解決時、つまりそれが指す Manifest と Aggregate のどちらかが探される前にたどられるため、以下の条件はチェーンが供給するはずだった兄弟ポインタではなく Release に対して報告されます。

Cyclic extends chain(extends チェーンの循環)

extends ポインタのチェーンが自分自身に戻ってループしています。extends を宣言するすべての種類(Component、Feature、Manifest、Release)は 1 つのチェーン走査でたどられるため、ループはどこで見つかっても同じ文言で報告されます。

出力されるメッセージ。条件を示す文で始まり、次に解決の起点となったエンティティとそれを拒否した規則、その後ループを閉じる辺、つまり問題の extends: を持つエンティティとそれが宣言する参照が続きます:

cyclic extends chain (<kind> <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain(循環する extends チェーン。エンティティが既にチェーン内にある参照を extends しています。そのエンティティの extends を削除するか、チェーン外のエンティティを指すようにしてください)

最初に示されるエンティティと辺に示されるエンティティは通常異なります。そこが要点です。ループはその上のすべてのエンティティに対して報告されますが、編集すべき extends: 行は辺が示すものです。見出しではなく辺に従ってください。

Manifest の場合、<kind> は Manifest となり、各エンティティはその metadata.name で示され、<reference> は記述どおりの extends: の値です。./base.yaml のような相対パス、または Release の隣にある Manifest の素の metadata.name です。どちらの形式で書いたかは報告内容を変えません。Manifest のリンクはそれが解決されるファイルであるため、たまたま同じ metadata.name を宣言する 2 つの Manifest ファイルは 2 つのリンクであり、その両方を通るチェーンはループではありません。

Release も同様に読みます。ここではファイル同一性の点がより重要です。保護する形が日常的なものだからです。<kind> は Release となり、<reference> は extends: が示す相対パスで、Release のリンクはそれが解決されるファイルです。環境ではなくデプロイされるシステムを名前とする 2 つの Release ファイル(どちらも metadata.name: shared-release で、一方が他方を拡張する)は 2 つのリンクであり、その両方を通るチェーンはループではありません。

ループはその長さにかかわらずループとして報告されます。 チェーン走査は終端のあるチェーンにのみ深さの上限を適用するため、上限を超える数のエンティティにまたがる循環も、深すぎるチェーンとしてではなくここで報告されます。ループの対処法は決して短くすることではありません。

修正方法: 辺が示すエンティティを開き、その extends: を削除するか、まだチェーン上にないエンティティを指すようにします。複数の階層で内容を共有するつもりだった場合は、重複した内容を単一の基底エンティティにまとめると、ループと重複を同時に解消できます。

Recipe implements does not match the mapped component type(Recipe の implements がマッピングされたコンポーネントタイプと一致しない)

Manifest のマッピングエントリが指す Recipe の spec.implements: 宣言が、そのマッピングエントリのコンポーネント型キーと一致しません。spec.implements はディスパッチの仕組みではなく整合性のアンカーです。マッピングの値が Recipe を直接指定し、このチェックは作成者が指定した Recipe が、マッピングした型を宣言するものであることを確認します。

このチェックはいずれかの Recipe が解決される前に合成済みの Manifest を読むため、下流の症状ではなく作成者が書いたマッピングエントリを報告します。

出力されるメッセージ:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (manifest mapping "<component-type>" -> "<recipe-uri>", recipe spec.implements is "<recipe-implements>", expected "<component-type>", or a type "<component-type>" extends)(Manifest のマッピングエントリの Recipe の spec.implements が、マッピングされたコンポーネント型/フィーチャー型キーと一致しません)

Release の依存関係を読むすべてのコマンドがこのチェックを行います。異なるのは、それぞれが結果をどう扱うかです。 aggrega build と aggrega pull は停止します。どちらも後で使うもの(レンダリングされた成果物とロックファイル)を生成するからです。aggrega validate と aggrega lint は、見つけた他のすべての診断とともにこの検出結果を報告し、非ゼロで終了します。これらの役割はワークスペースの問題をすべて伝えることなので、1 つの不具合でレポートが打ち切られることはありません。エディタでは検出結果が他の診断と並んで公開され、そのドキュメントが報告すべき他の内容には影響しません。表示される場所に注意してください。エディタは検出結果を、Aggregate ではなく、マッピングが書かれた Manifest 上の、それが示すマッピングエントリのキーに公開します。extends を通じて継承したエントリのように、Manifest の開いているテキストにそのエントリが書かれていない場合は、Manifest の先頭行に公開します。ワークスペースのどのドキュメントも示さない Release の他の依存関係レベルの検出結果は、Aggregate に残ります。aggrega validate を実行すれば、どのドキュメントを開いていても報告されます。

カタログが保持していない Recipe を指すマッピングエントリは、この条件ではありません。チェックには比較対象がないためそのエントリをスキップし、解決できない Recipe は Recipe の解決時に報告されます。

FeatureRecipe のエントリも同じ形に従います。features.type マッピングのチェックは manifest feature mapping ... featurerecipe spec.implements is ... (expected ...) を出力し、フィーチャー側はマッピングキー自体で照合するため、extends による代替は示しません。

components.type のキーは、別バージョンのインスタンスに到達する場合には、インスタンスごとにも判定されます。 インスタンスの正確な型を指定しないキーは、その正確な型を指定するキーがなく、同じベースに対して他のキーも書かれていない場合に、型のベースを通じてそのインスタンスに到達します。そのため、バージョンなしで書かれたキーや、別のバージョンを指定するキーが到達し得ます。したがってエントリだけでは Recipe が適合するかどうかを判断できないため、ビルドは、キーがこのように到達するコンポーネントインスタンスごとに Recipe を再度判定します。その際、キーの位置には、ビルドがそのインスタンスをコンパイルするバージョンにおけるインスタンス自身の型が置かれます。つまりインスタンスが指定するバージョン、またはバージョンを指定しないインスタンスの場合はカタログが保持するその Component の最も高いバージョンです。インスタンスのバージョンを Recipe の spec.implements: が満たさない場合(完全一致、キャレット範囲、バージョンなしであること、またはインスタンスの型が extends するベースを通じて、のいずれによっても)、この条件が発生し、Manifest ファイルではなくインスタンスの .spec.components.<instance> パスで報告されます:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (Manifest, at .spec.components.<instance>, "<instance>", of type "<component-type>", compiled as "<component-type>:<version>", reached through manifest mapping key "<key>", mapped to recipe "<recipe-uri>", whose spec.implements is "<recipe-implements>"). map this type at this version to a recipe that implements it, with a mapping key naming the version(Manifest のマッピングエントリが指すレシピの spec.implements が、マッピングされたコンポーネント型またはフィーチャー型のキーと一致しません(Manifest、このインスタンスの型とコンパイルされるバージョン、到達したマッピングキー、マッピング先のレシピとその spec.implements)。このバージョンのこの型を、それを実装するレシピに、バージョンを指定するマッピングキーでマッピングしてください)

compiled as の値は、型がバージョンを指定しないインスタンスでのみ表示されます。バージョンを指定するインスタンスでは、そのバージョンが of type に表示されます。インスタンス自身のバージョンを指定するキーは、エントリに対するチェックですでに判定されているため、2 度目の判定は不要です。また、キーによってすでに拒否されたエントリは、上記のとおり 1 回だけ報告され、インスタンスごとに再度報告されることはありません。aggrega build と aggrega pull はこれで停止し、aggrega validate --release はこれを報告して 0 以外で終了します。aggrega lint は Manifest のマッピングエントリを判定し、それが到達するインスタンスは判定しないため、これを報告しません。

修正方法: Recipe の spec.implements: 宣言を Manifest のコンポーネント型キーと一致するよう修正するか、Manifest のエントリを、spec.implements: がコンポーネント型キーと一致する Recipe を指すように変更します。キーが別のバージョンで到達するインスタンスについては、インスタンスのバージョンを指定するマッピングキーを追加して、それを実装する Recipe にマッピングするか、到達しているキーがそのような Recipe を指すようにします。

Manifest mapping value is not a shape a recipe reference accepts(Manifest のマッピング値がレシピ参照で受け付けられる形になっていない)

Manifest のマッピング値が、参照の文法では表現できない形で Recipe または FeatureRecipe を指しています。Recipe 参照が受け付けるのは、素の名前、バージョン付きの名前、ケイパビリティ修飾付きの名前、またはバージョン付きのケイパビリティ修飾付きの名前で、/ は最大 1 つです。それを超えるものを持つ値(core/helm/eso-aws-fetcher:1.0.0 のようなコンポーネント型形式のパス)は、カタログが何を保持していても、カタログのエンティティを指すことはできません。

形は Manifest の合成時、何かが検索される前に判定されます。判定は文字列内の区切り文字を数えることで得られるため、カタログをまったく必要としません。そこで判定することで診断が正確になります。値が意図した Recipe は多くの場合存在し、正しく命名されており、それが見つからないと伝えられると誤ったものを探すことになります。Release の依存関係を解決するすべてのコマンドが同じ方法で報告するため、どのコマンドを実行したかには左右されません。

出力されるメッセージ:

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries <n> slash-separated segments; a recipe reference accepts "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest(Manifest のマッピング値の Recipe 参照が不正です。Manifest のマッピング値を修正してください)

features セクションも自身の座標に対して同じメッセージを出力し、フィーチャーの Recipe 参照はそのように示されます。

ケイパビリティのセグメントにバージョン固定を含む値(compose:1.2.3/svc:1.0.0)も、何かが検索される前に同じように拒否されるため、レジストリからは何も取得されません。固定は Recipe が宣言する capability に書くものであり、そこでそのケイパビリティを提供するプラグインのどのバージョンでレンダリングするかを選択します。参照は、Recipe をケイパビリティ名だけで指定します(compose/svc:1.0.0)。

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries a version pin in its capability segment <segment>; a pin belongs on the capability the recipe declares, and a recipe reference names the recipe by its bare capability, as "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest(Manifest のマッピング値のレシピ参照が不正です: このマッピングキーの値はケイパビリティのセグメントにバージョン固定を含んでいます。固定はレシピが宣言する capability に書くものであり、レシピ参照はケイパビリティ名だけでレシピを指定します。Manifest のマッピング値を修正してください)

修正方法: マッピング値を文法が受け付ける形に短くします。Recipe は自身の metadata.name(任意で spec.capability を接頭辞に、バージョンを接尾辞に付ける)で識別され、実装するコンポーネント型のパスで識別されることはありません。マッピングのキーはコンポーネント型で、マッピングの値は Recipe です。

混同しないでください: 形は正しいがカタログが保持していない Recipe を指す値とは別です。こちらは実際に存在しないエンティティであり、引き続きそのように報告され、URI とそれを参照したマッピングエントリが示されます。

Several Recipes implement one Component type(複数の Recipes が 1 つの Component タイプを実装している)

2 つ以上の Recipes が spec.implements: で同じ Component タイプを宣言しています。1 つのタイプに対して厳密なバージョンを持つ Recipe が 2 つある場合や、バージョンなしの Recipe がピン留めされた Recipe と並んでいる場合です。

これ自体は停止を引き起こさず、ビルドが解決しなければならない曖昧さでもありません。 Recipe の選択はマッピングのみによって行われます。spec.implements: を読んで候補から選ぶものは何もないため、あるタイプを実装する Recipes がいくつあっても、インスタンスをレンダリングするのは Manifest がそのインスタンスをマッピングした Recipe です。spec.implements: は整合性のアンカーとして、つまり作成者がマッピングした Recipe が、マッピング先のタイプを宣言しているものであることを確認するために読まれ、また停止時に提案されるピン候補の出所として読まれます。選択を行うことはありません。

代わりに遭遇するのは、Manifest が何にもマッピングしていないインスタンスに対する停止です。この停止はそのタイプを実装するすべての Recipe を列挙するため、その中から 1 つをピン留めできます。下記の「No Recipe is mapped for a component or feature instance(コンポーネントまたはフィーチャーのインスタンスに Recipe がマッピングされていない)」を参照してください。タイプを実装する Recipe が 1 つでも 5 つでも同じように報告されるため、別個の曖昧さの条件を調べる必要はありません。

修正方法: マッピングを追加します。タイプをキーとするエントリはそのタイプのすべてのインスタンスをルーティングします。名前をキーとするエントリは名前付きの 1 つのインスタンスをルーティングし、先に読まれるため、1 つのインスタンスに兄弟とは異なる Recipe を与える方法でもあります。

Divergent Release (extends + aggregate pointer)(分岐した Release(extends と aggregate ポインタ))

Release が extends: を使ってベースの Release から継承しながら、独自の aggregate: ポインタも宣言しています。Release の JSON Schema は、スキーマ検証(Layer 1、つまりエンベロープチェック)の時点で allOf 制約によってこの形を拒否します。extends: がある場合は aggregate: は禁止され、extends: がない場合は aggregate: と manifest: の両方が必須です。

これは通常のエンベロープ違反として停止するため、診断はそのクラスの形を取ります(error-translation.md の「The document-envelope failure class」を参照してください)。検出結果は、ここで許可されていないキーを指します:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.aggregate: value matches a shape that is not allowed here. correct the document to match its kind’s schema(ドキュメントエンベロープの検証に失敗しました。spec.aggregate: 値がここでは許可されていない形に一致しています。ドキュメントをその種類のスキーマに合わせて修正してください)

修正方法: 子の Release から aggregate: フィールドを削除します。継承は意図的に、子が親と同じ Developer Intent をデプロイするように強制します。別の Aggregate をデプロイする必要がある場合は、extends: を持たない新しい Release を作成してください。

A feature attached by both the Aggregate and the Release cannot be merged(Aggregate と Release の両方でアタッチされたフィーチャーをマージできない)

ローカルの Manifest がベースの Manifest を extends する場合、2 つの層(type: マップと name: マップ)はそれぞれ独立してマージされます。各層の中では、子のキーが最上位レベルで親のキーを上書きします。これは浅い置換であり、深いマージではありません。あるキーに対する子のエントリは、そのキーに対する親のエントリを完全に置き換えます。

同じフィーチャーインスタンス名が Aggregate 側と Release 側の両方に現れ、マージできない状態(許可されている infra のレイヤリングを超えるもの)が競合する場合、コンパイラは停止し、調整できなかったアタッチメントに診断を配置します。競合する 2 つの宣言は固定の順序で続きます。まず Aggregate が宣言したタイプ、次に Release が宣言したタイプです。そのため、両方を開かなくてもどちらのドキュメントが何を宣言したかがわかります。

出力されるメッセージ:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<aggregate-declared-type>", "<release-declared-type>")(フィーチャーのマージ競合: このフィーチャーについて Aggregate と Release の宣言を整合させてください(Aggregate が宣言した型、Release が宣言した型))

コネクションが持つアタッチメントについても同様です。同じコネクションに対する Aggregate のコネクションエントリと Release のエントリが、どちらも 1 つのスロットにアタッチメントを書き、異なる Features を指定している場合、コンポジションが平坦化された時点で、ビルドは 2 つ目のタイプが書かれた Release のエントリで停止し、両方のタイプ、スロット、コネクション、ソケット、コンポーネントを示します:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, the Aggregate names "<aggregate-declared-type>", the Release names "<release-declared-type>", for the slot "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Drop the type from the Release’s entry so it sizes the attachment the Aggregate declares, or name the same Feature in both documents.(フィーチャーのマージ競合: このフィーチャーについて Aggregate と Release の宣言を整合させてください。Release のエントリから型を削除して Aggregate が宣言するアタッチメントのサイジングを行うようにするか、両方のドキュメントで同じ Feature を指定してください。)

修正方法: 2 つの宣言を調整します。同じフィーチャーインスタンスに対する Aggregate 側と Release 側の宣言は、ピラーごとに結合されます。Aggregate は values を、Release は infra を提供します。両側が同じ非ピラーのフィールド(type: など)を指定する場合、値は一致しなければなりません。一方を他方に合わせて修正するか、冗長な宣言を削除してください。

Annotation binding does not resolve against its target Feature(アノテーションバインディングが対象の Feature に対して解決されない)

Manifest のアノテーションバインディングの feature: フィールドが、カタログが読み込まない Feature を指定しているか、バインディングの maps.infra / maps.values リストが、指定された Feature の spec.schema に実際には存在しないドット区切りのパスを宣言しています。どちらの条件でもワークスペースの読み込みは停止します。バインディングが、ランタイムが解決できないパスへ値をルーティングする Feature アタッチメントを合成してしまうためです。

バインディングのルートが解決に失敗する 3 つのケースを 1 つの条件が扱い、診断はそのうちどれに該当したかを示します:

  • Feature not found(Feature が見つからない)。 feature: の値が、読み込まれたカタログに存在しない Feature URI を参照しています。
  • Feature schema does not resolve(Feature のスキーマが解決されない)。 指定された Feature は読み込まれますが、その spec.schema: が JSON Schema 2020-12 の表現に解決されません。内容が不正であるか、たどれないドキュメント間参照を指定しています。このバリアントは解決失敗自体の診断を後ろに伴うため、スキーマが解決されなかった理由を同じ停止から読み取れます。
  • Binding path not in target schema(バインディングのパスが対象のスキーマにない)。 バインディングの maps.infra または maps.values のエントリが、Feature の spec.schema.<pillar>.<path> が宣言していないドット区切りのパスを指定しています。

出力されるメッセージ(Feature-not-found バリアント):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", which this build’s catalog does not hold; correct or publish the Feature named under "feature")(アノテーションバインディングが対象の Feature に対して解決されません。ルーティング先の Feature はこのビルドのカタログにありません。指定された Feature を修正するか公開してください)

出力されるメッセージ(schema-does-not-resolve バリアント):

annotation binding does not resolve against its target Feature (Manifest, annotation binding routes to Feature "<feature-uri>", whose declared schema does not resolve: <resolution failure>)(アノテーションバインディングが対象の Feature に対して解決されません。ルーティング先の Feature の宣言されたスキーマが解決されません)

このバリアントは Feature と解決失敗を示しますが、バインディングのキーもソース位置も含みません。問題は Feature 自身の spec.schema: にあり、バインディングはそれを指定しているだけだからです。メッセージが引用する Feature URI を mappings.features.annotations で検索して、問題のバインディングを見つけてください。

出力されるメッセージ(path-not-found バリアント):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", at pillar "<pillar>", and path "<path>", which that Feature does not declare a property for under "schema")(アノテーションバインディングが対象の Feature に対して解決されません。ルーティング先のピラーとパスについて、その Feature はスキーマにプロパティを宣言していません)

修正方法: バインディングの feature: URI がカタログに存在し、Recipe が implements: する大文字と小文字を区別する URI と一致することを確認します。Feature のスキーマが宣言しているパスで path-not-found バリアントが発生する場合は、ドット区切りのパスの綴り(大文字と小文字を区別)とピラー名(infra か values か)を確認してください。

A bound annotation value does not conform to the target Feature’s schema(バインドされたアノテーション値が対象 Feature のスキーマに適合しない)

記述したアノテーションがバインディングを介して対象 Feature 上のパスへ値をルーティングし、その値がそのパスで Feature が宣言するサブスキーマを満たさない、またはそこに Feature がプロパティをまったく宣言していない場合です。この条件はバインディングではなく値に対して判定されるため、上記のバインディング対象の停止とは別になっています。前者は Manifest が宣言する内容を拒否し、こちらはそれを介して書かれた内容を拒否します。

特定できたパスでは完全な検証を行い、パスを特定できない場合にのみソフトスキップします。 バインドされたサブキーのサブスキーマが特定されると、値はそのパスにおける JSON Schema 2020-12 の完全な制約セット(型、enum、pattern、数値範囲、ネストされたオブジェクト/配列の形状)に対して検証されます。末端の $ref / allOf / oneOf はスキーマの定義に対して解決されて検証され、スキップされることはありません。ソフトスキップの規律はナビゲーションにのみ適用されます。ウォーカーがバインドされたリーフに到達する前の中間セグメントでエスケープハッチ($ref、patternProperties、oneOf/anyOf/allOf、またはスキーマ本体を持つ additionalProperties)に出会った場合、パスは静的に解決できないため、バリデーターは誤った停止のリスクを避けてエラーを発生させずに続行します。そのバインディングについては、引き続きランタイムが検証を担います。

出力されるメッセージ(値の適合性バリアント):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> value <value> does not conform to Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure>(アノテーションのサブキーが、ルーティング先の pillar においてターゲット Feature のスキーマに適合しません。アノテーションのサブキーの値が、Feature の spec.schema の該当箇所に適合しません)

出力されるメッセージ(未宣言サブキーのバリアント):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> is not declared at Feature <feature-uri> spec.schema.<pillar>.<subkey>(アノテーションのサブキーが、ルーティング先の pillar においてターゲット Feature のスキーマに適合しません。アノテーションのサブキーが Feature の spec.schema の該当箇所で宣言されていません)

この停止は、Feature のアタッチメントに展開される前の、記述されたままのアノテーションに対して発生します。そのため診断には、値が記述されたドキュメントとスコープ(Release 側のアノテーションではバウンダリとコンポーネント、Aggregate 側のアノテーションではコンポーネントパス)、および元になったアノテーションキーが示されます。

ガバナンスプラグインが注入したアノテーションも同じように判定され、診断は誰が書いたかを示します。 アノテーションを注入するためにアタッチされたプラグインは、Release のコンポーネントに値を設定します。そのため、その値はオペレーターがそこに書いたものとまったく同じようにチェックされますが、診断が指す Release の行は誰も書いていないものです。したがって診断には、どのプラグインが値を注入したか、およびそのプラグインがアタッチされているガバナンスロールが追加されます。修正は Release ではなく、そのプラグインの判断の側で行います。

修正方法: バインドされた値を宣言されたサブスキーマを満たすように修正するか、値が正当であればそのプロパティのスキーマを広げます。未宣言サブキーのバリアントは通常、上記のバインディング対象の停止によって先に検出されます。これに到達した場合は、バインディングがパスを宣言しているのに Feature のスキーマがそれを持っていないということなので、誤っている方を修正します。中間の合成演算子によってパスが解決不能になり、後でランタイムが拒否する場合は、スキーマを絞り込んでバインディングのパスにプロパティを直接現れるようにします。

An annotation subkey is not routed by its binding(アノテーションのサブキーがそのバインディングでルーティングされない)

記述したアノテーションが、Manifest のアノテーションバインディングが要求するキーの下にサブキーを持ち、そのうちの 1 つがバインディングのルーティングしない名前になっています。つまり maps.infra にも maps.values にも記載されていません。各サブキーは、バインディングがそのサブキーに対して宣言する Feature のパスへ個別にルーティングされるため、バインディングが指定しないサブキーには行き先がありません。それを除いてアノテーションを展開すると、記述した値が何の通知もなくビルドから外れてしまいます。通常の原因はサブキーの綴りの誤りです。そのためビルドは停止し、そのサブキー、それが書かれたアノテーションキー、およびバインディングが実際にルーティングするすべてのサブキーを示します。

この停止は、隣接する 2 つの条件と同様に、Feature のアタッチメントに展開される前の、記述されたままのアノテーションに対して発生します。前述の「A bound annotation value does not conform to the target Feature’s schema(バインドされたアノテーション値が対象 Feature のスキーマに適合しない)」は、Feature がその値を拒否した場合に、バインディングがルーティングするサブキーを拒否します。後述の「An annotation routes through a pillar its authoring side may not use(アノテーションが記述側で使用できない pillar を経由してルーティングされる)」は、誤った pillar を経由してルーティングされるサブキーを拒否します。どのバインディングも要求しないキーはこの条件には該当しません。何もそれをルーティングせず、ビルドは読み飛ばします。

ドキュメントとアノテーションが書かれた場所、サブキー、アノテーションキー、バインディングがルーティングするサブキーを示す、出力されるメッセージ:

annotation subkey is not routed by the annotation’s binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<subkey>", written under annotation "<key>", whose binding routes only "<subkey>, <subkey>")(アノテーションのサブキーがそのアノテーションのバインディングでルーティングされません(Release、このサブキーはこのアノテーションの下に書かれていますが、そのバインディングは列挙されたサブキーだけをルーティングします))

Aggregate に書かれたアノテーションも同じように、そこで書かれた場所で示されます。サブシステムに書かれたものなら (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …) です。ビルドは、それを書いたドキュメントに従い、Release 側のアノテーションを OPS_ERROR タグ、Aggregate 側のアノテーションを DEVELOPER_ERROR タグのもとに報告します。

修正方法: サブキーをメッセージに列挙されたものと比較します。綴りの誤りであれば、バインディングがルーティングするサブキーに修正します。値を Feature に届けたい場合は、バインディングがそれをルーティングする必要があります。Manifest のバインディングの maps.infra または maps.values にパス(Feature のスキーマが宣言するパス)を追加するか、アノテーションからそのサブキーを削除します。

A bare annotation value does not route to exactly one path of its binding(裸のアノテーション値が、バインディングのちょうど 1 つのパスにルーティングされません)

裸の値として記述したアノテーション(サブキーのマップではなく feature.aggrega.ai/monitoring: "30s" のように記述したもの)はサブキーを指定しないため、どの Feature パスを埋めるのかを示すものが何もありません。この値は、maps.infra と maps.values を合わせて数えたうえで、バインディングが宣言する唯一のパスに配置されます。複数のパスを宣言するバインディングでは、値の行き先が複数あり、その中から選ぶ根拠が何もないため、ビルドはどれかを選ぶのではなく停止します。数は両方のリストにまたがって数えられるため、1 つのパスを infra 経由で、別のパスを values 経由でルーティングするバインディングは、裸の値がどのドキュメントに記述されていても、それを拒否します。

隣接する条件と同様に、この停止は Feature アタッチメントに展開される前の、記述されたままのアノテーションに対して発生するため、診断は値が記述されたドキュメントと場所を示します。判定は記述したアノテーションごとに 1 回行われます。境界やサブシステムに記述した値は、その内部のコンポーネントがそれを取り込むかどうかにかかわらず、その場所で 1 回拒否されます。ビルド内のこのような値は、最初の 1 つだけでなくすべて報告されます。ビルドは、アノテーションを記述したドキュメントに応じて、Release 側のアノテーションを OPS_ERROR タグで、Aggregate 側のアノテーションを DEVELOPER_ERROR タグで報告します。この条件は a scalar annotation value does not route to exactly one path of its binding であり、aggrega explain がそのコードに対して出力するのはこの内容です。

出力されるメッセージです。アノテーションが記述されたドキュメントと場所、アノテーションキー、値、バインディングがルーティングするパスを示します:

a scalar annotation value does not route to exactly one path of its binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<key>", carrying the bare value "<value>", whose binding routes "<path>, <path>, <path>")(スカラーのアノテーション値が、バインディングのちょうど 1 つのパスにルーティングされません:Release 内のこのアノテーションは裸の値を持ち、そのバインディングは列挙されたパスをルーティングします)

空の値は何も書き込まないため、2 つのリストのいずれかが単一のパスを持つ場所であればそこに配置され、どちらも持たない場合にのみ拒否されます。パスをまったく宣言しないバインディングは、Manifest のスキーマがパスを要求するため Manifest の読み込み時に拒否されます。したがって、ビルドがそのような形でこの条件に到達することはありません。

ガバナンスプラグインが注入したアノテーションも同じように判定され、隣接する条件と同様に、その診断には値を注入したプラグインと、そのプラグインがアタッチされているガバナンスロールが追加されます。

修正方法: アノテーションを、各値がどのサブキー向けかを示すマップとして記述します(feature.aggrega.ai/monitoring: {interval: 30s})。こうすると各値は自身の名前でルーティングされます。あるいは、単一の値に、別のアノテーションキーの下で、その値が埋めるパスだけを宣言する専用のバインディングを与えます。

An annotation routes through a pillar its authoring side may not use(アノテーションが、記述側が使用できない pillar を経由してルーティングされる)

アノテーションは記述側によって区分されており、この区分は他のすべての記述 pillar を支配するものと同じです。Aggregate 側のアノテーションは values を対象とするバインディングパスのみを、Release 側のアノテーションは infra を対象とするパスのみを経由できます。それ以外の組み合わせは停止します。

この区分によって、アノテーションのショートカットが相手側の pillar を記述する手段になることを防いでいます。開発者のアノテーションは values を、オペレーターのアノテーションは infra のサイジングを提供します。両方の pillar にパスを宣言するバインディング自体はエラーではありません。各側は許可されたサブセットをルーティングし、相手側のパスには単に到達できないだけです。

1 つのパスを両方の pillar リストに宣言するバインディングは、この停止に最もよく至るケースです。ルーティングのタイブレークはそのようなパスを infra 経由に送るため、Aggregate 側からは到達できなくなり、そこへルーティングする Aggregate 側のアノテーションはここで停止します。ビルドがこの停止に至る前にそのバインディングの形を指摘する勧告については、warnings.md で説明しています。

出力されるメッセージ:

annotation routes through a pillar its authoring side may not use: annotation <key> at <source> routes through pillar <pillar> at path <path>, but <side>-side annotations may only route through pillar <permitted-pillar>(アノテーションが、その記述側が使用できない pillar を経由してルーティングされています。アノテーションは指定のパスで pillar を経由してルーティングされていますが、その側のアノテーションは許可された pillar のみを経由してルーティングできます)

ガバナンスプラグインが注入したアノテーションは Release のコンポーネント上にあるため、Release 側のアノテーションであり、同じ区分が適用されます。その診断には、どのプラグインがそれを注入したか、およびそのプラグインがアタッチされているガバナンスロールが追加されます。診断が指す Release のキーは誰も書いていないものだからです。

修正方法: バインディングが対象とする pillar を持つ側からアノテーションをルーティングするか、記述側に許可された pillar を対象とするパスを持つバインディングを、独自のアノテーションキーで追加します。1 つのバインディングが同じパスを両方の pillar リストに宣言している場合は、各側が到達できるパスを持つように 2 つのバインディングに分割します。診断が注入したプラグインを示している場合、アノテーションはそのプラグインの判断に由来します。そのプラグインか、それが注入に使うバインディングを修正してください。

Authored values or infra do not conform to the declared schema(記述された values または infra が宣言されたスキーマに適合しない)

コンポーネントインスタンス、またはアタッチされた Feature の解決済みの values: または infra: が、宣言されたカタログスキーマに適合しません。ビルドはレンダリング前に各 pillar を宣言されたスキーマに対して検証するため、キーのタイプミス、型の誤った値、範囲外の数値、必須フィールドの欠落は、デプロイ時に壊れたマニフェストを生成するのではなく、その発生源で検出されます。

このチェックは標準的なスキーマ制約を対象とします。誤った型の値(スキーマが整数を宣言している箇所の文字列)、宣言された範囲または enum の外にある値、宣言された pattern に一致しない値、宣言された format(名前付きフォーマットのいずれか)の有効なインスタンスではない文字列、そして指定されていない必須フィールドです。フォーマットの失敗ではキーワードが示され、値、フォーマット、および何が誤っているかが含まれます。たとえば uri フィールドに :::: を与えた場合、aggrega pull と aggrega validate --release は "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:" と出力します。このチェックはデフォルトを考慮します。スキーマが default: を与えているフィールドは省略されていても指定済みとみなされるため、デフォルト付きの必須フィールドが「欠落」チェックに引っかかることはありません。

values pillar は開発者の記述面です。これはクローズドで検証され、スキーマが宣言していないプロパティはタイプミスの可能性があるとして拒否されます。自身のドキュメント内で合成される values スキーマ(ローカルの #/$defs の $ref または allOf)は、その定義コンテキストに対して解決・検証されます。

infra pillar はオペレーターのサイジング面であり、Component が schema.infra pillar を宣言している場合にのみチェックされます。その宣言が、コンポーネントがオプトインする契約です。values pillar が schema.values に対して検証されるのとまったく同じように、その宣言に対して、そしてそれ以外の何に対してでもなくクローズドで検証されます。Component が宣言していないキーはタイプミスとして拒否され、宣言しているキーは型と範囲が強制されます。replicas のような provider 側で重ねられるキーを検証したいコンポーネントは、そのキーを自身の schema.infra に宣言します。provider が受け付ける語彙には、記述された infra 面に重ねるのではなく、その Recipe の valuesMapping を通じて到達します。

このチェックは Release が配置したすべてのコンポーネントのサイジングを測定し、infra: ブロックをまったく書いていないエントリも測定されます。ブロックがないことは空のブロックと同じなので、default: を持たない required: キーは欠落として報告されます。これこそがそうしたキーが検出するために存在するケースです。コンポーネントを配置する方法はどちらも対象になります。バウンダリの components の下に名前を記すことで配置され、それを提供するサブモジュールを aggregates の下でルーティングすることでも配置されます。ルーティングエントリは個々のコンポーネントについて何も述べずにコンポーネントを配置するため、そのように配置されたコンポーネントは空のサイジングブロックから始まり、その型にあるデフォルトなしの required: キーは欠落として報告されます。Release がどちらの経路でも配置しないコンポーネントは、この契約に対してまったく測定されません。それには別の不備があり、ビルドは代わりにそちらを報告します。どのバウンダリにも配置されていないコンポーネントとして、配置する 2 つの方法を示して報告されます。

この契約は、コンポーネントがどこで記述されたかにかかわらず適用されます。サブモジュールが提供するコンポーネントは、Release 自身の Aggregate が宣言するコンポーネントとまったく同じように測定されます。コンポーネントのネストの深さによって、その型のどの制約が適用されるかが変わることはありません。

Feature のアタッチメントも同じ方法で、アタッチされた Feature が宣言する schema.values / schema.infra に対して検証されます。アタッチメントは一つのサーフェスを共有するため、資格情報の Feature(feature.aggrega.ai/kind: secret のラベルを持つもの)も、他のアタッチメントとまったく同じように、それ自身が宣言するスキーマに対して検査されます。検査される値は、アタッチメントの値がスコープ(component、subsystem、boundary、component 固有)をまたいでカスケードした後の実効的なマージ結果です。そのため、あるスコープで正当に導入された値が、より具体的なスコープで不正な値に上書きされた場合も、断片ではなくマージ結果の上で検出されます。型がスキーマを宣言していないアタッチメントは検証されません。アタッチメントの infra は、そのアタッチメント自身の schema.infra に対して検証されます(アタッチメントはオーバーレイであり、provider の union を持ちません)。

アタッチメントの検出結果は、失敗した pillar を記述したドキュメントで報告されます。そのドキュメントの名前のもとに報告され、その作成者に帰属します。values は、それを記述した Aggregate のブロック、つまり component 自身の features: エントリ .spec.components.<component>.features.<attachment>.values.<field> で報告され(component に届く subsystem のブロックより優先されます)、開発者の不備として扱われます。infra は、それを記述した Release のブロック、つまりその component を名指す boundary の下にある Release の component エントリで報告され(boundary 自身の features: ブロックより優先されます)、オペレーターの不備として扱われます。その pillar を所有するドキュメントが記述していない pillar は、アタッチメント自体が記述された場所、つまり type が指定されている場所で報告されます。したがって、Release だけが作成し values を持たないアタッチメントでは、その Feature の values が要求するフィールドは、Release のエントリでオペレーターの不備として、Release が保持するパス(component のエントリ、または boundary 配下のすべての component に対して boundary が作成するアタッチメントであれば boundary の features: ブロック)で報告されます:

[OPS_ERROR E0168] .spec.boundaries.main.components.app.features.check.values.schema
authored pillar does not conform to its declared schema (Release probe, at .spec.boundaries.main.components.app.features.check.values.schema, values pillar does not conform to the Feature schema: missing required property: schema (required))

同じアタッチメントを Aggregate 内の component に記述した場合は、Aggregate の名前のもとで .spec.components.app.features.check.values.schema において [DEVELOPER_ERROR E0168] が報告されます。エディタは、それぞれを記述したドキュメント上で、そのパスのうちドキュメントが保持する最も深いキーに表示します。

接続が持つアタッチメントも同じ方法で検査され、component 自身の features: ブロック(これは当該アタッチメントを保持しません)ではなく、失敗した pillar を記述したドキュメントの接続エントリで報告されます。values は Aggregate の接続エントリ .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field> で報告され(sub-module が提供する component の場合は sub-module 自身のドキュメント内で報告されます)、infra はその接続に対する Release のエントリで報告されます。Release が boundary を名指す場合は、その component を名指す boundary の下で報告されます。Release だけが作成するアタッチメントは、両方の pillar について Release のエントリで報告されます。そのようなアタッチメントは values を持たないため、values がフィールドを要求する Feature は、オペレーターが記述したそのエントリで当該フィールドの欠落を報告します。

エッジごとの接続設定も同じ方法で、socket のエッジごとのコントラクトに対して検証されます。エッジの開発者が記述した values は socket の valueSchema に対して、エッジのオペレーターが(Release から)記述した infra は socket の infraSchema に対して検証されます。ある pillar についてエッジごとのスキーマを宣言していない socket は、その pillar について検証済みの設定を受け付けません(省略 = コントラクトなし、検査対象なし)。診断は、コンシューマー、socket、エイリアスによってエッジを特定します。Release 自身の Aggregate が宣言する component では、オペレーターの infra は、Release がその接続の一つについて記述するすべてのエントリについて検査されます。infra を持たないエントリも含まれ、これによりデフォルトのない required: キーが欠落として報告されます。報告は Release 内のそのエントリで行われ、Release が boundary を名指す場合はその component を名指す boundary の下で行われます。そこがオペレーターが編集する場所です。開発者の values は Aggregate 内の接続エントリで報告されます。

sensitive: true と宣言されたリーフは、制約違反の内容が伏せられます。 違反のテキストは問題の値を引用し、ビルドの診断はビルドを見ている誰もが読めるため、sensitive と宣言されたリーフ、または sensitive と宣言されたオブジェクト内のどこかでは、以下の <constraint failure> が代わりに <redacted> となります。配下に sensitive と宣言されたリーフを持つ位置でも、pillar 自体を含めて同じことが当てはまります。他のキーワードと並べて記述された $ref は、記述された位置で全体としてチェックされるため、それが指す定義の内部での違反はその位置で報告され、そうしなければリーフの値を引用してしまうからです。エンティティ、フィールドパス、pillar、コントラクト名はすべて引き続き示されるため、診断は違反がどこにあるかを依然として伝えます。値を再現しうるテキストだけが省かれます。sensitive は pillar ごとに読み取られるため、values と infra で同じ名前を持つリーフは、それを宣言した pillar でのみ伏せられます。

出力されるメッセージ:

authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”)(記述された pillar が宣言されたスキーマに適合しません) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”)(記述された pillar が宣言されたスキーマに適合しません) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>)(記述された pillar が宣言されたスキーマに適合しません: values pillar が Feature のスキーマに適合しません) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.features.<attachment>.infra.<field>, infra pillar does not conform to the Feature schema: <constraint failure>)(記述された pillar が宣言されたスキーマに適合しません: infra pillar が Feature のスキーマに適合しません) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>)(記述された pillar が宣言されたスキーマに適合しません: values pillar が Feature のスキーマに適合しません) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”)(記述された pillar が宣言されたスキーマに適合しません) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>)(記述された pillar が宣言されたスキーマに適合しません: values pillar が Feature のスキーマに適合しません) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>)(記述された pillar が宣言されたスキーマに適合しません: values pillar が Feature のスキーマに適合しません) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”)(記述された pillar が宣言されたスキーマに適合しません)

修正方法: 問題の値を宣言済みスキーマを満たすように修正するか、値が正当なものであれば、宣言側のスキーマ(Component の schema.values/schema.infra、またはアタッチされた Feature のスキーマ)を広げてその値を宣言します。Component の宣言済みスキーマは aggrega inspect <component-type> で確認でき、各 pillar が期待する正確な型、範囲、デフォルト、必須フィールドを確認できます。

A declared schema contract cannot be read as a schema(宣言されたスキーマ契約をスキーマとして読み取れない)

Component または Feature が、検証の基準となるものを何も生成しないスキーマ契約を宣言しているため、その契約が対象とする設定は何に対しても検証されません。この障害を含みうる契約は 3 つあり、それぞれ専用のフィールドに記述されます。エンティティ自身の spec.schema と、依存ソケットが宣言する 2 つのエッジ単位の契約、すなわち接続の開発者側を対象とする valueSchema とオペレーター側を対象とする infraSchema です。これらの契約が参照できる SchemaLibrary のエントリも、以下の障害のうち 3 つ目を含むことがあります。その場合の報告方法は後述します。

この停止に至る障害は 3 つあり、そのうち 2 つは契約が正常に見えるため見落としやすいものです。 ソケットの契約がそもそも JSON Schema 2020-12 にコンパイルできない場合があります。最も多い原因はキーワードの入力ミスです。エンティティ自身の spec.schema がコンパイルできない場合は、代わりにそのコンパイルが遭遇したコンパクト形式の条件として報告されます(不明なキーワードは E0120、型が受け付けない制約は E0116)。あるいは、正常にコンパイルできても検証器を構築できない場合があります。本体はコンパクト形式としては読み取れるものの、何かを検証できるスキーマではない場合で、たとえばプロパティのスキーマがあるべき位置に裸のスカラーがある場合(items: nonsense)です。あるいは、他のあらゆる点では整形式であっても、サポートされているセットにないフォーマットを指定している場合があります。format: password や、format: emial のような綴り間違いがその例です。これは、何もチェックしない制約として読み取られるのではなく、そのフィールドに値が届くかどうかにかかわらず拒否されます。format に指定できる名前は Named formats に記載されています。3 つはいずれも 1 つの条件として扱われます。対処法が同じであり、どれを見逃しても同じ結果になるためです。

契約を宣言しないことと、読み取れない契約を宣言することは別の状況であり、ビルドはこれらを異なる方法で扱います。 何も宣言していないフィールドはスキップされます。ピラー単位およびエッジ単位の適合性はオプトインであるため、どちらのピラーも制約しないソケットは通常の記述であり、診断は出ません。読み取れないものを宣言しているフィールドは拒否されます。これを見逃すと、ビルドが成功を報告する一方で、そのフィールドが対象とするすべてのペイロードが未検証のまま残ります。これは、停止したことを知らせるものが何もないまま動作を止めたチェックです。そのため、この拒否こそが 2 つを区別します。何も出なければチェックするものがなかったことを意味し、停止すればチェックするものがあったのにそれを読み取れなかったことを意味します。

拒否は、設定を記述したドキュメントではなく、契約を宣言したエンティティを示します。修正すべき箇所はそこだからです。読み取れない契約を持つコンポーネントタイプを渡された Aggregate の作成者は、自身のファイルで変更すべきものはありません。この拒否はカタログの読み込み時に発生し、その時点では宣言したエンティティ、ピラー、記述されたフィールド、ソース行がすべて判明しています。そのため、ビルドから到達しても、aggrega validate から到達しても、aggrega mcp が公開するビルドツールから到達しても、同じ障害は同じ形で報告されます。エンティティが $import: を通じて読み取る契約(spec.schema 全体、その 1 つのピラー、またはソケットの契約)は、インポートされたファイルで報告されます。位置はそのファイルと、その中でフラグメントが記述されている行を示し、メッセージは引き続き契約を宣言したエンティティとフィールドを示します。エンティティ自身の spec.schema で発生するコンパクト形式の停止も、同じ方法で位置が示されます。

サポートされているセットにないフォーマットを指定する SchemaLibrary のエントリは、そのライブラリの読み込み時にこの停止に至ります。拒否はライブラリとエントリを示し、ライブラリファイル内のそのエントリを指し示します。カタログ全体に対する aggrega validate はすべてのライブラリを読み込むため、どのスキーマがそのエントリを参照しているかにかかわらずエントリを報告します。一方、依存関係の解決がそのライブラリに到達しない Release は、そのライブラリを読み込みません。スキーマが $ref: を通じてそのエントリに到達する Release も拒否されますが、その拒否はフォーマットを示しません。aggrega pull はライブラリがカタログに見つからないと報告し(E0114)、aggrega validate --release は参照先が見つからないと報告します(E0121)。問題のエントリと名前を確認するには、カタログに対して aggrega validate を実行してください。

メッセージには、障害を検出したツールが報告したとおりの障害が含まれます。コンパイル失敗の場合は契約内のキー、ソース行、問題のキーワード、検証器を構築できない本体の場合は検証器が拒否した位置、サポートされているセットにないフォーマット名の場合はフィールド、キーワード format、記述されたとおりの名前、およびサポートされているすべての名前です。ソケットの契約内にあるドキュメント間の $ref: で、その SchemaLibrary のエントリが読み込まれたクロージャ内にないものは、aggrega validate がエンティティまたは Release をチェックするときに同じ停止に至ります。エンティティ自身の spec.schema 内では、上記の「A $ref: is not written in a form the compiler can resolve(参照がコンパイラで解決できる形式で書かれていない)」で説明するとおりに報告されます。aggrega pull は Release が必要とするライブラリについて両方の場所を読み取るため、カタログにないライブラリは、2 つのうちどちらが参照していても、「A reference names no entity the catalog holds(参照がカタログにないエンティティを指している)」(E0114)で説明するとおり、より早い段階で pull を停止させます。また、カタログにあるライブラリは、どちらから参照されてもロックファイルにピン留めされます。

読み取れない制約の隣にある整形式の制約は適用されません。 契約は 1 つのドキュメントとして読み取られるため、読み取れない断片が 1 つあるだけで、それとともに宣言されたすべての制約が無効になります。そのため、この停止には、それによって失われる制約以上の価値があります。停止しなければ、適用されているように見え、適用されているように読めるのに、何も適用しない契約が残るからです。

出力されるメッセージは、バージョン付きのエンティティと契約を宣言するフィールドを示し、次にその契約が制約するピラー、最後に障害を示します。以下は、ソケットの契約にキーワードの入力ミスがある例です。

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.usesSchema.<socket>.valueSchema declares a schema no validator can be built from, so the values it constrains would go unmeasured: compactform at <key>:<line> (keyword "<keyword>"): unknown keyword(宣言されたスキーマ契約を使用可能なスキーマにコンパイルできなかったため、何も検証されませんでした。契約を宣言箇所で修正するか、対象の設定に検証が不要であれば削除してください。Component:spec.usesSchema のソケットの valueSchema が検証器を構築できないスキーマを宣言しているため、それが制約する値は測定されません:compactform、示されたキーと行(示されたキーワード):不明なキーワード)

また、Component の values ピラーにサポートされているセットにないフォーマット名がある例です。

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.schema.values declares a schema no validator can be built from, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at values.<field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date)(宣言されたスキーマ契約を使用可能なスキーマにコンパイルできなかったため、何も検証されませんでした。契約を宣言箇所で修正するか、対象の設定に検証が不要であれば削除してください。spec.schema.values は検証器を構築できないスキーマを宣言しているため、制約対象の値は検証されません。フォーマットはサポートされていません)

Feature は Feature "<name>:<version>" として示され、ソケットの契約は spec.usesSchema.<socket>.infraSchema のようにそのフィールドで、ピラーは契約が制約するもの(values、infra または provides)で示されます。エンティティ自身のファイルを指定した aggrega validate は、エンティティをバージョンなしで示します。SchemaLibrary のエントリは、ライブラリとエントリで示されます。

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. SchemaLibrary "<library>": schema "<entry>" names a format no validator can check, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at <field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date)(宣言されたスキーマ契約を使用可能なスキーマにコンパイルできなかったため、何も検証されませんでした。契約を宣言箇所で修正するか、対象の設定に検証が不要であれば削除してください。スキーマは検証器がチェックできないフォーマットを指定しているため、制約対象の値は検証されません。フォーマットはサポートされていません)

修正方法: 診断が示すフィールドを開き、報告されたキーと行の断片を修正してください。多くの場合、原因はキーワードの入力ミス(vocabulary/compact-form-authoring.md のキーワード語彙と照合してください)か、ネストされたスキーマがあるべき位置に値が記述されていることです。障害がサポートされていないフォーマットを示している場合は、named formats のいずれかを記述するか、format: を削除してください。機密情報を持つフィールドは、代わりに sensitive: true を宣言します。password はフォーマットではないためです。SchemaLibrary のエントリの場合、修正は診断が示すライブラリファイルで行います。障害がドキュメント間の参照を示している場合は、SchemaLibrary のエントリが存在し、そのライブラリが Release の依存クロージャから到達可能であることを確認してください。そのフィールドが対象とする設定に本当に検証が不要であれば、何も読み取れない契約を残すのではなく、フィールドを削除してください。

Recipe の source: が空文字列である

Recipe が source: ""、つまり空文字列を宣言しています。Recipe の source: は 2 つのオーサリングモードのどちらかを選択します。sourceless モードでは外部アーティファクトがなく、出力は Recipe の他の種類の入力だけから生成されます。sourced モードでは source: が、レンダリング元となる外部のチャート、モジュール、またはファイルを指定します。フィールドを省略すると前者が、空でない値を指定すると後者が選択され、空文字列はどちらも選択しません。したがって空文字列は意味を持つ値ではなく、曖昧さです。null と書かれた source: は、省略した場合と同じです。

コンパイラが 2 つの解釈のどちらかを代わりに選ぶのではなく、Recipe が拒否されます。空の source: が書かれる最も一般的な経緯は、URI を削除してキーだけを残すことです。この場合は sourced モードが意図されており、空文字列を sourceless として受け入れると、アーティファクトのないコンポーネントが出荷され、2 つの解釈のどちらを採ったかも示されません。

この規則は Recipe の読み込み時に、記述されたとおりの値を読み取ってチェックされます。そのため、Recipe を読み込むすべてのコマンドは、何かが空の値を使おうとする前にこの条件を示します。Recipe ファイルに対する aggrega validate はこれを拒否します。aggrega pull、ビルド、aggrega validate --release、および aggrega mcp が公開するビルドツールは、その Recipe に到達する Release についてこれを報告し、そのせいで解決できなくなった Recipe への参照よりも先に示します。したがって pull は、空の参照を source の種類が判別できない参照として報告するのではなく、この条件を示します。この条件は source が宣言されているかどうかを読む規則より前にチェックされるため、source: が空の Recipe には、重ねる対象のない valuesMapping や欠けている入力の種類についてではなく、source: について伝えられます。

出力されるメッセージです。位置は、その Recipe をバインドするコンポーネントではなく、空の source: が記述された Recipe ファイルと、その中のキー .spec.source に置かれます。このエントリは、その Recipe をバインドするすべてのコンポーネントで共有されるためです:

recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode(recipe の source が空文字列であり、sourceless モードと sourced モードのどちらも指定していません。sourceless モードにするには source フィールドを省略し、sourced モードにするには空でないパスまたは URI を指定してください)

ビルドはこの行を、この条件の短いコード E0251 を伴う CATALOG_ERROR タグの下に、Recipe ファイルを添えて出力します。

修正方法: Recipe が sourceless であれば source: フィールドを完全に省略する(または null に設定する)か、Recipe が sourced であれば空でないパス/URI/構造化されたソースオブジェクトを指定します。

No Recipe is mapped for a component or feature instance(コンポーネントまたはフィーチャーのインスタンスに Recipe がマッピングされていない)

インスタンスの型に、カタログが保持する Recipe へ解決される Manifest マッピングがありません。Recipe の選択はマッピングのみで行われます。コンパイラが spec.implements: を読み取って候補の中から Recipe を選ぶことはないため、マッピングされていない型は、それを実装する Recipes がいくつあっても停止します。implements は選択の判断材料となり、選択は作成者が行い、Manifest がそれを記録します。

同じ条件は、マッピングは存在するもののどこにも行き着かない場合にも適用されます。つまり、受け入れられる参照の形をした値が、カタログが保持していない Recipe を指している場合です。これには、値がピン留めしたものとは異なるバージョンで存在する Recipe や、裸の名前を 2 つのケイパビリティがともに提供している Recipe も含まれます。いずれも、作成者が選択したと言える Recipe には解決されません。どの参照でも表現できない形のマッピング値は、上の「Manifest mapping value is not a shape a recipe reference accepts(Manifest のマッピング値が recipe 参照の受け付ける形ではない)」で別途報告されます。そのため、エンティティが存在しないという主張は、解決され得た参照についてのみ行われます。

コンポーネントインスタンスについて出力されるメッセージです。マッピングが存在し、存在しないものを指している場合:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", mapped to recipe "<uri>"). correct the mapping value in the Manifest, or publish the recipe it names

マッピングが存在せず、その型を実装する Recipes が存在する場合は、それらがピン留めする候補として列挙されます:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", recipes implementing it "<recipe-uris>"). pin one of them in the Manifest

そして、その型を実装するものがまったくない場合は、列挙するものがありません:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe in the catalog implements this type; write one, then map the type to it

カタログディレクトリを指定しないワークスペースでは、検索される Recipes はロックファイルが固定するものだけです。レジストリのものは列挙されず、その型に対して何もマッピングしない Manifest は何も固定しません。この場合、固定された Recipe のどれもその型を実装していないときは、不在の主張はカタログではなく固定内容について行われ、メッセージもそう明示します:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe the lockfile pins implements this type; with no catalog directory, the recipes searched are only those the lockfile pins, not a registry’s; pin one a registry publishes in the Manifest, or write one, then map the type to it(コンポーネント/フィーチャーのインスタンスに対して解決されたレシピがありません。その型の明示的なマッピングを Manifest に追加してください(Manifest、示された位置、示されたインスタンスと型)。ロックファイルが固定するレシピのうち、この型を実装するものはありません。カタログディレクトリがないため、検索されるレシピはロックファイルが固定するものだけで、レジストリのものは含まれません。レジストリが公開するものを Manifest で固定するか、レシピを作成してから型をそれにマッピングしてください)

Aggregate がバージョンなしで記述した型には、ビルドがその型をコンパイルするバージョン、つまりカタログが保持するその Component の最も高いバージョンを実装する Recipes が候補として示されます。カタログがその Component を 1.0.0 で保持している場合、core/datastore/postgres のインスタンスには、spec.implements: core/datastore/postgres:1.0.0 を宣言するすべての Recipe に加え、バージョンなしの型や 1.0.0 を許容するキャレット範囲を宣言する Recipe も候補として示されます。カタログに Component が存在しない型には、そのバージョンなしの型そのものを宣言する Recipes だけが候補として示されます。

機能インスタンスは、これらのケースを独自の形で、それぞれ条件の文の後に報告します。Aggregate がバージョンなしで記述した機能タイプは、コンポーネントタイプと同じように、ビルドがそれをコンパイルするバージョン(カタログが保持するその Feature の最も高いバージョン)で照合され、<type>:<version> を示すメッセージは、そのバージョンのタイプ、つまりカタログで検索された対象を示します。アタッチメントのコンポーネントがマッピングされている Recipe がわかっている場合、FeatureRecipes はその Recipe がバインドするケイパビリティによって区別されます。コンポーネントのケイパビリティにバインドするものが先に提示され、別のケイパビリティにバインドする FeatureRecipe も、コンポーネントの出力の中ではなくその隣の独自の出力としてレンダリングされます。そのため、コンポーネントのケイパビリティにバインドするものが 1 つもない場合は、代わりにそれらが提示されます。どこにもつながらないマッピングは feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog となります。コンポーネントのケイパビリティについてそのタイプを実装する FeatureRecipes がある場合は、それらだけが列挙されます:feature "<instance>" (type "<type>"); feature recipes implementing it for capability "<capability>", the capability its component's Recipe binds to: [<recipe-uris>]; pin one in the Manifest。他のケイパビリティについてのみ実装している場合:feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; feature recipes implementing it for other capabilities: [<recipe-uris>]; pin one of those in the Manifest, and it renders as its own output beside the component's, or write one for "<capability>", then map the type to it。そのタイプを実装するものがまったくない場合:feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it。そしてケイパビリティがわからない場合(コンポーネント自身のマッピングがどの Recipe にも解決されず、それが別途報告される場合、またはアタッチメントが境界に記述されていて、その境界のコンポーネントが複数のケイパビリティを通じてレンダリングされうる場合)は、すべての実装が列挙されます:feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest。カタログディレクトリを指定しないワークスペースでは、検索される FeatureRecipes はロックファイルが固定するものだけです。レジストリのものは列挙されず、そのタイプに対して何もマッピングしない Manifest は何も固定しません。この場合、不在の主張はカタログではなく固定内容について行われ、メッセージもそう明示します。そのタイプを実装するものがない場合:feature "<instance>" (type "<type>"); no feature recipe the lockfile pins implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; with no catalog directory, the feature recipes searched are only those the lockfile pins, not a registry's; pin one a registry publishes in the Manifest, where one for another capability renders as its own output beside the component's, or write one for "<capability>", then map the type to it。ケイパビリティがわからない場合、メッセージはケイパビリティを示さず、pin one a registry publishes in the Manifest, or write one, then map the type to it で終わります。固定された FeatureRecipes が他のケイパビリティについてのみ実装している場合、そのケースのメッセージは no feature recipe in the catalog implements の代わりに no feature recipe the lockfile pins implements となり、ケイパビリティの後には同じ節が続きます。

修正方法: メッセージが求めるマッピングを、Manifest の spec.mappings.components.type の下に、コンポーネント型をキー、Recipe を値として追加します。メッセージが候補を列挙している場合は、その中から 1 つを選びます。その一覧は、ビルドが解決するバージョンでその型を実装すると宣言している Recipes とちょうど一致します。カタログにない Recipe を指している場合は、値を修正するか、ビルドが読み取るカタログディレクトリに Recipe を追加します。値に含まれるバージョンは、カタログが保持するバージョンと一致する必要があります。その型を実装するものがない場合、欠けているのは Recipe そのものです。検索されるレシピやフィーチャーレシピはロックファイルが固定するものだけだとメッセージが述べている場合、ワークスペースはカタログディレクトリを読み取っていないため、その型を実装する Recipe または FeatureRecipe をレジストリが公開している可能性があります。Manifest でその型をそれにマッピングすることで、pull がそれを取得して固定します。

A Manifest name mapping names nothing in the build(Manifest の name マッピングがビルド内の何も指していない)

spec.mappings.components.name または spec.mappings.features.name の下のキーが、ビルドが保持するどのコンポーネントインスタンスもアタッチメントも指していません。name 階層は、実現される対象の正確な名前で照合されます。components.name のキーは Aggregate が記述するコンポーネントインスタンスの名前と照合され、features.name のキーはアタッチメント自身の名前、つまりコンポーネントの features: 内でそれが記述されているキー、または接続上に記述されたアタッチメントの場合は <alias>.<slot> と照合されます。アタッチメントが付いているコンポーネントの名前と照合されることはありません。何も指さないキーは一度も参照されません。それが対象としていたすべてのインスタンスは type 階層を通じて解決され、ビルドは無視したエントリについて何も言わずに完了してしまいます。そのため、ビルドは何かをレンダリングする前に停止します。

メッセージは、Manifest、キーとそれが記述されているセクション、ビルドが実際に保持するその種類の名前(エントリの Recipe または FeatureRecipe が実装する型が判明していて、ビルドがその型のものを保持している場合は、その型に絞り込まれます)を示し、判断できる場合は意図していたと思われる名前も示します。コンポーネントの名前になっている features.name のキーについてはそのコンポーネントが持つその型のアタッチメント、アタッチメントの名前になっている components.name のキーについてはそれを持つコンポーネント、それ以外の場合は 1 編集分だけ異なる名前です。

出力されるメッセージです。以下は、features.name のキーがアタッチメントの付いているコンポーネントの名前として記述されている例です。

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<component>" under mappings.features.name: no attachment in this build is named "<component>"; a features.name key names an attachment by its own name — the key it is written under in a component’s features, or <alias>.<slot> for one written on a connection — never the component it is attached to; attachments of type "<feature-type>" in this build: "<attachments>"; "<component>" is a component, and a features.name key names the attachment rather than the component it is attached to — did you mean "<attachment>"?(Manifest の name マッピングのキーがこのビルド内のどのコンポーネントインスタンスもアタッチメントも指していないため、このエントリは何もバインドしません。Manifest の mappings.features.name の下のキー:このビルドにその名前のアタッチメントはありません。features.name のキーはアタッチメントをそれ自身の名前、つまりコンポーネントの features 内で記述されているキー、または接続上に記述されたものについてはエイリアスとスロットで指し、アタッチ先のコンポーネントを指すことはありません。このビルド内のその型のアタッチメントは示されたとおりです。その名前はコンポーネントであり、features.name のキーはアタッチ先のコンポーネントではなくアタッチメントを指します。示されたアタッチメントのことですか?)

また、インスタンスの名前と 1 編集分だけ異なる components.name のキーの例です。

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<key>" under mappings.components.name: no component instance in this build is named "<key>"; a components.name key names a component instance exactly as the Aggregate writes it; component instances of type "<component-type>" in this build: "<instances>"; did you mean "<instance>"?(Manifest の name マッピングのキーがこのビルド内のどのコンポーネントインスタンスもアタッチメントも指していないため、このエントリは何もバインドしません。Manifest の mappings.components.name の下のキー:このビルドにその名前のコンポーネントインスタンスはありません。components.name のキーはコンポーネントインスタンスを Aggregate が記述するとおりの名前で指します。このビルド内のその型のコンポーネントインスタンスは示されたとおりです。示されたインスタンスのことですか?)

何も指さないキーはすべて、1 回のビルドで Manifest に記述された順に報告されます。

修正方法: キーをメッセージが提案する名前、またはメッセージが列挙する名前のいずれかに変更します。アタッチメントの場合は、そのコンポーネントの名前ではなく、アタッチメントが記述されているキーの名前にします。エントリが不要になった場合は削除します。その型のインスタンスは type 階層を通じて解決されるようになります。

A Manifest maps two version-distinct keys onto one type(Manifest がバージョンの異なる 2 つのキーを 1 つの型にマッピングしている)

型の検索が複数の Manifest マッピングキーに一致しました。型キーはバージョンを許容して照合されるため、core/api-server、core/api-server:1.0.0、core/api-server:2.0.0 を別々のマッピングキーとして記述すると、すべて同じベース型に対応します。そのうち 2 つに到達した検索には選ぶべき Recipes が 2 つあり、どちらを優先するかの規則はありません。

ビルドは、たまたま最初に読み取ったキーで解決するのではなく、停止します。どちらか一方を選ぶと、レンダリングされる出力がマッピングを走査した順序に依存することになり、それはまさにバイト単位で同一の出力が排除するものです。

出力されるメッセージ:

manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous: type "<type>" matches version-distinct keys [<keys>] — pin the authored type’s version or remove the duplicate mapping keys

修正方法: 方向は 2 つあり、メッセージはその両方を示します。重複したマッピングキーを削除し、その型に対応すべきキーを 1 つ残します。余分なキーがバージョンアップの名残である場合はこちらが適切です。あるいは、オーサリング側でバージョンをピン留めし、コンポーネントが宣言する型が意図したキーを正確に指すようにします。複数のキーが意図的なもので、異なるコンポーネントが本当に異なる Recipes を必要としている場合はこちらが適切です。

Two catalog entities in one directory share an identity(1 つのディレクトリ内の 2 つのカタログエンティティが同じアイデンティティを共有している)

同じカタログディレクトリから読み込まれた同じ種類の 2 つのエンティティが、同じアイデンティティを持っています。アイデンティティは参照が指すものであるため、1 つのアイデンティティを 2 つのファイルが主張すると、それへのすべての参照に答えが 2 つ存在することになります。

ディレクトリ内ではこれは停止しますが、ディレクトリをまたぐ場合は停止しません。 2 つの異なるカタログディレクトリに同じアイデンティティが存在する場合は、先勝ちのシャドーイングとして解決されます(先に列挙されたディレクトリが優先されます)。これにより、ローカルディレクトリで公開済みのエンティティを意図的に上書きできます。1 つのディレクトリの内部での衝突だけが、意図的と読める解釈のない記述ミスです。

この規則はインデックス対象のすべての種類で同じです:Component、Feature、Recipe、FeatureRecipe、Plugin、SchemaLibrary、MappingLibrary、WorkloadLibrary、ArtifactLibrary、Aggregate。停止は 2 番目のファイルの位置で報告され、衝突した種類とアイデンティティを示します。

出力されるメッセージ:

duplicate entity identity within a single catalog directory (Component identity "<identity>")

Component の部分には、その種類自身の語(recipe identity、feature recipe identity、Plugin identity、SchemaLibrary identity など)が入ります。

修正方法: 2 つのエンティティのどちらかの名前を変更するか、独自のディレクトリに移動します。Recipe または FeatureRecipe では、アイデンティティにプロバイダースコープとバージョンが含まれるため、バージョンだけが異なる 2 つのファイルは衝突しません。そこで本当に衝突している場合は、同じバージョンが 2 回公開されたことを意味します。よくある原因は、新しいエンティティを作るためにエンティティファイルをコピーし、metadata.name の変更を忘れることです。

1 ファイルずつではなく全体として読み込まれる場所が 2 つあります。名前による検索がその配下のどのドキュメントからも答えうるカタログディレクトリと、Release を保持するディレクトリです。後者に置かれた Aggregates と Manifests は、それらをアイデンティティで指定する Release の解決先になります。これらのファイル中のシンボリックリンクはマシン上のどこへでも向かいうるため、こうしたディレクトリにはそれぞれ、読み込みが留まるべきディレクトリがあり、その外へ出るリンクは読み込まれません。ワークスペース境界に、ここで適用される規則と、それが適用される他のパスが記載されています。

それがどのディレクトリになるかは、読み込まれるディレクトリの位置によって決まります。

  • ワークスペース:ワークスペース内にあるカタログディレクトリまたは Release のディレクトリの場合です。これは、誰も指定していないとき、つまりそこに存在するという理由だけで読み込まれるときのワークスペースの慣例的な catalog ディレクトリにも当てはまります。その場合それはワークスペース自身のものであるため、それ自体がワークスペースの外へ出るリンクである catalog は読み込まれません。
  • ワークスペースの外にある、指定したディレクトリ:その配下にあるものの場合です。--catalog で渡したカタログディレクトリ、またはワークスペース設定が(ワークスペース全体または 1 つの Release に対して)catalog_dirs に列挙するカタログディレクトリ、そして指定した、または設定が指定する Release のディレクトリのうち、ワークスペースの外にあるものが該当します。ディレクトリ自体は指定したとおりに使われ(リンクであるものはその指す先で読み込まれます)、その配下で読み込まれるものはその内部に留まります。これには、指定した後の慣例的な catalog ディレクトリも含まれます。catalog_dirs に列挙されるか --catalog で渡された場合、ワークスペースの外へ出るリンクである catalog は、他の指定したディレクトリと同様に、その指す先で読み込まれます。代わりにその指す先を(どのような表記であれ)指定するか、その上位のディレクトリを指定しても、それを指定したことになります。指定したディレクトリがすでにそこにあるものを読み込むため、そのディレクトリを通じて 1 回だけ読み込まれます。設定でディレクトリを指定することが、ワークスペースの外に置かれたエンティティをワークスペースが読み込む方法です。

判定の対象となるのは、読み込みが何かを取得しうるすべてのエントリです。YAML ドキュメントのような名前のファイルへのリンクと、独自のドキュメントを保持しうるディレクトリへのリンクです。読み込みが留まるべきディレクトリの内部のどこかへ向かうリンクは、走査がそれに出会った位置で読み込まれます。どのカタログ読み込みも何も取得しないファイル(メモファイルやチャートアーカイブなど)へのリンクはここでは判定されず、どこにも向かわないリンクには読み込むものがありません。

コンパイルが依存する検索は、そのようなリンクを読み飛ばさずに停止します。 リンクの先のエンティティが参照の指すものである可能性があり、それを黙って読み飛ばすと、後のカタログディレクトリにある同名の別のエンティティが代わりに解決されてしまうためです。そのため、aggrega build、aggrega pull、aggrega validate、カタログを読み込む場合の aggrega inspect、1 つの Release の lint、そして Release をビルド、プレビュー、グラフ化、検証、または記述するエディターやアシスタントのリクエストはすべて、何かが解決される前に停止し、そのリンクを示します。カタログ全体の lint も同様に停止します。その判定はカタログディレクトリが保持するすべてのドキュメントについて答えるものであるため、そのうちの 1 つが読み込めない間は、カタログに問題がないとは報告しません。Release が自身の Aggregate や Manifest をアイデンティティで指定する場合、あるいは Manifest が拡張元の Manifest をそのように指定する場合にも、Release のディレクトリには同じ規則が適用されます。また、Release の隣にあるドキュメント中のリンクについては、それが参照の指すリンクでなくても、そこでの重複が走査を停止させるのと同じ理由で走査は停止します。ドキュメントの 1 つが読み込めない間は、ディレクトリは名前について答えられないからです。操作の対象として指定された Release(または単独で検査する Manifest)は、それらのドキュメントには含まれません。それは指定された場所で読み込まれたため、それ自体が外へ出るリンクである Release はその指す先で読み込まれ、それが指定するものはリンクの隣、つまり指定したディレクトリで探されます(リンクを通じて指定された Release または Manifest)。

一覧表示では、そのようなリンクは読み飛ばされ、その先のものは何も一覧に含まれません。 エディターのエンティティインデックス、その補完、およびそれが提示する候補には、外へ出るリンクが表すエンティティは含まれず、エンティティインデックスは、ワークスペース内のそのようなリンクを読み込まなかったリンクの中に挙げます。

ワークスペースの設定ファイルも同様にワークスペースに留められます。 ワークスペースのルートからコマンドを実行するディレクトリまでのすべての .aggrega-config.yaml、およびパイプラインがそれらの隣に置く .aggrega-config-append-ci.yaml は、ワークスペース自身のコンテンツです。そのうちワークスペースの外へ出るリンクであるもの(または外へ出るディレクトリリンクを経由して到達するもの)は読み込まれません。すべてのコマンド、エディターの言語サーバー、およびアシスタントのツールは何よりも先に設定を読み込むため、残ったものから作られた設定で実行するのではなく、それぞれそこで停止し、そのリンクを示します。言語サーバー、および独自のストリームで通信するアシスタントのサーバーは、そのようなワークスペースでも起動します。その Releases とエンティティの一覧は、何も設定されていない状態で読み込まれて応答し、そのファイルを読み込まなかったリンクの中に挙げます。一方、設定によって決まるその他のすべてのリクエストは、この状況として拒否され、そのリンクが示されます。このメッセージが示す対処方法は設定固有のものです。グローバル設定ファイルは、どこに置かれていても読み込まれる唯一の設定であり、--config または AGGREGA_CONFIG で指定します。

Release のロックファイルも、書き込まれる場合と同様に読み込まれる場合も同じように扱われます。 Release の隣にあるロックファイルは、ビルド、pull、検証、lint、検査、aggrega cache prune、およびエディターやアシスタントのリクエストが解決に使うピンのために読み込まれ、その書き込みが留められるディレクトリ、つまりワークスペース、またはワークスペースの外で指定された Release の場合はその Release 自身のディレクトリに留められます。外へ出るリンクであるものは読み込まれず、これらはいずれも、マシン上の別の場所に置かれたピンで解決したり、ピンなしで解決したりするのではなく、停止してそのリンクを示します。このメッセージが示す対処方法はロックファイル固有のものです。ロックファイルの置き場所は、pull が書き込む Release の隣の 1 か所だけです。

エンティティの隣で読まれるファイルも同様に扱われます。 2 つの操作は、参照が指すファイルではなく、エンティティ自身のドキュメントの隣にあるファイルを読みます。エンティティのピン留めまたは公開では、別のエンティティがそのディレクトリを共有していないかを判断するため、エンティティのディレクトリ内の他のすべての YAML ドキュメントを読みます。カタログディレクトリで記述された Plugin エンティティの読み込みでは、その隣に置かれたビルド済みの .wasm を読みます。いずれも、エンティティ自身のドキュメントが読まれたディレクトリ(ワークスペース、ワークスペース外で指定したカタログディレクトリ、またはワークスペース外のドキュメントを指定してピン留めや公開を行うエンティティの場合はそのドキュメント自身のディレクトリ)の内側に限定され、その外へ出るリンクは読まれません。aggrega pin、--dry-run の有無にかかわらず aggrega push、ピン留めを行う pull、そしてエディタやアシスタントによるピン留めと公開は、リンクを示して停止します。読まれなかったドキュメントが妨げとなっているエンティティである可能性があるためです。プラグインを読み込むビルドや pull も、マシン上の別の場所にあるバイトを実行したり、代わりに別の場所でプラグインを探したりせず、リンクを示して停止します。このメッセージが示す対処はエンティティの隣のファイルに固有のもので、ファイルそのものをそこに置くことです。

ワークスペースのアーティファクトキャッシュも、書き込み時と同様に読み込み時にも同じように扱われます。 artifact_cache_dir 配下のキャッシュから読まれるすべてのもの(キャッシュされたエンティティ、プラグインまたはライブラリとその隣のマニフェスト、ソースアーカイブとそのメタデータ、ピン留めされた外部入力、署名バンドル、レジストリのローカル検索インデックス)と、aggrega cache status、aggrega cache prune、aggrega cache clear が一覧表示するすべてのワークスペースエントリは、キャッシュへの書き込みが限定されるディレクトリ、すなわちキャッシュディレクトリ自体の内側に限定されます。これはデフォルトの .aggrega/cache でも、設定で指定されワークスペースルートの外に出るものでも同じです。その中でキャッシュディレクトリの外へ出るリンク(ワークスペース内の別の場所であってもそれ以外であっても)は読まれません。また、ワークスペースルート内に記述されたキャッシュディレクトリ自体がワークスペースの外へ出るリンクである場合、その先にあるものも読まれません。ビルド、pull、検証、検索、3 つのキャッシュコマンド、そしてキャッシュを読むエディタやアシスタントのリクエストは、リンクを示して停止します。キャッシュが記録済みダイジェストの下に保持している内容も含まれます。ダイジェストはバイトが何であるかを示すものであり、どこから読んでよいかを示すものではないためです。ワークスペースルート内に記述されたキャッシュディレクトリが、ワークスペース内の別の場所へのリンクである場合は、リンク先で読まれます。aggrega inspect が表示する非推奨の通知は何も決定しないため、対象外です。prune または clear が、キャッシュディレクトリの外へ出るリンクであるキャッシュ自身のディレクトリ、またはそれ自体がワークスペースの外へ出るリンクであるキャッシュディレクトリに出会った場合は、何かを一覧表示する前に、それが行うことになる削除として「A path the operation writes leads through a link out of the directory it must stay inside(操作が書き込むパスがリンクを通じて留まるべきディレクトリの外へ出ています)」の下で扱います。このメッセージが示す対処はキャッシュに固有のもので、リンクを削除すれば pull がキャッシュを再び満たします。別の場所に置くキャッシュは、リンク経由ではなく、ワークスペースルートからの相対パスで artifact_cache_dir に指定します。

ソースが取得するリポジトリは、そのチェックアウトの内側に限定されます。 pull(aggrega pull、または Release の依存関係を解決するビルドやエディタ・アシスタントのリクエスト)が git-repository ソースを取得すると、リポジトリをチェックアウトし、ソースが指定するディレクトリをアーカイブします。チェックアウトはそれ自体が独立したディレクトリであり、リポジトリに含まれるすべてのリンクは、module_subdir 自体も含めて、その内側に限定されます。リポジトリ内のファイルまたはディレクトリへのリンクは、リンク先の内容としてリンクの名前でアーカイブされます。リポジトリの外へ出るリンク(pull を実行するマシン上の任意のファイルを指しうるもの)は読まれません。pull はリンクとそのリンク先を示して停止し、何もキャッシュされません。チェックアウトは pull の停止後に削除される一時ディレクトリであるため、メッセージはリンクをリポジトリ内の位置(コマンドラインの最初の行および文中の chart/secret.txt)で示し、留まるべきディレクトリをソースが指定するリポジトリとリビジョンで示します:which must stay inside the repository <url> at <ref> (commit <commit>)、またはソースが ref を指定していないかコミット自体を指定している場合は at commit <commit> です。リンク先は、マシン上の実際の場所として示されます。このメッセージが示す対処はリポジトリに固有のもので、リンクはそこにコミットされているため、そこで変更します(リポジトリ内を指すようにするか、ファイルそのものに置き換えます)。その後、変更を含むリビジョンをソースで指定します。アーカイブがすでにそのリンクを通じて読んでいるディレクトリへ戻るディレクトリリンクも、それが表すツリーに終わりがないため pull を停止させますが、その拒否はこの条件ではなく通常のエラーです。

カタログ生成が読むオーバーレイも同様に扱われます。 aggrega plugin gen-catalog --from-embedded は、与えられたオーバーレイディレクトリ(--overlay で入力、エディタで選択、またはアシスタントが指定)配下のすべてのオーバーレイを読み、それぞれをそのオーバーレイディレクトリが読まれるディレクトリの内側に限定します。ワークスペース内のオーバーレイディレクトリの場合はワークスペース、ワークスペース外で指定されたものの場合はオーバーレイディレクトリ自体です。オーバーレイディレクトリは指定したとおりに使われ、リンクであるものはリンク先で読まれます。その配下で、限定先ディレクトリの外へ出るリンクであるオーバーレイは読まれず、独自のオーバーレイを含みうる、外へ出るディレクトリリンクも読まれません。生成は、オーバーレイなしで生成するのではなく、何も書き込まずにリンクを示して停止します。限定先ディレクトリ内の別の場所へのリンクであるオーバーレイはリンク先で読まれますが、その内側へのディレクトリリンクには入りません。このメッセージが示す対処はオーバーレイに固有のもので、オーバーレイそのものをオーバーレイディレクトリ配下に置くか、すべてのオーバーレイを含むディレクトリをオーバーレイディレクトリとして指定することです。

インポートするディレクトリは、そのディレクトリ自体の内側に限定されます。 ディレクトリを与えられた aggrega import、アシスタントのインポートツール、セッションの aggrega/import メソッドは、ファイルパターンが選択するディレクトリ内のファイルを、それぞれディレクトリ内の位置の下でインポーターに渡します。そのため、そのディレクトリがどこにあっても(ワークスペース内でも外でも)、それらの読み込みはそのディレクトリの内側に留まります。判断対象は、インポートが何かを取り込むすべてのエントリです。関連するパターン(指定された形式を扱うインポーターのパターン、または形式が認識される場合はインポートが選択候補とするすべてのインポーターのパターン。コンパイラのコアインポーターを含む)が選択するファイルへのリンクと、決して入ることのないディレクトリへのリンクです。ディレクトリの外へ出るもの(ワークスペース内の別の場所でもそれ以外でも)は読まれません。インポートは、ディレクトリのどのファイルも開く前に、何も書き込まずにリンクを示して停止します。ディレクトリ内の別の場所にあるファイルへの選択されたリンクはリンク自身の名前でリンク先が読まれ、どのパターンにも選択されないファイルへのリンクは判断も読み込みもされません。ディレクトリ自体は指定したとおりに使われ、リンクであるものはリンク先で読まれます。リスナー経由で呼び出された場合、アシスタントのツールはリンクをワークスペース内の位置で示し、リンク先については何も示しません。このメッセージが示す対処はインポートされるディレクトリに固有のもので、リンクではなくファイルそのものをディレクトリに置くか、リンク先のディレクトリをインポートすることです。

出力されるメッセージ。条件自身の文で始まり、続いて読み込みが到達したパス、留まるべきディレクトリ、途中で出会うリンク、そのリンク先、最後に対処が示されます:

a file this operation reads leads through a link out of the directory it must stay inside (reading <workspace>/catalog-local/component/app/1.0.0/component.yaml, which must stay inside <workspace>, the link <workspace>/catalog-local/component/app/1.0.0/component.yaml leads to <elsewhere>/component.yaml). nothing was read through that link. Remove the link, or make it lead to a place inside <workspace>. To read what is kept outside, list the directory holding it as a catalog directory in the workspace configuration, rather than reaching it through a link beneath one: a listed directory is read where it leads, even when it is itself a link

この診断にはカテゴリがありません。問題があるのは、記述したドキュメントではなく、ディスク上のレイアウトだからです。

修正方法: リンクを、その指す先のコピーで置き換えるか、削除します。または、エンティティをワークスペースの外に置いておくことを意図している場合は、それを含むディレクトリをワークスペース設定の catalog_dirs に列挙するか、--catalog で渡して、そのディレクトリを独立したカタログディレクトリとして読み取らせます。列挙するのは、リンクが置かれているディレクトリではなく、リンクが指す先のディレクトリです。ディレクトリの下で見つかったリンクは、そのディレクトリがどのように読み取られたかに関わらず同じように判定されるため、それを列挙しても何も変わりません。リンクがワークスペースの慣例の catalog ディレクトリそのものである場合は、catalog(またはその指す先のディレクトリ)を catalog_dirs に列挙するか、いずれかを --catalog で渡せば十分です。指定したディレクトリは指す先で読み取られるためです。リンクが Release のロックファイルである場合は、それを削除して Release を再度 pull します。これにより新しいロックファイルがその横に書き込まれます。Manifest にはカタログ階層がないため、Release が読み取る Manifest は Release 自体の横に置きます。リンクが設定ファイルである場合は、ワークスペース内に置いたコピーで置き換えます。複数のワークスペース間で共有したい設定は、--config または AGGREGA_CONFIG でグローバル設定ファイルとして指定することで、各ワークスペース自身のファイルの下位として読み取られます。リンクが pin または公開されるエンティティの横にある場合は、ファイルそのもので置き換えるか、エンティティであるドキュメントを独立したディレクトリに移動します。Plugin エンティティの横の .wasm である場合は、ビルドされた .wasm そのものをそこに配置します。リンクがアーティファクトキャッシュディレクトリまたはその中のものである場合は、それを削除します(pull によりキャッシュは再び満たされます)。または、キャッシュを別の場所に置くには、artifact_cache_dir をそのディレクトリに設定し、ワークスペースルートからの相対パスで記述します(../shared-cache)。リンクが git-repository ソースが取得するリポジトリにコミットされている場合は、そのリポジトリ内で変更し(リポジトリの内側を指すようにするか、ファイルそのものをコミットします)、その変更を含むリビジョンを指定します。リンクがカタログ生成のオーバーレイディレクトリの下のオーバーレイである場合は、オーバーレイそのもので置き換えるか、すべてのオーバーレイを含むディレクトリをオーバーレイディレクトリとして指定します。リンクがインポートするディレクトリ内にある場合は、リンクではなくファイルそのものをディレクトリ内に置くか、リンクが指す先のディレクトリをインポートします。

A reference to another file leads out of the directory it must stay inside(別ファイルへの参照が、留まるべきディレクトリの外へ出ている)

Release と Manifest は、パスによって別のファイルを指定できます。./… または ../… と書かれた Release の aggregate: と manifest:、その extends:、パスとして書かれた Manifest の extends:、そして Release の parameters: { $import: … } です。ワークスペース内のドキュメントがこの方法で参照できるのは、ワークスペース内のファイルだけです。ワークスペースの外にある Release(コマンドラインで指定したもの、またはワークスペース設定が指定するもの)と、ワークスペースの外でコマンドラインに単独で指定した Manifest が参照できるのは、それ自身のディレクトリ内のファイルだけです。ワークスペースの外で指定したディレクトリと同様に、そのディレクトリはそれ自体が独立したルートとなり、その extends: チェーンがたどり着くすべての Release も同じディレクトリに制限されます。書かれたとおりの形でそのディレクトリの外へ上がるパスも、書かれた形ではディレクトリ内に留まっていても途中で外へ出るシンボリックリンクに出会うパスも、どちらも拒否され、それらが指すファイルからは何も読み込まれません。ディレクトリ配下のまだ存在しないファイルを指すパスは、ここでは拒否されず、読み込めなかったファイルとして報告されます。指定したパスに加えて参照も制限される理由は、ワークスペース境界で説明しています。

パスをどこから解決するかは、言語リファレンスが各キーについて説明している規則と同じです。Release の aggregate: と manifest:、および Manifest の extends: は、コマンドまたはリクエストが指定する Release の隣から解決されます(単独で指定した Manifest の場合は、その Manifest の隣から)。Release の extends: と parameters の $import: は、それを記述している Release の隣から解決されるため、extends: チェーンの各リンクは自身の隣にある親を指定します。診断には、解決の起点となったディレクトリが示されます。

パスではなく名前(aggregate: payments、extends: base-manifest)は、ここでは判定されません。名前は Release の隣にあるドキュメントの中から、また Aggregate の場合はカタログディレクトリの中から検索されます。カタログディレクトリは、上記の「A file the operation reads leads through a link out of the directory it must stay inside(操作が読み込むファイルが、リンクを通じて留まるべきディレクトリの外へ出ている)」の規則によって制限されます。

Release が指定するものを解決するすべての経路は、ファイルを読み込む前にこの条件で停止します。aggrega pull、aggrega build、aggrega validate、Release または Manifest に対する aggrega inspect、単一 Release の lint、そして Release のビルド、プレビュー、グラフ表示、検証、説明を行うエディタおよびアシスタントのリクエストです。エディタでは、診断はそのファイルへ至った Release 内のキーに表示されます。

出力されるメッセージ。条件そのものを表す文で始まり、次に書かれたとおりの参照、extends: と parameters の $import: の場合はそれが書かれたドキュメント、解決の起点となったディレクトリ、参照先、留まるべきディレクトリ、そしてリンクが外へ出している場合はそのリンクが続き、最後に対処方法が示されます。ワークスペース内のドキュメントの場合:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../shared/app.yaml, resolved from <workspace>, which leads to <elsewhere>/shared/app.yaml, outside the workspace <workspace>). nothing was read from that file. A document in the workspace reaches only files inside <workspace>: move the file there — or, where a link carries the reference out, make the link lead there — or open the workspace at a directory holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists

そして、ワークスペースの外で指定された Release または Manifest(それ自身のディレクトリが留まるべきディレクトリとなるもの)の場合:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../aggregates/app.yaml, resolved from <directory>, which leads to <parent>/aggregates/app.yaml, outside <directory>, the directory of a document named outside the workspace <workspace>). nothing was read from that file. A Release or a Manifest named outside the workspace — on the command line, or by the workspace configuration — reaches only files inside its own directory <directory>: move the file there — or, where a link carries the reference out, make the link lead there — or name the document from a workspace holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists

extends: または parameters の $import: の場合は参照の後に written in <document> が、リンクがパスを外へ出している場合は末尾に the link <link> leads to <place> が付きます。aggregate: または manifest: の参照はドキュメントを示しません。別の Release を継承する Release は、それをチェーンの上位の Release から継承している場合があり、いずれにしてもコマンドが指定する Release の隣から解決されるためです。

この診断のカテゴリは [OPS_ERROR] です。参照は Release または Manifest に書かれているためです。

対処方法: ワークスペースの外に置かれた Aggregate については、パスではなくその metadata.name を記述し、それを含むディレクトリをワークスペース設定の catalog_dirs に列挙するか、--catalog で渡します。カタログディレクトリは、ワークスペースが外部に置かれたエンティティに到達するための手段です。Manifest、extends: が指定する Release、parameters ファイルは Release の隣から読み込まれ、名前で検索されることはないため、ワークスペース内に置くか、Release とそのファイルの両方を含むディレクトリでワークスペースを開きます。ワークスペースの外から指定した Release または Manifest については、それが指定するものを自身のディレクトリに置くか、それと指定先の両方を含むワークスペースでビルドします。リンクがパスを外へ出している場合は、リンクをリンク先のコピーで置き換えるか、ディレクトリ内を指すようにします。

No catalog version satisfies a version constraint(バージョン制約を満たすカタログバージョンがない)

参照がカタログに存在するエンティティを指定しているものの、カタログにないバージョンを固定しています。存在しない厳密なバージョン、または利用可能なものがどれも一致しないキャレット範囲です。これは名前自体が不明である単純な未検出とは区別されます。ここではエンティティは存在し、満たせないのはバージョンだけです。そのため、メッセージはエンティティが見つからないと報告して名前のタイプミスを探させるのではなく、その旨を伝えます。

すべての種類が同一の選択処理を通じてこの条件に至るため、満たせない固定はどこに書かれても同じように振る舞います。Manifest の Recipe マッピングにおけるバージョンのタイプミスは、component type における同じタイプミスとまったく同様に拒否されます。

この条件は回復可能であり、そのためエディタはドキュメントを放棄せず、入力を続けている間も診断として表示できます。コマンドラインでは、停止にまとめられます。

出力されるメッセージです。Release の依存関係が到達する参照(コンポーネントの型や Manifest のマッピング値)について、それが収集された場所を示します。

no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>)(参照されたバージョン制約を満たすカタログのバージョンがありません。示されたエンティティと、それを参照している場所)

extends: ポインタに対する固定の場合に出力されるメッセージ:

no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>")

Feature のチェーンが固定を持つ場合は、Component の代わりに Feature となります。

対処方法: 固定をカタログにあるバージョンに変更するか、そのバージョンをカタログに追加します。aggrega inspect は、エンティティが利用可能なバージョンを一覧表示します。何にも一致しないキャレット範囲は、通常、利用可能なバージョンがすべてその範囲が示す下限を下回っていることを意味します。範囲を広げるか、参照が待っているバージョンを公開します。

固定がとる形式のいずれにも当てはまらない固定は別の条件であり、以下の「A version pin is none of the forms a pin takes(バージョン固定が、固定のとるいずれの形式でもない)」で説明しています。

A version pin is none of the forms a pin takes(バージョンピンがピンの取るどの形式にも当てはまらない)

参照は別のエンティティを指定し、コロンの後に必要なバージョンをピン留めできます。形式は 2 つあります。1 つは exact ピンで、1.0.0 のようなセマンティックバージョンです(すべてのエンティティの metadata.version が取る形式です)。もう 1 つは caret ピンで、^1.0.0 のように ^ の後にバージョンが続き、それと互換性のある最も高いバージョンを選択します。どちらでもないピン、つまり ^garbage のようにキャレットの後のテキストがバージョン範囲として読めないもの、あるいは 1.x、1.0、v1.0.0 のようにセマンティックバージョンではない exact ピンは、どのバージョンも指定していないため、それが求めるものを保持できるカタログは存在しません。

このようなピンは、カタログが保持していないエンティティやバージョンとしてではなく、不正な形式として報告されます。そのため診断は、存在しないものを探させるのではなく、入力したテキストへと導きます。ピンがどこに書かれていても同じ条件です。component または feature の type、Component または Feature の extends:、Manifest のマッピングのキーまたは値、Release の spec.aggregate、Recipe または FeatureRecipe の implements:、Recipe の capability: がそれを提供するプラグインの選択時にピン留めするバージョン、そしてパイプラインステップの plugin: です。

これは解決に失敗した参照が報告される場所で報告されるため、不正な形式のピンによってどの参照が解決されるかが変わることはなく、変わるのは失敗の内容です。形式は正しいものの利用可能などのバージョンも満たさないピンは、その箇所がそれに対して報告する条件のままです。上記の「No catalog version satisfies a version constraint(バージョン制約を満たすカタログバージョンがない)」、またはそれが書かれた箇所の not-found 条件です。

ピンとなるのは最後のコロンの後のテキストのみで、しかもそこに / が含まれない場合に限ります。したがって localhost:5000/core/api-server のようなポート付きのレジストリホストへの参照はピンを持たず(ポートのコロンの後のテキストは参照の続きです)、不正な形式のピンとして報告されることはありません。

component type に対する caret ピンの場合に出力されるメッセージ:

reference carries a malformed version pin (reference "<reference>", pin "<pin>", the text after ^ is not a version range, referenced from <authored location>). write the reference as , as : with a semantic version such as 1.0.0, or as :^ for the highest version compatible with it(参照に不正なバージョン pin があります。^ の後のテキストがバージョン範囲ではありません。参照は名前のみ、1.0.0 のようなセマンティックバージョンを付けた形、またはそれと互換性のある最も高いバージョンを選ぶキャレット付きの形で記述してください)

exact ピンの場合は、caret の節の代わりに an exact pin must be a semantic version となります。その後の値は、報告する箇所の言葉で参照がどこに書かれたかを示します。referenced from と記述場所、in the Release's spec.aggregate、または in the recipe's spec.implements です。Manifest のマッピングがその Recipe の implements: と照合される場合は、代わりにマッピングエントリと、そのどちら側がピンを持つか(in the mapping key または in the recipe's spec.implements)が参照の前に来ます。また Component または Feature の extends: では、拡張するエンティティとフィールドがその前に示されます。

修正方法: ピンを 2 つの形式のいずれかで書き直すか、ピンを削除して利用可能な最も高いバージョンを選択します。1.x のようなワイルドカードは caret ピン ^1.0.0 として記述します。先頭に v が付くバージョンや数値が 3 つ未満のバージョンは、1.0.0 のように完全な形で記述します。

Every version a reference could select has been withdrawn(参照が選択し得るすべてのバージョンが取り下げられている)

参照はレジストリが保持するリポジトリに解決されますが、ディスカバリがそこから選択し得たすべてのバージョンが取り下げ済みとしてマークされています。選択できるものが何も残っていません。

これは意図的に、エンティティの欠落としては報告されません。 リポジトリは存在し、それらのバージョンも保持しています。存在しないと伝えれば誤った問題を示し、タイプミスを探させることになり、実際には拒否であるのに暗黙のフォールバックのように読めてしまいます。メッセージは取り下げられた各バージョンを、それに対して記録された理由とともに示すため、伝えられる内容は公開者が記録した内容そのものです。

取り下げられたバージョンを明示的に指定した場合は、この停止にはなりません。exact バージョンはディスカバリを完全に迂回するため、それをピン留めすることが意図的に使い続ける方法です。ビルドは取り下げを報告し、処理を続行します。

出力されるメッセージ:

every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>)(この参照が選択し得る公開済みのバージョンはすべて取り下げられています)

修正方法: 記録された理由を読んでください。通常、移行先が示されています。取り下げられたエンティティを置き換えるものへ移行してください。それが取り下げが求めている結果です。当面は古いものを使い続ける必要がある場合は、参照で exact バージョンをピン留めします。バージョンを指定することがそれを受け入れるという意思表示になり、ビルドはその後、拒否する代わりに毎回取り下げを報告します。

A plugins.providers binding names a plugin that does not serve the capability(プロバイダーのバインディングが、その capability を提供しないプラグインを指定しています)

ワークスペースの plugins.providers ブロックがケイパビリティに対してプラグインのアイデンティティを選択していますが、そのケイパビリティを提供する provider-rendering の Plugin にそのアイデンティティを持つものがありません。バインディングはカタログが応えられない明示的な選択であるため、別のプラグインへ暗黙にフォールバックせず停止します。フォールバックすれば、使わないと指定したプラグインを通して出力をレンダリングし、しかも何も知らせないことになります。

バインディングはプラグインの座標アイデンティティ(プラグインタイプとプラグイン名で、lockfile がピン留めするものでもあります)によって選択し、その後にバージョンを付けることもできます。

これは Recipe がそのケイパビリティを要求しているかどうかにかかわらず判定されます。 そうでなければバインディングは Recipe の capability: がそれを指定したときにのみ読まれるため、ケイパビリティの綴りを誤ったバインディングは何からも参照されず、何からも報告されません。そのため、すべてのビルドとすべての aggrega validate --release は、プラグインを指定する各バインディングを検査します。pull は Recipe が使うかどうかにかかわらずそのようなバインディングを解決するため、ビルドはプラグインを保持し、それが何を提供するかを把握しています。したがって、そのプラグインが提供しないケイパビリティは確実に誤りです。この検査は lockfile ではなくワークスペース設定のバインディングを読み、どのプラグインが Recipe をレンダリングするかは一切変えません。それは引き続き lockfile が決めます。ビルドが保持していないプラグインを指定するバインディング(まだどの pull も取得していないレジストリのプラグイン)は、pull が取得するまで判定されません。プラグインを指定しないバインディングは別扱いで、勧告として判定されます。下記「Conditions that do not halt a build」の「A provider binding names a capability no plugin the build reads serves(provider バインディングが、ビルドが読むどのプラグインも提供しないケイパビリティを指定している)」を参照してください。

出力されるメッセージ。指定されたプラグインが実際に提供するものと、バインディングのケイパビリティが 1 文字違いである場合はその綴りが追加されます:

plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>"(プロバイダーのエントリが指定するプラグインに、その capability を提供するプロバイダーレンダリングプラグインのどれも一致しません)

バインディングが指定するプラグインがビルドの読むカタログにない場合、それが何を提供するかについて述べることがないため、メッセージは「matches that identity」の後で終わります。

修正方法: まず、バインディングの綴りをプラグイン自身の座標と照合してください。プラグインを指定すべきところでケイパビリティを指定しているのがよくある誤りです。書いたものと 1 文字違いのケイパビリティをメッセージが示している場合は、バインディングの capability: がタイプミスです。次に、プラグインがビルドの読むカタログにあり、spec.provider.capabilities にこのケイパビリティを列挙していることを確認してください。かつてそのケイパビリティを提供していて、もう宣言していないプラグインは、まさにこのメッセージを生じます。そのケイパビリティを提供するプラグインが 1 つだけの場合は、バインディングに区別すべき対象がないため、バインディングを削除するのが正しい修正です。

No provider plugin version satisfies a Recipe’s provider pin(Recipe の provider ピンを満たす provider プラグインのバージョンがない)

Recipe がバージョンを固定した provider(helm:1.0.0 や helm:^1.0.0)をバインドしていますが、そのピンを満たす provider をレンダリングする Plugin のバージョンがありません。ピンは明示的な要求であるため、ビルドはそれを無視してたまたま provider を提供しているバージョンでレンダリングするのではなく、停止します。ピンを黙って上書きすると、作成者自身の宣言が存在すべきでないとする出力が生成されてしまいます。

この状態に至る状況は 2 つあり、メッセージはそれらを区別します。capability を提供するものがまったくない場合と、提供するものはあるがそのどのバージョンも制約を満たさない場合です。

これは前述の満たせないエンティティのバージョンとは別のものです。あちらはカタログが保持していないバージョンで指定されたカタログエンティティに関するもので、こちらは capability をレンダリングするプラグインの選択に関するものです。

出力されるメッセージ:

no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it (レシピのプロバイダーバージョン指定を満たすプロバイダーレンダリングプラグインのバージョンがありません: capability はバージョンを指定していますが、それを提供するプロバイダーレンダリングプラグインがありません) no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it (レシピのプロバイダーバージョン指定を満たすプロバイダーレンダリングプラグインのバージョンがありません: capability はバージョンを指定していますが、提供するプラグインのどのバージョンもそれを満たしません)

修正方法: Recipe の capability: フィールドのピンを広げるか修正するか、要求されたプラグインのバージョンをカタログに追加します。キャレットピンは同じメジャー内で下限以上のバージョンに一致するため、^2.0.0 のピンはどれほど新しくても 1.x のプラグインでは満たされません。メッセージが capability を提供するものがないと述べている場合、問題はピンではありません。プラグインがまったく存在しないため、ピンを外しても解決しません。

No plugin advertises a requested parse or import format(要求された parse または import 形式を公開するプラグインがない)

形式が要求されましたが、それを公開しているプラグインがありません。形式によってルーティングする 2 つのソケットにはそれぞれ独自の状態があり、違いは要求された作業だけです。parser プラグインは外部のソース形式を読み込み、importer プラグインは外部のコンテンツを Aggrega のエンティティとして取り込みます。

形式の空間は開かれており、すべてプラグインに属します。どちらのソケットもコンパイラが知る形式の一覧を持ちません。プラグインは扱う形式を capability として宣言し、新しい形式はコンパイラを変更せずに新しいプラグインとして提供されます。そのため、この停止は固定の列挙ではなく現時点で公開されている集合を報告し、一致しない場合はすべて明示的に報告されます。要求には公開者があるか、応じられないかのどちらかです。後述する、コンパイラが持つ parser という 1 つの例外を除き、欠けたプラグインの代わりになるものはありません。

出力されるメッセージ:

no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" (要求されたフォーマットを公開しているパーサープラグインがありません: この capability を公開しているパーサープラグインがありません) no importer plugin advertises the requested format: no importer plugin advertises "import:<format>" (要求されたフォーマットを公開しているインポータープラグインがありません: この capability を公開しているインポータープラグインがありません)

形式を公開しているものの解決できないバージョン形状を持つ parser プラグインが 1 つだけある場合は、黙って通過させるのではなく公開者なしとして扱われ、その旨が表示されます:

no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>" (要求されたフォーマットを公開しているパーサープラグインがありません: この capability に対して解決されるパーサープラグインのバージョンがありません)

解析はコンパイラが持つ parser にフォールバックします。 ビルドは、render-verdict ポリシーに渡す各ファイルのうち、そのポリシーがネイティブに読めない形式のものを解析し、importer は指定した構文の parser を通してソースを読み込み、形式を指定しない import は該当する各シグネチャが指定する構文でソースを解析します。各構文について、ワークスペースのカタログが提供する parser が使われ、カタログが提供しない場合はコンパイラ自身がその構文用に持つ parser が使われます。ビルドが Terraform の出力を読み込むのに使う HCL parser や、コンパイラのコア importer が読み込みに使う JSON parser もその一つであるため、Terraform の出力に対するポリシーにも、コア importer を通した import にも、カタログ内の parser は不要です。カタログがある構文の parser を提供する場合、コンパイラ自身のものは関与せず、カタログ内の名前の異なる 2 つは A parse or import format is advertised by more than one plugin(parse または import 形式が複数のプラグインによって公開されている) の説明どおり拒否されます。したがって、この停止はカタログもコンパイラも parser を提供しない構文を示します。

修正方法: 形式がプラグインの公開どおりに綴られているか確認します。capability はソケットの接頭辞と形式名から成るため、parse:hcl を公開するプラグインは形式 hcl のみを提供します。次に、ビルドが読み込むカタログにプラグインが存在するか確認します。その形式のプラグインが存在しない場合は、そのプラグインが欠けている要素です。何も公開していない形式はコンパイラには読み込めません。

A parse or import format is advertised by more than one plugin(parse または import 形式が複数のプラグインによって公開されている)

2 つ以上の異なるプラグインが同じ形式を公開しており、どれを使うか推測せずに要求をルーティングできません。

両方を保持するカタログは正当であり、問題なく読み込まれます。 2 つの公開者がそれぞれ同じ形式の parser や importer を提供することはあり得、それらのカタログを統合することはサポートされた操作です。この曖昧さは使用時点の状態であり、競合する形式が実際に要求されたときに停止します。そのため、ビルドの範囲外にある競合ペアがビルドを妨げることはありません。

すべての候補がソートされて示されるため、メッセージは毎回同じになります。

出力されるメッセージ:

format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] (フォーマットが複数のパーサープラグインによって公開されています: このフォーマットは列挙されたパーサープラグインによって公開されています) format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>] (フォーマットが複数のインポータープラグインによって公開されています: このフォーマットは列挙されたインポータープラグインによって公開されています)

importer の場合、この停止はもう 1 つの形で発生します。ワークスペースの plugins.importer エントリがその形式を公開する importer を複数アタッチしている場合で、このとき示される importer はアタッチされたものです。

import が選択の対象とする importer は、ワークスペースのカタログにあるものと、すべてのワークスペースで形式を公開するコンパイラのコア importer です。そのため、コア importer が提供する形式(import:langflow や import:flowise)に対して別名の独自 importer を持つカタログは、どちらもアタッチしない import でこの停止に至り、メッセージはカタログのものと並べてコア importer を示します。コア importer と同じ名前でカタログが保持する importer は 2 つ目の公開者ではありません。同じ名前の中では最も高いバージョンが選ばれ、コア importer と同じバージョンで横にモジュールがあるものが、その代わりに実行されます。横にモジュールがないものは、実行可能な同名の importer がその形式を公開している場合には候補になりません。これは独自のインポーターと並んでどれが実行されるかで説明しているとおりです。

修正方法: importer の場合は、両方をカタログに残すか(あるいは独自のものをコア importer と並べて残し)、使いたいものをアタッチします。aggrega plugin add importer が書き込むように、uri でその識別子とバージョンを指定する plugins.importer エントリ、uri: importer/<name>:<version> です。アタッチされた importer は、後述の「A capability is served by more than one provider plugin(capability が複数の provider プラグインによって提供されている)」で説明する provider ソケットで plugins.providers エントリが capability を提供するプラグインの中から選ぶのと同様に、その形式を公開するものの中から選ばれます。示された importer がエントリでアタッチしたものである場合は、使いたいもののエントリを残し、もう一方を削除します。parse ソケットにはこのような選択がないため、parser の場合は、ビルドが読み込むカタログを使いたいプラグインだけが含まれるよう絞り込むことが対処法です。選んだものを保持するディレクトリを --catalog で指定するのが直接的な方法です。

plugins.importer エントリが、カタログに存在しないインポーターのバージョンを固定している

plugins.importer エントリはインポーターをそのアイデンティティとバージョンで接続します。バージョンは厳密なもの(uri: importer/<name>:1.2.0)か範囲(uri: importer/<name>:^1.2.0)です。そのインポーターはインポートが要求するフォーマットをアドバタイズしていますが、インポートが選択対象とするバージョン、すなわちワークスペースのカタログが保持するバージョン、および コアインポーター の場合はコンパイラ自身のバージョンのいずれも、固定を満たしません。厳密なバージョンが存在しないか、範囲に収まるバージョンがひとつもありません。バージョンは明示的な選択であるため、代わりに別のバージョンのインポーターを実行するのではなく、どのインポーターも実行される前にインポートは拒否されます。

これは、前述の「フォーマットをアドバタイズするインポーターが存在しない」場合とは異なります。ここではインポーターはインポートの選択対象であり、フォーマットもアドバタイズしており、エントリが指定するバージョンだけが欠けています。:latest のように、バージョン固定が取るどの形式にも当てはまらない固定は、「A version pin is none of the forms a pin takes(バージョン固定が固定の取るどの形式にも当てはまらない)」で説明するとおり、代わりに不正な形式として報告されます。

出力されるメッセージ(フォーマットのケイパビリティと、エントリが固定するバージョンを示します):

no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it(plugins.importer エントリのバージョンピンを満たす importer プラグインのバージョンがありません: capability がバージョンをピン留めしていますが、それを満たす提供プラグインのバージョンがありません)

修正方法: エントリの uri のバージョンをカタログが保持するものに変更します(コアインポーターの場合、コンパイラ自身のバージョンもその一つです)。あるいは範囲を広げるか、エントリが指定するバージョンをカタログに追加します。キャレット範囲は同じメジャー内で下限以上のバージョンに一致するため、^2.0.0 はどれほど新しくても 1.x のインポーターでは満たされません。

プラグイン参照がレジストリホストまたはアーティファクトパスを含んでいる

Plugin 参照が、レジストリホストの形をしたセグメント(DNS 名やホストとポートのように、ドットまたはコロンを含むもの)、またはアーティファクトパスで始まっています。Plugin はその 座標アイデンティティ で指定されます。すなわち、プラグインタイプ、スラッシュ、名前、そして任意でバージョンです。プルは、設定されたレジストリとプラグインパスを自ら前置してそのアイデンティティを物理的な場所に結び付けるため、すでにそれを含む参照は二重に前置され、取得できない場所に結び付いてしまいます。

この参照は取得時ではなく場所が形成される時点で拒否されるため、後になって読みにくいタグエラーとして現れるのではなく、記述した内容がメッセージに示されます。

出力されるメッセージ(場所を形成していたプルを前置きとし、その下の行に対処方法が示されます):

catalog: tier-3 pull <uri>: wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path: "<identity>" remediation: remove the registry host and the artifact path, leaving the coordinate alone — <pluginType>/<name>:<version>, for example provider/helm:1.0.0; the pull prefixes the configured registry itself, so a reference that already carries one is prefixed twice

修正方法: プラグインタイプより前にあるものをすべて取り除き、座標だけを残します。hub.example.com/plugin/provider/helm:1.0.0 ではなく provider/helm:1.0.0 とします。ビルドがプルするレジストリはアイデンティティの一部ではなくワークスペースの設定であり、これにより、カタログ内のエンティティを編集せずに一つのカタログを複数のレジストリから提供できます。

プラグインまたはレシピの参照がスコープを含んでいない

Plugin または Recipe の参照に先頭のスコープセグメントがありません。スラッシュがまったくないか、/name のようにスラッシュの前が空です。どちらの種類も二つの部分で識別され、最初の部分が同名のエンティティ同士を区別します。Plugin は プラグインタイプ と名前で、Recipe は プロバイダー と名前で識別されます。二つのソケットがそれぞれ redact というプラグインを持つことも、二つのプロバイダーがそれぞれ postgres というレシピを提供することもあり得るため、スコープは飾りではなくアイデンティティの一部です。

空のスコープから構築された場所には空のパスセグメント(二重のスラッシュ)が含まれ、解決できません。そのため、後になって読みにくい取得失敗となるのではなく、場所が形成される時点で参照が拒否されます。

二つの対処方法は、前述の修飾済みプラグインの場合とも互いとも逆であるため、それぞれ個別に記述されています。ここでは参照のセグメントが 不足して おり追加しますが、修飾済みの参照では余分なセグメントがあり、それを取り除きます。

出力されるメッセージ(それぞれプルを前置きとし、その下に対処方法が示されます):

catalog: tier-3 pull <uri>: wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location: "<identity>" remediation: add the missing pluginType segment — write the reference as <pluginType>/<name>, for example provider/helm or governance/redact, using the pluginType the plugin entity declares under metadata.pluginType

catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable)

修正方法: プラグインの場合は、Plugin エンティティが metadata.pluginType で宣言するプラグインタイプを前置します。レシピの場合は、Recipe が spec.capability で宣言するプロバイダーを前置します。レシピの対処方法は、読む価値のある別の可能性も示しています。そもそもレジストリに到達したということは、ローカルのカタログディレクトリが先に検索され、どれもその参照を保持していなかったことを意味します。したがって、レシピがローカルディレクトリから来るはずであれば、スコープを追加するのではなく、ビルドをそのディレクトリに向けてください。

The build consumes an artifact its publisher has deprecated(ビルドが、公開元によって非推奨とされたアーティファクトを使用している)

このビルドが解決する参照に、公開元が記録した非推奨マーカーが付いており、そのマーカーの重大度が、ワークスペースが停止のしきい値として設定した重大度以上です。マーカーは公開済みのアーティファクトに後から付けられるため、昨日問題なくビルドできたアーティファクトに、自分のファイルを何も変更していなくても今日マーカーが付いていることがあります。

報告と停止は別のものであり、設定できるのは停止だけです。 記録されたマーカーはすべて、どの重大度でも報告され、どの設定でもそれを抑止できません。マーカーがビルドを停止させるかどうかは halt_on_deprecated_severity が決め、記録された重大度を設定されたしきい値と warning < error < retracted の順序で比較します。しきい値が設定されていなければ何も停止せず、すべてのマーカーは助言になります。この 3 つ以外の重大度、またはこの 3 つ以外のしきい値は、決して条件を満たしません。不正な値は停止を引き起こすことも、停止を抑止することもできません。

ビルドが停止する前に、停止の原因となったものだけでなくすべての通知が出力されます。 そのため、しきい値を上げても検出結果が失われることはなく、停止そのものは停止の原因となった 1 つの参照を示します。検出結果は参照順に並べられるため、同じ lockfile は毎回同じ順序で報告し、停止の原因となるものも常に同じです。

2 つのストアが検査され、どちらも同じ方法で報告します。lockfile が固定する参照と、受理・拒否の判定のために信頼済みとして記録されたプラグインです。どちらの検査もレジストリにはアクセスせず、すでに記録されたものを読むだけなので、ビルドは事前(ahead-of-time)のままです。

出力されるメッセージ。各検出結果は走査された順に出力され、その後、停止がしきい値を満たしたものを繰り返し、ビルドを停止させた設定を示します:

deprecation: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run `aggrega pull` to refresh it)

deprecation: build consumes a deprecated entity: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run aggrega pull to refresh it): halt_on_deprecated_severity is "error"

2 つの助言的な重大度のいずれかのマーカーは、retracted の代わりに deprecated (warning) または deprecated (error) と表示されます。この区別が保たれるのは、2 つの意味が異なるためです。非推奨だがまだ選択可能であるものと、選択から除外されたものです。強い方を弱い方として報告すると、起きたことを過小に伝えることになります。

修正方法: 記録されたメッセージを読み、移行します。このメッセージは、何に移行すべきかについての公開元自身の説明です。まだ移行できない場合は、halt_on_deprecated_severity を上げるか設定を解除すると、停止は引き続き表示される助言に戻ります。これは回避策ではなく意図的な受け入れであり、通知は出力され続けます。もう使っていないバージョンに対して記録されたマーカーは、aggrega pull で lockfile を更新すると消えます。

A trusted plugin’s recorded digest disagrees with the cached artifact(信頼済みプラグインの記録されたダイジェストがキャッシュ済みアーティファクトと一致しない)

ビルドを受理または拒否する役割で接続されたプラグインに、信頼済みとして記録されたダイジェストがあり、そのプラグインのキャッシュ済みマニフェストが異なるダイジェストを報告しています。両者はプラグインの実行ファイルが読み込まれる前に比較され、不一致があるとその時点で解決が停止します。

この比較によって、記録されたダイジェストは単なる再記述ではなく権威となります。比較がなければ、プラグインのバイト列は、そのバイト列を検証するまさにそのマニフェストから導かれた固定値とだけ照合されます。これは構造上自己整合的であり、アーティファクト全体が置き換えられたことに気づけません。記録されたものと、マニフェストが現在報告するものを比較することで、その検査に外部からの視点が与えられます。

これは、解決されたバイト列がそれに対して主張されたダイジェストと一致しないことを報告するコンテンツダイジェストの不一致とは別のものです。ここでは何も読み込まれておらず、バイト列はマニフェストと一致している可能性も十分にあります。一致しないのは、そもそもどのアーティファクトが解決されているかです。両者を区別することが重要なのは、対処法が正反対だからです。一方は破損または改ざんされたアーティファクトであり、もう一方は正当に変更されたプラグインで、その新しいアイデンティティがまだレビューされていないものです。

出力されるメッセージ:

resolve cached plugin "<plugin-identity>": the digest recorded as trusted for it is <recorded-digest>, but the plugin manifest in the content cache reports <cached-digest>; review what changed and re-record the trusted digest, or restore the recorded artifact: the digest recorded as trusted for this plugin does not match the digest its cached manifest reports

修正方法: 何かを記録し直す前に、何が変わったのかを確認します。これはビルドを拒否できるプラグインであり、記録されたダイジェストは誰かがそれを確認したことを示すものです。プラグインを意図的にアップグレードしたなど、変更が想定どおりの場合は、新しいアーティファクトをレビューし、それに対する信頼済みダイジェストを記録し直します。想定外の場合は、記録が示すアーティファクトを復元します。この不一致は、誰も決めていないのにアイデンティティが変わったことを示しています。

extends: チェーンを組み立てられない

Component、Feature、Manifest または Release の extends: チェーンが解決できない親を指定しているため、チェーンを単一の解決済みエンティティにまとめられません。

これは、独自の条件と独自の対処法を持つ循環(上記の「Cyclic extends chain(循環する extends チェーン)」を参照)とも、下記に独自の条件がある深さの上限を超えたチェーンとも、親は存在しバージョンだけが存在しない、満たせないバージョン固定とも異なります。

出力されるメッセージ。解決できない extends: を持つエンティティと、それが宣言する参照を示します:

inheritance merge failed (Component <name>, at .spec.extends, <entity> extends <reference>, which no catalog entity provides). Verify the extends reference names an entity present in the catalog(継承のマージに失敗しました。extends が参照する先を提供するカタログエンティティがありません。extends の参照がカタログに存在するエンティティを指していることを確認してください)

それを報告するチェックがロックファイルのピンに従ってアーティファクトキャッシュから親を読み込む場合(ビルドおよび aggrega validate --release の extends チェック、カタログ全体に対する aggrega validate、aggrega inspect、そしてエディタやアシスタントの validate ツールから実行される同じチェック)、アドバイスはさらに pull を示します:「a base published to a registry is fetched by aggrega pull --release <release>」(レジストリに公開されたベースは、示されたコマンドで取得されます)。単一のエンティティファイルの検証ではロックファイルを読まないため、pull を実行しても読み込む内容は何も変わらず、そのメッセージはカタログで終わります。

失敗したのが Feature のチェーンである場合は、Component の代わりに Feature が表示されます。ループの場合と同様に、最初に示されるエンティティは解決の起点となったもので、エッジに示されるエンティティは開くべき extends: 行を持つものです。多段のチェーンではこの 2 つは異なります。

Manifest の extends: は別の場所に対して解決されるため、異なる助言が示されます。 Manifest はカタログのコンテンツではなく Release の隣に記述されるオペレーター設定であり、その extends: は相対パスのファイル、または Release 自身のディレクトリにある Manifest の metadata.name を指定します。カタログエンティティを指すことはありません。そのため、メッセージの最後には、参照が何に解決できなかったかと、代わりにどこを確認すべきかが示されます:

inheritance merge failed (Manifest <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path or the name of a Manifest in the Release’s directory(継承のマージに失敗しました。extends の参照を解決できませんでした。extends の参照が相対パス、または Release のディレクトリにある Manifest の名前であることを確認してください)

末尾の詳細は、検索自体が報告した失敗です。読み取れなかったファイル、またはその名前の Manifest を 1 つも索引付けしなかった走査が示されるため、通常は 2 つの形式のどちらが試され、なぜ空で返ったかがわかります。

Release の extends: はディレクトリに対して解決され、受け付ける形式は 1 つです。 Release は親を相対パスで指定します(./base-release.yaml または ../shared/base-release.yaml)。解決の基準となるディレクトリは参照を記述した Release を含むディレクトリであり、チェーン上の各リンクはそれぞれ自身のディレクトリに対して解決されます。そのため、サブディレクトリに置かれたチェーン途中の Release は、コマンドが指定する Release がどこにあっても、自身の隣にある親を指定します。単独のトークンはパスではなく、コンパイラが探す Release を指定しないため、見つかるはずのない場所を探す代わりにここで報告されます:

inheritance merge failed (Release <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path to a Release file, such as ./base-release.yaml, resolved from the directory holding this Release(継承のマージに失敗しました。extends の参照を解決できませんでした。extends の参照が、この Release を含むディレクトリから解決される Release ファイルへの相対パス(./base-release.yaml など)であることを確認してください)

対処法: Component または Feature の場合は、extends: の値がカタログにあるエンティティを、そのエンティティ自身の metadata.name のとおりに(大文字・小文字も含めて)指定していることを確認します。レジストリに公開されたベースは、Release のロックファイルがそれについて記録したピンに従ってアーティファクトキャッシュから読み込まれます。そのため、ベースがレジストリにある場合は aggrega pull --release <release> を実行します。pull はチェーンをたどり、ベースを取得してピン留めします。Manifest の場合は、相対パスが指す場所にファイルがあること、またはその metadata.name を持つ Manifest が Release のディレクトリにあり、パースできることを確認します。Release の場合は、値が ./ または ../ で始まり、指す先のファイルが存在して Release としてパースできることを確認します。

extends: チェーンが深さの上限を超える

Component、Feature、Manifest または Release の extends: チェーンは正常に終わっていますが、上限の 10 を超える数のエンティティを経由しています。

これは上記の条件を共有せず独自の条件を持ちます。2 つの対処法に共通点がないためです。存在しない親は修正すべき参照であり、深すぎるチェーンは平坦化すべき構造です。この上限は構造上の制限ではなく記述上の事故に対する防御です。アーキテクトがベースラインを拡張するのは通常 1〜2 段であり、10 段のチェーンはたいてい意図的な設計ではなく、膨らんだベースツリーです。

この条件に達するのは終わりのあるチェーンだけです。 自身に戻るチェーンは長さにかかわらずループとして報告されるため、この条件が循環の代わりになることはなく、その助言(チェーンを短くする)が循環に対して示されることもありません。

出力されるメッセージ。上限とチェーンが達した長さを示します:

extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root(extends チェーンが最大深度を超えています。上限は 10 ですが、このチェーンはそれを超える長さに達しています。チェーンを短くするか、ルートにより近いベースを extends してください)

失敗したのがそれらのチェーンである場合は、Component の代わりに Feature、Manifest または Release が表示されます。上限は extends を宣言するすべての種類で同じ 10 であり、リンクではなくチェーン上のエンティティを数えます。ちょうど 10 エンティティのチェーンはビルドでき、11 番目のエンティティがこの報告の対象です。したがって、ベースを拡張するベースを拡張するエンティティ(3 エンティティ、2 リンク)は 3 に達しています。

対処法: チェーンの中間部分をまとめます。それほど深いチェーンは通常、各段が少しずつしか追加していないことを意味し、複数の段を 1 つのベースエンティティにまとめることが修正であり、より明快な構造にもなります。各段が本当に別個のものである場合は、チェーンの下位にあるエンティティが、間のすべての段を経由して継承する代わりに、ルートに近いベースを直接拡張できます。それほど深い Manifest チェーンは通常、環境ごとのオーバーレイの積み重ねです。誰も変更しない段を、それがオーバーレイするベースにまとめてください。

extends: チェーン上でアサーション名が二重に宣言されている

エンティティとその拡張元の両方が同じ名前でアサーションを宣言し、両者が異なるルールを宣言しています。拡張するエンティティのアサーションはベースのアサーションに追加されるもので、置き換えることはありません。そのため、異なる 2 つのルールで二重に宣言された名前は、ベースの不変条件を暗黙のうちに無効にしてしまい、エンティティを拡張する目的と正反対になります。

同じ名前を同一のルールで宣言することは衝突ではなく、ビルドできます。これによりチェーン上でのチェックが冪等に保たれます。これがなければ、3 段のチェーンは毎回自身の中間段と衝突してしまいます。

順序は付随的なものではなく契約の一部です。アサーションはマージされた順序で評価され、最初に失敗したものが停止させます。そのため、ベースの不変条件は子孫のものより先にチェックされ、チェーン上ではルートから下へ集合が蓄積されます。

出力されるメッセージ:

assertion name declared twice across the extends chain (Component <name>:<version>, rule assertions, at .spec.assertions.<key>). assertion "<key>" is already declared by the base Component "<base>", carrying a different rule; rename the extending entity’s assertion; an extending entity’s assertions add to the base’s and never replace one(extends チェーン全体でアサーション名が二重に宣言されています。このアサーションはベースの Component によって異なるルールで既に宣言されています。拡張する側のエンティティのアサーションの名前を変更してください。拡張するエンティティのアサーションはベースのアサーションに追加されるものであり、置き換えることはありません)

対処法: 拡張するエンティティのアサーション名を変更します。メッセージにはそのアサーションと、既に宣言しているベースが示されます。ベースのルールを置き換えるつもりだった場合、それは拡張ではサポートされません。ベースのアサーションを絞り込んで、それを拡張するすべてのエンティティで成り立つようにするか、ルールを実際に必要とするエンティティへ移してください。2 つのルールが同じであるべき場合は、テキストとして同一にすれば衝突は解消されます。

Release は、その Aggregate のコンポーネントを 2 つの方法のいずれかでルーティングします。boundaries: の下の名前付き境界か、components: の下のトップレベルコンポーネントです。この 2 つは相互に排他的であり、両方を宣言する単一のドキュメントは読み込み時に拒否されます。この条件は、同じ規則を extends: チェーン全体に適用したものです。名前付き境界を宣言するベースと、トップレベルコンポーネントを宣言する子は、それぞれ単独では形式が正しく、それらを統合して初めて 2 つの選択が 1 つの解決済み Release に入ります。

どちらのドキュメントも単独では誤っていません。そのため、メッセージは両方のドキュメントと両方のキーを示します。ビルドが指定された Release だけを示す診断では、何も問題のないファイルに誘導してしまいます。

リンクが一致しているチェーンには影響しません。 名前付き境界を宣言するリンクばかりであれば通常どおり合成され、トップレベルコンポーネントを宣言するリンクばかりの場合も同様です。停止するのは混在した場合です。

出力されるメッセージ。2 つのファイルと、それぞれが宣言するキーを示します:

release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both (Release <release-file>, boundaries declared by "<file>", components declared by "<file>")(release の extends チェーンが名前付きバウンダリとトップレベルのコンポーネントの両方を組み合わせています。チェーン全体で 1 つのルーティング形状だけを宣言し、両方を宣言しないでください。Release ファイル、バウンダリを宣言したファイル、コンポーネントを宣言したファイルが示されます)

対処方法: チェーンで使用するルーティング形状を選び、チェーン全体でそれを記述します。ベースが名前付き境界を宣言している場合、コンポーネントを設定したい子は、Release のルートではなく、それを保持する境界の中でコンポーネントを指定します。これにより、トポロジーを再記述せずに 1 つのコンポーネントのサイジングを変更することもできます。ベースがトップレベルコンポーネントを宣言している場合、名前付き境界を必要とする子はベースとは異なるルーティング形状を記述しており、その子としてではなく独立した Release として作成するほうが適切です。

An external input’s URL uses a scheme that is not allowed (外部入力の URL が許可されていないスキームを使用している)

エンティティが指す URL が、許可されたスキームの集合の外にあるスキームを使用しています。許可されているのは 3 つです。https、http(ただしループバックホストへのものに限られ、平文は常にローカルマシンにしか届きません)、そしてレジストリから取得するコンテンツのための oci です。

出力されるメッセージ(ループバックでない http URL の場合と、その他のスキームの場合):

externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed(externalinputs: この URL について、平文の http はループバックホストに対してのみ許可されています(許可されているスキーム: https、ループバックホストへの http、oci): externalinputs: URL スキームが許可されていません) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed(externalinputs: この URL について、このスキームは許可されていません(許可されているスキーム: https、ループバックホストへの http、oci): externalinputs: URL スキームが許可されていません)

修正方法: URL を https に、またはコンテンツがレジストリで公開されている場合は oci に切り替えます。リモートホストへの平文の http URL はダウングレードされるのではなく拒否されるため、安全なスキームを指すようにすることが修正になります。ループバックホストは許可されているため、ローカルの開発サーバーは http のまま動作し続けます。

A render requests an external input the lockfile does not pin (レンダリングがロックファイルでピン留めされていない外部入力を要求している)

ビルドに必要なものが、ロックファイルでピン留めされていない URL から取得されようとしています。ビルドはロックファイルが記録するクロージャをレンダリングし、何も取得しません。そのため、この実行で代わりにその URL を取得させる設定は存在しません。凍結されたクロージャこそがビルドを再現可能にするものであり、入力の集合を暗黙に広げることは、ビルドが決してしてはならないことです。

したがって、この停止に至ることは設定ミスというよりも、情報を与えるものです。Release が解決された時点ではピンは完全だったため、ピン留めされていない URL があるということは、それ以降に何かが変わったことを意味します。たとえば、レンダリングが要求する参照を左右する値、新しい場所を指し始めたチャート、あるいは別の Release に対して解決されたロックファイルなどです。

出力されるメッセージ:

"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs(この URL はロックファイルでピン留めされていません。上記のコマンドを実行してこの Release のレンダリングが消費するすべての外部入力をピン留めしてから、再度ビルドしてください: externalinputs: ピン留めされていない入力の取得は無効です)

修正方法: 入力をピン留めします。aggrega pull --release <path> は Release をレンダリングしてどの外部入力を使用するかを調べ、それぞれを取得し、そのダイジェストを依存関係のピンと並べてロックファイルに記録します。以降のビルドはすべてピン留めされた記録からそれを提供し、ネットワークを一切必要としません。自分が記述したものがその URL を指し始めたために URL が新しくなった場合は、Release の再解決が省略された手順です。予期しない URL である場合は、ピン留めする前にそれを持ち込んだ参照を突き止める価値があります。

Fetched bytes do not match a pinned digest (取得したバイトがピン留めされたダイジェストと一致しない)

ピン留めされた URL が(保存されたコピーが欠けていたために)再取得され、返ってきたものがロックファイルでピン留めされたものと一致しません。記録されたダイジェストが常に優先されます: ストアには何も書き込まれず、バイトも返されません。

再補充は URL のタグではなく記録されたダイジェストによって取得されるため、別のコンテンツを指すように移動されたタグが、ピン留めされたエントリの提供するものを変えることはありません。したがって、この停止に至ることは、ダイジェストの背後にあるコンテンツ自体が完全な状態で返ってこなかったことを意味します。

出力されるメッセージ(レジストリから取得したコンテンツの場合と、HTTPS で取得したコンテンツの場合):

externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest(externalinputs: この URL について、再取得したマニフェストのダイジェストがピン留めされたダイジェストと異なります: externalinputs: 取得したバイト列がピン留めされたダイジェストと一致しません) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest(externalinputs: この URL について、再取得したバイト列のハッシュがピン留めされたダイジェストと異なります: externalinputs: 取得したバイト列がピン留めされたダイジェストと一致しません)

修正方法: 更新すべきロックファイルの問題としてではなく、まずサプライチェーンの問題として扱います。ピンは「まさにこのバイトに対してビルドした」という表明であり、拒否はその表明が守られていることを示します。ソースがダイジェストの示すコンテンツを今も公開しているかを確認し、その間にあるものがレスポンスを書き換えていないかを調べます。代替物を提供するプロキシやミラーはよくある原因です。何が変わったかを把握し、それを受け入れた後にのみ、新しいダイジェストを記録する aggrega pull で再ピン留めしてください。

A stored external input no longer matches its record (保存された外部入力がその記録と一致しなくなった)

ピン留めされた入力をローカルストアから読み戻したところ、それに対してピン留めされた記録と一致しません。このチェックはバイトが提供される前に毎回の読み取りで実行されるため、破損または改ざんされたストアは、暗黙にビルドへ供給されるのではなく、使用時点で表面化します。

何が比較されるかは、入力がどのようにピン留めされているかによります。HTTPS で取得したコンテンツはペイロードのハッシュによってピン留めされるため、読み取りのたびに再ハッシュされ、両方のダイジェストが報告されます。レジストリから取得したコンテンツはマニフェストのダイジェストによってピン留めされます。これはペイロードを直接ハッシュするのではなくレジストリ自身のマニフェストを通じてペイロードを確定させるものであるため、保存されたコピーは記録されたサイズと照合されます。完全なダイジェスト検証は、代わりに取得時と、ダイジェスト指定によるすべての再補充時に行われます。

出力されるメッセージ:

externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record(externalinputs: この URL について、ストアの blob の sha256 がピン留めされたダイジェストと異なります: externalinputs: ストアの blob がピン留めされたレコードと一致しません) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record(externalinputs: この URL について、ストアの blob のサイズがピン留めされたレコードのサイズと異なります: externalinputs: ストアの blob がピン留めされたレコードと一致しません)

修正方法: 問題の blob をストアから削除し、次の実行でソースから再補充させます。再補充は、何かが書き込まれる前に記録されたダイジェストと照合されます。その後の再補充でもダイジェストの不一致が報告される場合、不一致はローカルではなく上流にあり、読むべきは上のエントリです。複数のマシン間で共有されているストアや、書き込み途中に取得されたバックアップから復元されたストアが、ローカルでの一般的な原因です。

A guard needs a catalog entity the build resolved and cannot see (ガードが、ビルドが解決したのに参照できないカタログエンティティを必要としている)

セマンティックガードがコンポーネントの型の背後にあるカタログエンティティを参照しようとしましたが、解決処理がその型をカタログ参照として解決したにもかかわらず、そのエンティティがガードに与えられたビューに存在しません。本当に解決できない参照はより早く解決時点で停止するため、エンティティが欠けた状態でガードに到達したということは、ビルドの解決済み集合とガードのビューが食い違っていることを意味します。

ビルドはガードをスキップせずに停止します。スキップすると、チェックが消えたことを示すものが何もないままチェックが取り除かれ、ガードの対象だったコンポーネントは検査されずに通過し、ビルドは成功を報告することになります。

相対パス(./ または ../ で始まるもの)として書かれた型は、ここでは判定されません。型がファイルとして読み取られることはないため、そのような値はカタログエンティティをまったく指しておらず、より早い段階、つまり Release の依存関係が解決されるときに、カタログにない参照として拒否されます。この停止に至るのは、ベアトークンのカタログ参照だけです。

この条件はどこで満たされても同じ文言で報告されるため、テキストはそれを発生させたチェックではなく、型と障害を示します。

また、ドキュメントもその中のキーも示しません。これは意図的なもので、この停止が他のすべての停止と異なる唯一の点です。他の停止はすべて、解消するために編集すべきファイルとフィールドを位置として示しますが、ここにはそのようなファイルがないため、位置を示すと問題のないキーへ誘導してしまいます。代わりに 2 つのビューで食い違っている型が報告されます。それが、調査する人にとって食い違いを再現可能にするものだからです。

出力されるメッセージ:

the compiler’s own views of the catalog disagree (internal error: this build resolved a component type that the catalog it reads then held no entry for. This is a fault in the compiler rather than in an authored document, so there is nothing to correct in the Aggregate, the Release or the catalog. Please report it, naming the command that produced this build and the type the views disagree on: "<type>")(コンパイラ自身が持つカタログのビューが一致しません(内部エラー: このビルドはコンポーネントの型を解決しましたが、その後読み込んだカタログにはその型のエントリがありませんでした。これは作成したドキュメントではなくコンパイラの不具合であるため、Aggregate、Release、カタログに修正すべき点はありません。このビルドを生成したコマンドと、ビューが一致しない型を添えて報告してください))

修正方法: 自分のファイルには修正すべき点はありません。これは記述内容の障害ではなくコンパイラ内部の不整合を報告するものであり、メッセージが示す型を添えて不具合として報告する価値があります。コンポーネントの型はほぼ確実に問題ありません。

A reference names no entity the catalog holds(参照がカタログ内のどのエンティティも指していない)

ビルドが何かをレンダリングする前に、Release が依存するエンティティの集合全体を走査し、それぞれをピン留めします。これにより、ビルドが読み込むものがロックファイルに正確に記録されます。カタログが応答できない参照があると、この走査は停止します。その参照に対しては何もピン留めできず、処理を続行すると、ビルドが後で必要とするエントリが欠けたロックファイルが、それを示すものもないまま書き込まれてしまうためです。

拒否の際には、参照とそれが収集された場所が示されます。1 つのエンティティは多くの場所から到達されるため、修正すべきなのはそれを指定している場所だからです。ライブラリ参照は収集パスなしで単独で報告されます。ライブラリはそれを $ref または $import するエンティティから到達されるものであり、失敗した名前がそのまま障害のすべてだからです。

カタログエンティティの場合に出力されるメッセージ(末尾部分にはそれを参照している場所が列挙されます):

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>)

ライブラリの場合:

resolve: no entity in the catalog matches this URI: library "<reference>"

また、プロバイダソケットにバインドされたプラグインの場合(カタログドキュメントではなく、それを保持していたワークスペース設定キーによって示されます):

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers)

カタログディレクトリ配下のファイルが、どのカタログも保持しない種類(たとえば綴りを誤った kind)のもとで参照の求める名前を宣言している場合、この失敗の下の注記は、そのファイル、そのファイルが宣言する種類、カタログが保持する種類を示し、ローカルのエンティティがどこから読み込まれるかについての助言は省きます。これは、ロックファイルを埋めるビルドでも、それを読むビルドでも、この失敗を報告するその他すべてのサーフェスでも同じです。拒否されたカタログファイルと、それが説明する失敗を参照してください。

修正方法: メッセージが引用しているとおりに参照を正確に読んでください。存在しない名前、公開されたことのないバージョン、ワークスペースがそのレジストリを指していない裸の名前は、いずれもまったく同じ形でここに到達します。そのため、次の 3 点をこの順に確認してください。スペルを修正する、バージョンが存在することを確認する、それを保持するレジストリが設定されていて到達可能であることを確認する。ローカルで作成したエンティティの場合は、そのファイルがビルドの走査するカタログ内にあることを確認してください。

aggrega pull または aggrega build --auto-pull がライブラリ参照で停止し、そのときアーティファクトキャッシュに、どのロックファイルエントリも固定しておらず、どのカタログディレクトリも提供していない SchemaLibrary がある場合、メッセージの後に remediation: 行が続き、そのようなライブラリをそれぞれ示します。キャッシュされたライブラリがカタログの内容として扱われるのは、ロックファイルエントリがそのダイジェストを保証している場合だけであり、プルはそのエントリを、ライブラリを提供するレジストリから記録します。オフライン体制ではプルはライブラリを取得することもエントリを記録することもできないため、この行は、レジストリに到達できる場所で aggrega pull --release <release> を実行するか、カタログディレクトリの下でライブラリを作成するよう示します。接続されている場合は、プルが読み取るカタログディレクトリやレジストリのいずれもそのライブラリを提供していないため、記録すべきエントリがなく、この行はカタログディレクトリの下でライブラリを作成するよう示します。

A library reference is not written in the identity form(ライブラリ参照が識別子形式で書かれていない)

ライブラリをまたぐ $ref: または $import: は、ライブラリを識別子で指定し、次にその中のエントリを指定します。ライブラリの裸の名前、任意で : とバージョンの下限、続いて # と、そのフィールドが読み取るサーフェス上のエントリのパスです。この形式にはレジストリホストは含まれません。名前がどのレジストリを通じて解決されるかはワークスペース設定が決め、ビルドがどのバージョンを使うかはロックファイルが決めます。そのため、いずれかを含む参照は、ビルドが決めるべきものをドキュメント内に固定してしまうことになります。

ここで拒否されるのは次のものです。レジストリホストを含む値、ライブラリをまたぐ参照が期待される場所に書かれたドキュメント内アンカー、空のライブラリ名、そしてバージョン区切りとして書かれた @ です。最後のものは、この形式で最も多い誤りであるため、汎用的な形状の指摘ではなく修正後の表記とともに報告されます。

出力されるメッセージ:

resolve: invalid library reference URI: "<the value as written>"

また、区切りとして @ が使われた場合は、値を本来どう書くべきかを引用して:

resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>"

修正方法: 値を <Library>#<entry-path> の形に書き直してください。選択可能なバージョンに下限が必要な場合に限り、ライブラリ名の後に :<version> を追加します。レジストリホストはすべて削除してください。同じドキュメント内を指すつもりだった場合、ドキュメント内アンカーはライブラリ参照とは別のものであり、それを書いたフィールドはライブラリ形式を期待しています。

Two consumers of one library require incompatible versions(1 つのライブラリの 2 つの利用者が互換性のないバージョンを要求している)

複数のエンティティが 1 つのライブラリを参照でき、それぞれがバージョンの下限を指定するか、まったく指定しません。ビルドが選択するバージョンは、いずれかが指定した最も高い下限です。これにより、より低いものを求める利用者もそれを満たすバージョンを受け取れます。また、より高い下限を持つ利用者を追加すると、ビルドが 2 つのコピーに分かれるのではなく、全員が引き上げられるのもこのためです。

この規則が成り立つのは、下限の先頭のバージョン番号が一致している間だけです。異なるメジャーバージョンを指定する 2 つの利用者は、たまたま名前が同じ 2 つのライブラリを求めていることになり、両方を満たす単一の選択はありません。そのため、一方を選んでもう一方の利用者に想定外の形状を読ませるのではなく、ビルドは停止して不一致を示します。下限を指定しない利用者はここでは関与しません。選択はピン留めした利用者によって決まります。

出力されるメッセージ。利用者はソート順に比較されます。最初に下限を指定したものがメジャーバージョンを決め、メッセージには、比較された各利用者が、異なるメジャーバージョンを下限に指定した最初のものまで(それを含む)、要求したバージョンとともに列挙されます。そのため、同じドキュメントからは常に同じ利用者が示されます:

resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version>

修正方法: 低い方の利用者の下限を同じメジャーバージョンに引き上げてください。新しい形状を全員が望んでいる場合は、これが通常の対処です。両方のメジャーバージョンが本当に同時に必要な場合、それらは 2 つのライブラリです。古い形状を独自の名前で公開し、それを必要とする利用者にそちらを指させてください。これにより、各参照は自身が前提として書かれたものを指すようになります。

The chain of module imports is deeper than the pin walk descends(モジュールのインポートの連鎖がピン留めの走査の深さを超えている)

ピン留めでは、Aggregate がインポートするすべてのモジュールを走査し、さらにそれらがインポートするすべてのモジュールを走査します。これにより、最初の階層だけでなく集合全体がロックファイルに記録されます。すでに記録されたモジュールは 2 回走査されないため、通常のループはこれで終了します。あるモジュールをインポートし、そのモジュールが逆にそれをインポートする Aggregate は、それぞれを一度ずつ記録したうえで問題なく終了します。

深さの上限 10 は、繰り返し検出では捉えられない連鎖を防ぐ最後の歯止めです。各ステップで新しいバージョンとして再公開されるモジュールのように、階層ごとに新しい識別子を示す連鎖がこれにあたります。この上限はグラフビルダーが適用するものと同じであるため、ピン留めできる構成はビルドもできる構成です。

出力されるメッセージ:

resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth>

修正方法: 連鎖を短くしてください。これほど深い連鎖は、多くの場合デプロイメントの構成ではなく組織の構成を反映しています。そのため、独自のコンポーネントを提供していない階層を探し、親に統合してください。各階層が下の階層を新しいバージョンで再公開するためだけに存在する場合は、バージョンそのものが連鎖になっています。実際に必要なモジュールを、必要なバージョンで直接インポートしてください。

これはピン留めの走査の上限です。グラフビルダーは独自の上限を適用し、それは後述の「Sub-aggregate nesting depth exceeded(サブ Aggregate のネストの深さの超過)」で報告されます。両者は同じ上限に 2 つの地点で達したことの別々の報告であり、1 つ目はロックファイルの記録中、2 つ目はグラフの構築中に発生します。

The catalog view a build was given cannot load the bodies pinning needs(ビルドに与えられたカタログビューがピン留めに必要な本体を読み込めない)

ピン留めが走査する軸のうち 2 つは、カタログからバージョンの答え以上のもの、つまりドキュメントそのものを必要とします。Aggregate がインポートするモジュールは、それらがさらに何をインポートするかを調べるために読み込む必要があります。ビルドがバインドする Recipes、FeatureRecipes、Plugins は、それらが指定するアーティファクトとライブラリを調べるために読み込む必要があります。バージョンは解決できてもそれらの本体を返せないカタログビューでは、両方の軸で読むものがなくなります。

どちらもスキップされずに最初の段階で拒否されます。その理由は、スキップした場合に生じるものにあります。ある種類のエントリがまるごと欠けたロックファイルが何の警告もなく書き込まれ、後のビルドがそれを忠実に再構築して不完全だと気づくことになるのです。どちらのメッセージも独自の値を含みません。どちらも作成したドキュメントに関するものではないためです。それぞれ、どの軸が計算できないかを示します:

resolve: catalog lookup cannot load resolved sub-aggregate bodies resolve: catalog lookup cannot load resolved recipe and plugin bodies

修正方法: どちらもファイル内の何かによって生じるものではなく、解消できる記述上の変更もありません。障害はビルドに求められた内容ではなく、ビルドの接続方法にあります。実行したコマンドと、その実行対象となったワークスペース設定を添えて報告してください。

An annotation-transform plugin names a component it was not given, or injects a value no annotation takes(アノテーション変換プラグインが、渡されていないコンポーネントを指定しているか、どのアノテーションも受け付けない値を注入している)

オペレーターは、アノテーションを追加するロールでガバナンスプラグインをアタッチできます。このアタッチは宣言です。オペレーターが変換を求めたのであり、プラグインが追加するものは誰にも知られずに注入されるのではなく明示的なものです。ロールはそれに合わせて制限されています。プラグインにはドキュメントが宣言するコンポーネント座標が渡され、それらにアノテーションを追加できます。各アノテーションは、そのアノテーションに自分で記述できたはずの値、つまり文字列かサブキーのオブジェクトを持ちます。プラグインが返す形は他のフィールドを一切受け付けないため、出力の適用時に確認すべき残りの点は、すべての注入が渡された座標を指定しているかどうか、そしてすべての値がアノテーションの受け付ける値かどうかです。

その集合の外にあるバウンダリとコンポーネントの組を指定する注入があると、ビルドは停止します。ドキュメントが公開していないコンポーネントにプラグインが到達すれば、誰も宣言していないインフラストラクチャを設定することになります。また、プラグインが追加するアノテーションは記述されたアノテーションとまったく同じように Feature のアタッチメントへ展開されるため、その結果、オペレーターがプラグインに渡していないコンポーネントからリソースが現れることになります。

値が null、リスト、数値、ブール値、またはサブキーのないオブジェクトである注入も、ビルドを停止させます。null と空のオブジェクトは、コンポーネントが継承するはずのアノテーションをオプトアウトするために記述する値として読み取られますが、このロールはアノテーションを追加するものであり、削除するものではありません。その他の形は、アノテーションが受け付ける値ではありません。出力全体は、そのいずれかが適用される前にチェックされるため、拒否された出力は何も変更しません。

受け入れられた各注入には、それを行ったプラグインを示す付随アノテーション aggrega.ai/injected-by も付きます。このアノテーションはホストが書き込みます。プラグインはこれを指定できないため、注入されたアノテーションの出所について述べる内容をプラグインが左右することはできません。

出力されるメッセージです。プラグインに渡されていない座標の場合と、どのアノテーションも受け付けない値の場合です。

annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection targets boundary "<boundary>" component "<component>" (annotation "<key>")(アノテーション変換プラグインの出力が拒否されました。注入が、ホストが渡していないコンポーネント座標を対象としているか、文字列でもサブキーのオブジェクトでもない値を持っています。注入の対象は示されたバウンダリのコンポーネントです(示されたアノテーション)) annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection for boundary "<boundary>" component "<component>" (annotation "<key>") carries a list; an injected annotation value is a string or an object of subkeys(アノテーション変換プラグインの出力が拒否されました。注入が、ホストが渡していないコンポーネント座標を対象としているか、文字列でもサブキーのオブジェクトでもない値を持っています。示されたバウンダリのコンポーネントへの注入(示されたアノテーション)がリストを持っています。注入されるアノテーションの値は文字列かサブキーのオブジェクトです)

修正方法: 誤りはドキュメントではなくプラグインにあります。プラグインを修正し、渡された座標にのみ注入し、値としては文字列かサブキーのオブジェクトだけを使うようにしてください。各座標はプラグインの入力に含まれています。メッセージ内のコンポーネントがプラグインから見えるはずのものである場合は、Release がそれをバウンダリ内で宣言していることを確認してください。渡されるのは宣言されたコンポーネント座標だけです。プラグインの修正中にビルドを進めるには、plugins.governance からアタッチメントを削除するのが即効性のある方法です。

A plugin reference is not a Plugin entity(プラグイン参照が Plugin エンティティではない)

プラグインは Plugin エンティティによって参照され、常にプラグイン自身のソケットタイプでスコープされます。形式は <pluginType>/<name> で、parser/yaml や parser/yaml:1.0.0 のように任意でバージョンを付けます。スコープは複数ある形式の一つではなく必須です。スコープのない name:version は拒否されます。二つのソケットが同じ名前のプラグインを持つことがあり、スコープこそがエンティティを解決可能にするからです。エンティティが指すバイナリはエンティティを通じて到達され、直接指定されることはありません。そのため、能力の宣言、ランタイム制限、そしてロード時にバイナリと照合される記録済みコマンドセットを持つのはエンティティです。したがって Plugin エンティティを指定しない参照にはバイナリを照合する対象がなく、ビルドは未確認の参照でバイトをロードする代わりに停止します。

ここで報告される形は二つあり、確認されるタイミングが異なります。形式がエンティティになり得ない参照、つまりファイルシステムのパス、または oci:// URL、裸の .wasm、@sha256: ダイジェストといったアーティファクト参照は、エンティティ参照のみを受け付ける箇所で最初に拒否されます。どこにも存在しないエンティティを指定する参照は検索後に拒否され、メッセージの内容は書き方によって異なります。Plugin エンティティ URI(<pluginType>/<name>、任意でバージョン付き)は、どのカタログディレクトリにもなく、バイナリにも含まれず、どの pull でも取得されていないエンティティとして報告され、それ以外の参照にはその形式を取るよう示されます。どちらの形も同じ状態を報告するため、ビルドの対応はどちらでも同じです。

二つ目の形は、ビルドが遭遇する前に pull が拒否します。 Recipe または FeatureRecipe の pipeline が指定するすべての Plugin は、Release の他の依存関係とともに、カタログディレクトリ、コンパイラバイナリ内のコピー、コンテンツキャッシュ、またはレジストリから解決されます。いずれにも存在しないものがあると、aggrega pull はロックファイルを書き込む前にこの状態と同じメッセージで停止し、そのパイプラインで指定している Recipe または FeatureRecipe を示します。

すべての箇所がエンティティ以外の形式を拒否するわけではありません。 パイプラインプラグインの箇所はエンティティ参照のみを受け付けますが、オペレーターがプラグインを直接アタッチする箇所はどの形式も受け付け、エンティティ以外の参照はアーティファクトとして解決されるよう渡します。そのため同じ参照が、あるアタッチ箇所では受け入れられ、別の箇所では拒否されることがあり、その違いは参照ではなく箇所によるものです。

出力されるメッセージ。ファイルシステムのパスの場合:

plugin reference is not a Plugin entity: "<reference>" is a filesystem path, but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0)(プラグイン参照が Plugin エンティティではありません: 参照はファイルシステムパスですが、パイプラインプラグインはプラグインタイプでスコープされた Plugin エンティティ URI(バージョン指定は任意)でなければなりません)

アーティファクト参照の場合:

plugin reference is not a Plugin entity: "<reference>" is an artifact reference (an oci:// scheme, a bare .wasm, or an @sha256: digest), but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0)(プラグイン参照が Plugin エンティティではありません: 参照はアーティファクト参照(OCI スキーム、単独の Wasm ファイル、または SHA-256 ダイジェスト)ですが、パイプラインプラグインはプラグインタイプでスコープされた Plugin エンティティ URI(バージョン指定は任意)でなければなりません)

どこにも存在しない Plugin エンティティ URI の場合:

plugin reference is not a Plugin entity: "<reference>" is a Plugin entity URI, but no catalog directory holds the entity it names, the binary does not carry it, and no pull has fetched it into the content cache; place the Plugin entity in a catalog directory, or publish it to a registry and run aggrega pull(プラグイン参照が Plugin エンティティではありません: 参照は Plugin エンティティ URI ですが、それが指すエンティティを保持するカタログディレクトリがなく、バイナリにも含まれておらず、どの pull もコンテンツキャッシュに取得していません。Plugin エンティティをカタログディレクトリに配置するか、レジストリに公開して pull を実行してください)

その他、エンティティを指定しない参照(プラグインタイプのスコープがないもの、バージョンの前に / が複数あるもの、レジストリホストを含むもの)の場合:

plugin reference is not a Plugin entity: "<reference>" must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0); a bare .wasm reference or an artifact reference names no Plugin entity(プラグイン参照が Plugin エンティティではありません: 参照はプラグインタイプでスコープされた Plugin エンティティ URI(バージョン指定は任意)でなければなりません。単独の Wasm ファイルへの参照やアーティファクト参照は Plugin エンティティを指しません)

修正方法: 参照を、Plugin エンティティのソケットタイプでスコープされた識別子として、任意でバージョンを付けて記述してください(<pluginType>/<name> または <pluginType>/<name>:<version>)。ファイルやアーティファクトを直接指していた場合は、それに対応する Plugin エンティティを公開または作成し、代わりにそれを参照してください。ロード時に確認される宣言はエンティティにあるため、エンティティを省略できる同等の形式はありません。メッセージが参照を Plugin エンティティ URI だとしている場合、形式は正しく、欠けているのはエンティティです。ワークスペースが列挙するカタログディレクトリに、ビルド済みの .wasm を隣に置いて Plugin エンティティを配置するか、ワークスペースが読み取るレジストリにプラグインを公開して aggrega pull を実行し、コンテンツキャッシュに取得してください。また、指定したバージョンが存在することを確認してください。

A cached signature bundle does not match the digest recorded for it(キャッシュされた署名バンドルが記録されたダイジェストと一致しない)

取得時に署名が検証されたアーティファクトは、その事実をロックファイルのエントリ(verdict ロールでアタッチされたプラグインの場合は plugins-trust.yaml のエントリ)に、署名マテリアルの記録済みダイジェストとして引き継ぎます。署名マテリアル自体はアーティファクトと並べてキャッシュされます。何かがレンダリングされる前に、ビルドは読み込むエントリのうちダイジェストを記録しているすべて(あらゆる種類のカタログエンティティ、ライブラリ、プラグイン)について、キャッシュされたマテリアルを読み直して再ハッシュし、そのハッシュは記録されたものと一致しなければなりません。ロックファイルが固定するプラグインと、verdict ロールでアタッチされたプラグインは、バイトが読み込まれる時点でもマテリアルが再度チェックされます。これにより、ビルド外でプラグインを読み込むコマンド(aggrega lint --release や aggrega validate --release など)にもチェックが及びます。バンドルが存在しない、読み取れない、または別の値にハッシュされる場合、レビュー済みのマテリアルが現在ディスク上にあるものではないことを意味するため、署名の証拠が記録の下で変わってしまったアーティファクトを使う代わりに、実行は停止します。

再チェックはハッシュの比較であり、それ以上のものではありません。 署名を再検証せず、ネットワークに接続せず、信頼マテリアルも参照しないため、ネットワークアクセスがまったくないビルドでも成立します。これにより、一度検証されたアーティファクトは、その後のオフラインビルドでも検証済みのまま扱われます。

次の pull で修復されます。 pull は、コンテンツキャッシュが提供したすべてのエントリを同じチェックにかけ、チェックがエントリを拒否した場合は、署名要件の内容にかかわらず、取得するアーティファクトと同じ検証を通じてアーティファクトのレジストリに署名を再度問い合わせます。そして検証された内容をエントリに記録し、それが指すバンドルをキャッシュして、ダイジェストと一致しなくなったキャッシュ済みコピーを書き換えます。verdict ロールでアタッチされたプラグインは、エントリの記録内容にかかわらず pull のたびに再検証され、そのバンドルも同じようにキャッシュされます。そのため、コンテンツキャッシュが提供したエントリに対するメッセージは、その pull を示します。カタログディレクトリ、コンパイラバイナリ内のコピー、または Release の隣から読み込まれたエントリは、レジストリに問い合わせられることがないため、pull はそこに記録された署名をそのまま残し、そのメッセージは pull を示しません。

出力されるメッセージは、アーティファクト、キャッシュされたファイル、そして(コンテンツキャッシュが提供したエントリの場合)修復する pull、署名を記録するファイル、pull 対象の Release を示します。ビルドのチェックで、読み取れない、または存在しない場合:

artifact "<reference>": cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names(アーティファクト: キャッシュされた署名バンドルを読み取れません: キャッシュされた署名バンドルが記録されたダイジェストと一致しません。対処: 示された pull コマンドを実行して、アーティファクトの署名をそのレジストリで再検証し、示されたファイルに記録して、署名が示すバンドルをキャッシュしてください)

ずれが生じた場合:

artifact "<reference>": cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names(アーティファクト: キャッシュされた署名バンドルのダイジェストが記録されたダイジェストと異なります: キャッシュされた署名バンドルが記録されたダイジェストと一致しません。対処: 示された pull コマンドを実行して、アーティファクトの署名をそのレジストリで再検証し、示されたファイルに記録して、署名が示すバンドルをキャッシュしてください)

そして、プラグインのバイトがコンテンツキャッシュから読み込まれる場合は、その取得元も示します:

plugin "<reference>" resolved from <source>: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names(示された取得元から解決されたプラグイン: キャッシュされた署名バンドルを読み取れません: キャッシュされた署名バンドルが記録されたダイジェストと一致しません。対処: 示された pull コマンドを実行して、アーティファクトの署名をそのレジストリで再検証し、示されたファイルに記録して、署名が示すバンドルをキャッシュしてください)

plugin "<reference>" resolved from <source>: cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names(示された取得元から解決されたプラグイン: キャッシュされた署名バンドルのダイジェストが記録されたダイジェストと異なります: キャッシュされた署名バンドルが記録されたダイジェストと一致しません。対処: 示された pull コマンドを実行して、アーティファクトの署名をそのレジストリで再検証し、示されたファイルに記録して、署名が示すバンドルをキャッシュしてください)

<file> は Release のロックファイル、または Release のディレクトリにある plugins-trust.yaml です。pull が問い合わせないエントリの場合、メッセージは remediation: の前で終わります。

問い合わせるレジストリがない pull は、代わりに停止します。 カタログエンティティやライブラリはレジストリを指定せずに名前で参照され、ワークスペースの default_registry を通じてレジストリに結び付けられます。ワークスペースがレジストリを指定していない場合(署名が記録された時点では指定していたが、現在は指定していない場合)、エントリについて再度問い合わせるレジストリが設定されていないため、pull は次のビルドが拒否するロックファイルを書き込む代わりにこの条件で停止し、ロックファイルを元のまま残します。そのメッセージには、pull が実行していたステップの後に次の内容が含まれます:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest(検証: 参照がビルドの受け付けない署名を記録しており、それを再照会するためのレジストリが設定されていません: キャッシュされた署名バンドルを読み取れません: キャッシュされた署名バンドルが記録されたダイジェストと一致しません)

対処方法: エンティティファイルの内容が原因ではありません。キャッシュはビルドのものであり、ユーザーのものではありません。メッセージが示すコマンド aggrega pull --release <release> を実行してください。これはアーティファクトの署名を再検証し、署名とそのバンドルを一緒に書き込むため、キャッシュした pull 以降に削除または変更されたバンドルが修復されます。オフライン設定ではこの pull は停止します。修復にはレジストリへの問い合わせが必要なためオフラインの拒否で停止するか、verdict ロールでアタッチされたプラグインの場合は、pull がプラグインの .wasm をそのプラグインのレジストリから解決するため、それより前に .wasm を解決できなかったものとして示して停止します。その 1 回の実行に限りネットワークを許可すれば修復されます。エントリについて問い合わせるレジストリが設定されていないとして pull が停止する場合は、アーティファクトの取得元レジストリを default_registry に設定し、再度 pull してください。ワークスペースがアーティファクトの署名検証をスキップしている場合、pull は代わりにエントリに署名を記録せず、ビルドは同じ設定のもとでそれを受け入れます。レジストリが提供する署名が検証に失敗する場合、pull はその検証自体の拒否で停止します。記録された署名と公開者が提供するマテリアルが実際に食い違っているため、アーティファクトの公開者に確認すべき問題です。メッセージが pull を示さないエントリ(カタログディレクトリ、コンパイラバイナリ内のコピー、または Release の隣から読み込まれたもの)の場合は、そのエントリから signature を削除してください。そのようなエントリは署名要件の対象にならないため、ビルドはそのまま進みます。

A recorded signature was made for a different artifact(記録された署名が別のアーティファクトに対して作成されています)

署名は、それがどのアーティファクトに対して作成されたかを示します。pull がアーティファクトの署名を検証すると、その事実をアーティファクトのロックファイルエントリ(verdict ロールでアタッチされたプラグインの場合は plugins-trust.yaml 内のエントリ)に記録し、検証した署名をキャッシュします。何かがレンダリングされる前に、ビルドはコンテンツキャッシュが提供したすべてのエントリについて、キャッシュされた署名からそれがどのアーティファクトに対して作成されたかを読み取ります。それは、ビルド自身がそのエントリについて読み取ったアーティファクト、すなわちコンテンツキャッシュ内でバイト列の横にマニフェストが保持されているアーティファクトでなければならず、エントリが記録している内容が使われることはありません。別のアーティファクトに対して作成された署名はビルドを停止させます。これは、あるエントリから別のエントリへコピーされた signature が示す状態です。それが指すキャッシュ済み署名は損なわれておらず(記録されたダイジェストとまだ一致しています)、もう一方のエントリのアーティファクトに対して作成されたものです。

署名要件には依存しません。 記録された署名は、要件があるかどうかにかかわらず、その主張内容に照らして検査されます。これは、キャッシュ済み署名が記録されたダイジェストと一致するかの検査と同じです。

プラグインは、どこでロードされても同じように検査されます。 ロックファイルが固定するプラグインと、verdict ロールでアタッチされたプラグインは、バイト列がコンテンツキャッシュからロードされる際に、記録された署名がそのバイト列の読み取り元のアーティファクトに照らして検査されます。これはビルド外でプラグインをロードするコマンド(aggrega lint --release や aggrega validate --release、および aggrega serve と aggrega mcp を通じて到達する同じ操作など)にも及びます。

検査が読み取るものと、判別できないもの。 この検査はキャッシュ済み署名とアーティファクトの横にあるマニフェストを読み取り、ハッシュを比較します。署名の検証も、ネットワークへの接続も、トラストマテリアルの参照も行わないため、ネットワークにまったくアクセスできないビルドでも成立します。署名がどのアーティファクトに対して作成されたかは、pull が受け付ける両方の形式で読み取ります。すなわち、アーティファクト自体に対して作成された署名(ツールチェーン自身の署名者が作成する形式)と、アーティファクトを名指しする署名付きステートメントです。そのため、あるエントリから別のエントリへコピーされた署名はどちらの形式でも拒否されます。これは pull が受け付けるすべての署名に適用する読み取りと同じです。pull は、検証には成功しても、この読み取りでそのアーティファクトに対して作成されたと判断できない署名や、アーティファクトをまったく読み取れない署名を拒否するため、pull が記録する署名で検査が読み取れないものはありません。カタログディレクトリ、コンパイラバイナリ内のコピー、または Release の横から読み取られたエントリにはマニフェストがないため、記録された署名は記録されたダイジェストに照らしてのみ検査されます。これら 2 つのどちらの形式でもない、手作業でキャッシュに置かれた署名も同様です。また、署名は検証されないため、手作業でキャッシュに書き込まれ、エントリ自身のアーティファクト宛てに作成された署名は、pull が検証した署名と区別されません。

次の pull で修復されます。 pull は、コンテンツキャッシュが提供したすべてのエントリに同じ検査を適用し、検査がエントリを拒否した場合は、署名要件の内容にかかわらず、アーティファクトのレジストリに署名を改めて問い合わせ、検証された内容をコピーされた署名の代わりにエントリへ記録します。verdict ロールでアタッチされたプラグインは、エントリの記録内容にかかわらず、pull のたびに再検証されます。署名がどのアーティファクトに対して作成されたかを検査されるのはコンテンツキャッシュが提供したエントリだけであるため、ビルドまたはプラグインのロードによるこの条件の拒否はすべて、その pull を示します。

出力されるメッセージは、エントリ、署名を記録しているファイル、キャッシュ済み署名、ビルドがそのエントリについて読み取ったマニフェスト、および修復する pull を示します。ビルドの検査からは次のとおりです。

artifact "<reference>": signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names(アーティファクト: 署名: 記録された署名は別のアーティファクトに対して作成されたものです(記録しているファイル、キャッシュされた署名バンドル、読み込んだアーティファクトのマニフェストを示します)。対処: 示されたコマンドを実行して、アーティファクトの署名をそのレジストリで再検証し、ファイルに記録して、署名が示すバンドルをキャッシュしてください)

また、プラグインのバイト列がロードされる場合は、その取得元も示します。

plugin "<reference>" resolved from <source>: signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names(解決元から解決されたプラグイン: 署名: 記録された署名は別のアーティファクトに対して作成されたものです(記録しているファイル、キャッシュされた署名バンドル、読み込んだアーティファクトのマニフェストを示します)。対処: 示されたコマンドを実行して、アーティファクトの署名をそのレジストリで再検証し、ファイルに記録して、署名が示すバンドルをキャッシュしてください)

<file> は Release のロックファイル、または Release のディレクトリ内の plugins-trust.yaml です。

問い合わせるレジストリがない pull は、代わりに停止します。 これは、ダイジェストと一致しなくなったキャッシュ済み署名バンドルの場合と同じです。カタログエンティティまたはライブラリがコピーされた署名を持ち、ワークスペースがそれをバインドする default_registry をもう指定していない場合、pull はこの条件で停止し、ロックファイルを元のまま残します。そのメッセージには、pull が実行していたステップの後に次の内容が含まれます。

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: signing: the recorded signature was made for a different artifact (cached signature bundle <path>, the artifact read has manifest <manifest-digest>)(検証: この参照はビルドが受け入れない署名を記録しており、再確認先のレジストリが設定されていません: 署名: 記録された署名は別のアーティファクトに対して作成されたものです(キャッシュされた署名バンドルと、読み込んだアーティファクトのマニフェストを示します))

修正方法: エンティティファイルの内容が原因ではありません。エントリが記録している署名は別のアーティファクトのものです。メッセージが示すコマンド aggrega pull --release <release> を実行してください。これはエントリ自身の署名をそのレジストリで検証し、コピーされた署名の代わりに記録します。ロックファイルのエントリでも、verdict ロールでアタッチされたプラグインでも同様です。ファイルがコミットされている場合は、バージョン管理からエントリ自身の記録済み署名を復元する方法でも解決します。オフライン設定では pull は停止します。修復にはレジストリへの問い合わせが必要なためオフラインによる拒否で停止するか、verdict ロールでアタッチされたプラグインの場合は、pull がその .wasm をプラグインのレジストリから解決するため、それより前にプラグインの .wasm を解決できなかったものとして示して停止します。その 1 回の実行に限りネットワークを許可すれば修復されます。問い合わせるレジストリが設定されていないとして pull が停止する場合は、default_registry をアーティファクトの pull 元のレジストリに設定し、再度 pull してください。ワークスペースがそのアーティファクトの署名検証をスキップしている場合、pull は代わりにエントリに署名を記録せず、ビルドは同じ設定のもとでそれを受け入れます。

No verified signature is recorded for an artifact that requires one(署名を必要とするアーティファクトに検証済みの署名が記録されていない)

レジストリからアーティファクトを取得する pull は、そのレジストリのトラストポリシーに照らして署名を検証し、検証済みであるという事実をアーティファクトの lockfile エントリに記録します。ビルドはどのレジストリにも接続しないため、再検証せずに記録された事実を読み取ります。そして何かをレンダリングする前に、読み取るすべてのエントリを、pull がアーティファクトを取得したときに適用した要件に照らして確認します。コンテンツキャッシュが提供したエントリのうち、署名が必要なアーティファクトに対するもので、検証済みの署名を記録していないものがあると、ビルドは停止します。これからレンダリングに使うアーティファクトがかつて検証されたことを示すものが、ビルドの手元に何もないためです。

要件は pull のものと、設定ごとに同じです。 ワークスペース全体の署名ポリシーがアーティファクトの種類を対象としている場合、または .aggrega-config.yaml にあるそのレジストリ自身のエントリ(独自のエントリがない hub.aggrega.ai の場合は公式ハブの組み込みポリシー)が署名を要求している場合に、署名が必要になります。種類を判定できなかったアーティファクトは、ポリシーが有効な状態では必要とみなされます。pull が署名のないアーティファクトを受け入れる条件は、ビルドがそのエントリを受け入れる条件でもあります。トップレベルの skip_signature_verification、レジストリ自身のエントリにある同じスイッチ(ただしワークスペース全体のポリシーが要求する種類は除く)、および advisory と指定されたレジストリです。

エントリの出所は lockfile からではなく、常にビルドから読み取られます。 コンテンツキャッシュが提供したすべてのエントリは、そのエントリが他に何を記録していても確認の対象となるため、署名とともにエントリのマニフェストダイジェストを削除しても除外されません。カタログディレクトリ、コンパイラバイナリ内のコピー、または Release の隣から読み取られたエントリは対象になりません。レジストリから来ていないバイトにはレジストリの署名が存在しないためです。すべてのセクションのエントリ(カタログエンティティ、ライブラリ、プラグインアーティファクト)が同様に確認され、チェックが拒否したすべてのエントリが同じ実行の中で示されます。

verdict ロールにアタッチされたプラグインは、plugins-trust.yaml を通じて同じチェックの対象になります。 ir-verdict または render-verdict ロールの plugins.governance アタッチメント、およびすべての plugins.linter アタッチメントは、レンダリングされるバイトに影響しないため lockfile エントリを持たず、代わりに lockfile の隣にある記録が検証済みの署名を保持します。ビルドがコンテンツキャッシュから読み取るそのようなプラグインはそれぞれ、同じ設定を通じて同じ要件の対象となります。その記録内のエントリが署名を記録していない場合にビルドは停止し、プラグインのエントリがまったくない場合も停止します。記録を削除しても除外されません。カタログディレクトリまたはコンパイラバイナリ内のコピーから提供されたプラグインは対象になりません。この要件は、ビルドに限らず、Release のためにそのようなプラグインが読み込まれるあらゆる場所で適用されます。aggrega lint --release と aggrega validate --release、および aggrega serve と aggrega mcp を通じて到達する同じ操作は、そのプラグインを読み込む際にこの条件で失敗します。

出力されるメッセージは、エントリ、そのエントリの署名を記録していないファイル、その署名を要求する設定、およびそのファイルに署名を記録するコマンドを示します。lockfile エントリの場合は lockfile を示します。

signing: no verified signature is recorded for an artifact that requires one ("<reference>", <lockfile-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry and record it in <lockfile-path>

verdict ロールにアタッチされたプラグインの場合は、その記録を示します。

signing: no verified signature is recorded for an artifact that requires one ("<plugin>", <record-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the plugin’s signature at its registry and record it in <record-path>

どちらのファイルも、コマンドに渡された Release の隣にあるパスで示されます。<lockfile-path> は Release の lockfile、<record-path> は Release のディレクトリにある plugins-trust.yaml です。

設定は設定ファイル自身の表現で示されます。 `signing.required` at the top level of the workspace configuration、 `signing.required` on the `registries` entry for "<host>"、または the official hub's built-in signature requirement for "hub.aggrega.ai" であり、複数が該当する場合は連結されます。

修正方法: メッセージが示す pull を実行します。コンテンツキャッシュが提供するエントリで、署名が必要なのに記録されていないものについては、pull はエントリが記録するマニフェストダイジェストを使って、取得するアーティファクトの場合とまったく同じようにアーティファクトのレジストリに署名を問い合わせ、検証済みの署名をエントリに記録します。これにより次のビルドがそれを読み取ります。verdict ロールにアタッチされたプラグインはいずれにせよ pull のたびに問い合わせの対象となり、pull は検証した内容を plugins-trust.yaml 内のプラグインのエントリに記録し、エントリがなければ作成します。レジストリが署名をアタッチしていない場合や、トラスト設定が受け入れない署名の場合は、代わりにその pull がアーティファクトを示して停止します。これはそのアーティファクトの公開者に確認すべき問題です。オフライン態勢では pull は問い合わせできません。lockfile エントリに対しては、1 回の実行でネットワークを許可する方法を示して拒否し、verdict ロールにアタッチされたプラグインに対しては問い合わせる前に停止し、プラグインの .wasm を解決できなかったものとして示します。pull はその .wasm をプラグインのレジストリから解決するためです。キャッシュがその記録の示す署名マテリアルをまだ保持している場合は、バージョン管理からエントリの記録済み署名を復元すれば、ネットワークなしで解消できます。アーティファクトが署名されることを想定していない場合は、変更すべきは要件であり、メッセージがどの設定かを示します。ただし要件を緩めると、そのレジストリのアーティファクトは pull でも確認されなくなるため、要件をオフにするよりも、ワークスペース全体のポリシーの種類を絞り込むことを優先してください。

A recorded signature is not the one a pull would record(記録された署名が、pull が記録するはずの署名と一致しません)

aggrega pull --verify は、今 aggrega pull を実行した場合に pull がコミットするファイルが変わるかどうかを報告します。pull がアーティファクトについて検証した署名は、pull が書き込む内容の一部です。ロックファイルのエントリ上の signature、および判定ロールでアタッチされたプラグインについては plugins-trust.yaml のエントリ上の署名です。この条件は、通常の pull であれば異なる内容を書き込む記録済み署名それぞれについて verify が報告するものです。記録がない箇所に記録する署名、置き換える署名、またはクリアする署名がこれに当たります。verify はどちらのファイルにも書き込まず、両ファイルにおけるそのようなエントリをすべて同じ実行の中で示します。

2 種類のロックファイルエントリは、レジストリに問い合わせずに報告されます。レジストリの応答にかかわらず pull がそれらを書き換えるため、オフライン体制でも報告されます。1 つは、コンテンツキャッシュが提供したエントリのうち、信頼設定が署名を要求しているのに署名を記録していないものです(pull はアーティファクトの署名を記録するか、署名を確定できない場合は停止します)。もう 1 つは、記録された署名が別のアーティファクトに対して作成されたエントリで、pull はこれをそのアーティファクト自身の署名に置き換えます。

pull が再度照会するその他のエントリはすべて問い合わせの対象になります。pull がそれを変更するかどうかは、レジストリの応答によってのみ決まるためです。対象は、コンテンツキャッシュが保持していなかったために verify がバイトを取得したエントリと、キャッシュされた署名バンドルが削除された、読み取れない、または改変されたエントリです。verify は pull と同じようにレジストリに問い合わせ、応答によって署名が記録、置き換え、またはクリアされる場合にそのエントリを報告し、検証したバンドルを pull と同じようにキャッシュします。オフライン体制では、そのようなエントリは問い合わせも報告もされません。verify はそのエントリを示し、署名が確認されなかったことを述べる行を出力します。

プラグイン信頼レコードについては、 すべての pull が判定ロールでアタッチされた各プラグインの署名をそのレジストリで検証し、verify も同様に検証します。その検証によって署名が記録、置き換え、またはクリアされるエントリは報告されます。また、レコードにエントリがなく、署名が記録されていないことを理由にビルドが拒否するプラグインも報告されます。pull はその署名を持つエントリを書き込み、それまでビルドはそのプラグインを拒否するためです。レコードがまだ保持していないその他のプラグインは初回の検出であり、報告されません。オフライン体制では、verify はこれらのプラグインについてどのレジストリにも問い合わせません。ビルドと同じように各プラグインをコンテンツキャッシュから読み取り、接続時の verify と同じようにその識別情報とホスト関数を照合します。問い合わせずに報告するのは、署名が記録されていないことを理由にビルドが拒否するプラグイン(エントリが署名を記録していないか、レコードにそのエントリがないもの)と、エントリに記録された署名が別のアーティファクトに対して作成されたためにビルドが拒否するプラグインです。レジストリの応答にかかわらず pull がそのエントリを書き換えるためです。その他のエントリについては、それぞれを示し、署名が確認されなかったことを述べる行を出力します。

非推奨マーカーは比較されません。 pull の後にアーティファクトにアタッチされたマーカーはレジストリの状態であり、ワークスペース内の何も変わらなくても変動します。そのため、verify がマーカーを理由に失敗すると、誰も触れていないファイルに対するチェックが失敗することになります。記録されたマーカーがビルドを停止せずに警告するのはこのためです。

出力されるメッセージは、エントリごとに 1 つで、エントリ、ファイルとその記録内容、pull が代わりに記録する内容、およびファイルを最新にする pull を示します。レジストリの応答、またはレコード自身の検証によって pull が記録する署名が得られる場合:

signing: a recorded signature is not the one a pull would record (記録された署名が pull の記録するものと一致しません) ("<reference>", <file> records <signature>, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <file> up to date

署名が要求されているのに署名を記録していないエントリ(ロックファイルのエントリ、またはオフライン体制ではプラグイン信頼レコードのエントリ)の場合:

signing: a recorded signature is not the one a pull would record (記録された署名が pull の記録するものと一致しません) ("<reference>", <file> records no signature, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <file> up to date

記録された署名が別のアーティファクトに対して作成されたエントリ(ロックファイルのエントリ、またはオフライン体制ではプラグイン信頼レコードのエントリ)の場合:

signing: a recorded signature is not the one a pull would record (記録された署名が pull の記録するものと一致しません) ("<reference>", <file> records <signature>, made for another artifact, a pull would ask its registry for this artifact’s own signature and record it). remediation: run aggrega pull --release <release> to bring <file> up to date

そして、レコードにエントリがなく、署名が記録されていないことを理由にビルドが拒否するプラグインの場合(2 つ目の形式は、verify がどのレジストリにも問い合わせないオフライン体制でのものです):

signing: a recorded signature is not the one a pull would record (記録された署名が pull の記録するものと一致しません) ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <record-path> up to date

signing: a recorded signature is not the one a pull would record (記録された署名が pull の記録するものと一致しません) ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <record-path> up to date

<signature> は、署名をそのモード、署名者、バンドルのダイジェストで表します(a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>。キーレス署名の場合は署名者の後に issued by <issuer> が続きます)。または no signature です。<file> は Release のロックファイル <lockfile-path>、または Release のディレクトリ内の plugins-trust.yaml(<record-path>)です。

修正方法: メッセージが示す pull を実行します。pull は、メッセージが記録すると述べた署名を指定されたファイルに書き込み、そのバンドルをキャッシュするため、次の verify は成功します。メッセージが pull がレジストリに問い合わせると述べている場合、pull はレジストリが検証した内容を記録します。ただし、レジストリが信頼設定の受け入れない署名をアタッチしている場合、または署名が要求されているのに署名をアタッチしていない場合は、アーティファクトを示して停止します。これはその公開者に確認すべき事項です。オフライン体制ではその pull は停止します。ロックファイルのエントリについては、レジストリに問い合わせる必要があるためオフラインの拒否によって停止し、判定ロールでアタッチされたプラグインについてはそれより前に、プラグインの .wasm を解決できなかったものとして示して停止します。pull はその .wasm をプラグインのレジストリから解決するためです。その 1 回の実行に限りネットワークを許可すると、ファイルが最新になります。メッセージが pull は署名を記録しないと述べている場合、レジストリはもう署名をアタッチしておらず、何も署名を要求していません。pull はエントリの署名をクリアし、ビルドは同じ設定のもとでそれを受け入れます。レジストリがそのアーティファクトへの署名をやめることを想定していなかった場合は、それも公開者に確認すべき事項です。

プラグインの .wasm がこのマシン上にない

プラグインの .wasm は、次の 4 つの場所のいずれかから、この順序で読み取られます。コンパイラバイナリに組み込まれたプラグイン、カタログディレクトリ内でプラグインの Plugin エンティティの隣にあるファイル、参照が指定する明示的なファイルシステムパス、そして aggrega pull が埋めるワークスペースのコンテンツキャッシュです。プラグインの解決はマシン上に既にあるものを読み取るだけで何も取得しないため、この条件は 4 つのいずれもバイトを保持していないことを報告するものであり、ダウンロードが失敗したことを報告するものではありません。例外は 1 つのプラグインで、インポートが必要とするコアインポーターです。 そのモジュールはバイナリまたはコンテンツキャッシュからのみ読み取られ、カタログエンティティの隣からは決して読み取られません。どちらにも保持されていない場合、インポートはワークスペースのデフォルトレジストリからそれを 1 回取得します。その場合、この条件は取得もできなかったことを併せて報告します。ワークスペースがオフラインである、そのレジストリに到達できないかモジュールを保持していない、またはワークスペースがデフォルトレジストリを指定していない、のいずれかです。取得されたが検証に失敗したモジュールは、代わりにダイジェストの不一致や署名の拒否といったそれ自身の条件で拒否され、何も保持されません。

エンティティの隣のファイルは、エンティティのプラグインタイプと名前から命名され、後述の pull の拒否メッセージがその名前を示します。pipeline-step/patch の場合は pipeline-step--patch.wasm で、エンティティのドキュメントがあるディレクトリに置かれます。

カタログディレクトリのいずれかで作成された Plugin エンティティは、pull がそれを解決する時点で拒否されます。 pull はそのようなエンティティの .wasm を一切取得しません。build が探すのとまったく同じ、上記の 4 つの場所を探します。パイプラインステップ、プロバイダ、または判定ロールにアタッチされたプラグインはまったく固定されず、build は毎回カタログディレクトリからそのエンティティを読み込みます。変換ロールにアタッチされたプラグインは、そのバイトがレンダリング出力を形作るため固定されます。pull はそのエンティティと、そこで見つけた .wasm のコンテンツダイジェストを記録し、build はもはや一致しない .wasm を拒否します。そのため、4 つの場所のいずれにも成果物を見つけられない pull は、build がプラグインを読み込むステップで後から失敗するのに任せるのではなく、ロックファイルや entity.lock を書き込む前にその場で停止します。バイナリが持つ .wasm、またはすでにコンテンツキャッシュにあるものは、build を満たすのとまったく同じように pull を満たすため、コンパイラに同梱されるプラグインのエンティティには、その横にファイルを置く必要はありません。

出力されるメッセージ。pull の拒否で、ファイルがあるはずのディレクトリを示し、その下に照会した解決方法が続きます:

plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory(プラグインの成果物がこのマシン上に見つかりません(この Plugin エンティティはカタログディレクトリで作成されており、指定のディレクトリに指定のファイルが想定されています)。ビルドした .wasm をその名前でエンティティの横に置くか、プラグインを公開し、カタログディレクトリ内のものではなく公開された Plugin エンティティを参照してください)

ビルドまたはインポートが読み込むプラグインで、そのバイトを保持するソースがない場合。また、オフライン体制の aggrega pull --verify がビルドと同じようにコンテンツキャッシュから読み取る、判定ロールでアタッチされたプラグインの場合です。プラグインの Plugin エンティティがカタログフォルダーにある場合は、そのバージョンとモジュールを置く場所が示されます。

plugin "<reference>" at version <version> is not on this machine; place its module, named <file>, beside its Plugin entity in <directory>: plugin artifact not found on this machine(そのバージョンのプラグインがこのマシン上にありません。示されたファイル名でモジュールを、示されたディレクトリ内の Plugin エンティティの横に置いてください:プラグインのアーティファクトがこのマシン上に見つかりません)

それ以外の場合は、モジュールを探したそれぞれの場所が示されます。

plugin "<reference>" is not on this machine: the binary does not carry its module, no catalog folder holds its Plugin entity and the content cache a pull fetches into does not hold it: plugin artifact not found on this machine(プラグインがこのマシン上にありません。バイナリはそのモジュールを持たず、どのカタログフォルダーにもその Plugin エンティティがなく、pull が取得先とするコンテンツキャッシュにもありません:プラグインのアーティファクトがこのマシン上に見つかりません)

lint はバイナリの中だけを探すため、これらの場所のうち最初のものだけを示します。

そして、レジストリの場所として記述された参照についても同様です:

plugin "<reference>" not resolvable: an OCI plugin URI requires a prior aggrega pull --release <release> (so its bytes are cached) or an explicit local path; plugin resolution does not fetch from a registry: plugin artifact not found on this machine(このプラグインは解決できません:OCI プラグイン URI には、事前の pull の実行(バイトがキャッシュされるように)または明示的なローカルパスが必要です。プラグインの解決はレジストリから取得しません:プラグインの成果物がこのマシン上に見つかりません)

インポートが読み取りも取得もできなかったコアインポーターの場合。インポーター、そのバージョン、理由(ここではワークスペースがオフラインであること)を示し、続いてそのモジュールをマシン上に置く方法を示します:

core importer "<importer>" at version <version> is not on this machine, and the workspace is offline, so its registry <host> is not asked for it; run the import once with the network available, which fetches it from the workspace’s default registry, verifies it and keeps it in the content cache for every later import, or place its module, named <file>, beside a Plugin entity of <importer> at <version> in a catalog folder: plugin artifact not found on this machine(指定のバージョンのこのコアインポーターはこのマシン上になく、ワークスペースがオフラインのため、そのレジストリには問い合わせません。ネットワークが利用可能な状態でインポートを一度実行すると、ワークスペースの既定のレジストリから取得して検証し、以降のすべてのインポートのためにコンテンツキャッシュに保持します。または、そのモジュールを指定の名前で、カタログフォルダ内にある同じインポーターの同じバージョンの Plugin エンティティの横に置いてください:プラグインの成果物がこのマシン上に見つかりません)

その他の理由は its registry <host> could not be reached (<cause>)、its registry <host> holds no <location>:<version>、the workspace names no default registry to fetch it from となります。後の 2 つは 2 つ目の対処法のみを示します。ネットワークが利用可能な状態で実行しても状況が変わらないためです。

修正方法: エンティティが自分で作成したものである場合は、プラグインをビルドし、その .wasm をメッセージが示す名前でエンティティの隣に置きます。または、aggrega push でプラグインを公開し、カタログのコピーの代わりに公開されたエンティティを参照します。pull もビルドも、カタログ内のエンティティの .wasm を取得しないためです。プラグインがレジストリから利用するものである場合は、そのリリースに対して aggrega pull を実行するとキャッシュされます。コンパイラ自体がプラグインを持っていると想定していた場合は、実行しているバイナリが持っているかを確認します。aggrega plugin list が組み込みプラグインを示します。コアインポーターの場合は、ワークスペースがデフォルトレジストリに到達できる環境でインポートを 1 回実行します。その実行で取得、検証、キャッシュが行われ、以降のインポートはすべてオフラインで動作します。そのレジストリが保持していない場合は、そのモジュールを、カタログフォルダ内のそのバージョンのそのインポーターの Plugin エンティティの隣に、メッセージが示す名前で置きます。以後はそのエンティティがコアインポーターの代わりに実行されます。

A plugin recorded as a trusted gate is no longer attached(信頼されたゲートとして記録されたプラグインがアタッチされなくなっている)

ビルドに対して受理または拒否の判定を返すプラグインは、解決された時点で記録されます。これにより、どのゲートがレビュー済みかの記録がワークスペースに保持されます。この状態は、記録済みのゲートがどこからもアタッチされなくなったときに報告されるものです。黙って通過させずにビルドを停止する理由は、そうしなければその出力が、ゲートが承認した出力と区別できなくなるためです。ゲートが黙って欠けたビルドと、ゲートが通過させたビルドは同じファイルを生成し、結果をレビューする人はどちらを手にしているのか判別できません。

これは、バイトがずれたプラグインとは別の問題です。そちらはレビュー済みのものではないプラグインの実行を拒否するもので、同一性の問題です。こちらはレビュー済みのゲートがまったく欠けた状態でのビルドを拒否するもので、存在の問題です。対処もそれに応じて異なります。前者はアーティファクトを復元し、後者はアタッチメントを復元します。

確立されること、確立されないこと。 設定を記録と照合することで、記録されたすべてのゲートがまだアタッチされていること、そして各ゲートのアーティファクトが記録どおりのものであることが確立されます。アタッチされたゲートがそもそも判定を返すかどうかについては何も確立されません。エントリ関数が、判定を返さない宣言済みのエクスポートを指すアタッチメントは、実行され、何も報告せず、ビルドを通過させます。記録との比較もこれには気づきません。実行されたプラグインは記録どおりのものであり、単に何も実行しなかっただけだからです。隣接する 2 つのケースはビルドを停止します。この境界が実際より広く読まれないよう明記しておきます。プラグインが宣言していないエクスポートを指すエントリ関数は、プラグインのロード時に拒否されます。また、判定の形式が宣言していないキーを含む出力は、空の判定リストとして読まれるのではなく拒否されます。

出力されるメッセージ。記録、外されたゲート、および両方の対処を示します:

a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role: <record-path> records <plugin> as trusted, but no verdict attachment in the workspace configuration names it; a gate that was reviewed and is now absent leaves output indistinguishable from output that gate approved. Attach the plugin again under plugins.governance at an ir-verdict or render-verdict role, or under plugins.linter; or, if it was meant to go, run aggrega pull --upgrade --release <release> <plugin> to drop it from the record — an ordinary aggrega pull leaves the record as it is, so only an explicit upgrade removes an entry(受理か拒否かの判定について信頼済みとして記録されたプラグインが、どの判定ロールにもアタッチされていません。記録ファイルはそのプラグインを信頼済みとして記録していますが、ワークスペース設定のどの判定アタッチメントもそれを指定していません。レビュー済みで現在存在しないゲートは、そのゲートが承認した出力と区別できない出力を残します。上記の governance 設定の判定ロール、または linter 設定の下にプラグインを再度アタッチしてください。意図して外した場合は、上記の upgrade コマンドを実行して記録から削除してください。通常の pull は記録をそのまま残すため、エントリを削除するのは明示的なアップグレードだけです)

複数のゲートが外された場合、それらはゲートごとに 1 つのコマンドではなく、1 つのアップグレードコマンドにまとめて示されます。対象を絞ったアップグレードは複数の対象を受け取り、指定されなかったピンはすべてそのまま残すため、まとめて指定する方が、代替手段で必要になる全体の再取得より短く、範囲も狭くなります。

対処方法: どちらが当てはまるかは利用者にしかわからないため、メッセージは 2 つの対処を提示します。ゲートが誤って削除された場合は、plugins.governance の下で判定ロールに、あるいは plugins.linter の下にプラグインを再度アタッチします。意図的に外した場合は、メッセージが示す対象を絞ったアップグレードでそれを明示します。これによりエントリが削除されます。この状態を解消するために記録を編集または削除しないでください。記録はレビュー済みの内容をコミットしたものであり、通常の pull が意図的にそのまま残すのは、削除を黙って受け入れることこそ、この拒否が防ぐために存在するものだからです。

A gate recorded as trusted resolves to a different identity(信頼済みとして記録されたゲートが別の同一性に解決される)

ビルドに対して受理または拒否の判定を返すプラグインは、解決された時点で、解決先のバージョンおよびアーティファクトのダイジェストとともに記録されます。この状態は、記録がすでに保持しているゲートについて、後の解決が異なるバージョンまたは異なるバイトに到達し、かつ実行がその同一性の採用を求めていなかったときに報告されるものです。

バージョンの変化とバイトの変化の両方を 1 つの状態で扱うのは、記録がプラグインの同一性でアドレス指定され、バージョンとダイジェストを 1 つのエントリのフィールドとして持つためです。解決結果との比較は、結果が 1 つの単一の比較になります。バイトを変えない再公開と同じバージョンでの再プッシュは、レビュー担当者にとっては同じ出来事です。同一性がもはやレビューされたものではないということです。

これは、記録済みのゲートがどこからもアタッチされなくなった場合とは別の問題です。そちらは同一性ではなく存在の問題です。また、キャッシュされたバイトが記録されたダイジェストと一致しないプラグインとも異なります。そちらはレビュー済みではないプラグインの実行を拒否し、対処はアーティファクトの復元または再記録です。一方こちらは、求められずに新しい同一性を採用することを拒否し、対処はアップグレードでプラグインを指定することです。対処が 2 つ、状態も 2 つです。

新しい同一性を求める手段は pull がすでに提供しており、方法は 2 つあります。 全体の再取得はすべてを再解決し、対象を絞ったアップグレードは指定したプラグインを再解決します。どちらも新しい同一性が求められたものとして扱われ、記録が更新されます。それ以外の pull は記録された同一性を保持して停止します。これが記録する目的です。次に解決されたものを何でも受け入れる記録は、解決を統制するのではなく解決に追従するだけになります。初めて現れたものは不一致ではありません。記録がまだ保持していない同一性は、単に書き込まれます。

この比較は検証のみを行う pull でも実行されます。 この pull は記録もロックファイルも書き込みません。隣のロックファイルを確認しながら記録を飛ばす検証は、確かめてもいない一致を報告することになります。

出力されるメッセージ。プラグイン、両方の同一性、および両方の対処を示します:

plugin "<plugin-identity>": <record-path> records version <recorded-version> with digest <recorded-digest> as trusted for it, but this resolution reports version <resolved-version> with digest <resolved-digest>; review what changed and adopt it with aggrega pull --upgrade --release <release> <plugin>, or restore the recorded identity: the plugin identity recorded as trusted no longer matches what this resolution reports(プラグインについて、記録ファイルは記録済みのバージョンとダイジェストを信頼済みとして記録していますが、今回の解決は別のバージョンとダイジェストを報告しています。変更内容をレビューして上記の upgrade コマンドで採用するか、記録された同一性を復元してください。信頼済みとして記録されたプラグインの同一性が、今回の解決が報告するものと一致しなくなりました)

対処方法: 2 つの同一性のどちらが意図したものかを判断してください。それができるのは利用者だけです。変化が意図したもので、ゲートが再公開され変更内容をレビュー済みであれば、メッセージが示す対象を絞ったアップグレードで採用します。これによりそのプラグインが再解決され、エントリが書き換えられます。予期していなかった場合は、記録された同一性がレビュー済みのものです。記録が示すバージョンまたはアーティファクトを復元し、参照が別の場所に解決されるようになった理由を調査してください。この状態を解消するために記録を編集しないでください。記録はレビュー済みの内容をコミットした記述であり、通常の pull が意図的にそのまま残すのは、変更されたゲートを黙って受け入れることこそ、この拒否が防ぐために存在するものだからです。

A Plugin entity’s claims disagree with the plugin’s own self-report(Plugin エンティティの主張がプラグイン自身の自己申告と一致しない)

Plugin エンティティは、それが指すプラグインが提供するものを記述します。どの export を持つか、それぞれが何に対してどのスコープで動作するか、そしてプロバイダーを提供するプラグインについてはレンダリング時にどう振る舞うか、です。プラグインはロードされたときに同じ事項を自身について報告します。この条件は、両者の不一致を報告するものです。

比較は export ごとに名前をキーとして行われ、一方向にのみ実行されます。エンティティが主張するものはすべて一致しなければならず、プラグインはそれ以上を提供してもかまいません。 プラグインの表面の一部を記述するエンティティは残りを列挙する必要がないため、プラグインが宣言しエンティティが省略した export は不一致ではありません。不一致となるのは、プラグインが宣言していない export を主張した場合、または主張した export の operates やスコープがプラグインの報告と異なる場合です。自由形式のセレクタは比較されません。

エンティティが render-behaviour ブロックも記述している場合、そのフィールドが一つずつ比較されます。入力の種類、アセンブリモード、artifact-template の区切り文字ペア、アセンブリ名アノテーション、再利用可能インスタンスの主張、境界をまたぐリンクの主張、omit エントリの主張、ネストディレクトリです。最初に不一致となったものが示されます。そのようなブロックを記述していないエンティティでは、この比較は完全に省略されます。

同じチェックが公開時にも実行されるため、不一致は通常、ビルドがエンティティをロードする時点ではなく、エンティティの公開前に表面化します。

出力されるメッセージ。プラグインが持たない export を主張した場合:

entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe()(エンティティが、プラグインの describe() が宣言していない export を主張しています: wasm: エンティティのコントラクトの主張がプラグインの describe() と一致しません)

主張した export のフィールドの場合:

entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe()(エンティティの export が宣言する operates が、プラグインの describe() が報告する値と異なります: wasm: エンティティのコントラクトの主張がプラグインの describe() と一致しません)

そして render-behaviour のフィールドの場合で、同じ形で不一致となったフィールドを示して報告します:

entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe()(エンティティが宣言する boundary_assembly が、プラグインの describe() が報告する値と異なります: wasm: エンティティのコントラクトの主張がプラグインの describe() と一致しません)

修正方法: 修正すべきは Plugin エンティティの主張であり、Aggregate や Release ではありません。主張をプラグインの報告に合わせてください。メッセージは両方の値を示すため、どちらに合わせるべきかはメッセージ自体から分かります。自分が公開するエンティティであれば、バイナリから再生成するのが両者を一致させる確実な方法です。公開済みのエンティティを利用している場合は、主張が指し示すバイナリと一致するバージョンを選択し、不一致を公開者に報告してください。

A Plugin entity’s recorded command set does not match the plugin(Plugin エンティティに記録されたコマンドセットがプラグインと一致しない)

ターミナルコマンドを提供するプラグインは、それらのコマンドが Plugin エンティティに記録されます。この記録は記述されたものではなく機械的に書き込まれたものです。プラグインから読み出して書き留めるため、バイナリを正確に反映します。この条件は、記録がバイナリを反映しなくなったことを報告するものです。コマンド名、短いヘルプテキスト、またはコマンドが宣言される順序の違いが該当します。

比較は完全一致であり、これは意図的です。 エンティティ上の他の capability や export の主張は人の手で選ばれたものです。作成者は表面の一部を記述して残りを省略することが正当に許されるため、それらは部分集合としてチェックされます。コマンドの記録は人の手で選ばれたものではないため、完全一致に満たない状態は記録がプラグインの実際の提供内容からずれたことを意味し、近いが正しくないコマンドリストこそが呼び出しを誤ってルーティングさせる原因になります。

エンティティなしでロードされたプラグインはここではチェックされません。 記録はエンティティ上にあるため、直接ロードされたバイトには記録がなく、比較の対象がありません。

出力されるメッセージ。両方のセットと再記録の方法を示します:

wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe()(記録されたコマンドのミラーがプラグインの describe() のコマンドと一致しません。同期コマンドを再実行し、結果をコミットしてください: wasm: 記録されたコマンドのミラーがプラグインの describe() と一致しません)

公開時の同じ比較では、再記録の指示なしでセットを報告します:

plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>: wasm: recorded command mirror does not match plugin describe()(記録されたコマンドのミラーがプラグインの describe() のコマンドと一致しません: wasm: 記録されたコマンドのミラーがプラグインの describe() と一致しません)

修正方法: バイナリからセットを再記録し、結果をコミットしてください。そのためのコマンドはメッセージに示されています。記録を手で編集して合わせないでください。記録は機械が所有するものであり、今日たまたま一致する手編集も、次に記録されるときに再導出されて上書きされます。公開済みのエンティティを公開するのではなく利用している場合、そのエンティティは自身のバイナリが裏付けない記録とともに公開されており、それは公開者が対処すべき問題です。

A Plugin entity’s recorded version does not match the plugin(Plugin エンティティに記録されたバージョンがプラグインと一致しない)

プラグインはビルドが埋め込んだバージョンを報告し、Plugin エンティティもバージョンを記録します。両者は同じ文字列でなければなりません。Aggrega のプラグインのビルドに使われるビルドレシピは、そのバージョンをプラグインをリリースするタグから取得します。コンパイラに同梱されるプラグインではコンパイラ自身のタグ、コンパイラの外で配布されるプラグインではプラグイン自身のタグです。そのため、タグが指すコミットのビルドはリリースバージョンを報告し、それ以外のコミットのビルドは 1.0.0-3-g1a2b3c4 のような開発バージョンを報告します。この条件は、この対がずれたことを報告するものであり、ずれた対がカタログに届かないよう、バイトが公開される前にチェックされます。

比較は文字列の完全一致です。ビルドバージョンを記録せずにビルドされたプラグインは空のバージョンを報告し、その場合はエンティティのバージョンがその空の値と等しくなければなりません。このチェックは「バージョンが報告されない」ことを「どのバージョンも受け入れる」こととしては扱いません。公開されたエンティティのバージョンが、そのバイナリが実際に報告するものを常に示すことがこのチェックの目的だからです。

出力されるメッセージ:

plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe()(記録された metadata.version がプラグインの describe() のバージョンと一致しません: wasm: エンティティの metadata.version がプラグインの describe() と一致しません)

公開時には、拒否のメッセージはエンティティファイル、.wasm、および修正方法も示します:

Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe()(エンティティファイルの metadata.version が .wasm の describe() のバージョンと一致しません — metadata.version を公開するリリースに設定し、そのリリースのタグが指すコミットのクリーンなチェックアウトからプラグインをビルドして、プラグイン自身がそのバージョンを報告するようにしてください。新しいリリースの場合は、まずエンティティをリリース対象のソースとともにコミットし、そのコミットにタグを付けてください: 記録された metadata.version がプラグインの describe() のバージョンと一致しません: wasm: エンティティの metadata.version がプラグインの describe() と一致しません)

修正方法: エンティティの metadata.version を公開するリリースにし、そのリリースのタグが指すコミットのクリーンなチェックアウトからプラグインをビルドして、プラグイン自身がそのバージョンを報告するようにしてください。新しいリリースの場合は、まずエンティティをリリースするソースとともにコミットし、そのコミットにタグを付けてください。タグは、すでにエンティティを含むコミットを指していなければなりません。プラグインが報告するバージョンをエンティティにコピーしないでください。それ以外のコミットのビルドは開発バージョンを報告するため、コピーするとどのリリースタグも指さないバージョンでそのビルドが公開されてしまいます。プラグインがバージョンをまったく報告しない場合、バージョンを記録せずにビルドされています。バージョンを記録してビルドしてください。

A plugin was built from a working tree with uncommitted changes(プラグインが未コミットの変更を含む作業ツリーからビルドされています)

プラグインのビルドは、ビルド元のコミットからバージョンを記録します。未コミットの変更を含む作業ツリーから行われたビルドでは、そのバージョンの末尾に -dirty マークが付きます(タグ上では 1.0.0-dirty、タグより後では 1.0.0-3-g1a2b3c4-dirty)。このようなバージョンは有効なセマンティックバージョンですが、ビルドされたバイトを保持していないコミットを指すため、公開されるバージョンから公開されるものを誰も再ビルドできません。Plugin の公開では、自身のバージョンにこのマークを持つプラグインを、バイトが公開される前、かつレジストリに接続する前に拒否します。ドライランでも拒否されます。

拒否されるのはこのマークだけです。1.0.0-3-g1a2b3c4 のようにコミットからビルドされた開発バージョンは、ビルドされたものを実際に保持するコミットを指すため、公開できます。1.0.0-rc.1 のようなプレリリースも同様です。公開以外の場面でプラグインをエンティティに対して検証する場合、この条件は発生しません。開発中のビルドは編集済みのツリーから行われるのが通常だからです。

このチェックはプラグインが自身のビルドについて報告するバージョンを読み取り、エンティティの metadata.version との比較より前に実行されます。そのため、クリーンなバージョンを記録したエンティティのもとで未コミットの変更を含めてビルドされたプラグインは、記録されたバージョンがプラグインと一致しないとしてではなく、ここで報告されます。

出力されるメッセージ(プラグイン、それが報告するバージョン、対処方法を示します):

Plugin <plugin>: the .wasm at <path> was built from a working tree with uncommitted changes — set metadata.version in <entity-path> to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports (plugin "<plugin>", describe() version "<version>", which ends with "-dirty")

対処方法: リリースのタグが指すコミットのクリーンなチェックアウトからプラグインをビルドし、エンティティが記録するリリースバージョンをプラグイン自身が報告するようにします。変更そのものをリリースするには、エンティティの metadata.version を新しいリリースに設定し、変更とともにエンティティをコミットし、そのコミットにタグを付けて、そこでビルドします。変更をコミットして再ビルドするだけではリリースへの道は開けません。再ビルドしたプラグインは開発バージョンを報告し、それをエンティティにコピーすると、どのリリースタグも指さないバージョンでビルドを公開することになるからです。

A Plugin entity’s recorded host functions do not match the binary(Plugin エンティティに記録されたホスト関数がバイナリと一致しません)

プラグインはホスト自身の呼び出しのうちどれを使用するかを宣言し、その集合はプラグインの公開時に Plugin エンティティに記録されます。これは記述されるのではなく、バイナリ自体から読み取られます。プラグインを取得する際、内容が検証されたばかりのバイトから集合が再度導出され、記録と比較されます。どちらの方向の差異でも取得は停止します。

これはコンテンツのピンを繰り返すのではなく、その上に重なるものです。ピンだけでは検出できない二つのことを検出します。一つは通常の公開経路以外で公開されたバイナリで、記録を持たないか、自身のバイトを記述していない記録を持つものです。もう一つは記録ステップ自体の不具合です。ピンはバイトがピン留めされたバイトであることを保証し、このチェックはそのバイトについて書き留められた内容が事実であることを保証します。

記録を持たないエンティティは空の集合と比較され、ホストの呼び出しを一切使用しないプラグインと一致します。どちらから見ても同じ無害な一致であるため、記録のないエンティティが記録の欠如を理由に拒否されることはありません。

出力されるメッセージ(プラグイン、両方の集合、バイトの取得元アーティファクトを示します):

plugin "<plugin>": stamped spec.runtime.hostFunctions <recorded set> does not match <derived set> derived from the verified .wasm <artifact>: wasm: stamped host-function record does not match .wasm imports

プラグインの検証中に実行される同じ比較では、アーティファクトを含めずに二つの集合を報告します:

plugin "<plugin>": recorded host-function record <recorded set> does not match the .wasm imports <derived set>: wasm: stamped host-function record does not match .wasm imports

対処方法: エンティティファイルの内容が原因ではなく、記述を変更しても解消しません。通常の公開経路でプラグインを再公開してください。この経路はバイナリから記録を導出し、両者を一緒に書き込みます。公開済みのプラグインを利用している場合、エンティティとそれが指すバイナリが食い違ったまま公開されています。メッセージから両方の集合を引用して、公開者に不一致を報告してください。記録を手作業で編集して一致させてはいけません。記録は記述されるのではなく導出されるものであり、次の導出で編集は破棄されます。

The lockfile no longer matches what the release resolves to(lockfile が、release の解決結果と一致しなくなっています)

release の lockfile は、その release が到達するすべてのエンティティ、ライブラリ、プラグインを、選択されたバージョンとダイジェストとともに固定します。また、release ファイル自体(release と、それが拡張する各 release)を、その内容のダイジェストによって記録します。エンティティのダイジェストは、その公開物が運ぶもの、すなわちドキュメントと、その横に置かれて名前で参照される各ファイルを、それぞれのパスとバイト列によってカバーします。ライブラリとプラグインのダイジェストは、そのバイト列をカバーします。release を再度解決すると同じ集合が生成され、両者が比較されます。この条件は、その不一致を報告するものです。

不一致は、いずれかが報告される前にすべて収集されます。対象は lockfile が固定するすべてのものです。そのため、1 件ずつではなく、1 回の実行で全体像がわかります。

報告される不一致には次の形があり、対処法が異なるため区別する価値があります。

  • lockfile が固定していない参照。 release が、lockfile にエントリのないものに到達するようになっています。lockfile を書き込んだ pull 以降に追加された依存関係です。エントリには release がそれを要求している場所が示されます。Manifest がバインドする Recipe または FeatureRecipe は、それをバインドするマッピングエントリとともに報告され、name 層がバインドするものは、それが選ばれたインスタンスまたはアタッチメントを示します。
  • ペアが変わった固定済みの参照。 lockfile はあるバージョンとダイジェストのペアを固定していますが、解決結果は別のペアを生成しました。これは、バイト列が変わったベンダリング済みのコンテンツか、ワークスペース内で変わったものです。具体的には、エンティティやライブラリのドキュメントの編集、エンティティが名前で参照するファイル(source 配下のチャート、インポートするファイル、横にある entity.lock)の編集・追加・削除、またはプラグインのエンティティの横にある .wasm の置き換えです。エントリはファイルではなくエンティティを示します。Recipe や FeatureRecipe の lock の配下で変わったファイルは、An entity reads an input the lock beside it records no pin for(エンティティが、横にある lock に固定が記録されていない入力を読み込んでいます)で説明しているとおり、通常の aggrega pull --release <release> が示します。レジストリが固定済みバージョンで別のバイト列を提供している場合は、ここでは報告されません。それを取得する pull が拒否します。Fetched or cached bytes do not match the digest committed for them(取得またはキャッシュされたバイト列が、それに対してコミットされたダイジェストと一致しません)を参照してください。
  • release がもはや到達しない固定済みの参照。 lockfile は、release 内のどこからも依存されなくなったものをまだ固定しています。
  • pull 以降に編集された release ファイル。 release、またはそれが拡張する release が、lockfile に記録されたバイト列を保持していません。release が要求するもの(どの source バージョンを取得するか、どのコンポーネントをどこに配置するか)はすべてファイルの内容から解決されるため、記録された固定が現在の要求を表していない可能性があります。これは、レンダリングが失敗したであろう箇所としてではなく、何かがレンダリングされる前にここで報告されます。編集された source バージョンは、そうでなければ後になって、固定が見つからない取得として表面化することになります。release ファイルをまったく記録していない lockfile は release を未記録として報告し、release がもはや拡張しない release ファイルは、もう読み込まれないものとして報告されます。
  • リモートで移動した source 参照。 git の ref: で記述された source は、その ref が解決されたコミットで記録されます。アップグレードではない各 pull は、ref が現在どこを指しているかをリモートに問い合わせます。ネットワークに到達できる場合は aggrega pull --verify も同様です。別のコミットに解決される ref は、採用されるのではなくここで報告されます。これを報告するのはこの 2 つだけです。ビルドは記録されたコミットを読み込み、問い合わせを行いません。

比較は内容に対して行われるため、別の経路で到達した同一の内容はずれとはなりません。これが発生するには、バイト列が異なる必要があります。release ファイルでは、コメントや空白の変更も含まれます。これは release が名前で参照する Aggregate と Manifest の場合とまったく同じです。エンティティでは、それが運ぶものの内容が対象です。そのため、カタログディレクトリから読み込んだ同じエンティティとレジストリから取得したものはずれとならず、実行ビットを含むパーミッションビットだけが異なるチェックアウトや、アーカイブの圧縮方法が異なる公開物もずれとはなりません。

出力されるメッセージです。条件自身の文で始まり、その後に収集されたすべての不一致が続きます。それぞれがその軸を示し、エンティティの場合はその種類も示します。エンティティは種類と URI の組み合わせで識別されるため、Aggregate と Manifest が同じ名前を持つ Release には 2 つのエントリがあり、どちらかを編集すると、編集された方に対して報告されます:

lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>)(ロックファイル:最新ではありません。その Release の解決結果と一致しなくなっています:種類付きのエンティティがロックファイルにありません。参照元の位置も示されます) <axis> "<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>)(示された軸上の示された参照が変更されました:ロックファイルのバージョンとダイジェストが現在のものと異なります) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>)(示された種類の示されたエンティティが変更されました:ロックファイルのバージョンとダイジェストが現在のものと異なります) <axis> "<uri>" no longer used by the release(示された軸上の示された参照は、リリースで使用されなくなりました) release document "<file>" was edited after the lockfile was written: its content no longer matches the recorded digest (lockfile=<digest> current=<digest>), so the pins may no longer describe what it asks for; re-resolving the Release records the files it reads as they now stand(示されたリリースドキュメントはロックファイルの書き込み後に編集されました:その内容は記録されたダイジェストと一致しなくなったため、ピンはそれが要求する内容を表していない可能性があります。Release を再解決すると、読み込むファイルが現在の状態で記録されます)

<site> は、release がその参照を要求している場所で、それを名前で参照するエントリへのパスとして書かれます(たとえば manifest.spec.mappings.components.name.db-primary)。このような場所はソート順で最大 3 つまで列挙され、それ以上ある場合は後に ... が付きます。解決時にこのような場所が記録されない参照は、括弧なしで報告されます。

移動した source 参照を報告する pull は、作成者が書いたとおりにアーティファクトを示し、source が名前を指定している場合は chart= と module_subdir= も付けます。

source-artifact kind=<kind> url=<url>: reference "<ref>" moved — the lockfile pins <commit>, and it now resolves to <commit>; adopt where it now points with aggrega pull --upgrade --release <release>

ビルドは、エントリの後に対処法を出力します。

run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile

どのコマンドがリリースをそのロックファイルに従わせるか。 aggrega build はレンダリングの前に比較を行い、停止します。aggrega validate --release と、リリースを解決するすべての aggrega inspect の選択(デフォルトのビュー、--resolved、--ir-graph、--closure)は、リリースの依存関係が解決されるとすぐに同じ比較を実行し、同じメッセージと対処法で停止し、標準出力には何も書き込みません。そのため、どちらもビルドがずれているとして拒否するロックファイルを見逃すことはありません。アシスタントツールの build、release を指定した validate、release を指定した describe も同じ条件で拒否します。aggrega pull はこれから書き込むロックファイルに対して、aggrega pull --verify はディスク上のロックファイルに対してこの比較を実行します。リリースを解決しないコマンド(引数なし(この場合は extends の親を見つけるためだけにロックファイルのピンを読み込みます)、またはエンティティパスを指定した aggrega validate、および --ir-graph なしの aggrega inspect --raw または --output yaml)はロックファイルに従わされず、隣にロックファイルがないリリースも同様です。エディタの言語サーバーはこれによってビルドを停止し、グラフ要求に対してはグラフを描画しつつ、ロックファイル上の警告として報告します。

修正方法: release を再解決し、書き直された lockfile をコミットします。ビルドが報告するすべてのものについて、通常の aggrega pull --release <release>(ビルドが出力するコマンド)だけで修正が完了します。これは release を現在の状態で解決し、変わった固定を書き直し、それ以外はすべて保持するため、触れていないものが変動することはありません。変わったものが Recipe や FeatureRecipe のローカル source 配下のファイルである場合、その pull はまずそのエンティティに対する aggrega pin を示して停止します。新しい固定をその横に記録するのは作成者の手順だからです。それを実行するか、pull に --pin-sources を渡すと、pull がずれを解消します。通常の pull で解消されない唯一のエントリは、リモートで移動した source 参照です。これを解消するには、参照が現在示すコミットを採用する必要があるためです。aggrega pull --upgrade --release <release> がそれを行い、エントリにもそう記されています。Recipe の entity.lock がその source を記録している場合、新しいコミットがその横に固定されるまで、アップグレードは同様に停止します。実行する前にエントリを読んでください。3 番目の形は特に立ち止まって確認すべきものです。release がもはや到達しない参照は、通常は意図的に削除した依存関係ですが、削除していない場合は、何か別の変更によって到達不能になっています。触れていない参照でペアが変わった場合、そのバージョンの内容はレビューされた内容ではないことを意味します。これは確認せずに採用すべきものではなく、それを提供する者に問い合わせるべき事柄です。

pull は、書き込もうとしている lockfile に対してこれと同じ比較を実行し、比較で拒否されるものは書き込みません。そのため、pull が書き込んだ直後の lockfile は、同じ入力が与えられたビルドではこの比較を通過します。完了した pull の直後にこの条件が再び発生する場合、2 つの実行には異なる入力が与えられています。たとえば、一方にだけ渡されたカタログディレクトリや、両者の間に編集されたワークスペース設定です。pull とビルドは同じ入力で実行してください。

An artifact is not at the source the build was told to find it(ビルドが探すよう指示されたソースにアーティファクトがありません)

カタログ参照はアーティファクトとバージョンを指定します。この条件は、その組に応答するものが、参照の解決先のレジストリにも、ビルドが読み取るローカルのアーティファクトキャッシュにも存在しないことを報告します。

ビルドはキャッシュを読み取り、自らネットワークに接続することはありません。 取得は別のステップです。リリースを解決する pull がリリースに必要なものを取得してキャッシュに書き込み、その後ビルドがそこにあるものを読み取ります。そのため、この条件はビルドにはキャッシュミスとして、pull にはそのようなアーティファクトを持たないレジストリとして現れます。開始時にロックファイルを埋めるよう設定されたビルドでは、そこで実行される取得も同じ pull です。

出力されるメッセージ。該当するタグを持たないレジストリの場合と、コンテンツ blob が存在しないマニフェストを解決した取得の場合:

oci: "<reference>:<version>": oci: artifact not found at remote source

oci: content for "<reference>:<version>": oci: artifact not found at remote source

エントリが見つからなかったキャッシュ読み取り(ビルドが遭遇するのはこの形です):

oci: cache miss for <reference>@<version>: oci: artifact not found at remote source

そして、キャッシュ済みアーティファクトの横にマニフェストがない場合も同様です:

oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source

修正方法: まず参照とバージョンを確認します。もう存在しないバージョンと、タイプミスを含む名前は同じ応答になります。メッセージには両方が引用されるため、カタログと照合できます。参照が正しい場合、アーティファクトはまだ取得されていません。リリースの pull を実行すると、リリースが到達するものが取得され、キャッシュに格納されます。ワークスペースがオフラインの場合、その pull はネットワークにアクセスできる場所で実行する必要があります。オフラインのビルドはすでにキャッシュされているものしか読み取らず、キャッシュにそれがない場合にこのメッセージを出します。

The registry will not serve an artifact without credentials it accepts(レジストリは受け入れ可能な認証情報なしにはアーティファクトを提供しません)

レジストリは応答しましたが、拒否しました。認証情報が提示されなかったか、提示された認証情報が受け入れられなかったかのいずれかです。これはまったく到達できなかったレジストリとは異なります。ここでは通信が行われ、その応答が拒否だったということです。

これを報告するのは、アーティファクトの取得中または公開中の 4 つの時点です。参照の解決、そのコンテンツの pull、リポジトリが保持するバージョンの一覧取得、そして認証情報を保存する時点でのその確認です。

出力されるメッセージ。それぞれ要求されていたものを示し、レジストリの応答を引用します:

oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed

リポジトリのバージョン一覧取得では、代わりにステータスを示します:

oci: tags/list "<repository>": status <code>: oci: authentication required or failed

そして、保存時の認証情報の確認:

oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed

修復手順を提供するステップで失敗が表面化した場合、行の末尾に、導出したホストに対して実行するログインが付きます:

remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release>(対処:aggrega pull —release を再実行する前に、示されたホストに対して aggrega login(または docker login)を実行してください)

また、import がコンパイラのコアインポーターの 1 つを取得していた場合は、import を再実行する前に行う同じログインで終わります:

remediation: aggrega login <host> (or docker login <host>) before re-running the import(対処:import を再実行する前に aggrega login(または docker login)を実行します)

http または https で取得される従来型の Helm チャートリポジトリやチャートアーカイブ、compose フラグメント、Git リポジトリも、サーバーがリクエストを未認可として拒否した場合にこの条件を報告します。その修復策はログインではなく追加すべき netrc エントリを示します。これらの取得はそのファイルから認証情報を読み取るためです:

remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again(修復策:netrc ファイルにそのホストのエントリ(machine、login、password を含む)を追加してから、コマンドを再実行してください)

修正方法: これはエンティティの作成者ではなくオペレーターの対応事項です。Aggregate、Component、Recipe の内容が原因になることはありません。公式ハブである hub.aggrega.ai は公開するものを誰にでも提供するため、そこからの読み取りに認証情報は不要ですが、そこへの公開には必要です。他のレジストリでは読み取りにも認証情報が必要な場合があります。メッセージが示すホストにログインし(http または https で取得されるソースの場合は、修復策が示す netrc エントリを追加し)、取得を再実行します。すでにログインしている場合、ストア内の認証情報はそのホストがそのリポジトリに対して受け入れるものではありません。再度ログインして更新し、参照の解決先リポジトリへの読み取り権限がアカウントにあるか確認します。プライベートリポジトリは、それを参照できないアカウントに対してまさにこのように応答するためです。参照が想定外のホストに解決される場合は、.aggrega-config.yaml のレジストリエイリアスまたはデフォルトレジストリが別の場所を指しています。

The netrc file cannot be read(netrc ファイルを読み取れない)

従来型の Helm チャートリポジトリやチャートアーカイブ、compose フラグメント、http または https で取得する Git リポジトリは、認証情報を netrc ファイルから取得します。このファイルは、そのようなソースが取得されるとき、つまり pull、pin、またはロックファイルを埋めるビルドによって読み取られます。どのファイルが読み取られ、どのエントリがリクエストに応答するかは Authentication で説明しています。この条件は、存在するものの使用できない netrc ファイルを報告します。たとえばディレクトリである、読み取り権限がないなどの理由で読み取れないか、netrc の形式に従っていない場合です。形式は厳密に読み取られます。誤った位置で読まれた単語は、その後のすべての単語をずらしてしまうためです。キーワードの綴りを間違えると、その後のパスワードが次のキーワードとして扱われ、ファイルは問題なく見えるのに、リクエストは認証情報なし、または誤った認証情報で送信されてしまいます。

存在しないファイルはこの条件に該当しません。認証情報を何も持たず、認証情報を必要とするリクエストにはサーバーの拒否が応答します。マシンの他のユーザーが読み取れるファイルもこの条件には該当しません。Linux と macOS では、そのファイルを示す警告が 1 回出ますが、ファイルは読み取られます。

メッセージはファイルを示し、形式の誤りの場合は行も示します。また、何が誤っているかを形式の観点だけで述べ、ファイルに含まれる単語は決して示しません。位置を誤った単語がパスワードである可能性があるためです。この診断にはカテゴリがありません。netrc ファイルはビルドが読み取るドキュメントではなく、自分自身の認証情報ファイルだからです。

形式の誤りに対して出力されるメッセージです。形式の誤りとは、キーワードがあるべき位置に単語がある、キーワードの後に値がない、login、password または account がどの machine や default のエントリよりも前にある、引用符で囲んだ単語が始まった行で閉じられていない、のいずれかです。

the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead(netrc ファイルを読み取れませんでした(示されたファイルと行で、キーワード(machine、default、login、password、account または macdef)があるべき位置に単語があります)。ファイルを修正するか、代わりに読み取る別の netrc ファイルのパスを NETRC に設定してください)

また、読み取れなかったファイルの場合は、その理由を引用します。

the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead(netrc ファイルを読み取れませんでした(示されたファイルと読み取れなかった理由)。ファイルを修正するか、代わりに読み取る別の netrc ファイルのパスを NETRC に設定してください)

修正方法: メッセージが示すファイルを開きます。形式の誤りの場合は、示された行に移動します。各エントリは machine <host>(または default)の後に login <user> と password <secret> が続く形であり、キーワードの綴り間違いや値の欠落がよくある原因です。読み取れなかったファイルの場合は、自分が読み取れ、かつ自分だけが読み取れるファイルにします(chmod 600)。そのファイルが読み取らせたいものでない場合は、読み取らせたいファイルのパスを NETRC に設定します。

The registry could not be reached(レジストリに到達できませんでした)

レジストリとの通信は行われませんでした。名前解決、接続、またはセキュアハンドシェイクが失敗しています。これは応答して拒否したレジストリの対になるものです。ここではどちらとも確定していないため、相手側のアーティファクトの状態は、存在しないと判明しているのではなく不明です。

また、Recipe のソースの取得中に、より具体的な原因のないトランスポート障害が起きた場合もこれが報告されます。そのため、これはその経路における一般的な「相手側に到達できなかった」という応答であり、どの層が失敗したかを示すものではありません。

出力されるメッセージ。取得中のソースを示し、根本のトランスポート障害を引用し、この条件が持つ修復手順を添えます:

sourceresolver: kind=<kind> url=<url> version=<version>: oci: network unreachable (cause: <the transport failure>); remediation: check network connectivity to <host>; corporate proxies typically need HTTPS_PROXY exported

修正方法: 修正はオペレーターの対応事項であり、カタログの外にあります。コマンドを実行している場所からメッセージのホストに到達できるか確認します。環境がプロキシ経由でネットワークに接続する場合、修復手順が示すとおり、プロキシを環境にエクスポートする必要があります。ブラウザやパッケージマネージャーにのみ設定されたプロキシは使用されません。手動ではホストに到達できるのにここからは到達できない場合、違いは通常、プロキシでの認証情報か、ハンドシェイクが受け入れなかった傍受用証明書です。アーティファクトがキャッシュされれば、以降のビルドはキャッシュを読み取るため、ネットワークはまったく必要ありません。

A server did not answer in time (サーバーが時間内に応答しませんでした)

リクエストが、宛先のサーバー(レジストリ、または署名が記録される透明性ログのような、コマンドが到達するその他のサーバー)を待ち続け、取り下げられました。リクエストは、全体の送信が完了してからサーバーが応答を開始するまで最大 30 秒、すでに届きつつある応答の次の部分を最大 30 秒待ちます。いずれかを超えると、この条件のもとで拒否され、サーバーと待機時間が示されます。接続を受け付けたまま応答しないサーバーも、接続をまったく受け付けないアドレスも、この結果を生み、コマンドが際限なく待つことはありません。レジストリのリポジトリ一覧全体の走査は、代わりに各ページで走査が実行できる時間いっぱいまで待ち、独自の条件 E0377 によって制限されます。

制限されるのは待機だけです。進み続けるダウンロードやアップロードは、必要なだけ時間がかかります。待機時間は何も届いていない間だけ計測されるためです。Recipe の source: が HTTPS で取得する Helm チャートは、応答の開始を待つ時間だけが制限され、その期限切れはこの条件ではなく、ネットワークライブラリ自身の言葉で報告されます。タイムアウトしたときにコマンドがもともと再送するリクエスト(aggrega registry update 中の読み取りや、公開中の書き込み)は、まず再送されるため、拒否はその最後の試行の後に残ったものです。

レジストリが応答しなかったバージョン一覧について出力されるメッセージ:

aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: plugin/cli/mo のバージョンを一覧表示: oci: タグを一覧表示: Get: 127.0.0.1:18471 が 30s 以内に応答しませんでした: egress: サーバーが時間内に応答しませんでした)

また、応答が途中で止まった場合:

<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (応答を停止しました: 応答の続きが 30s の間まったく届きませんでした: egress: サーバーが時間内に応答しませんでした)

修正方法:修正はオペレーターが行うもので、カタログの範囲外です。メッセージが示すサーバーが稼働しており、コマンドを実行している場所から到達可能であることを確認してください。高負荷またはメンテナンス中のレジストリは後で再び応答するので、コマンドをそのまま再実行できます。環境がプロキシ経由でネットワークに接続している場合は、プロキシがリクエストを保持せずに転送していることを確認してください。待機時間は固定されており、延長する設定はありません。

A registry’s repository listing did not end in time (レジストリのリポジトリ一覧が時間内に終わりませんでした)

レジストリのリポジトリ一覧全体の走査が、一覧の末尾に到達しないまま 5 分間続いたため、停止されました。一覧を走査するコマンドは 2 つあります。aggrega plugin add は、与えられた名前と完全に一致するプラグインがなく、その名前を含む名前のプラグインを探す場合に限って走査します。aggrega registry update は、レジストリの各リポジトリを読む前にリポジトリを一覧表示します。新しいリポジトリを際限なく挙げ続ける一覧も、レジストリの提供が遅すぎて終わらない一覧も、コマンドを止めたままにせずここで終了します。走査はリポジトリをまったく返さないため、途中で打ち切られた一覧から何かが選ばれたりインデックスされたりすることはありません。メッセージには、停止された時点で一覧が挙げていたリポジトリの数が示されます。

クエリが名前の一部であるプラグイン追加について出力されるメッセージ:

aggrega plugin add: 127.0.0.1:18472: no cli plugin is named “mo”, and searching every repository for a name containing it did not finish; name the plugin exactly, as aggrega plugin add cli <name>: the walk was stopped after 5m0s, before the listing ended (repositories named so far: 146): registry: the repository listing did not end in time (aggrega plugin add: 127.0.0.1:18472: 「mo」という名前の cli プラグインはなく、それを含む名前をすべてのリポジトリから探す検索は完了しませんでした。aggrega plugin add cli の後にプラグイン名を続けて、プラグインを正確な名前で指定してください: 走査は一覧が終わる前に 5m0s で停止されました (これまでに挙げられたリポジトリ数: 146): registry: リポジトリ一覧が時間内に終わりませんでした)

修正方法:aggrega plugin add では、プラグインを正確な名前で指定してください(aggrega plugin add cli mo ではなく aggrega plugin add cli moo)。そうすると、1 回のリクエストでその名前のプラグインを検索し、一覧を走査することはありません。aggrega registry update では、レジストリの一覧が原因です。レジストリを運用している人に一覧が終わることを確認し、終わるようになったら更新を再実行してください。5 分の上限は固定されており、延長する設定はありません。

A registry kept asking to slow down (レジストリが速度を落とすよう求め続けた)

混雑しすぎたレジストリは 429 Too Many Requests、または待つべき時間を示す Retry-After ヘッダー付きの 503 Service Unavailable を返します。コマンドがレジストリに送るすべてのリクエストは、レジストリが求める時間(示されていない場合は 10 秒)だけ待機してから再度送信されます。そのレジストリへのすべてのリクエストが一緒に待機し、再び応答するまで同時に送られるリクエストは減らされます。5 分間「速度を落として」以外に何も応答しないレジストリはこの条件で拒否され、そのレジストリ、最後の応答、およびそれ以外の応答がなかった時間が示されます。待機中にリクエスト自身の時間制限が切れた場合も同様です。その場合 aggrega registry update はそのレジストリをインデックス未作成として報告し、そのレジストリには実行前のインデックスが保持されます。

5 分間速度を落とすよう求め続けたレジストリについて出力されるメッセージ:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for 5m0s: oci: the registry kept asking to slow down (速度を落とすよう求め続けた: 最後の応答は 429 Too Many Requests で、5m0s の間それ以外に何も応答しなかった: oci: レジストリが速度を落とすよう求め続けた)

および、リクエスト自身の時間制限によって待機が終了した場合:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for <how long> when the request’s own time ran out: oci: the registry kept asking to slow down (速度を落とすよう求め続けた: 最後の応答は 429 Too Many Requests で、リクエスト自身の時間が尽きた時点までそれ以外に何も応答しなかった: oci: レジストリが速度を落とすよう求め続けた)

対処方法:原因はレジストリのレート制限であり、作成した内容ではありません。クライアントのリクエスト頻度を制限するレジストリは、通常、同じアドレスから来るすべてのリクエストを制限しているため、そのアドレスの背後にあるほかのコマンドやマシンが同時にリクエストしていないかを確認し、それらが終わってからコマンドを再実行してください。レジストリを自分で運用している場合は、そのレート制限を確認してください。5 分の上限は固定されており、延長する設定はありません。

Fetched or cached bytes do not match the digest committed for them(取得またはキャッシュされたバイトが、それに対してコミットされたダイジェストと一致しない)

すべてのアーティファクトは、その内容のダイジェストをコミットするマニフェストを持ち、lockfile はそのマニフェストのダイジェストを独立してピン留めします。どちらのコミットメントも、手元のバイトを再ハッシュして比較することで検査されます。この比較が失敗したときに報告されるのがこの状態であり、取得したばかりのバイトに対しても、キャッシュから読み戻したバイトに対しても同じように発生します。

状態は 2 つあり、どちらが発生したかでどの層が食い違ったかがわかります。 一方は、内容が自身のマニフェストのコミットするダイジェストと一致しないことを示します。もう一方は、キャッシュされたマニフェストが lockfile のピン留めしたダイジェストと一致しないことを示します。これは、改ざんされたマニフェストが後続の内容検査の信頼する根拠になるのを防ぐ検査です。この 2 つ目の検査を意味あるものにしているのはピンです。ピンはキャッシュされたバイトからマニフェストを再導出するのではなく lockfile から得られるため、2 つは真に独立しています。

その後、エンティティはバイトが持つ内容よりも、自身の行に照らして検査されます。 キャッシュされたエンティティのバイトがマニフェストと一致すると、次に lockfile がそのエンティティについて記録するダイジェストと比較されます。このダイジェストは圧縮されたバイトではなく、公開物が持つファイル(それぞれのパスとバイト)を対象とします。そのため、同じファイルを別の圧縮で公開しても一致しますが、同じバージョンで異なるファイルは一致せず、その不一致は内容の状態として報告されます。ピンに従う pull も、ピン留めされたバージョンでレジストリが提供するものに対して同じ比較を行います。

これらの検査はいずれもネットワークを必要としません。 それぞれが手元にあるバイトに対するハッシュ比較であり、これにより完全にオフラインのビルドでも、読み込んでいるものがピン留めされたものであることを確認できます。

出力されるメッセージ。 マニフェストに対する内容:

oci: content digest <computed> != manifest layer <committed>: oci: content digest mismatch(内容ダイジェストの不一致)

プラグインエンティティ。マニフェストは別の位置でこれをコミットします:

oci: config digest <computed> != manifest config <committed>: oci: content digest mismatch(内容ダイジェストの不一致)

ピン留めされたダイジェストに対するキャッシュされたマニフェスト:

oci: cached manifest digest <computed> != pinned <pinned>: oci: cached manifest digest mismatch(キャッシュされたマニフェストのダイジェストの不一致)

自身の行に対するキャッシュされたエンティティ、およびピン留めされたバージョンで別の内容を提供するレジストリ:

catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch(キャッシュされた内容ダイジェストが lockfile のピンと一致しない)

oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin(oci: コンテンツのダイジェストが一致しません: ピン留めされたエンティティについて、レジストリはピン留めされたバージョンに対し、ピン留めされたダイジェストではなく別のダイジェストを現在配信しています。ピンを更新するには上記の pull コマンドを実行してください)

どちらも、読み込まれていた対象によって囲まれて報告されます。ピンの位置でどのソースも保持していないピン留めされたエンティティは、キャッシュエントリのマニフェストが食い違った場合はマニフェストの状態として、それ以外の場合は内容の状態として報告されます:

pinned entity <uri>: no source holds the pinned bytes <pinned> (<what each source it read held>); with a registry reachable, aggrega pull --release <release> fetches the pinned version again: <the message above>(ピン留めされたエンティティ: ピン留めされたバイト列を保持するソースがありません。レジストリに到達できる状態であれば、上記の pull コマンドでピン留めされたバージョンを再取得できます)

アーカイブの外へ抜け出すパスを指すアーカイブエントリも内容の状態として報告されます。それを試みるバンドルは、コミットされたバンドルではないためです:

path traversal entry "<name>": oci: content digest mismatch(パストラバーサルのエントリ: 内容ダイジェストの不一致)

表面化させたステップが修正方法を提供する場合、どちらも同じ修正方法を伴います:

remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache(対処: aggrega pull —upgrade —release を実行して lockfile とキャッシュを更新してください)

修正方法: エンティティファイルの内容が原因ではなく、記述を変更しても解消しません。aggrega pull --upgrade --release <release> でキャッシュと lockfile を一緒に更新してください。これはソースから再取得し、両方を書き直します。それで解消した場合、キャッシュされたコピーが書き込まれた後に変更または切り詰められていました。更新後も不一致が残る場合、公開者が提供するバイトがピン留めされたものと実際に異なっています。これはバージョンの再公開であり、公開者に問い合わせるべき事項です。新しいダイジェストを採用した後ではなく、採用する前に問い合わせる価値があります。

A manifest carries no layer of the expected kind, or more than one(マニフェストに期待される種類のレイヤーがない、または複数ある)

アーティファクトのマニフェストはそのレイヤーを列挙し、内容を持つレイヤーは位置ではなくメディアタイプによって選択されます。これにより、アーティファクトは複数のレイヤーを束ねながら(たとえば、チャートとその横に分離された来歴レイヤー)、内容を確実に選び出すことができます。

選択の余地がなくなる形が 2 つあります。期待されるタイプのレイヤーがない場合、マニフェストは参照が想定したものとは別のものを記述しています。複数ある場合は選択に答えがなく、最初のものを選ぶと正しいこともあれば、気づかれないまま誤ることもあります。

出力されるメッセージ。それぞれ期待されたメディアタイプを示します。存在しない場合:

oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type(マニフェストに期待される内容メディアタイプのレイヤーがない)

複数ある場合。個数も示します:

oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type(マニフェストに期待される内容メディアタイプのレイヤーが複数ある)

修正方法: 修正するのは利用者ではなく公開者です。マニフェストはカタログの作成者が記述するものではありません。まず、参照が意図した場所を指しているか確認してください。別の種類のアーティファクトに解決される参照は 1 つ目の形を生じます。マニフェストは別のものに対する正規のマニフェストだからです。参照が正しい場合、そのアーティファクトは、主張されている種類として記述しないマニフェストで公開されています。メッセージのメディアタイプを引用して公開者に伝えてください。通常の公開経路で公開すると内容レイヤーがちょうど 1 つのマニフェストが生成されるため、いずれかの形のアーティファクトは別の方法で組み立てられたものです。

A published bundle holds no entity, or holds two(公開されたバンドルにエンティティが含まれていない、または 2 つ含まれている)

ドキュメントの横にファイルを宣言するエンティティ(Recipe のローカルチャートやそのロック、Component のインポートされたスキーマなど)は、エンティティとそれらのファイルをまとめた .tar.gz として公開されます。これを読み戻すには、それらのファイルの中からエンティティを再び見つける必要があります。エンティティが記述されたファイルの名前は任意であるため、エンティティを識別するのは名前ではなく、それが持つエンティティのプリアンブルです。バンドルの最上位にあり、kind: が公開可能なエンティティ種別であるドキュメントがエンティティです。その横にある compose フラグメント、チャートテンプレート、Kubernetes マニフェストはエンティティではありません。また、source/ ツリーの奥にあるエンティティドキュメントもエンティティではなく、エンティティ自体ではなくエンティティが同梱するコンテンツです。

選択対象が残らない形が 2 つあり、どちらもアーティファクトの公開方法に起因する性質です。

バンドルの最上位にエンティティドキュメントがない。 バンドルが最上位にエンティティを含まずにパックされています。ドキュメントが除外されたか、それが持つファイルの横ではなくサブディレクトリに置かれています。メッセージにはバンドルの最上位に実際に含まれるものが列挙され、通常はそれでどちらが起きたかを判断できます。

バンドルの最上位にエンティティドキュメントが 2 つある。 2 つのエンティティが記述されたディレクトリ全体からバンドルがパックされています。各エンティティは宣言したファイルのみを持つため aggrega push がこれを行うことはありませんが、他のクライアントでは起こりえます。そのようにパックされると、それぞれの公開座標が同じバイトを持つことになります。そのため、どちらかで応答すると、要求された名前のもとで別のエンティティを返してしまい、下流ではそれに気付く手段がありません。安全な選択肢がないため、選択は行われません。

出力されるメッセージ。見つかったものを列挙します。バンドルに他のファイルがある場合でエンティティがないとき:

bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document(バンドルのルートに含まれるファイルの中にエンティティドキュメントがありません: oci: 公開されたバンドルにエンティティドキュメントが含まれていません)

何も含まれていない場合でエンティティがないとき:

bundle root carries no files at all: oci: published bundle carries no entity document(バンドルルートにファイルが一つもありません: oci: 公開されたバンドルにエンティティドキュメントがありません)

そして複数ある場合で、件数と衝突しているドキュメントの両方を示すもの:

bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document(バンドルのルートに複数のエンティティドキュメントがあります: oci: 公開されたバンドルに 2 つ以上のエンティティドキュメントが含まれています)

修正方法: どちらも解消するのは利用者ではなく公開者であり、修正箇所はエンティティの公開元のバージョンディレクトリです。各エンティティに専用のバージョンディレクトリを用意し、そのディレクトリに 1 つのエンティティとそれに属するファイルだけが入るようにします。これは公開済みのすべてのエンティティがすでに従っているレイアウトで、ディレクトリはエンティティの metadata.version にちなんで命名され、エンティティ自身の名前の下に置かれます。そのうえで新しいバージョンで再度公開します。公開されたバイトは固定されるため、既存バージョンへの再公開は修正されるのではなく拒否されます。公開ではなく利用している場合は、アーティファクトの公開者にメッセージを伝えてください。メッセージ内のファイル名から、分割すべきディレクトリを特定できます。

A published artifact cannot be read as an entity(公開されたアーティファクトをエンティティとして読み取れない)

公開座標からエンティティを読み取る処理は、レジストリがそこで提供するバイトから始まります。aggrega inspect oci://… はそれを読み取って表示し、依存関係の pull も同じ方法でアーカイブのバイトを読み取り、ピン留めするバージョンを見つけます。そのバイトが読み取るべきエンティティを含まない形が 2 つあります。

展開できないアーカイブ。 宣言したファイルとともに公開されたエンティティは .tar.gz として公開され、バイトもその形式で始まっていますが、圧縮ストリームまたはその中のアーカイブが正しい形式ではありません。多くの場合、途中で切れていることが原因です。バイトはアーティファクト自身のマニフェストが記録するダイジェストと一致しているため、公開されたものそのものです。損傷は利用者に届く途中ではなく、公開前または公開中に起きています。

エンティティではないドキュメント。 座標が単一のドキュメントを持ち、それがパースできないか、kind: を宣言していないか、Release や Manifest のように公開されることのない種別を宣言しています。この場合、参照はエンティティではなく、カタログとは別に公開されたもの(たとえば aggrega push-artifact で公開されたデータアーティファクト)を指しています。

出力されるメッセージ。 圧縮ストリームが正しい形式でないアーカイブで、処理を止めたエラーを含むもの:

oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked(oci: gzip の展開に失敗しました: oci: 公開されたバンドルを展開できません)

ファイルの途中で止まるもの:

read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked(公開されたバンドルからファイルを読み取れません: oci: 公開されたバンドルを展開できません)

公開されることのない種別を宣言するドキュメント:

the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document(公開されたドキュメントが、レジストリでは公開されない kind を宣言しています: oci: 公開されたアーティファクトはエンティティドキュメントではありません)

そしてドキュメントですらないバイト:

the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document(公開されたバイト列をドキュメントとして解析できません: oci: 公開されたアーティファクトはエンティティドキュメントではありません)

修正方法: 展開できないアーカイブは公開者が差し替えるものです。公開されたバイトは固定されるため、対処法は新しいバージョンでエンティティを再度公開することです。利用している側であれば、公開者にメッセージを伝えてください。エンティティではないドキュメントは、ほとんどの場合、参照が意図したものではないことを意味します。参照がエンティティの公開座標を指していることを確認してください。これは aggrega push がエンティティを公開するときに出力する参照です。

The registry could not answer what is attached to an artifact(アーティファクトに何が添付されているかにレジストリが応答できなかった)

署名やその他の添付物はアーティファクトの内部ではなくアーティファクトに紐づいており、それらを見つけるにはレジストリに問い合わせます。この状態は、その問い合わせが応答されなかったことを示します。レジストリがその検索を提供していない、添付物が紐づくアーティファクトを特定できなかった、またはリクエスト自体が失敗した、のいずれかです。

これは「何も添付されていない」という応答と同じではなく、この 2 つの混同を防ぐことこそがこの状態の存在理由です。 実際に署名を持たないアーティファクトは正常に解決され、空のリストを返します。この状態はリストがまったく取得されなかったことを示すため、何が添付されているかについては何もわかっていません。

停止するかどうかは署名が必須かどうかによって決まり、どちらの挙動も意図的なものです:

  • 署名が必須の場合。 ビルドは停止します。実行できなかった必須チェックは合格しておらず、アーティファクトを受け入れれば、誰も問い合わせられなかった問いに依拠することになります。
  • 署名が必須でない場合。 ビルドは続行し、黙ってではなく明示的にその旨を伝えます。検索ではどちらにしても検証対象が得られなかったため、拒否すれば応答のない問いを根拠にアーティファクトを拒むことになります。一方で黙っていれば、問題のない未署名の pull のように見えてしまいますが、実際にはそうではありません。

出力されるメッセージ。 レジストリが検索を提供していない場合:

oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed(oci: ターゲットが referrer の検出をサポートしていません: oci: referrer の検出を完了できませんでした)

アーティファクト自体を特定できない場合:

oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed(oci: subject を解決できません: oci: referrer の検出を完了できませんでした)

そして検索が失敗した場合:

oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed(oci: referrer を一覧表示できません: oci: referrer の検出を完了できませんでした)

署名が必須でない場合は、同じテキストが代わりに通知として表示されます:

signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above>(署名検証を実行できませんでした。レジストリが署名の照会に応答できず、署名は必須ではないため、処理を続行します)

修正方法: 修正するのはオペレーターであり、原因はカタログではなくレジストリにあります。レジストリが添付物の検索をまったく提供していない場合、そのレジストリは署名を持てません。そのため、アーティファクトを対応しているレジストリにミラーするか、.aggrega-config.yaml でそのホストからの署名を必須としないようにします。どちらを選ぶのかは明記しておいてください。後者を選ぶと、そのホストからの署名はチェックされなくなるためです。検索を提供しているレジストリで検索が失敗した場合は、添付物のエンドポイントに固有の通信または権限の問題であり、レジストリに到達できるようになってから再実行すれば解決します。

An artifact that must be signed carries no signature(署名が必須のアーティファクトに署名がありません)

アーティファクトに署名が必須となるのは、ワークスペース自身の署名ポリシーがその種類を対象としている場合、または取得元のレジストリが署名を必須とするよう設定されている場合です。この状態は、レジストリが添付物の照会に応答し、何も添付されておらず、かつ署名が必須だったことを報告します。

2 つの要件は、1 つの姿勢を 2 つのスコープで読んだものです。 ワークスペース全体のポリシーは、ホスト自身のエントリが署名を必須としていない場合でも、対象となる種類に署名を強制します。そのため、何も要求しないホストであっても、ワークスペース全体のポリシーが対象とするアーティファクトは免除されません。

署名が必須でない場合、これは失敗ではまったくありません。 アーティファクトは署名があれば検証され、なければ黙って通過します。これにより、姿勢が設定されていないホストを手間なく利用できます。

ワークスペース全体のポリシーが有効な間に種類を判定できなかったアーティファクトは、免除ではなく署名が必須なものとして扱われます。そのため、分類できないアーティファクトが有効化されたポリシーをすり抜けることはありません。

出力されるメッセージ(検査していた参照で囲まれます):

verifying the signature of <uri>: signing: no signature found for an artifact that requires one

修正方法: 修正するのはオペレーターまたは公開者であり、エンティティの作成者ではありません。アーティファクトが署名されていると想定していた場合、それは署名なしで公開されています。署名を添付できるのは公開者だけなので、参照を公開者に伝えてください。アーティファクトが署名される想定でない場合は、要件のほうを変更します。要件は .aggrega-config.yaml 内のレジストリのエントリ、またはワークスペース全体の署名ポリシーのいずれかに由来し、メッセージの参照からどのホストを確認すべきかがわかります。要件を無効にすると、そのホストからのアーティファクトは検査されなくなります。そのため、完全に無効化するよりも、ポリシーのスコープを特定の種類に絞ることを優先してください。

A signature does not verify(署名が検証されません)

署名が見つかって検査され、その検査が失敗しました。これは検査の一般的な否定結果であり、トラストマテリアルをルートとしない証明書チェーン、透明性ログの記録が必須なのに記録がない署名、手元のものとは異なるアーティファクトに対する署名、改ざんされたバンドル、そして検証の通らない固定鍵に対して検査されたバンドルを含みます。

これは、署名者が信頼されていない署名とは意図的に区別されています。 そちらは構造的に正しく、誤った署名者によって作成されたものです。こちらはそもそも検査を通りませんでした。両者を区別することで、「アーティファクトが署名されたものではない」ことと「受け入れていない誰かによってアーティファクトが署名された」ことを見分けられます。

署名がどのアーティファクトに対して作成されたかは 2 回検査されます。 署名の暗号学的検査が成立すると、ツールチェーンは署名自体から、それがどのアーティファクトに対して作成されたかを読み取ります。これは以降のすべてのビルドが記録済みの署名を照合するのと同じ読み取りであり、これによりビルドは、何も検証せずに、あるアーティファクトから別のアーティファクトへコピーされた署名を拒否できます。その読み取りが手元のアーティファクトを示さない場合、または署名がその読み取りでアーティファクトを判別できない形式である場合、ツールチェーンは署名を拒否します。プルが受け入れる両方の形式が読み取られます。アーティファクト自体に対して作成された署名と、それを示す署名付きステートメントです。読み取りは暗号学的検査自身の規則に従うため、その検査が受け入れる署名については両者は一致します。この種の拒否は両者が一致しなかったことを意味し、設定で回避するのではなく、参照とメッセージを添えて報告する価値があります。

レジストリのエントリが検証を勧告扱いとしている場合、同じテキストが通知として報告され、実行は継続します。

出力されるメッセージ。 検査自体からのもので、検証器が報告した内容を引用します:

signing: signature bundle does not verify: <what the verifier reported>(signing:署名バンドルが検証に通りません。検証器が報告した内容が続きます)

また、暗号学的検査は成立するものの、署名がどのアーティファクトに対して作成されたかの読み取りが一致しない場合:

signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for(signing:署名バンドルが検証に通りません。暗号学的チェックは成立しますが、示されたマニフェストダイジェストを署名対象のアーティファクトとして示していません)

signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read(signing:署名バンドルが検証に通りません。暗号学的チェックは成立しますが、署名対象のアーティファクトを読み取れない形式です)

いずれも検証対象の参照で囲まれます:

verifying the signature of <uri>: <the message above>

また、レジストリのエントリが検証を勧告扱いとしている場合は、停止ではなく通知として:

signature verification failed for <uri> (advisory; continuing): <the message above>

修正方法: エンティティファイル内にこれを引き起こすものはなく、作成側の変更で解消することもできません。これは設定についてではなく、アーティファクトについての表明として扱ってください。手元のバイトが署名されたバイトではないか、署名が設定済みのトラストマテリアルで検査できるものではありません。まずアーティファクトを再取得してください。切り詰められたり改ざんされたりしたキャッシュのコピーはまさにこの形で失敗し、新たに取得すれば解消します。新たに取得しても解消しない場合は、参照と検証器自身の文言をアーティファクトの公開者に伝えてください。これを回避するために勧告設定に頼らないでください。その設定は検査を実行したまま停止しないようにするものであり、アーティファクトを修正する手段ではなく、そのホストからの未検証のアーティファクトを受け入れるという意図的な選択です。

A signature verifies but its signer is not one the registry trusts(署名は検証されますが、その署名者はレジストリが信頼するものではありません)

署名は検査を通りました。証明書チェーンはトラストマテリアルをルートとし、透明性記録も存在します。しかし、その証明書内のアイデンティティは、レジストリに対して受け入れ可能として設定されたどのアイデンティティとも一致しません。アーティファクトは、受け入れられていない実在の署名者によって署名されています。

アイデンティティの両方の要素が比較されます。 サブジェクトと、それを保証した発行者であり、どちらが一致しなかった可能性もあります。メッセージは、証明書から読み取れる場合は両方を示します。誰も受け入れていない発行者のもとで想定どおりのサブジェクトを提示する署名者は、両方を示さない限り、誤ったサブジェクトと見分けがつかないためです。

出力されるメッセージ。両方の要素が読み取れる場合:

signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer(signing:署名のアイデンティティはこのレジストリで信頼されていません。検証器が報告した内容が続きます。署名者は示された発行者とアイデンティティを提示しましたが、その発行者を許可する信頼済みアイデンティティはありません)

また、読み取れない場合は、検証器自身の報告にフォールバックします:

signing: signature identity is not trusted for this registry: <what the verifier reported>(signing:署名のアイデンティティはこのレジストリで信頼されていません。検証器が報告した内容が続きます)

修正方法: これはオペレーターが判断することであり、形式的なものではなく実質的な判断です。メッセージ内の発行者とアイデンティティを、.aggrega-config.yaml でそのレジストリに設定された信頼済みアイデンティティと比較してください。署名者が受け入れるつもりのものであれば追加します。エントリはアイデンティティ、またはそれに一致するパターンを発行者とともに指定し、両方が正しくなければなりません。そうでない場合、アーティファクトは受け入れていない誰かによって署名されており、ビルドを通すためにそのアイデンティティを追加することこそ避けるべき対応です。独自のトラストポリシーを公開しているレジストリでは、レジストリの追加時にそれを固定できます。これが、書き写すことなく意図したアイデンティティを取り込む方法です。

A keyless trust policy names no acceptable signer(キーレス信頼ポリシーが受け入れ可能な署名者を 1 つも指定していない)

キーレス検証では、署名証明書内のアイデンティティを、受け入れ可能として設定されたアイデンティティの集合と照合して、アーティファクトを受け入れるかどうかを決定します。空の集合はポリシーとして扱われず、拒否されます。何もない集合と照合すると、すべての署名者を受け入れるか、すべてを拒否するかのどちらかになり、検証を設定したオペレーターの意図はそのどちらでもないためです。

出力されるメッセージ(この状態そのものを表す文です):

signing: keyless verification requires at least one trusted identity(signing: キーレス検証には少なくとも 1 つの信頼済みアイデンティティが必要です)

修正方法: .aggrega-config.yaml で、そのレジストリに少なくとも 1 つの信頼済みアイデンティティを設定します。エントリは、アイデンティティ(完全一致のサブジェクト、またはそれに一致するパターン)と、それを保証する発行者を指定し、両方が必須です。レジストリが独自の信頼ポリシーを公開している場合は、レジストリの追加時にそのポリシーをピン留めすると、レジストリが公開する内容から集合が埋められます。このレジストリからの署名をまったく検証しないつもりであれば、それは空のアイデンティティ集合とは別の設定であり、その設定を明示的に行うことでその意図を示します。

The pinned trust root cannot be read(ピン留めされたトラストルートを読み込めない)

ワークスペースにピン留めされたトラストルートは、キーレス検証がどこで実行されてもネットワークアクセスなしで検証できるようにするものです。これは、すべての署名の照合対象となるマテリアルを内容とするファイルです。この状態は、設定されたパスのファイルを使用可能な信頼マテリアルに変換できなかったことを示します。ファイルが存在しない、読み取れない、または内容がトラストルートではない、のいずれかです。

フォールバックせずに停止します。 ピン留めされたルートは、自分が管理するマテリアルに対して署名を検証するという意図的な選択です。代わりに暗黙のうちにルートを取得すると、その選択が別の選択に置き換わり、誰も求めていない検証結果が生じることになります。

出力されるメッセージ(パスを示し、読み込みが報告した内容を引用します):

signing: cannot load pinned trust root: <path>: <what the read reported>(signing: ピン留めされたトラストルートを読み込めません: パスと読み込み時の報告内容)

修正方法: これはオペレーターの対応事項です。トラストルートに設定されたパスが存在し、コマンドを実行するユーザーが読み取れることを確認します。別の作業ディレクトリを基準とする相対パスや、存在するが読み取れないファイルは、どちらもここで報告されます。ファイルが存在し読み取れる場合は、その内容がトラストルートではないため、編集せずに、入手元から取得した最新のバンドルで置き換えます。ルートをピン留めするつもりがなかった場合は、設定を変更します。ピン留めを解除すると、検証は本来与えられるマテリアルを使用します。

A pinned verification key is not the key profile the verifier accepts(ピン留めされた検証キーが検証器の受け入れるキープロファイルではない)

保持しているキーによる署名と検証では 1 つのキープロファイルを使用し、それ以外の種類のキーは試行されずに拒否されます。これはキーの種類についての判定であり、そのキーで何かを検証できるかどうかについてではありません。

報告される 2 つのタイミングは別の処理です。 1 つは署名に使うキーの読み込みで、アーティファクトを公開する場所で行われます。もう 1 つはレジストリ用にピン留めされたキーに対する署名の検証で、アーティファクトを検証する場所で行われます。拒否の内容はどちらも同じです。

出力されるメッセージ(それぞれ、実際に指定されたキーのアルゴリズム、つまり an RSA key または an Ed25519 key を示します)。ピン留めされた検証キーの場合:

signing: unsupported held-key type: pinned key is <the key's algorithm>, want ECDSA P-256(signing:サポートされていない保持鍵の種類です。ピン留めされた鍵は示されたアルゴリズムですが、ECDSA P-256 が必要です)

署名用に読み込まれたキーの場合:

signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256(signing:サポートされていない保持鍵の種類です。保持鍵は示されたアルゴリズムですが、ECDSA P-256 が必要です)

修正方法: メッセージが示すプロファイルのキーを指定します。検証する場合、キーは .aggrega-config.yaml でレジストリ用にピン留めされたもので、公開者が署名に使うキーの公開鍵側である必要があります。ここでの不一致は通常、誤ったファイルがピン留めされたことを意味します。種類は正しいがキーが違う場合は、代わりに署名が検証されないとして報告されるためです。署名する場合は、指定されたプロファイルのキーを生成するか、保持キーをまったく必要としないキーレスの方法を使用します。

The workspace is offline and the step needs the network(ワークスペースがオフラインで、ステップにネットワークが必要)

ワークスペースはオフラインに設定でき、その設定は希望ではなく拒否です。ネットワークにアクセスするステップはすべて、構築された時点で、接続が行われる前に拒否されます。早期に拒否することで、失敗が後から説明のないタイムアウトとして現れるのではなく、「このワークスペースはオフラインです」と示されるようになります。

1 つの判断を 1 か所で読み取ります。 ネットワークに到達できるかを事前に知る必要があるステップは、取得処理自体と同じ問いを発するため、チェックとそれが保護する操作が異なる結論に至ることはありません。

この拒否はいくつかの種類の処理に及び、いずれも同じ拒否です。レジストリからのアーティファクトの取得、ネットワーク経由での Recipe のソースの取得、外部入力の取得、署名に使うアイデンティティの取得、信頼マテリアルの取得です。キャッシュが用意された状態でそれを読むビルドはこのいずれにも該当せず、それがこの設定の目的です。

コマンド全体がネットワークの往復である場合、拒否は最後ではなく最初に行われます。 push、push-artifact、registry update はレジストリにアクセスするためのコマンドなので、エンティティを読んだりリポジトリを走査したりする前にその旨を示し、3 つのうちどこでその状態が設定されたか(入力したフラグ、環境変数、またはファイルとその中のキー)を示します。--dry-run は例外で、その名前ではなく動作によって例外となります。公開する内容を報告するだけで何も呼び出さないため、オフラインでも安全な公開の形であり、引き続き動作します。

出力されるメッセージ(独自の対処法を含み、この状態そのものを表す文です):

egress: network access refused because the workspace is offline; remediation: pass --offline=false to allow the network for this one run, or clear the top-level offline key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run aggrega pull --release <release> from a connected environment first to populate the cache(egress: ワークスペースがオフラインのため、ネットワークアクセスが拒否されました。対処: この 1 回の実行でネットワークを許可するにはオフライン無効化フラグを渡し、以降も許可するには設定ファイルのトップレベルのオフラインキー(または AGGREGA_OFFLINE)をクリアしてください。マシンにないコンテンツを必要とするビルドの場合は、先にネットワークに接続された環境で pull コマンドを実行してキャッシュを用意してください)

ネットワークを必要とした処理によって前置きされます。たとえば Recipe のソースを取得する場合:

sourceresolver: kind=<kind> url=<url> version=<version>: <the message above>

オフラインのワークスペースで公式ハブを追加することは拒否されません。ハブは組み込みのベースラインで追加され、ワークスペースがオフラインのためハブに信頼ポリシーを問い合わせなかったことが通知されます。

修正方法: メッセージは 3 つの方法を示しており、どれを適用するかは利用者が判断します。状態が設定されていて、この 1 回のコマンドだけ回避したい場合は、--offline=false を渡します。それがこのフラグの目的であり、設定ファイルを自分で書いていない人が使える唯一の方法です。ワークスペースがオフラインであるべき場合は、不足している内容を解決します。ネットワークにアクセスできる場所で pull を実行し、release が到達するすべてをキャッシュに保持させれば、オフラインのビルドはそれ以上何も必要としません。そもそもオフラインであるべきでない場合は、設定をその発生源でクリアします。.aggrega-config.yaml の最上位の offline キー、またはメッセージが示す環境変数です。環境変数はどのファイルにもないため、つまずきやすい点です。なお、オフラインのワークスペースではキーレスの方法で署名することはまったくできません。証明書の発行とその記録は、オフラインの形を持たないネットワーク操作であるためです。

トポロジーの構築時

すべての Component の Recipe が解決されると、コンパイラは各 Component の uses: ブロックを読み取り、ターゲットと Feature のアタッチメントを相互参照して、Components を IR グラフへとつなぎ合わせます。

Dangling uses target(存在しない uses ターゲット)

uses: エッジが、解決済みのトポロジーに存在しないターゲットコンポーネントを指定しています。この停止は由来に依存しません。開発者が記述した Aggregate のエッジも、Release が配線したエッジも同様に検出されます。宙に浮いたターゲットは、黙って破棄されるのではなく致命的な停止になります。そうしなければ、存在しないターゲットへのエッジは消えてしまい、デプロイ時に利用側へ注入される値が黙って空のままになるためです。これは後述の未宣言ソケットによる停止と構造上の兄弟関係にあります。接続がどのソケットに配線されていても、エッジの型チェックの前に、そのターゲットが既存のコンポーネントに解決されることが必要です。

出力されるメッセージ。まず拒否が示され、次に何にも対応しないターゲットと接続が配線されたソケット、最後に対処方法が示されます:

uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name.(uses エッジのターゲットが存在しません(ターゲットと、接続先のソケット)。ターゲットを Aggregate が宣言するコンポーネントに向けるか、その名前でコンポーネントを宣言してください。)

検出結果は、対象となる記述済みエントリの位置に、そのエントリが書かれたドキュメント内で示されます。そのため、コンポーネント自身の uses: ブロックが引いた接続、アタッチメントが投影した接続、Release が配線した接続は、それぞれ自身のブロックで報告されます。問題のある接続はそれぞれ個別の検出結果として報告されるため、1 回のビルドで最初の 1 件で止まらずすべてが示されます。

修正方法: 不足しているターゲットコンポーネントを宣言するか、uses: エントリのターゲット名を既存のコンポーネントに一致するよう修正します。

1 つのコンポーネントの 2 つの接続が 1 つのエイリアスを使用している

コンポーネントは各接続をそのエイリアスで読み取ります。エイリアスとは接続が書かれたキー、またはリストのエントリとして書かれた接続の場合はそのターゲット自身の名前です。Recipe のテンプレートはコンポーネントの接続をエイリアスのみをキーとして読み取り、アサーションはソケット、次にエイリアスをキーとして読み取ります。そのため、1 つのコンポーネントの 2 つの接続が 1 つのエイリアスを使うと、少なくとも一方のビューで 1 つのスロットを共有することになります。後の接続がそのスロットを占め、もう一方はテンプレートやアサーションから見えなくなります。したがって、1 つのエイリアスはコンポーネントの 1 つの接続を指します。各接続がどのソケットに配線されていても、何がそれを引いたか(コンポーネント自身の uses: ブロック、任意のスコープのアタッチメントの uses: ブロック、または Release のエッジごとのエントリ)にかかわらず、またターゲットが何であっても同様です。このような組は、グラフが確定した時点で、アサーションの実行前かつレンダリングの前にビルドを停止させます。

この組は、各面で単独では正当な記述から生じます。1 つのソケットとエイリアス上のコンポーネント自身のエントリとアタッチメントのエントリ、1 つのターゲットを 2 回指定するリスト(models: [llama, llama])、2 つのソケットに書かれた 1 つのエイリアス(databases: { local: … } と並ぶ models: { local: … })、1 つのエイリアスを配線する 2 つのアタッチメント、あるいは Aggregate が未結合のままにしたソケット上で、Aggregate が別のソケットですでに使ったエイリアスにより接続を引く Release エントリです。隣接する 2 つの形はこの停止に至りません。キー付きエントリの 1 つのブロック内で 1 つのキーを 2 回書くとドキュメントの読み込みに失敗し、別のブロックがすでに引いたソケットとエイリアスにある Release エントリは、2 つ目の接続を引くのではなくその接続を設定します(異なるターゲットを指定する場合はリターゲットとして停止します)。

出力されるメッセージ。まず拒否が示され、次にエイリアスとコンポーネント、この接続のソケット、ターゲット、エントリが書かれた場所、続いてすでにそのエイリアスを持つ接続について同じ情報、最後に対処方法が示されます:

connection alias is already used by another connection of the same component ("<alias>", on component "<component>", this connection wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>", the connection already holding the alias wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>"). Give one of the two connections an alias of its own: a component reads each connection by its alias, whatever socket it is wired into. A list entry takes its target’s name as its alias, so a target listed twice is listed once, or written as two keyed entries under two aliases.(接続のエイリアスは、同じコンポーネントの別の接続ですでに使われています(エイリアス、コンポーネント、この接続のソケット・ターゲット・記述されたファイルとキーパス、およびエイリアスをすでに持つ接続のソケット・ターゲット・記述されたファイルとキーパス)。2 つの接続のいずれかに固有のエイリアスを付けてください。コンポーネントは、どのソケットに接続されているかにかかわらず、各接続をそのエイリアスで読み取ります。リストのエントリはターゲットの名前をエイリアスとするため、2 回記載されたターゲットは 1 回だけ記載するか、2 つのエイリアスによる 2 つのキー付きエントリとして記述してください。)

両方の接続が 1 つのキーパスで書かれている場合(1 つのターゲットを 2 回指定するリスト)、それぞれはリスト内の位置でも示されます(list entry "1" と並ぶ list entry "2")。これが 2 つのエントリを区別する唯一の手がかりです。

検出結果は、後の接続自身のエントリ、つまり 2 番目に引かれ、本来であればエイリアスのスロットを占めていたはずのエントリの位置に、そのエントリが書かれたドキュメント内で示されます。そのため、Release のエントリや Release が書くアタッチメントは運用側の不備として、Aggregate 内のエントリは開発者側の不備として扱われます。問題のある接続はそれぞれ個別の検出結果として報告されるため、1 回のビルドですべてが示されます。

一部の形は、より不正確に示されます。複数のスコープで宣言されたアタッチメント名(たとえばコンポーネントと、それを保持するサブシステムの両方)は、宣言している各ブロックから接続を引き、ビルドは両方をアタッチメント名のみで記録します。その場合、両方の接続は宣言しているブロックの 1 つ(その名前がコンポーネント自身のアタッチメントブロックで宣言されていれば、そのブロック)で示され、どちらにもリスト位置は付きません。インポートされた Aggregate の内部でも同様で、宣言しているブロック(コンポーネントのブロックと、モジュール自身のサブシステムの 1 つのブロック)はモジュール自身のドキュメント内で示されます。これらいずれの形でも、組は拒否されます。

修正方法: 2 つの接続の一方に独自のエイリアスを付けます。1 つのターゲットを 2 回指定するリストの場合は、ターゲットを 1 回だけ列挙するか、2 つの接続を 2 つのエイリアスによるキー付きエントリとして記述します。2 つのソケットにある 1 つのエイリアスの場合は、2 つのキーの一方の名前を変更します。コンポーネントがすでに使用しているエイリアスでソケットを配線するアタッチメントは、自身の uses: ブロックで別のキーを使います。

uses: socket not declared in the owning entity’s usesSchema(ソケットが所有エンティティの usesSchema で宣言されていない)

uses: ブロックが、そのサーフェスを所有するエンティティが usesSchema で宣言していないソケットを指定しています。これは、宣言済みのソケットしか指定できない 2 つのサーフェスのいずれかで起こります。Feature アタッチメントの uses: ではソケットがアタッチされた Feature で宣言されている必要があり、Release のエッジ単位の uses: では消費側の Component で宣言されている必要があります。Release がエッジを配線または設定できるのは、Component の usesSchema がすでに宣言しているソケットの範囲内に限られます。

アタッチメントのサーフェスは、アタッチメントが記述されるすべてのスコープでチェックされます。コンポーネント、サブシステム(Aggregate のもの、またはそれがインポートするモジュールのもの)、Release のバウンダリ、そして Release のコンポーネントエントリ(モジュールが提供するコンポーネントのエントリを含む)です。モジュール自身の宣言は、それをインポートするコンポジションがビルドされた時点でチェックされ、検出結果はモジュールの Aggregate とそのドキュメント内のキーを示します。

コンポーネント自身の uses: ブロックは意図的にこれらのサーフェスに含まれていないため、この停止はそこでは発生しません。Aggregate が宣言するトポロジーは開発者が所有しており、カタログが宣言していないソケットを指定できます。カタログがあるソケットについて何も述べていないことは、その接続が想定されていなかったことを意味するのであって、禁止されていることを意味するのではありません。そのようなソケットは正当であり、そのエッジは構築されます。失われるのは、宣言済みのソケットが持つセレクタとエッジ単位の契約です。したがって、そこでのソケット名のスペルミスは停止ではなく、それ自体がアドホックな接続となり、両方の綴りを示す警告として報告されます。warnings.md の「Uses-socket near-miss lint」を参照してください。

出力されるメッセージ:

unknown uses socket: name a socket the entity declares in its usesSchema — only a component’s own uses block may name one the catalog did not declare (Release <release-name>, at .spec.components.<component>, "<component-type>", "<socket-name>", "<declared-sockets>")(不明な uses ソケット:エンティティが usesSchema で宣言しているソケットを指定してください。カタログが宣言していないソケットを指定できるのは、コンポーネント自身の uses ブロックだけです。括弧内には Release、位置、コンポーネント型、ソケット名、宣言済みのソケットが示されます)

アタッチメント側では、コンポーネントタイプの代わりにフィーチャータイプが示されます。usesSchema をまったく宣言していないアタッチされた Feature の場合は、代わりにその Feature では uses: の宣言が許可されていないことが報告されます。

修正方法: アタッチメントでは、ソケット名をアタッチされた Feature が宣言しているものに修正するか、そのソケットを Feature の usesSchema で宣言します。Release のエッジ単位のエントリでは、ソケット名を消費側の Component が宣言しているものに修正します。Release は Component が宣言していないソケットを導入できず、宣言をカタログエンティティに移すことがサポートされている方法です。カタログエンティティが usesSchema をまったく宣言していない場合、そのサーフェスでは uses: の宣言を一切受け付けないため、ブロックを削除してください。

接続が、そのソケットがスロットを宣言していない名前でアタッチメントを持っている

接続エントリの features: ブロックが、その接続のソケットのどのスロットも宣言していないアタッチメントを指定しています。接続が持つアタッチメントは閉じた集合です。接続が経由するソケットは、消費側の Component の usesSchema エントリにある featuresSchema で、そのソケット上の接続が埋めてよいすべてのスロットを宣言しており、それ以外の名前のアタッチメントはビルドの読み込み時に拒否されます。featuresSchema を宣言していないソケットは、その接続にアタッチメントを一切認めません。Component が宣言していないのに Aggregate が指定したソケットも同様で、そのようなソケットはスロットを宣言していません。

この規則は、接続のアタッチメントを記述する両方のドキュメントに適用されます。すなわち、コンポーネントの uses: の下にある Aggregate の接続エントリと、Release のエッジ単位の uses: エントリです。サブアグリゲートが提供するコンポーネントについては、開発者の名前はそのサブアグリゲート自身のドキュメントが読み込まれた時点でチェックされ、検出結果はそのドキュメントのファイルとその中のコンポーネントのエントリを示します。Release の名前は、コンポジションがフラット化された時点で、Release が記述対象とするすべてのコンポーネントについてチェックされ、検出結果は Release 自身のエントリを示します。これは、そのエントリが置かれた境界の中、またはサブアグリゲートのコンポーネントに到達するルーティングエントリの下にあります。Component が宣言していないソケット上の Release エントリは、これではなく、実在するソケットを列挙する前述の未宣言ソケットの停止によって報告されます。

出力されるメッセージ。最初に拒否が示され、続いてドキュメントとエントリ、アタッチメントの名前、接続、ソケット、コンポーネント、ソケットが宣言しているスロットが示され、最後に対処方法が示されます:

a connection carries an attachment under a name its socket declares no slot for (Aggregate <aggregate-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<attachment>", on the connection "<alias>", through socket "<socket>", of component "<component>", the socket declaring the slots "<slots>"). Write the attachment under one of the slots the socket declares, or declare this slot in the socket’s featuresSchema on the Component.(接続が、そのソケットがスロットを宣言していない名前でアタッチメントを持っています。括弧内には、Aggregate、エントリのパス、アタッチメント名、接続、ソケット、コンポーネント、およびソケットが宣言しているスロットが示されます。ソケットが宣言しているスロットのいずれかの下にアタッチメントを記述するか、Component 上のソケットの featuresSchema でこのスロットを宣言してください。)

名前がソケットの宣言しているスロットから 1 編集以内である場合(文字の入れ替え、脱落、重複、誤りといった、タイプミスの形)、そのスロットが直後に示されるため、意図されたと思われる綴りが同じ文の中にあります:

a connection carries an attachment under a name its socket declares no slot for (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, "credentail", near the declared slot "credential", on the connection "<alias>", …)(接続が、そのソケットがスロットを宣言していない名前でアタッチメントを持っています。括弧内には、Release、エントリのパス、アタッチメント名、それに近い宣言済みスロット、接続などが示されます)

このような名前について別の勧告は出されません。コンポーネント自身の features: ブロックでは、宣言済みスロットから 1 編集の名前は正当であり、後述の「An attachment name is one edit from a declared slot」の勧告が出るだけです。接続上ではその名前は拒否され、拒否メッセージ自体が対応関係を示します。

ソケットがスロットを宣言していない場合、一覧は省略され、助言は「The socket declares no slots, so no connection wired through it carries an attachment: remove the attachment, or declare the slot in the socket’s featuresSchema on the Component.(ソケットはスロットを宣言していないため、そのソケットを経由する接続はアタッチメントを持てません。アタッチメントを削除するか、Component 上のソケットの featuresSchema でスロットを宣言してください。)」となります。Component がそのソケットをまったく宣言していない場合は、「The component’s type does not declare this socket, so the socket declares no slots and no connection wired through it carries an attachment: remove the attachment, or declare the socket and its slot in the Component’s usesSchema.(コンポーネントのタイプはこのソケットを宣言していないため、ソケットはスロットを宣言しておらず、そのソケットを経由する接続はアタッチメントを持てません。アタッチメントを削除するか、Component の usesSchema でソケットとそのスロットを宣言してください。)」となります。

問題のあるアタッチメントはそれぞれ個別の検出結果として報告されるため、1 回のビルドですべてが示されます。

修正方法: ソケットが宣言しているスロットでアタッチメントを記述します。接続にソケットが持たないスロットが必要な場合は、Component 上のソケットの featuresSchema でそれを宣言します。Component が宣言していないソケットの場合は、Component の usesSchema でソケットとそのスロットを宣言するか、アタッチメントを削除します。

Release retargets a developer-declared edge(Release が開発者の宣言したエッジの接続先を変更している)

Release のエッジ単位の uses: エントリが、同じソケットとエイリアスに対して開発者がすでに接続した接続先とは異なる接続先を指定しています。Release は開発者が宣言したエッジを設定すること(エッジ単位の infra を設定し、同じ接続先を指定するか省略する)と、宣言済みだが未接続のソケットにエッジを接続することはできますが、開発者が宣言したエッジの接続先を変更することはできません。開発者は自身が記述したアーキテクチャを所有しています。

両方の接続先は、解決後ではなく記述されたとおりに比較されます。target: はコンポーネント ID ではなくサブアグリゲートの公開エイリアスを指定できます。そのエイリアスは、モジュールがそれを公開している対象のコンポーネントに解決されます。そのため、開発者が記述したのとまったく同じエイリアスを繰り返す Release エントリは設定であり、通常のコンポーネント ID を繰り返す場合とまったく同様に受け入れられます。

このハルトが発生するかどうかにかかわらず、エッジは開発者が与えた接続先を保持し、Release エントリの infra: はそのエッジに適用されません。拒否された接続先変更が中途半端に適用されることはありません。

出力されるメッセージ。最初に拒否が示され、次に開発者が宣言した接続先、Release が指定した接続先、ソケット、そして対処方法が続きます:

release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (Release のエッジが、開発者の宣言したエッジのターゲットを付け替えています。宣言されたとおりに接続を設定するには Release エントリからターゲットを削除するか、接続が宣言されている場所でターゲットを変更してください。)

この検出結果は、接続を宣言したドキュメント内の、接続が宣言された記述エントリの位置に示されます。違反しているエントリはそれぞれ個別の検出結果として報告されるため、1 回の実行で 1 件ずつではなく、1 回のビルドですべてが示されます。

**修正方法:**既存のエッジを設定する(エッジ単位の infra のみ)には、Release の uses: エントリから異なる target を削除します。あるいは、その接続が本当に別のソケットに属する場合は、開発者が未接続のまま残したソケットを通して接続します。接続先そのものを変更するには、トポロジーが記述されている Aggregate で変更してください。

Release per-edge configuration has no edge to apply to(Release のエッジ単位の設定に適用先のエッジがない)

Release のエッジ単位の uses: エントリが infra:、features: 配下のアタッチメント、またはその両方を設定していますが、ビルド内のすべてのエッジが描かれた後、そのエントリが指定するコンシューマー、ソケット、エイリアスにエッジが存在しません。

Release エントリができることは、エッジを接続することと設定することの 2 つであり、どちらを行うかは target: を指定しているかどうかで決まります。接続先を持つエントリは、自身が設定するエッジを作成します。接続先を持たないエントリは、すでに存在している必要があるエッジを設定します。そのエッジは Aggregate で開発者が宣言したものか、アタッチされた Feature が提供したものです。そのため、接続先を指定せず既存のエッジにも一致しないエントリは何にも適用されず、infra: ブロックとその下のアタッチメントはどの出力にも届きません。何もしない記述を受け入れるのではなくビルドを停止するのは、そうしなければビルドの成功が、インフラが適用され接続がエントリの設定内容を持っていることの確認と読まれてしまうためです。

エイリアスはエントリが指定するものの一部であるため、開発者が宣言していないエイリアスを設定するエントリは、ソケットが別のエイリアスで接続されていてもエッジに届きません。Aggregate が宣言していないコンポーネントを指定するエントリも同様です。

隣接する 2 つの条件は、それぞれより多くの情報を伝えられるため、このハルトではなく専用のハルトで報告されます。コンシューマー側の Component の usesSchema が宣言していないソケットは未宣言ソケットとして報告され、実際に存在するソケットを一覧表示できます。どのコンポーネントも指定しない target: は宙に浮いた接続先として報告されます。active: トグルで無効化されたコンポーネントは設計上そのエッジも一緒に取り除くため、そのコンポーネントに残されたエントリはハルトせずに受け入れられます。

**違反しているエントリはすべて報告されます。**エッジに届かないエントリを複数持つ Release は、最初の 1 件を報告して残りを次のビルドに回すのではなく、1 回のビルドでエントリごとにこのハルトを 1 件ずつ、ドキュメントが宣言した順に報告します。

エントリが存在するコンポーネントを指定している場合に出力されるメッセージ。エントリ自体へのパスを含むため、そのエントリを持つコンポーネントではなく、編集すべき行が示されます:

release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (Release のエッジ単位の設定に、適用先のエッジがありません。エッジを接続するにはエントリにターゲットを指定するか、エントリを削除してください。ターゲットのないエントリは、すでに存在しているはずのエッジを設定します。)

境界の下ではなく最上位でコンポーネントを指定する Release では、作成者が記述した形 .spec.components.<consumer>.uses.<socket>.<alias> が示されます。また、aggregates: ルーティングエントリ内で指定されたコンポーネントは、そのエントリを通じて、そこで持つローカル名で示されます。

エントリが Aggregate の宣言していないコンポーネントを指定している場合、ハルトはビルドのより早い段階で発生し、エントリが設定する内容(infra、features、または infra and features)を示して次のように表示されます:

release per-edge configuration has no edge to apply to: release edge <consumer>/<socket>/<alias> sets <infra|features|infra and features> on <consumer>, which is not a component in the topology (Release のエッジ単位の設定に、適用先のエッジがありません。Release のエッジが設定を行う対象は、トポロジ内のコンポーネントではありません。)

**修正方法:**エントリに target: を追加してエッジを接続し、設定をそのエッジに適用します。エイリアスを Aggregate がその接続に宣言したものに修正して、エントリが既存のエッジを設定するようにします。コンポーネント名を Aggregate が宣言しているものに修正します。あるいは、その設定が不要になった場合はエントリを削除します。

A Release attachment takes the name of a connection’s attachment(Release のアタッチメントが接続のアタッチメントの名前を取っています)

Release が、コンポーネントのいずれかの接続上のアタッチメントが取る名前でアタッチメントを記述しています。その名前とは、接続のエイリアス、ドット、アタッチメントが埋めるスロットを連ねたものです。接続 gpt の credential スロットを埋めるアタッチメントであれば gpt.credential です。接続のアタッチメントはその接続エントリ上に記述されます。つまり、コンポーネントの uses: の下にある Aggregate の接続、または同じ接続に対する Release のエッジ単位の uses: エントリです。そして、この合成された名前で、消費側コンポーネントのアタッチメントになります。Release は、キーにドットを含められる別の 2 つのスコープでもアタッチメントを記述するため、そこにも合成された名前を書けてしまいます。

  • コンポーネントエントリ自身の features: ブロック。そのコンポーネントにアタッチします。
  • バウンダリ自身の features: ブロック。そのバウンダリ、またはその内部にネストされたバウンダリに配置されたすべてのコンポーネントにアタッチします。バウンダリが名前を挙げずに取り込むサブアグリゲートのコンポーネントも含まれます。そこにあるキーが、到達するいずれかのコンポーネント上の合成された名前と等しい場合、type: を指定しているかどうかにかかわらず停止します。

どちらかを接続のアタッチメントに統合するとビルドがそれに対して行うことの全体をどちらのドキュメントも示さなくなるため、ビルドは統合せずに停止します。ソケットのスロットは接続ごとに、その接続自身のエントリによって埋められ、より広いスコープからカスケードしてくるアタッチメントによって埋められることはありません。到達するコンポーネントのどの接続アタッチメントも取らないドット付きキーは通常のアタッチメント名であり、拒否されません。

このチェックは、どちらのドキュメントが接続に付けたアタッチメントも対象とし、Aggregate が宣言するコンポーネントだけでなく、サブアグリゲートが提供するコンポーネントも対象とします。

コンポーネントエントリ上のキーに対して出力されるメッセージです。まず拒否が示され、次に Release とコンポーネントエントリ、Release が記述したキー、コンポーネント、接続、ソケット、スロットが続き、最後に記述先となる接続エントリが示されます。

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.components.<component>, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on the connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this entry’s features: an attachment a connection carries is written on that connection and nowhere else.(Release のアタッチメントが、コンポーネントの接続のいずれかが持つアタッチメントの名前を取っています(上記の Release、コンポーネントエントリ、キー、コンポーネント、接続、ソケット、スロット)。接続エントリの該当する features の下に記述し、このエントリの features からそのキーを削除してください。接続が持つアタッチメントはその接続にのみ記述します。)

バウンダリ上のキーに対して出力されるメッセージです。バウンダリのアタッチメントブロックと、接続がそのアタッチメントを持つコンポーネントを示します。

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.boundaries.<boundary>.features, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on component "<component>"’s connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this boundary’s features: an attachment a connection carries is written on that connection and nowhere else.(Release のアタッチメントが、コンポーネントの接続のいずれかが持つアタッチメントの名前を取っています(上記の Release、境界のアタッチメントブロック、キー、コンポーネント、接続、ソケット、スロット)。そのコンポーネントの接続エントリの該当する features の下に記述し、この境界の features からそのキーを削除してください。接続が持つアタッチメントはその接続にのみ記述します。)

バウンダリ上のキーが、接続に合成された名前を持つ複数のコンポーネントに到達する場合、それぞれの接続が別々の編集となるため、コンポーネントごとに 1 回ずつ報告されます。

検出結果の位置は、キーが記述されたブロック、つまりコンポーネントエントリまたはバウンダリの features: に置かれます。キー自体がドットを含み、位置ではそのようなキーを指し示せないためです。代わりにキーはメッセージ内で示されます。バウンダリを指定する Release では、コンポーネントエントリは .spec.boundaries.<boundary>.components.<component> となり、aggregates: ルーティングエントリ内で指定されたコンポーネントはそのエントリを経由し、そこで持つローカル名で示されます。また、ネストされたバウンダリのブロックは .spec.boundaries.<outer>.boundaries.<inner>.features となります。

修正方法: アタッチメントを、その接続に対する Release のエントリ、つまりコンポーネントの下の uses.<socket>.<alias>.features.<slot> に移動します。Aggregate が宣言するアタッチメントのサイズを指定する場合はそこに infra: のみを記述し、Release だけが作成するアタッチメントの場合は type: と infra: を記述します。その後、コンポーネントまたはバウンダリの features: からドット付きキーを削除します。複数のコンポーネントの接続を対象とするバウンダリ全体のキーは、それぞれの接続上に 1 回ずつ記述します。

A Release connection attachment names no Feature type(Release の接続アタッチメントが Feature タイプを指定していません)

Release のエッジ単位の uses: エントリが、Aggregate がその接続上でアタッチメントを宣言していないスロットの下で接続にアタッチメントを付け、type: を指定していません。Release が接続上に記述するアタッチメントは、次の 2 つのいずれかです。Aggregate が同じ接続上ですでに宣言しているアタッチメントのサイズを指定するもので、Aggregate の宣言がタイプを指定しているためタイプを指定しないもの。あるいは、Release だけが作成するアタッチメントで、その場合は Release エントリが Feature タイプの唯一の出どころとなります。タイプがなければ、そのアタッチメントの FeatureRecipe を選択できません。

このチェックは、Aggregate が宣言するコンポーネントだけでなく、サブアグリゲートが提供するコンポーネントも対象とします。active: トグルで無効化されたコンポーネントは接続も一緒に取り除かれるため、そこに残されたエントリはチェックされません。

出力されるメッセージです。まず拒否が示され、次に Release と接続エントリ、スロット、接続、ソケット、コンポーネントが続き、最後に対処方法が示されます。

a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Name the Feature this attachment attaches under its type, or declare the attachment on the Aggregate’s connection entry and size it here.(Release の接続アタッチメントが Feature の型を指定しておらず、Release のみが作るアタッチメントにはその型が必要です(上記の Release、接続エントリ、スロット、接続、ソケット、コンポーネント)。このアタッチメントが付与する Feature を型で指定するか、Aggregate の接続エントリでアタッチメントを宣言し、ここでサイズを指定してください。)

問題のあるアタッチメントはそれぞれ個別の検出結果として報告されるため、1 回のビルドですべてが示されます。

修正方法: アタッチメントがアタッチする Feature を指定する type: を追加します。あるいは、アタッチメントを開発者が宣言すべき場合は、Aggregate の接続エントリで values: とともに宣言し、Release エントリには infra: のみを残します。

Component identity cannot be stamped on what it emits(コンポーネントの識別子を、それが出力するものに刻印できません)

コンポーネントの識別子は Aggregate 内のキーであるだけではなく、クラスタ内の名前でもあります。コンポーネントが出力するすべてのリソースには、aggrega.ai/component-id と app.kubernetes.io/name の下にこの識別子が刻印され、ワークロードシンセサイザーは出力するものにこの識別子にちなんだ名前を付けます。そのため、識別子はターゲットが受け入れる名前である必要があり、かつ書かれたとおりの意味を持つ名前である必要があります。

記述した名前は、記述したとおりに出力へ届きます。これにより、Aggregate 内の名前をそのままクラスタ内で探せる名前にできます。これは価値のある性質であり、ターゲットが拒否するような識別子を、記述していない何かへ黙って修正するのではなく、ここで報告する理由でもあります。

例外は 1 文字だけで、それは記述できない文字です。モジュールの名前とその中のコンポーネントの名前をつなぐドットです。この結合を曖昧にしないために、ドットは記述するすべての名前から予約されており、刻印の前に識別子から書き換えられます。data-layer.main-db は data-layer-zdmain-db として刻印されます。これによって誰かが入力した名前が失われることはなく、インポートされた Aggregate が提供するコンポーネントを刻印できるのもこのためです。ドットは Service 名が受け入れる文字ではなく、クラスタのアドレス内ではサービスとその名前空間を区切るため、ドットを含む名前をホストとして利用側に渡すと、失敗するのではなく別のサービスに解決されてしまいます。

拒否される形は 2 つあります。

刻印のアルファベットで表現できない識別子。 識別子は出力されるすべてのリソースが持つラベル値に書き込まれます。このアルファベットが認めるのは英字、数字、-、_、. であり、値が英字または数字で始まり、英字または数字で終わることを要求します。記述する名前の規則はこれに近いものの同じではなく、名前が - や _ で始まったり終わったりすることを許します。そのため _api と api- はどちらも記述できる名前ですが、どちらも刻印できません。

名前の長さの上限はここでは問いません。 それはコンポーネントのデプロイ先ターゲットが決めることであり、ターゲットによって答えが異なります。この条件が扱うのは、どのターゲットでも表現できない形です。長さを理由に拒否される名前は、代わりにターゲット自身による拒否として報告され、そこにはそのターゲットの理由と受け入れ可能な長さが示されます。

合成された識別子と同じ始まり方をする識別子。 Feature が出力するリソースには、記述したコンポーネント名を刻印できません。そのため Aggrega は、記述された部分からそれらの識別子を合成し、Feature がどこにアタッチされたかを示す固定の先頭部分を付けます。Feature が単一のコンポーネントにアタッチされている場合、識別子はそのコンポーネントと Feature がアタッチされたキーから合成され、cfr-- で始まります。バウンダリ全体にアタッチされている場合、どのコンポーネントの名前も当てはまらないため、識別子はバウンダリのパスと Feature がアタッチされた名前から合成され、bfr-- で始まります。この先頭部分によって、リソースがコンポーネントからではなく、この 2 つのどちらから来たのかを読み手が判断できます。そのため bfr-- と cfr-- はどちらもコンポーネント識別子の先頭で予約されています。 bfr--api や cfr--api という名前のコンポーネントは合成された識別子と同じように刻印され、出力からは両者を区別できません。予約されているのは先頭部分全体だけです。bfr、cfr、bfr-api、bfrontend という名前のコンポーネントは通常の名前であり、ビルドされます。

このチェックはコンポーネントが実際に持つ識別子を読みます。インポートされた Aggregate が提供するコンポーネントの場合、それは修飾された識別子、つまりモジュール名、ドット、コンポーネント自身の名前です。そのため、それぞれ単独では問題のない 2 つの名前が、結合すると問題のある識別子になることがあります。bfr--x という名前のモジュールとその中の y という名前のコンポーネントは bfr--x.y に結合され、これは合成された識別子と同じ始まり方をします。この停止は、記述したキーを指しながら、結合後の識別子を示します。

ターゲットが拒否する識別子に対して出力されるメッセージ:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>") (コンポーネント ID は、出力されるリソースに付与される名前にできません。コンポーネントの名前を変更してください。Aggregate 内の該当パスにある ID が、満たす必要のある規則に従っていません)

また、合成された識別子と同じ始まり方をする識別子に対しては次のとおりです。<opening> は、名前が一致した予約済みの先頭部分です:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must not open with the reserved "<opening>") (コンポーネント ID は、出力されるリソースに付与される名前にできません。コンポーネントの名前を変更してください。Aggregate 内の該当パスにある ID が、予約された先頭部分で始まっています)

修正方法: コンポーネントを指名しているすべての箇所、つまりそれを宣言する Aggregate と、それを配置・設定する Release で、コンポーネントの名前を変更します。英字または数字で始まり英字または数字で終わり、bfr-- でも cfr-- でも始まらない名前を付けます。コンポーネントの名前を変更するとクラスタ内でそのリソースが持つ名前も変わるため、デプロイ済みのアプリケーションでは、他のリソース名の変更と同様に扱ってください。

The target will not accept a name derived from an authored identity(ターゲットが、作成された識別子から派生した名前を受け付けない)

どのターゲットも、component の識別子から独自の名前を派生させます。チャートインストーラーは release 名を、コンテナオーケストレーターはサービス名を派生させます。このハルトは、ターゲットがそのうちの 1 つを使用できないと伝えているものです。

Aggrega はどのターゲットの命名規則も保持しません。 名前の長さの上限、ターゲットが許容する文字、名前の先頭でターゲットの文法が要求するものを Aggrega は知りません。そしてこれは意図的なものです。これらはターゲットごと、名前が付けられるリソースの種類ごと、さらには 1 つの provider 内の 1 つのサービスごとに異なることがあるためです。そのため、名前が確定する前に、コンパイラはその component をレンダリングする provider に問い合わせ、このハルトは provider の回答を報告します。メッセージに、コンパイラに書き込まれた規則ではなく、拒否したものを表すターゲット自身の用語(release name、Service name)とターゲット自身の理由が含まれるのはこのためです。

名前が短縮されずに拒否される理由。 作成した名前はワークロードのデプロイ時の名前です。短縮すると、既存のすべての出力のすべてのリソースの名前が変わり、しかも依頼していないのに代わりに行われることになります。別の名前を選べるのはこの名前を書いた人なので、ハルトは作成された spec.components のキーを指し示し、名前自体には手を加えません。一方、Aggrega 自身が合成する名前(たとえば boundary 全体にアタッチされた Feature の識別子)は短縮されます。これらは複数のドキュメントにまたがって書かれた部分から組み立てられ、どの作成者も単独ではその長さを把握できないためです。

ターゲットが返しうる回答は 2 種類あり、それぞれ対処が異なります。 より短い名前なら受け付けられる場合、ハルトは有効な長さを示すため、新しい名前を一度で選べます。どの長さでも解決しない場合(ターゲットの文法が、その位置では拒否する文字である場合)は、短縮では解決できないため長さは示されません。後者で最も多いケースは次のとおりです。名前が小文字のみのターゲットは、許容しない各文字をエスケープし、各エスケープはハイフンで始まるため、先頭の文字がエスケープされた名前はハイフンで始まる名前になります。そこに小文字または数字を要求するターゲットは、残りがどれほど短くてもそれを拒否します。また、ターゲットは名前の先頭に、その名前に基づいて命名されるリソースのより厳しい規則を適用することがあります。helm ターゲットは数字で始まる名前を拒否し、Service name として報告します。Helm はそのような release 名を受け付けますが、クラスタはそれに基づいて命名された Kubernetes Service を拒否するためです。

3 つ目の形式は合成された名前の場合にのみ現れます。合成された識別子は識別子のための領域を確保するため、ターゲットが、与えられた部分からコンパイラが合成できる最短の識別子よりも短い長さを示すことがあります。その場合、ハルトは provider を不具合として報告するのではなく、その旨を述べて対処法(作成された部分を短くすること)を示します。

一部の名前は、コンポーネントがレンダリングするワークロードのためだけに存在します。 プロバイダーへの問い合わせはそのコンポーネントの Workload が解決された時点で行われ、問い合わせには Workload の form とその Service キーが含まれるため、ターゲットはそれらから組み立てる名前も判断できます。helm ターゲットでは、これにより 2 つが加わります。1 つは CronJob name で、最大 52 文字、scheduled の Workload に対してのみ判断されます。クラスターが各実行の Job に、CronJob の名前にサフィックスを付けた名前を付けるためです。もう 1 つは各 Service name(<release name>-<service key>)で、最大 63 文字です。Service の名前は 2 人の作成者の部分、つまりコンポーネント名と、Recipe または FeatureRecipe の中でワークロードが宣言するキーから組み立てられます。そのため理由には、記述したフィールドと並んで、そのキーと、ワークロードがそれを宣言している場所 spec.workload.services.<key> が示されます。どのコンポーネント名の入る余地も残さないほど長いキーの場合、選べる長さは示されず、理由には短くする必要があるのはキーであると示されます。境界全体にアタッチされた Feature については、これらの名前は判断されません。その ID は Workload が解決される前に確定されます。出力がどこで組み立てられるかがその ID に依存する場合があるためです。

作成された識別子の場合に出力されるメッセージ:

the target will not accept a name derived from this component’s authored identity: rename the component (component "<identity>", written at <field-path>, which the target cannot use as a <name-kind>, <the target's reason>). choose a name of at most <n> characters that the target accepts(ターゲットは、この Component の記述された識別子から導出された名前を受け入れません。コンポーネントの名前を変更してください。ターゲットが受け入れる、上記の文字数以内の名前を選んでください)

対処法: component を、それを名指しするすべての箇所(それを宣言する Aggregate と、それを配置・設定する Release)で、ターゲットが受け付ける名前に変更します。メッセージに長さが示されている場合は、その範囲内に収めます。示されていない場合は、ターゲットの理由を読みます。通常はターゲットが許容しない文字であり、最も多いのは名前の先頭の大文字です(helm ターゲットでは先頭の数字)。単語間をハイフンでつないだ小文字と数字を推奨します。命名の章では、各種類のターゲットで名前が何をもたらすかを説明しています。理由に Service キーが示されている場合は、ワークロードがそれを宣言している場所でそのキーを短くすることでも長さを取り戻せます。理由にそのキーが余地を残していないと示されている場合は、それが唯一の方法です。component の名前を変更すると、そのリソースが持つ名前が変わるため、デプロイ済みのアプリケーションでは他のリソース名の変更と同様に扱ってください。

識別子が作成されたものではなくコンパイラが合成したものである場合、同じハルトが合成された値を報告し、その元になった部分(Feature をアタッチした名前と、アタッチ先の boundary のパス)を短くするよう求めます。

A provider never accepted a name the compiler composed(provider が、コンパイラの合成した名前を一度も受け付けなかった)

これは、作成した内容ではなく、プラグインの不具合を報告するものです。

合成された名前の確定はやり取りによって行われます。コンパイラが識別子を提案し、provider はそれを受け付けるか、どこまで短くする必要があるかを伝え、コンパイラがより短いものを合成し、再び provider に問い合わせます。2 回目の拒否は正常かつ想定内です。ある長さに短縮すると、そのターゲットの文法が許さない位置に文字が来ることがあり、provider がそれを伝えることで、どのターゲットの文法も知らないコンパイラと、文法を知る provider が合意に達します。

正常でないのは、何も受け付けない provider です。つまり、長さを示し、その長さの名前を渡されても再び拒否するものです。このやり取りには上限があり、上限に達するとビルドは停止し、provider が一度も同意しなかった名前を使うのではなく、その provider を名指しします。諦めて確定した名前は、合意に至らなかったことを出力に何も記録しないまま実際のリソースに付与され、その影響は、それを生成したビルドではなく適用時に表面化することになります。

出力されるメッセージ:

provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin(プロバイダーゲストが、コンパイラが合成したコンポーネント識別子を一度も受け入れませんでした。その欠陥を、そのプロバイダープラグインの保守者に報告してください)

対処法: メッセージにある最後の提案を引用して、名指しされた provider プラグインの保守担当者に報告します。これを回避できる記述上の変更はありません。コンパイラは provider が求めたすべての長さをすでに提示しています。自分が保守する provider である場合は、自らが示した上限に切り詰めた名前を、その後実際に受け付けるかどうかを確認してください。

Required uses: socket not populated(必須の uses ソケットが設定されていません)

Component がその usesSchema で required: true と指定されたソケットを宣言しているにもかかわらず、その Component のいずれかのインスタンスについて、ビルド内のどこにもそのソケットへの接続が配線されていません。

配線できる面は 3 つあり、この停止は 3 つすべてが空の場合にのみ発生します。 Aggregate 内のインスタンス自身の uses: ブロック、target: を指定する Release のエッジ単位の uses: エントリ(宣言済みで未バインドのソケットへの接続を作成します)、そしてコンポジションが生成した接続の集合です。3 つ目は、インポートされた Aggregate が提供するコンポーネントに対応するものです。そのようなコンポーネントの uses: ブロックはその Aggregate 自身のドキュメントにあり、コンポジションが組み立てられた後でのみ読み込まれます。3 つ目の面が最後に完成するため、このチェックは 2 つの記述ドキュメントを読み込んでいる間ではなく、コンポジション全体が存在した時点で実行され、どのドキュメントが宣言したかにかかわらず、すべてのコンポーネントに同じ問いを投げかけます。

ソケットを設定するように見えても、設定しない形が 2 つあります。target: を指定しない Release エントリは、接続を作成するのではなく既存の接続を設定するものなので、何も配線しません(また、infra: を持つ場合は、上記の専用の停止で報告されます)。そして、Feature アタッチメントの uses: は、アタッチされた Feature 上で宣言されたソケット、つまり別のエンティティ上の別のソケット集合を指定するため、アタッチメントが Component 自身のソケットを設定することはありません。

出力されるメッセージ:

required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>")(必須の uses ソケットが設定されていません。示された位置のソケットは、示されたコンポーネント型によって必須と宣言されています)

この検出結果は、作成者が記述すべきソケットエントリ .spec.components.<instance>.uses.<socket> の位置に示されます。その中のインスタンス名は、そのコンポーネントを宣言するドキュメント内でコンポーネントが持つ名前です。したがって、インポートされた Aggregate が提供したコンポーネントの場合、ロケータは、コンポジションが付けたプレフィックス付きの名前ではなく、その Aggregate 自身のファイルに含まれるキーを示します。

設定されていない必須ソケットは、すべてのコンポーネントについてそれぞれ報告されます。1 回のビルドで、最初の 1 つだけでなくそのすべてがわかります。

修正方法: 必須ソケットに対する uses: エントリを追加し、ソケットの selector: が受け入れるターゲットに配線します。または、target: を指定するエントリで Release から配線します。ソケットをもう必須にすべきでない場合は、Component の usesSchema を更新して required: false を設定するか、required の宣言を削除します。

Sub-aggregate nesting depth exceeded(サブアグリゲートのネストの深さの上限を超過)

サブアグリゲートのインポートの連鎖が、コンパイラのネストの深さの上限を超えています。この制限は、深くネストされたトポロジーの際限のないフラット化を防ぎ、一定のしきい値を超えるとアーキテクチャの分割を促します。

出力されるメッセージ:

max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>.(サブアグリゲートのネストの最大深度を超えました。深度と、平坦化されたプレフィックスが示されます。)

修正方法: ネストを減らすように aggregate のトポロジーを再構成します。これほど深いネストは、通常、Aggregate の形がデプロイのトポロジーではなく組織の階層を反映していることを示しています。サブアグリゲートのグループを、1 つの親 Aggregate 内の対等なサブシステムにフラット化することを検討してください。

Feature type mismatch between Aggregate and Release(Aggregate と Release の間での Feature 型の不一致)

Aggregate と Release の両方が同じインスタンス名で feature をアタッチしていますが、それぞれ異なる type: を宣言しており、Release のアタッチメントはバウンダリの features: からコンポーネントに届いています。Release が代わりにそのコンポーネント用の自身のエントリに記述している場合は、同じ競合がより早い段階で拒否され、上記の「A feature attached by both the Aggregate and the Release cannot be merged(Aggregate と Release の両方がアタッチした feature をマージできない)」の下で E0153 として報告されます。

出力されるメッセージ:

feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>)(Aggregate と Release の間でフィーチャーの型が一致しません。ノード、アタッチメント、Aggregate 側の既存の型と、それと競合する Release 側の型が示されます)

修正方法: Release から type: を削除する(Aggregate から継承されます)か、両方が同じ型を宣言するようにどちらか一方を変更します。Release は type: を省略するか Aggregate の型を繰り返すことはできますが、別の型で置き換えることはできません。

Cyclic extends on Components or Features(Components または Features での extends の循環)

Component の extends: の連鎖、または Feature の extends: の連鎖が自身に戻ってループしています。

出力されるメッセージ(ループしているのが Feature の連鎖である場合は、Component の代わりに Feature になります):

cyclic extends chain (Component <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain(extends のチェーンが循環しています。エンティティが、すでにチェーン内にある参照先を拡張しています。そのエンティティの extends を削除するか、チェーン外のエンティティを指すようにしてください)

修正方法: エッジが示すエンティティ(3 つ以上の連鎖では、メッセージの先頭で示されるエンティティとは異なります)を開き、その extends: を削除するか、別の参照先に変更します。

A component the composition holds is placed in no boundary(コンポジションに含まれるコンポーネントがどのバウンダリにも配置されていない)

Release がコンポーネントをバウンダリに配置する方法は 2 つあり、どちらでも有効です。1 つは、コンポジション全体がフラット化された後にコンポーネントが持つ id で指定して、バウンダリの components の下にコンポーネントを記述する方法です。もう 1 つは、そのコンポーネントを提供するモジュールを aggregates の下でバウンダリに振り分ける方法で、これによりそのモジュールに含まれるすべてのコンポーネントが一度に配置されます。

どちらにも該当しないコンポーネントは、Release が宣言したすべてのバウンダリの外でレンダリングされます。その場合、出力ディレクトリ、sync wave、アノテーション、コンポーネント単位の infra はどこからも与えられません。そして、この停止がなければビルドは成功し、成果物を出力し、オペレーターの設定がそのコンポーネントに一度も適用されなかったことについて何も示しません。また、この境界線で隔てられた 2 つのコンポーネントは異なる出力にレンダリングされ、一緒に配置された場合に持つ順序付けを失います。

意図的にこれに該当しない形が 2 つあります。名前付きのバウンダリではなくトップレベルの components を宣言する Release は、記述したものすべてを配置します。そのような Release を正規化すると、まさにそれらのコンポーネントを保持する専用のバウンダリが与えられます。また、Release がモジュール全体をどこにも配置していないコンポーネントは、自身の宣言が正しいコンポーネントごとに報告されるのではなく、下記のエントリでモジュールに対して 1 回だけ報告されます。1 つの誤り、1 つの対処、編集すべき 1 つのキーです。

出力されるメッセージ。末尾の値は、コンポジションがフラット化された後にコンポーネントが持つ id です。モジュールが提供したコンポーネントの場合は、そのモジュールの名前、ドット、コンポーネント自身の名前になります:

component placed in no boundary: name it under a boundary’s components, or place the sub-module that contributes it under aggregates (Release <name>, at <authored key>, "<component-id>")(コンポーネントがどのバウンダリにも配置されていません。バウンダリの components の下にそのコンポーネントを指定するか、それを提供するサブモジュールを aggregates の下に配置してください。Release 名、記述されたキー、コンポーネント ID が示されます)

修正方法: メッセージが示す id をそのまま使って、バウンダリの components の下にコンポーネントを記述します。モジュールが提供したコンポーネントの場合、それはプレフィックス付きの id であり、モジュール自身のファイル内に書かれた名前ではありません。または、モジュール全体が 1 つのバウンダリに属する場合は、aggregates の下でそこに振り分け、そのモジュールが持つすべてのコンポーネントを一度に配置します。

A sub-module’s components are placed in no boundary(サブモジュールのコンポーネントがどの境界にも配置されていない)

上記のルールのモジュール単位の形です。コンポジションが取り込んだモジュールがコンポーネントを提供しているのに、そのいずれもどの境界にも保持されていません。これはコンポーネントごとではなくモジュールにつき 1 回報告されます。どこにも配置されていない 1 つのモジュールは、1 つのキーに 1 つの対処がある 1 つの記述上の誤りであり、コンポーネントごとに報告すると、それ自体の宣言はまったく正しいコンポーネントを名指しすることになるためです。

このルールは記述の仕方ではなく配置を読むため、各コンポーネントが境界の components の下で個別に指定されているモジュールは配置済みとみなされ、通過します。ルーティングエントリがないことを理由にそれを拒否すると、言語が認める記述形式を退けることになります。一部だけが配置されたモジュールも通過します。どのコンポーネントが独自のエントリを持つかはコンポーネント側のルールが扱う問題であり、漏れたものはそちらで、それぞれのキーにおいて報告されます。

コンポーネントを提供していないモジュールはこれに該当しません。配置するものがないためです。false の active: トグルで除去されたモジュールも該当しません。それはそもそも合成されていないためです。

出力されるメッセージ。モジュールを宣言した aggregates エントリの位置に、インポート元のドキュメントが記述したローカル名で示されます:

sub-module placed in no boundary: route it into a boundary under aggregates, or name its components there under components (Release <name>, at <authored key>, "<module-path>")(サブモジュールがどの境界にも配置されていません: 境界へルーティングするか、そのコンポーネントを境界で名指ししてください)

対処方法: モジュールが属する境界の下に、そのモジュールの aggregates エントリを追加します。これにより、モジュールが提供するすべてのコンポーネントが配置されます。あるいは、コンポーネントがそれぞれ異なる境界に属する場合は、平坦化後に持つプレフィックス付きの id を使って、各コンポーネントを属する境界の下で指定します。

A boundary names a component the composition does not hold(境界がコンポジションに存在しないコンポーネントを指定している)

上記 2 つのルールに対応する過剰指定側のルールであり、どちらかの分岐ではなく別の問いです。上記のルールはコンポーネントについて何かがそれを配置したかを問い、このルールは Release が記述したエントリについて何かがそれに対応するかを問います。一方が他方を含意することはありません。Release は、存在するすべてのコンポーネントが適切に配置されている状態で存在しないコンポーネントを指定することもあり、記述したすべてのエントリが解決される状態で実在するコンポーネントを未配置のまま残すこともあります。

何も指さないエントリは何も設定しません。その directory、subDirectory、syncWave、アノテーション、コンポーネント単位の infra は存在しないコンポーネントに向けて書かれているため、その下では何もレンダリングされず、このチェックがなければビルドはオペレーターの設定が黙って無効なまま成功してしまいます。

境界がコンポーネントを指定する方法は 2 つあり、どちらもチェックされます。components の下では、エントリはコンポジションが平坦化された後にコンポーネントが持つ id で指定します。そのため、モジュールが提供するコンポーネントは、それ自身の名前の前にそのモジュールのプレフィックスを付けて記述します。aggregates のルーティングエントリの内側では、エントリはそのモジュール内でコンポーネントが持つローカル名で指定し、これは同じ id に解決されます。メッセージはエントリが指定した id を引用します。ルーティング側では、これはファイルに書かれた名前ではありません。ファイルはローカル部分を持ち、残りはモジュールが補います。

サブシステムはコンポーネントの id に何も加えないため、サブシステム内で宣言されたコンポーネントは素の名前で指定します。サブシステムが id の一部であるかのように書かれたエントリは何も指さず、これに該当します。

false の active: トグルで無効化されたコンポーネントはこれに該当しません。コンポーネントの無効化は記述上の操作であり、それを設定する Release を同じ編集で書き換えることは想定されていません。エントリを拒否すると、いずれかの Release がそのコンポーネントを指定している限り、トグルが使えなくなってしまいます。

出力されるメッセージ:

boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>")(境界がコンポジションに存在しないコンポーネントを指定しています:名前を修正するか、エントリを削除してください)

対処方法: メッセージが引用する id を、コンポジションが実際に保持するコンポーネントと比較します。モジュールプレフィックスの欠落と、id へのサブシステム名の記述が 2 つの一般的な原因です。サブシステムを外す、モジュールプレフィックスを追加する、または綴りを修正してください。その後削除または名前変更されたコンポーネントのエントリが残っている場合は、それを削除します。

A uses edge targets a component an active: toggle removed(トグルによって除去されたコンポーネントをエッジが指している)

上記の存在しないターゲットによる停止と対になるもので、ターゲットがなぜ存在しないかを作成者に伝えるために別に報告されます。ターゲットは宣言されなかったから存在しないのではありません。宣言されており、その active: トグルが false に解決されたためにこのビルドから意図的に除去され、そのエッジも一緒に取り除かれました。残ったコンポーネントが依然としてそれに依存しており、エッジを消えるままにすると、その利用側に注入される値がデプロイ時に黙って空になってしまいます。

出力されるメッセージ。最初に拒否の内容、次にトグルが除去したターゲットと接続が結線されたソケット、その後に対処方法が続きます:

uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it.(トグルが false に解決されたため uses エッジのターゲットが除去されました。ターゲットのトグルを true のままにするか、そのターゲットへの依存を削除してください。)

この検出結果は、対象となる記述済みエントリの位置に、上記の存在しないターゲットによる停止が示すのと同じパスで示され、最初のものだけでなく問題のあるすべての接続が報告されます。

対処方法: この環境にどちらが属するかを決めます。ターゲットを再び有効にします。トグルがパラメーターを読む場合は、この Release でそのパラメーターを指定することを意味します。あるいは、利用側を同じトグルの背後に置き、両者が一緒に外れて何も指さないエッジが残らないようにします。または、利用側が本当にもう必要としない場合は、利用側の uses: ブロックからエッジを削除します。

A uses target names a module’s component the module does not export(uses のターゲットが、モジュールがエクスポートしていないそのモジュールのコンポーネントを指定している)

モジュールは自身のインターフェイスを exportedComponents: の下で公開し、モジュールをインポートするドキュメントは、それらの名前、つまりモジュール名、ドット、エイリアスのいずれかを通してのみモジュールのコンポーネントに到達します。それ以外の方法、つまりモジュール内でのコンポーネント名や、モジュールを通ってその中にネストされたモジュールへ入るパスによってモジュール内のコンポーネントに到達する uses: のターゲットは、ビルドを停止させます。その接続は、モジュールの作成者が公開しておらず、自由に名前を変えたり削除したりできるものにバインドされてしまうためです。コンポーネント自身の uses: ブロック、アタッチメントのブロック、Release が配線した接続のいずれも同様に扱われます。接続がどのモジュールに入るかは、その利用側の位置から読み取られます。そのため、1 つのモジュール内の 2 つのコンポーネント間の接続は、Release がそれらを互いに配線する場合も含め、どのインターフェイスもまたがず、拒否されません。どのコンポーネントにも対応しないターゲットは、代わりに宙に浮いたターゲットの停止で報告されるため、1 つの入力ミスは 1 回だけ報告されます。

出力されるメッセージです。最初に拒否、次に記述されたとおりのターゲット、それが入るモジュールとそのモジュールがエクスポートするエイリアス、ソケット、そして対処法が示されます。

uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents.(uses エッジのターゲットが、モジュールがエクスポートしていないコンポーネントを指定しています(ターゲット、モジュールとそのエクスポートするエイリアス、配線先のソケットが示されます)。モジュールがエクスポートするエイリアスのいずれかを通してコンポーネントを指定するか、モジュールの exportedComponents の下に列挙してください。)

何もエクスポートしないモジュールは、"nothing" をエクスポートしていると示されます。検出結果は、接続を描いたドキュメント内の記述されたエントリに配置されます。

修正方法: モジュールがエクスポートするエイリアスを通してコンポーネントを指定します(finance-db-subsystem.internal-pg-primary ではなく finance-db-subsystem.primary_db)。あるいは、自分がそのモジュールを作成していてコンポーネントを公開するつもりであれば、モジュールの exportedComponents の下に列挙します。インポート側が使うべき名前がそのコンポーネント自身の名前であれば、その名前で列挙します。

An active: toggle does not resolve to true or false(トグルが true または false に解決されない)

active: トグルは、グラフビルダーに届く時点ですでにリテラルに解決されています。直接書かれたブール値か、ドキュメントが読まれる前に Release の値が代入されたパラメーター参照です。その後は厳密に読まれます。ブール値でないリテラルは、何かにデフォルトされるのではなくビルドを停止させます。このルールはコンポーネントのトグルでもモジュールのトグルでも同じです。

特に挙げるべきは空のリテラルです。未充足のパラメーターが生むのがこれだからです。{{ .parameters.<key> }} を読むトグルは、そのパラメーターに値がない間は何にも解決されず、何もないことを「存在する」と読めば、作成者がまさにそのパラメーターの背後に置いたエンティティをデプロイしてしまいます。存在するとデフォルトされるのは誰も書かなかったトグルだけであり、それはトグルの値ではなくトグルの不在から読み取られます。そのため、active: の後に何も書かないことは、キーを省略することと同じではありません。

出力されるメッセージ:

active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>")(active トグルがブール値に解決されませんでした)

また、何にも解決されなかった場合は、一般的な原因を示す助言が付きます:

active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled(active トグルがブール値に解決されませんでした。パラメーターを読むトグルは、そのパラメーターが充足されるまで何にも解決されません)

対処方法: true または false を書きます。トグルがパラメーターを読む場合は、Release でそのパラメーターを指定するか、すべての環境に値があるよう Aggregate での宣言箇所で default: を与えます。エンティティを無条件に存在させるには、空のままにせず active: キーを削除します。

A module a composition imports cannot be loaded, or imports itself(コンポジションがインポートするモジュールを読み込めない、またはモジュールが自身をインポートしている)

Aggregate は aggregates: の下に他の Aggregates を指定することでそれらを合成し、各 Aggregate は順に読み込まれて走査され、そのコンポーネントがグラフに加わります。ここでは 2 つの状況がこの走査を停止させます。

1 つは、モジュールをまったく読み込めない場合です。参照がカタログから返せるものに解決されないか、その背後のドキュメントを読み取れません。ローダーが示した理由は停止に組み込まれずその下に保持されるため、何が失敗したかはローダー自身の言葉で報告されます。

もう 1 つは、モジュールが、走査中のチェーン上にすでにある型を指定している場合です。これを展開すると、それを含むチェーンが際限なく再生成されます。これは参照がループを閉じる箇所で報告され、型とそれがコンポジション内のどこにあるかの両方が示されます。

循環参照の場合に出力されるメッセージ:

sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>")(サブアグリゲートの読み込みに失敗しました。サブアグリゲートの循環参照です)

読み込み失敗の場合は、停止は次の文のみとなり、モジュールのパスに位置付けられ、その下にローダー自身の理由が示されます:

sub-aggregate load failed(サブ Aggregate の読み込みに失敗しました)

修正方法: 読み込み失敗の場合は、停止の下にある理由を読んでください。カタログが応答できない名前やバージョンがよくある原因で、修正はそれを指定している aggregates: エントリで行います。循環参照の場合は、ループを断ち切ってください。メッセージ中のパスはチェーンが閉じる箇所であり、その途中のモジュールのいずれかが、自身をインポートするモジュールのインポートをやめる必要があります。2 つのモジュールが本当に互いのコンポーネントを必要とする場合、共有部分は両方がインポートする 3 つ目のモジュールに置きます。

Two instances flatten to one identifier(2 つのインスタンスが平坦化されて 1 つの識別子になる)

Aggregate を合成すると、すべてのコンポーネントが単一の集合に平坦化され、モジュールが提供したコンポーネントは、そのモジュールの名前、ドット、自身の名前を持ちます。この集合は 1 つの識別子の下に 2 つのエントリを保持することを拒否します。2 つ目が 1 つ目を置き換えてしまい、2 つのコンポーネントの一方が何の通知もなく出力から消えるためです。

この停止はモジュールのコンポーネントがマージされる際に発生するもので、オーサリングの表面はこれを引き起こす名前を提供しません。モジュールが提供するすべてのコンポーネントは、自身の名前の前にそのモジュールの名前を持ちます。インスタンス名は英字、数字、- および _ で記述されるため、両者を結合するドットを含むことができず、異なるモジュール名から構築された 2 つの識別子が一致することはありません。1 つの名前で 2 つのモジュールをインポートすると重複キーとなり、ドキュメントは読み込み時に拒否されます。したがってこれは、通常のオーサリング経路以外の何かによって組み立てられたコンポジションに対する安全策であり、遭遇した場合は回避するのではなく報告する価値があります。

1 つの Aggregate の 2 つのコンポーネントが 1 つの識別子に到達するのは別の停止であり、通常のオーサリングで発生します。下記の Two subsystems declare a component under one name(2 つのサブシステムが 1 つの名前でコンポーネントを宣言している) を参照してください。

出力されるメッセージ:

flattened node ID collision: rename one of the colliding instances so their flattened IDs differ (id "<identifier>", path "<path in the composition>", collides with existing entry from "<the other contributor>")(フラット化されたノード ID が衝突しています。フラット化後の ID が異なるよう、衝突しているインスタンスのいずれかの名前を変更してください。既存のエントリと衝突しています)

修正方法: メッセージが示す 2 つのインスタンスの一方の名前を、それを宣言しているドキュメントと、それを指定しているすべての Release エントリで変更してください。

Two subsystems declare a component under one name(2 つのサブシステムが 1 つの名前でコンポーネントを宣言している)

サブシステムは、読み手のため、またカスケードされる設定のために Aggregate のコンポーネントをグループ化するものであり、コンポーネントが応答する名前を修飾するものではありません。subsystems.frontend の下で宣言されたコンポーネントは frontend.api ではなく api として指定され、モジュールが提供したコンポーネントはサブシステムの名前ではなくそのモジュールの名前を持ちます。そのため、1 つの Aggregate の 2 つのサブシステムがそれぞれ api というコンポーネントを宣言でき、その場合 2 つは同じ識別子に応答することになります。

ドキュメントは整形式です。2 つは別々のブロック内の別々のキーであり、だからこそそれより前の段階では何も拒否しません。しかし、1 つの識別子を持てるコンポーネントは 1 つだけです。ビルドは、最後に読み込まれた方を保持して単一のコンポーネントが宣言されたかのようにレンダリングするのではなく、停止します。

1 つのサブシステム内で同じ名前が 2 回現れるのは別の不備です。それらは 1 つのキーの下の 2 つのエントリであり、ドキュメントは読み込み時に拒否されます。

出力されるメッセージ:

components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component’s identity (Aggregate, at .spec.subsystems.<second>.components.<identifier>, "<identifier>", declared under subsystems "<first>, <second>")(異なるサブシステムのコンポーネントが同じ識別子を持っています。サブシステムはコンポーネントの識別子に何も加えないため、いずれかの名前を変更してください)

修正方法: 2 つのコンポーネントの一方の名前を、それを宣言しているドキュメントと、それを指定しているすべての Release エントリで変更してください。2 つが本当に 2 か所で必要とされる同一のコンポーネントである場合は、1 回だけ宣言し、もう一方のサブシステムからそれに依存させてください。サブシステムの名前を変更しても解決しません。サブシステムは名前の一部ではないためです。

A re-published component alias points back at itself(再公開されたコンポーネントのエイリアスが自身を指している)

モジュールはエイリアスの下でコンポーネントをエクスポートすることで自身の一部を公開し、それをインポートする Aggregate は、それらのエイリアスの 1 つを独自の名前で再公開できます。このようなエイリアスの解決では、再公開のチェーンをたどって最終的に指すコンポーネントに到達するため、公開名を指すエッジは実在するコンポーネントに届きます。

コンポーネントに到達する前にエイリアスを再訪するチェーンは、決して終着しません。走査は永遠にたどり続けるのではなく停止し、たどったチェーンを示すことで、ループを閉じるリンクがわかるようにします。

記述できるどのような内容もこのようなチェーンを生み出しません。インポートツリーは非巡回であり、各リンクは前のリンクよりも深くネストされたものを指すため、インポートから組み立てられたチェーンは下降して終わります。したがってこれは、Aggregate が宣言できる形状ではなく、通常のオーサリング経路以外の何かによって組み立てられたエイリアステーブルに対する安全策です。

出力されるメッセージ:

re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>)(再エクスポートされたコンポーネントのエイリアスが循環しています)

修正方法: ファイル内の何もこれを引き起こさず、これを解消するオーサリング上の変更はありません。実行したコマンドと、メッセージが示すエイリアスチェーン(ループが閉じた箇所を示す詳細)を添えて報告してください。

An Aggregate reached graph building without being normalised(Aggregate が正規化されずにグラフ構築に到達した)

トップレベルにコンポーネントを持つように記述された Aggregate と、名前付きサブシステムで記述された Aggregate は、読み込まれる際に同じ形状になります。トップレベルのコンポーネントはコンパイラが用意するサブシステムに畳み込まれ、トップレベルは空にされます。この畳み込みにより、下流のすべての処理が 1 つの形状に対して 1 つの問いを立てることができます。

両方が設定された状態でグラフ構築に到達した Aggregate は、その読み込みによって生成されたものではありません。2 つの形状はオーサリング時点で互いに排他的であり(両方を宣言したドキュメントは読み込み時に拒否されます)、畳み込みがその後それらを 1 つの形状にするため、作成者が記述できるどのような内容もここには到達しません。これは通常の読み込み経路以外の何かによって組み立てられた Aggregate に対する安全策であり、遭遇した場合は回避するのではなく報告する価値があります。

メッセージは次のように始まります:

aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)(Aggregate が正規化されないままトポロジーに到達しました(合成されたデフォルトサブシステムと並んで、空でないルートコンポーネントが存在します))

続いてコンパイラが想定する構築経路が示されます。これはオーサリングの指示ではなく、ビルドをデバッグする人に向けた注記です。

修正方法: ファイル内の何もこれを引き起こさず、これを解消するオーサリング上の変更はありません。実行したコマンドを添えて報告してください。

A label-transform plugin’s patch reaches outside node labels(label-transform プラグインのパッチがノードラベルの外に及んでいる)

label-transform ロールでアタッチされたガバナンスプラグインには、グラフの射影が渡されます。ノードごとに 1 エントリで、各エントリはそのノードのラベルと、そのインスタンスが宣言する値を持ちます。ただし、その Component が sensitive と宣言する値は伏せられます。プラグインはノードのラベルに対するパッチを返します。ホストはパッチをラベルだけに適用した後、返ってきたものが依然としてそのラベルのビューであること、すなわち同じノードで、各ノードがラベルのみを持ち、各ラベル値が文字列であることを確認します。

それ以外はすべて拒否され、ビルドは停止します。ノードの追加や削除、あるいはラベル以外のノードフィールドの変更は、まさに誰も宣言していないインフラストラクチャが黙って現れることにほかなりません。そのため、ロールが対象としない変更を取り込むのではなく、ビルドはパッチがどの制限規則に違反したかを示します。ラベルがこのロールの対象のすべてであり、プラグインをアタッチしたオペレーターが宣言したのはそこまでで、それ以上ではありません。

出力されるメッセージ。パッチが適用前に拒否された場合:

mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (ミューテーターのパッチが拒否されました: パッチを JSON Patch ドキュメントとしてデコードできません) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (ミューテーターのパッチが拒否されました: パッチをノードラベルのサーフェスに適用できません)

または、適用した結果がホストが渡したビューではなかった場合:

mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (ミューテーターのパッチが拒否されました: 変更後のノード集合のサイズが変わりました(ミューテーターはノードを追加・削除できません)) mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (ミューテーターのパッチが拒否されました: 変更後のノード集合に新しいノードが追加されました(ミューテーターはノードを追加できません)) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (ミューテーターのパッチが拒否されました: ノードにラベル以外のフィールドが追加されました(ミューテーターが変更できるのはラベルのみです)) mutator patch rejected: node "<node>" lost its "labels" field (ミューテーターのパッチが拒否されました: ノードからラベルのフィールドが失われました) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (ミューテーターのパッチが拒否されました: パッチ適用後、ノードが文字列以外のラベル値を持っています)

修正方法: 誤りはドキュメントではなくプラグインにあります。プラグインが返すすべての操作が、いずれかのノードの labels 配下のエントリを対象とし、文字列値のみを設定するように修正してください。対象は文字列しか受け付けないため、数値や真偽値のラベル値がよくある原因です。プラグインを修正する間、ビルドを即座に通すには plugins.governance からアタッチメントを削除します。

意図的な省略:トポロジは非巡回である必要はない

Aggrega はトポロジ内の循環を許容します。依存関係グラフが有向非巡回グラフ(DAG)であることは求めません。エージェント間アーキテクチャ、コールバックパターン、相互認証のペアはいずれも循環するエッジを生み出し、コンパイラはそれらを受け入れます。デプロイ時の順序付けは IR グラフではなくレンダラーの関心事です(境界ごとの syncWave または同等の仕組みによります)。

inject 契約のチェック時

コンパイラはすべての inject: ブロック(self-inject(Component が自身に注入するもの)と uses-inject(Component 間の配線)の両方)を走査し、配信契約を対象 Component の provides: スキーマ、Feature のラベル区分、および宣言された配信キーの集合に照らして検証します。Aggregate 自身の component が記述したブロック上の from: キーはカタログの解決直後にチェックされるため、記述した行に対して失敗します。モジュールが提供するコンポーネントのブロック上のものは、そのモジュールをインポートするコンポジションがビルドされた時点でチェックされ、モジュール自身のドキュメント内の行に対して失敗します。アタッチされた Feature が提供する接続上の from: キーは、接続を描けるすべてのサーフェスが提供を終えた時点でチェックされます。これは、そのような接続がチェック対象として存在する最も早い時点です。

Inject from key is not in the target’s provides(Inject の from キーがターゲットの provides にありません)

inject: エントリが、読み取り元のソースが公開していない from: キーを参照しています。コンポーネント自身のブロックまたは接続の場合は対象 Component の provides: スキーマ、アタッチされた Feature 自身の inject: ブロックの場合はアタッチされた Feature の FeatureRecipe がそのソースです。

このチェックは、接続がどこに記述されていても適用されます。 uses: 接続は複数の記述サーフェスから構築済みトポロジーに到達します。Component 自身の uses: ブロックと、それにアタッチされた Feature の uses: ブロックです。後者のアタッチは component 上、subsystem 上、Release の boundary 上、または Release の boundary の component エントリ上のいずれに記述されていてもかまいません。同じ綴り誤りのキーは、そのすべてで拒否されます。診断は、それを記述した作者のブロックを指します。つまり、アタッチ自身の uses: エントリ、すなわちアタッチ自体が宣言された箇所を指し、消費側 component の uses: ブロックは指しません。提供された接続の場合、そのブロックには何も含まれていないためです。

参照がどこで解決されるかは、参照がどこにあるかによって決まります。Component レベルの self-inject の from: は、同じ Component 自身の provides: に対して解決されます。uses: 接続上の from: は、その接続が指す component の provides: に対して解決されます。2 つのサーフェスが 1 つのソケットと 1 つのエイリアスを記述する場合、各接続はそれ自身が指定する対象に対して解決され、そのペアがエイリアスを共有していることを拒否するのと同じビルドで行われます。provides: を宣言しない Component は、自身に向けられたすべての from: 参照を拒否します。

アタッチされた Feature 自身の inject: ブロック。 ここでの from: は、Feature の FeatureRecipe が provides: で公開するキーに対して、Feature がアタッチされているコンポーネントについて評価されたとおりに解決され、そのコンポーネントのレンダリング時にチェックされます。FeatureRecipe が公開していないキーはコンポーネントの環境、ファイル、引数のいずれにも何も渡さないため、代わりにビルドが停止します。ただし、FeatureRecipe がアタッチされた Feature のエントリを .inject で自ら読み取る場合は除きます。これは、アタッチされた Feature 自身のレンダリングコンテキスト、つまり .inject を持つコンテキストに対して評価するテンプレート内での読み取りで、該当するのはその値のマッピング、ワークロード、アーティファクト、省略指定、またはパイプラインステップの with: や when: であり、インラインで記述されたものもインポートされたものも含みます。その locals:、provides:、source:、assertions: は .inject を持たず、その injectMapping: はコンポーネントのコンテキストに対して評価されるため、それらのいずれかでの読み取りはカウントされません。このような FeatureRecipe は各エントリを記述どおりに受け取り、独自の方法で配信するため、そのエントリは拒否されません。また、公開していないキーはコンポーネント自身の配信を通じては何も配信せず、FeatureRecipe が使用するものとなります。FeatureRecipe が .inject を読み取るかどうかは、そのテンプレートが指定するパスから判断されます。コンテキスト全体を渡すテンプレート(toJson .)や、index . "inject" のような関数を通じてエントリに到達するテンプレートはエントリの読み取りとはみなされず、公開されていないキーを指定するそのエントリは拒否されます。境界でアタッチされ、その FeatureRecipe がその境界に対して 1 回だけレンダリングされる Feature は、その 1 回の評価に対してチェックされます。コンポーネントを含むどの境界もその評価を行っていない場合は、キーをチェックする対象がないため、キーは拒否されません。公開済みのキーを指定する from: はこれまでどおり配信されます。この検出結果は、アタッチされた Feature 自身のエントリの位置、つまりそれを記述したドキュメント内の位置(たとえば Aggregate 内の .spec.components.<component>.features.<attachment>)に示されます。また、配信キーを別の inject ソースもすでに保持しているエントリは、「An attachment delivers a key another inject source already claimed(アタッチメントが、別の inject ソースがすでに要求したキーを配信している)」でも報告されます。それぞれに個別の修正が必要なためです。

コンポーネント自身の inject: ブロックでは、value: エントリはリテラルを保持し、何に対しても解決されないため、たまたま provides キーのように読めるリテラルもそこでは拒否されません。接続上では、後述の「An inject: entry on a connection carries a literal(接続上の inject エントリがリテラルを持っている)」で説明するとおり、value: エントリは拒否されます。キーを指定するのは from: だけです。

Release 自身のエッジ単位の uses: サーフェスは target と infra を持ち、inject: は持たないため、そこで配線された接続は配信を指定せず、チェック対象の from: キーもありません。

Component 自身の inject: ブロックで読まれる from: に対して出力されるメッセージです。最初に拒否理由が示され、続いて問題のキー、解決対象となった component type、そしてその type が宣言するキーがソート順で示されます(選択可能な候補です)。

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<delivery-key>, "<from-key>", "<component-type>", "<key-1>", "<key-2>")(無効な inject キー:from キーはそのソースが公開する provides キーを指定する必要があります)

uses: 接続で読まれる from: の場合は、同じ拒否理由が先頭に来て、エントリが記述されたメカニズムと配信キーが問題のキーより前に示されます。

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>, "<mechanism>", "<delivery-key>", "<from-key>", "<component-type>", "<key-1>")(無効な inject キー:from キーはそのソースが公開する provides キーを指定する必要があります)

アタッチされた Feature 自身の inject: ブロックで読み取られる from: の場合、問題のキーが最初に来て、次にエントリの in: とメカニズム、解決の対象となった FeatureRecipe、その FeatureRecipe が公開する各キーがソート順に続きます:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<from-key>", in "<in>", mechanism "<mechanism>", FeatureRecipe "<feature-recipe>", publishes "<key-1>", publishes "<key-2>")(無効な inject キー:from キーはそのソースが公開する provides キーを指定する必要があります)

対象が provides: キーをまったく宣言していない場合は列挙する候補がないため、メッセージは component type の後で終わります。アタッチされた Feature のブロックでは、FeatureRecipe の後で終わります。

修正方法: from: キーをメッセージに列挙された宣言済みキーのいずれかに合わせて変更するか、対象 Component の provides: スキーマを拡張して必要なキーを宣言します。アタッチされた Feature のブロックでは、from: キーを FeatureRecipe が公開するキーに変更するか、FeatureRecipe が自分のものであればその provides: でキーを公開するか、FeatureRecipe が独自の方法で値を配信する場合は .inject でエントリを自ら読み取らせます。

Required feature not attached(必須の feature がアタッチされていません)

Component が存在の義務付け(features.aggrega.ai/requiredType.<label> アノテーション)を宣言しており、そこで指定された Feature type が、この component インスタンスが最終的に持つアタッチの中に存在しません。これはすべてのスコープを数えた結果です。対象は Aggregate の component レベルと subsystem レベルのブロック、Release の boundary レベルと component レベルのブロック、およびアノテーション駆動の展開です。

出力されるメッセージ:

missing required feature: attach a Feature of the required type to the component (<required-type>, required by component type <component-type>, under the requirement label <label>)(必須の feature がありません:必須タイプの Feature をコンポーネントにアタッチしてください)

3 つの値は、義務付けが要求する Feature type(上の文ですでに名前が示されているため、そのまま記載されます)、義務付けを宣言する component type、そして義務付けが持つラベルです。後の 2 つには見出しが付いており、2 つのエンティティ参照を区別できます。2 つの異なる type を要求する component は異なる 2 つのメッセージを報告し、異なる type からの義務付けを宣言する 2 つの component には、それぞれの要求をどの type が行ったかが示されます。レポートは components: 配下の component 自身のキーに位置付けられ、subsystem 内に記述された component は、まずその subsystem のキー配下に位置付けられます。

ここでは、アタッチが記述された名前は関係ありません。義務付けが問うのは、指定された type のアタッチがそもそも存在するかどうかです。スロットをバインドすればこれを満たし、他の任意の名前でのアタッチでも満たします。

修正方法: 必須 type の Feature を、Aggregate または Release の component に、あるいは component が継承するより広いスコープにアタッチします。Component がもはやそれを必須としない場合は、カタログ宣言から義務付けのアノテーションを削除します。

Malformed attachment requirement(不正なアタッチ要件)

存在の義務付けの宣言を評価できません。アノテーションの値は不透明な文字列であるため、コンパイラが読み取る前にその形を検証するものはありません。Feature type URI ではない値や、プレフィックスの後にラベルがなく義務付けファミリーだけを指定するキーは、満たされていない要件としてではなく、壊れた宣言として報告されます。タイプミスが満たされた要件として読まれることがあってはならないためです。

出力されるメッセージ:

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the value must be a Feature type URI of the form <publisher>/<name> in lower-case kebab segments, as in core/prometheus-exporter). Correct that annotation on the component type’s catalog entity.(不正なアタッチメント要件:値は小文字のケバブケースのセグメントからなる Feature タイプ URI である必要があるため、評価できません。コンポーネントタイプのカタログエンティティにあるそのアノテーションを修正してください。)

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the key needs a label naming the requirement, as in features.aggrega.ai/requiredType.database). Correct that annotation on the component type’s catalog entity.(不正なアタッチメント要件:キーには要件を指定するラベルが必要なため、評価できません。コンポーネントタイプのカタログエンティティにあるそのアノテーションを修正してください。)

メッセージは、停止の対象である宣言、つまりアノテーションキーを先頭に示し、その後に宣言が壊れている component type を示します。そのため、レポートがその type を使う component インスタンスに位置付けられていても、修正すべきエンティティが分かります。インスタンスは問題が見える場所であり、カタログエンティティは対処する場所です。

この停止はコンポジションが組み立てられた直後に発生し、完成したグラフを読むどのチェックよりも早い段階です。そのため、壊れた義務付けを含むビルドはそれだけを報告します。後で実行されるはずのチェックは、宣言の内容に基づいて判断するものの宣言を読めないため、到達しません。修正して再ビルドすると、残りが表示されます。

修正方法: Component のカタログエンティティを修正します。対処はカタログで行い、Aggregate では行いません。そのため、この停止は、自身のドキュメントの変更が必要な「Required feature not attached(必須の feature がアタッチされていません)」とは区別されます。

Required attachment slot not bound(必須のアタッチメントスロットがバインドされていない)

カタログエンティティが featuresSchema 内で required: true を指定したアタッチメントスロットを宣言しているにもかかわらず、そのエンティティのインスタンス上でそのスロット名をバインドするものがありません。このチェックは、すべてのスコープが畳み込まれた後にインスタンスが最終的に持つアタッチメントに対して実行されます。対象は、Aggregate のコンポーネントレベルおよびサブシステムレベルの features: ブロック、Release の境界レベルおよびコンポーネントレベルのブロック、そしてアノテーション駆動の展開によって生成されたアタッチメントです。そのため、インスタンスが継承するスコープで一度アタッチされたクレデンシャルは、インスタンス上に記述されたフィルとまったく同じようにスロットをバインドします。

出力されるメッセージ:

required attachment slot unfilled (<slot>, declared required by component type <component-type>). Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it.(必須のアタッチメントスロットが未充足です。上記のスロットは、上記のコンポーネント型によって必須と宣言されています。Aggregate または Release で、コンポーネント上またはその上位のスコープで、その名前に Feature をアタッチしてください。)

2 つの値はスロット自体の名前と、それを宣言するコンポーネントタイプです。そのため、1 つのインスタンスが 2 つのスロットを未バインドのままにすると、異なる 2 つのメッセージが報告されます。レポートは Aggregate 内のコンポーネントの features: ブロック配下にあるスロットのキーに位置付けられます。そのキーこそが欠けているものであるため、エディタは実際に存在する最も近いキー、つまりコンポーネントが features: ブロックを記述している場合はそのブロック、記述していない場合はコンポーネント自体に位置付けます。欠けているアタッチメントを記述した者はいないため、どのドキュメントの作成者も特定されません。レポートはコンポーネントに留まり、開発者の過失として記録されます。また、どちらのドキュメントでもスロットを埋められるため、対処方法は両方のドキュメントを挙げます。Aggregate ではコンポーネント上またはそれを含むサブシステム上、Release ではそのコンポーネントのエントリ上またはそれを含む境界上です。

ソケットが宣言するスロット(usesSchema エントリの featuresSchema 内)は、コンポーネントではなく、そのソケットを通じて配線される各接続に要求されます。各接続は Aggregate または Release 内の自身のエントリ上でそれぞれスロットを埋め、上位のスコープはそこに届きません。したがって、2 つの接続を持ち、そのうち 1 つがスロットを埋めているソケットは、もう一方のみを名前付きで報告します:

required attachment slot unfilled ("<slot>", declared required by socket "<socket>", of component type "<component-type>", left unfilled by the connection "<alias>"). Attach a Feature under that slot in this connection’s features, on its entry in the Aggregate or in the Release.(必須のアタッチメントスロットが未充足です。上記のスロットは、上記のコンポーネント型のソケットによって必須と宣言されており、上記の接続によって未充足のままです。Aggregate または Release におけるこの接続のエントリで、この接続の features のそのスロットの下に Feature をアタッチしてください。)

このレポートは、接続を記述したドキュメント内の接続エントリ、つまり Aggregate の uses: エントリ、または Release が配線した接続については Release のエッジごとのエントリに位置付けられます。アタッチされた Feature が記述する接続は、コンポーネントのソケットではなく Feature が宣言するソケットに配線されるため、コンポーネントのソケットスロットを埋める対象にはなりません。

修正方法: Aggregate または Release で、スロットの名前で Feature をアタッチします。コンポーネント上、またはスロットのすべての利用者が共有するより広いスコープで行い、ソケットのスロットの場合はレポートが示す接続上で行います。別の名前でのアタッチメントはスロットをバインドしません。スロットは名前付きのバインディングポイントであり、名前そのものがバインディングだからです。スロットを必須にする必要がなくなった場合は、カタログエンティティの featuresSchema(コンポーネント自身のもの、またはソケットのもの)を更新して required の宣言を削除します。

Two Features declared to conflict reach one component(競合すると宣言された 2 つの Features が 1 つのコンポーネントに到達する)

Feature の interoperability.conflictsWith は、一緒にアタッチできない Features を指定します。1 つのコンポーネントが、その Feature と、それが指定する Feature の両方を持つことになった場合に該当します。このチェックは、すべてのスコープが畳み込まれた後にコンポーネントが最終的に持つアタッチメントに対して実行されます。対象は、Aggregate のコンポーネントレベルおよびサブシステムレベルの features: ブロック、Release の境界レベルのブロック(コンポーネントが内側にあるすべての境界、ネストされたものを含む)とコンポーネントレベルのエントリ、そしてアノテーション駆動の展開によって生成されたアタッチメントです。したがって、両方がコンポーネント上に記述されている場合、一方がそれを含む境界またはサブシステム上にある場合、あるいは一方が外側の境界に、もう一方がその内側にネストされた境界にある場合に、そのペアは停止します。コンポーネントを共有しない兄弟の境界にアタッチされた 2 つの Features は出会うことがなく、コンポーネントを含まない境界はどこにも到達しないため、いずれも停止しません。

宣言は 1 つで十分です。どちらかの Feature のリストがもう一方を指定していれば停止が発生します。名前は両側ともバージョンを除いて比較されるため、エントリはそれが指定する Feature のすべてのバージョンに一致します。コンパイラは、Feature の作成者が宣言した名前とコンポーネントが持つ Features を比較するだけで、どちらにもそれ以上の意味を読み込みません。

出力されるメッセージ:

a Feature reaches a component alongside a Feature it declares a conflict with ("<feature>", attached in the Release on boundary "<boundary-path>", conflicts with "<other-feature>", attached in the Aggregate on component "<component>", on component "<component>"). Attach only one of the two where they meet: remove one attachment, or move it to a scope that does not hold this component.(ある Feature が、競合を宣言している Feature と同じコンポーネントに到達しています。上記の各 Feature とそのアタッチ箇所、および両者が出会うコンポーネントを参照してください。両者が出会う箇所ではどちらか一方だけをアタッチしてください。一方のアタッチメントを削除するか、このコンポーネントを含まないスコープへ移動してください。)

最初の値は、リストでもう一方を指定している Feature(上の文が指す Feature)で、その後にそれがアタッチされたすべての場所が続きます。次に競合相手の Feature と、それがアタッチされたすべての場所、最後に両者が出会うコンポーネントです。各場所は、変更するために開くドキュメントの言葉で表記されます:attached in the Aggregate on component、attached in the Aggregate on subsystem、attached in the Release on boundary(ネストされた境界のパスは各レベルを / でつなぎます)、attached in the Release on the entry for component の後に in boundary、または attached by annotation-driven expansion of とアノテーション、その後に記述された場所を示す declared at です。接続上に記述されたアタッチメントは、コンポーネント自身のブロックではなくその接続のエントリで編集されるため、その接続のエントリとして表記されます:attached in the Aggregate on the connection の後に through socket と of component、または attached in the Release on the connection の後に through socket、of the entry for component、in boundary です。2 か所にアタッチされた Feature は両方を列挙します。レポートは components: 配下のコンポーネント自身のキーに位置付けられ、複数のコンポーネントで出会うペアは、Aggregate がコンポーネントを宣言する順に、それぞれについて 1 回ずつ報告されます。

修正方法: 両者が出会う場所では一方のみをアタッチします。アタッチメントの一方を削除するか、一方を兄弟の境界など、このコンポーネントを含まないスコープに移動します。アタッチメントがアノテーション駆動の展開によるものである場合、変更すべきは展開先のブロックではなくアノテーションです。2 つの Features を実際には組み合わせてよい場合は、宣言が誤っています。宣言している Feature のカタログエンティティ上の conflictsWith リストから、もう一方の Feature を削除してください。

Attachment does not conform to its declared slot shape(アタッチメントが宣言されたスロットの形状に適合しません)

アタッチメントが宣言済みのスロットを束縛していますが、そのスロットが宣言する形状に一致しません。よくあるのは配信のケースです。スロットの inject 許可リストは、フィルがマテリアルを配信できるメカニズムを列挙します。空の許可リストはブラックボックスを意味し、Recipe がマテリアルを内部で配信するため、フィルは配信を一切指定できません。空の inject: {} ブロックは配信を指定しないため、空の許可リストを含むあらゆるスロットの形状に合致し、アタッチメントがどこに書かれていても同じ判定になります。Aggregate が宣言するコンポーネント上でも、インポートされたモジュールが提供するコンポーネント上でも、より広いスコープでも同様です。どのスロットも宣言していない名前のアタッチメントは自由なアタッチメントであり、スロットの制約を受けません。

出力されるメッセージです。アタッチメントが、そのスロットが受け付けない配信を指定している場合で、スロット、次にメカニズム、続いてスロットの inject 許可リストが受け付ける各メカニズムが、スロットが宣言した順に示されます(許可リストが空の場合は何も続きません):

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>")(アタッチメントが、宣言されたスロットの形に適合していません)

インポートされたモジュールが提供するコンポーネントは、それをインポートするコンポジションがビルドされた時点でチェックされ、2 つ目の形式で報告されます。この形式は、モジュールの Aggregate と、モジュールのドキュメント内でスロットが宣言していないキー(アタッチメントの inject: ブロック配下のメカニズム、または許可リストが空のスロットで何らかのメカニズムを指定している inject: ブロックそのもの)を示します:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>.<key>, attachment does not conform to the declared slot shape: this key is not part of the slot’s declaration — <remedy>)(アタッチメントが宣言されたスロットの形状に適合していません:このキーはスロットの宣言に含まれていません)

ここで <remedy> はキーによって異なります:

  • remove it:許可リストが空のスロットでメカニズムを指定している inject: ブロックの場合;
  • remove it, or add it to the slot's inject allowlist in the entity's featuresSchema:スロットの許可リストが指定できるメカニズム(env、file、arg)の場合;
  • remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg:それ以外のメカニズムの場合。これらはどのスロットも宣言できません。

より広いスコープで宣言されたアタッチメント(サブシステム全体に宣言され、その配下のすべての component にカスケードするもの)も同じ形状に従う必要があり、到達する各 component のスロットに対してチェックされます。そのため、同じアタッチメントがある component では形状に適合し、別の component では適合しないことがあります。この形式では、失敗した component とスロットを示し、アタッチメントの位置を配信ブロック内のキーではなく、宣言されたスコープで示します:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.subsystems.<scope>.features.<attachment>, this attachment is declared at a scope that reaches component <component>, whose attachment slot <slot> does not accept the delivery it carries: move the attachment down to the components that may receive it)(アタッチメントが宣言されたスロットの形状に適合していません:このアタッチメントは上記の component に届くスコープで宣言されていますが、その component のアタッチメントスロットは、このアタッチメントが持つ配信を受け付けません:アタッチメントを、それを受け取れる component まで下へ移動してください)

接続が持つアタッチメントがこの停止に至ることはありません。その形状は記述された場所で閉じています。Aggregate の接続エントリでは type、description、values を、Release のエントリでは type、description、infra を取るため、配信を一切指定できません。そこに書かれた inject: はドキュメントの読み込み時にキーを示して拒否され、代わりにそれを配信する Workload エントリがソケットスロットの inject 許可リストに従います。また、どのスコープもソケットのスロットには到達しないため、上記のスコープ全体の形式には接続上の対応するものがありません。

修正方法: これらの形式では 2 種類の異なる編集が必要で、フィールドパスからどちらであるかがわかります。フィールドパスが component 上のアタッチメント、またはその中のキーを示している場合は、配信が原因です。削除するか、そのエントリをスロットの inject 許可リストが指定するメカニズムの下に移動してください。マテリアルを、スロットが列挙していないメカニズムを通じて本当に workload に届けるべき場合は、カタログエンティティの featuresSchema にある許可リストを広げることができます。ただし、広げられるのはスロットが宣言できるメカニズムである env、file、arg だけです。そこで他のメカニズムを指定する Component は読み込み時に検証に失敗するため、それ以外のメカニズムについては削除することが唯一の修正方法です。フィールドパスがスコープのアタッチメントを示している場合は、アタッチメント自体は正しく、その配置が原因です。スロットがその配信を受け付ける component までアタッチメントを下げ、配信を自身の Recipe に委ねている component はその到達範囲の外に置いてください。

Duplicate delivery key across inject sources(inject ソース間での配信キーの重複)

1 つのコンポーネントに対する開発者が記述した inject ソースの間で、同じ配信キー(たとえば同じ環境変数名)が 2 回指定されています。Component レベルと uses[] エントリの下、同じコンポーネント上の 2 つの uses[] エントリ、または Component 自身の inject: ブロックの 2 つの配信メカニズムの下のいずれかです。配信が同時に 2 か所から来ることはできないため、2 回指定されたキーはどちらが優先されるかの問題ではなく矛盾です。

ビルドはこれを 4 か所で読み取ります。それぞれが参照する記述済みソースと依存関係の接続の集合が異なり、それらに対して異なる問いを立てるためで、それぞれが独自の形式で報告します。

1 つ目は Aggregate に記述した接続を読み取り、ファイルの解決時に報告します。配信メカニズム、キー、そして記述順で最初に同じキーを指定している接続のソケットとエイリアスを示します。

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>")(inject ソース間での配信キーの重複)

2 つ目は同じ記述済みブロックを読み取り、別の問いを立てます。接続をまったく介さずに、コンポーネントが自身の 2 つの配信メカニズムの下で 1 つのキーを指定しているかどうかです。キーを指定しているメカニズムごとに 1 回、そのメカニズム自身のエントリの位置で報告し、報告対象のメカニズム、キー、そしてそのキーを指定している他のすべてのメカニズムを記述順に示します。

duplicate delivery key across inject sources (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>")(inject ソース間での配信キーの重複)

どちらのメカニズムも違反者ではなく、どちらの報告も変更できます。一方の下でキー名を変更するか、2 つの配信のうち一方を削除してください。コンポーネントがそもそもどのメカニズムを使用できるかは別の問題で、その spec.inject 許可リストによって決まります。後述の「Self-inject mechanism not in the component’s allowlist(自己 inject のメカニズムがコンポーネントの許可リストにない)」を参照してください。

モジュールが提供するコンポーネントも、これら最初の 2 つの形に該当します。これは、そのモジュールをインポートするコンポジションがビルドされた時点で、モジュール自身のドキュメントから読み取られます。その場合、メッセージはモジュールの Aggregate とそのドキュメント内のキーを示します。

3 つ目は完成したトポロジーが持つ接続を読み取ります。これには Feature のアタッチメントが代わりに追加した接続も含まれます。何かがレンダリングされる前に実行され、記述した配信キーと、同じキーを配信する依存関係ソケットを示します。

duplicate delivery key across self-inject and uses-inject ("<key>", socket "<socket>")(self-inject と uses-inject の間での配信キーの重複)

1 つの記述済みキーが 2 つの依存関係ソケットを通じて配信される場合はソケットごとに 1 回報告されるため、最初に到達したものだけでなく、1 回のビルドですべてが示されます。

4 つ目は同じ完成したトポロジーを読み取り、別の問いを立てます。コンポーネント自身は何も指定せず、コンポーネント自身の 2 つの依存関係接続が合わせて 1 つのキーを配信しているかどうかです。各接続で 1 回、その接続自身の配信エントリの位置で報告し、エントリのパスに続けてそのキーを配信するすべてのソケットを示します。

duplicate delivery key across inject sources ("inject.<mechanism>.<key>", "<socket>", "<socket>")(inject ソース間での配信キーの重複)

ソケットが 2 回示されている場合、2 つの接続が異なるエイリアスで 1 つのソケット上にあることを意味します。その場合は位置だけが両者を区別するため、ソケット名ではなく 2 つの報告それぞれのフィールドパスを読んでください。

どちらの接続も違反者ではなく、どちらも変更できます。一方のキー名を変更するか、2 つの配信のうち一方を削除してください。

キーがパスの場合、フィールドパスは代わりにメカニズムのブロックを示します。 配信キーが何を表すかはメカニズム自身の事柄であり、file メカニズムはマウントパスに配信します。そのためそのようなキーにはドットが含まれますが、フィールドパスはドットで自身のステップを区切ります。フィールドパスは、ドキュメントに存在しないキーをたどるように読めるステップを記述するのではなく、曖昧さなく示せる最後のステップで止まります。そのため /etc/app/config.yaml のようなキーでは .spec.components.<component>.inject.<mechanism> となり、そこで止まります。いずれの場合もメッセージはキーを示すため、報告は同じように対処可能です。ただし、メッセージのどこでキーを読むかは上記の 4 つの形式で異なるため、フィールドパスでブロックを読み、手元の形式からキーを取り出してください。詳細が配信メカニズムで始まる場合、キーはその直後の引用値です。詳細がキー単体で始まる場合、キーは最初の引用値です。詳細が配信エントリ自身のパスで始まる場合、キーはそのパスの最後のステップです。

修正方法: 競合するキーの一方の名前を変更するか、重複する宣言を削除してください。なお、FeatureRecipe の injectMapping が、コンポーネント自身の inject: ブロックまたはその接続の inject: ブロックが配信したキーを書き換えることは意図的なインターセプトであり、ここでも他のどこでも検出されません。

コンポーネントにアタッチされた Feature が指定するキーは、3 つある記述面のうち 3 つ目から同じ共有空間に入り、後述の「An attachment delivers a key another inject source already claimed(アタッチメントが、別の inject ソースがすでに指定したキーを配信している)」で報告されます。アタッチされた 2 つの Features が配信するキーのうち、後のものがその FeatureRecipe の injectMapping を通じて配信する場合は「Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping(アタッチされた 2 つの Features が 1 つのキーを配信し、後のものがその FeatureRecipe の injectMapping を通じて配信している)」で報告されます。

Self-inject on a component without an allowlist(許可リストのないコンポーネントでの自己 inject)

開発者がコンポーネントレベルの inject: ブロックを記述しましたが、Component カタログエンティティが spec.inject を宣言していません。spec.inject 許可リストを持たない Components は Black-Box 型であり、開発者が記述した注入を受け取りません。

出力されるメッセージ:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>")(spec.inject 許可リストのないコンポーネントでの自己 inject)

報告は inject: ブロック自体の位置に置かれ、これが削除すべき要素です。

修正方法: この Component インスタンスから inject: ブロックを削除するか、カタログ宣言に spec.inject を含む White-Box の Component 型に切り替えてください。

Self-inject mechanism not in the component’s allowlist(自己 inject のメカニズムがコンポーネントの許可リストにない)

開発者が、Component の spec.inject 許可リストに含まれていないメカニズム(たとえば env や特定のファイルマウント形式)を使ってコンポーネントレベルの inject: ブロックを記述しました。

出力されるメッセージ:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>, "<component-type>", "<mechanism>", "<allowlisted-mechanism-1>", "<allowlisted-mechanism-2>", …)(spec.inject 許可リストのないコンポーネントでの自己 inject)

指定されたメカニズムの後に、その型が許可するメカニズムが続くため、メッセージには記述された内容と型が許可する内容の両方が含まれます。許可リストをまったく宣言していない型では、指定されたメカニズムの後に何も続きません。

このルールと上記のルールはどちらも、モジュールが提供するコンポーネントにも、そのモジュールをインポートするコンポジションがビルドされた時点で適用されます。その場合、レポートはモジュールの Aggregate とそのドキュメント内のキーを示します。

修正方法: 許可リストにあるメカニズムに切り替えるか、Component が必要なメカニズムをサポートすべき場合は、そのカタログの spec.inject 許可リストを拡張してください。

uses edge dictates delivery on a socket that allowlists none(uses エッジが、許可リストを持たないソケットで配信を指定しています)

uses: エッジ上の inject: ブロックが、usesSchema エントリで inject: 許可リストを宣言していない、または空の許可リストを宣言しているソケットに接続しています。このようなソケットは Black-Box 接続です。ソケットを宣言したエンティティが依存先の値を内部で扱うため、利用側はプロデューサーの Recipe が出力するものをそのまま受け取り、配信形式を選びません。inject: キーがないことと inject: [] は同じ宣言です。

ソケットは、それを宣言したエンティティ上で読み取られます。Feature のアタッチメント上に記述されたエッジは、アタッチされた Feature の usesSchema に対して解決され、それ以外のすべてのエッジは消費側 Component のものに対して解決されます。

出力されるメッセージ。最初に拒否の内容、次にエッジが指定したメカニズム、ソケット、宣言が読み取られたエンティティが続き、最後に対処方法が示されます:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry.(uses エッジの inject が、ソケットが許可しない配信メカニズムを指定しています。ソケットは配信の許可リストを宣言していないため、指定は一切許可されません。ソケットを宣言したエンティティが依存先の値を自ら配信します。この接続から inject ブロックを削除して利用側 Recipe で接続の provides から値を読み取るか、ソケットの usesSchema エントリで許可するメカニズムを宣言してください。)

この検出結果は、対象となる記述済みエントリに、そのエントリが書かれたドキュメント内で位置付けられます。コンポーネント自身の uses: ブロックが引いたエッジでは .spec.components.<consumer>.uses.<socket>.<alias>、アタッチメントが引いたエッジでは .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias> です。後者はアタッチメントを宣言したブロックを起点とし、それはコンポーネント自身ではなくサブシステムや境界のブロックである場合があります。ソケットがアタッチされた Feature 上で宣言されている場合、メッセージはコンポーネントタイプの代わりにフィーチャータイプを示します。違反するエッジはそれぞれ個別の検出結果として報告されるため、1 回のビルドですべてが示されます。

対処方法: エッジから inject: ブロックを削除し、代わりに利用側 Recipe で .context.uses.<alias>.provides.<name> から依存先の値を読み取ります。または、接続を透過的にする意図がある場合は、ソケットの usesSchema エントリの inject: 許可リストに、ソケットが許可する配信メカニズムを宣言します。

宣言するエンティティがまったく宣言していないソケットは別のケースであり、ここでは拒否されません。アドホックなソケットは許可リストを持たないため、エッジがその外にあるということが起こり得ません。

uses edge dictates a delivery mechanism outside the socket’s allowlist(uses エッジが、ソケットの許可リストにない配信メカニズムを指定しています)

uses: エッジ上の inject: ブロックが、ソケットの inject: 許可リストに含まれない配信メカニズムを指定しています。許可リストは、宣言するエンティティのエントリポイントが実際にどの配信形式から依存先の値を読み取れるかを示すものであり、その外にあるメカニズムは誰も消費しない値を配信することになります。

ブロックが指定するすべてのメカニズムが検査され、許可リスト外のものはそれぞれ報告されるため、1 回の実行につき 1 つずつではなく、1 回のビルドですべてが示されます。

出力されるメッセージ。最初に拒否の内容、次に拒否されたメカニズム、ソケット、そのソケットが許可するもの、宣言が読み取られたエンティティが続きます:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry.(uses エッジの inject が、ソケットが許可しない配信メカニズムを指定しています。ソケットが許可するメカニズムのいずれかを指定するか、宣言するエンティティの usesSchema エントリでそのソケットの inject 許可リストを広げてください。)

この検出結果は、対象となる記述済みエントリに、上記の拒否が示すのと同じパスで位置付けられます。ソケットがアタッチされた Feature 上で宣言されている場合、メッセージはコンポーネントタイプの代わりにフィーチャータイプを示します。

対処方法: 許可リストにあるメカニズムのいずれかに切り替えます。または、エンティティが必要なメカニズムをサポートすべき場合は、カタログの usesSchema エントリでそのソケットの inject: 許可リストを広げます。

An inject: entry carries both a literal and a source key(inject: エントリがリテラルとソースキーの両方を持っています)

inject: エントリが配信するのは、value: の下に書かれたリテラル(コンポーネント自身のブロック上で、ここがリテラルを配信する唯一の場所です)か、from: の下に書かれた、接続先のコンポーネントから読み取るキーのいずれか一方です。両方を持つエントリは 2 つのことを同時に述べており、どちらを選ぶかの規則がないため、一方が暗黙に優先されるのではなく拒否されます。

記述用スキーマはこの組のうちちょうど 1 つだけを認めるため、ファイルから読み込まれたドキュメントは読み込み時に拒否されます。これはその検査を裏で支える検査です。2 つのドキュメントが解決される間に Aggregate と Release が持つすべての inject: ブロックを読み取るため、ファイル以外の経路で構築されたドキュメントも、一方のフィールドが黙って選ばれるのではなく、そこから何かが構築される前に拒否されます。対象となるブロックは下記の形の検査と同じです。

違反するエントリを含む配信メカニズムはそれぞれ個別の検出結果として報告され、それを記述したドキュメント内のそのメカニズムの位置(コンポーネント自身のブロックであれば .spec.components.<component>.inject.env)が示されます。ビルド内のすべてが一度に報告されます。検出結果はメカニズムを示し、続いてそのメカニズムのリスト内の違反する各エントリの in: を示します。

出力されるメッセージ:

inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>")(inject エントリがリテラルとソースキーの両方を持っています。スキーマはちょうど一方のみを要求します)

対処方法: メッセージが示す各エントリを開き、2 つのうち不要な方を削除します。値を接続先のコンポーネントから取得すべき場合は from: を残します。これはそのコンポーネントの provides: が宣言するキーを指定します。値がこちら側でコンポーネント自身のブロック上に与えるリテラルである場合は value: を残します。接続上およびアタッチされた Feature 自身のブロック上ではリテラルは拒否されるため、そこでは from: を残します。

An inject: entry on a connection carries a literal(接続上のインジェクションエントリがリテラルを持っている)

接続は、接続先のコンポーネントが公開するものを利用側のコンポーネントに配信します。接続の inject: ブロックの各エントリは、from: の下でそのコンポーネントの provides: キーの 1 つを指定します。value: の下に書かれたリテラルはターゲットが公開する何ものも指さないため、接続上には置き場所がなく、そのエントリは破棄されるのではなく拒否されます。コンポーネントが自分自身に配信するリテラルは、value: が認められるコンポーネント自身の inject: ブロックに置きます。

どのドキュメントが描いた接続であっても、すべての接続が検査されます。コンポーネント自身の uses: ブロック上の接続、Aggregate 内でアタッチされた Feature が描く接続、そして Release に記述されたアタッチメントが描く接続です。何かがレンダリングされる前に拒否されるため、aggrega build と同様に aggrega validate --release でも報告されます。

違反するエントリはそれぞれ個別の検出結果として報告され、それを描いたドキュメント内の接続のエントリの位置が示されます。コンポーネント自身の接続であれば .spec.components.<component>.uses.<socket>.<alias>、アタッチメントが描く接続であれば .spec.components.<component>.features.<attachment>.uses.<socket>.<alias>、Release ではアタッチメントのエントリの下の同じパス(たとえば .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias>)です。ビルド内のすべてが一度に報告されます。Aggregate 内の検出結果は DEVELOPER_ERROR、Release 内の検出結果は OPS_ERROR に分類されます。検出結果はメカニズムとエントリの in: を示します。

出力されるメッセージ:

inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>")(接続上の inject エントリがリテラルを持っています。接続はターゲットが公開するキーを配信し、各キーはソースキーで指定されます)

対処方法: 値がターゲットの公開するものである場合は、value: をその provides: キーを指定する from: に置き換えます。利用側のコンポーネントが必要とするリテラルである場合は、エントリをそのコンポーネント自身の inject: ブロックに移します。そのメカニズムは、その Component タイプの spec.inject 許可リストによって管理されます。

An inject: entry on an attached Feature carries a literal(アタッチされた Feature の注入エントリがリテラルを持っている)

アタッチされた Feature に記述された inject: ブロックは、そのアタッチメントの FeatureRecipe が公開するものをコンポーネントに配信します。各エントリは、FeatureRecipe の provides: が公開するキーの 1 つを from: の下で指定します。value: の下に記述されたリテラルはアタッチメントが公開するものを何も指定しないため、そのエントリの in: の下でコンポーネントに届くものは何もありません。このエントリはビルドされてから破棄されるのではなく、拒否されます。コンポーネントが必要とするリテラルはコンポーネント自身の inject: ブロックに属し、そこでは value: が受け入れられ、配信されます。

Aggregate が inject: ブロックを記述するすべてのアタッチメントがチェックされます。対象は、コンポーネント自身の features: ブロック内のアタッチメントと、サブシステムの features: ブロック内のアタッチメント(サブシステムが保持するすべてのコンポーネントに及びます)で、Release が指定する Aggregate と、その Aggregate が aggregates: の下でインポートするすべてのモジュールに、深さを問わず適用されます。アタッチメントが描く接続は独自の inject: ブロックを持ち、そこでのリテラルは前述の接続での拒否に該当します。Release のアタッチメントは独自の inject: ブロックを記述しません。このエントリは何もレンダリングされる前に拒否されるため、aggrega validate --release も aggrega build と同様にこれを報告します。

問題のある各エントリは個別の検出結果として報告され、ブロックを記述したドキュメントの Aggregate に対して DEVELOPER_ERROR として分類され(モジュール内で記述されたアタッチメントの場合はモジュール自身のドキュメント)、そのドキュメント内のアタッチメントのブロック内にある配信メカニズムの位置に示されます:.spec.components.<component>.features.<attachment>.inject.<mechanism>、またはサブシステムのアタッチメントの場合は .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism> です。1 つのドキュメント内のものはすべて一度に報告され、インポートされたモジュール内のものは、インポート元の Aggregate がチェックを通過した時点で報告されます。検出結果はメカニズムとエントリの in: を示します。value: と from: の両方を持つエントリは、前述の「An inject: entry carries both a literal and a source key(注入エントリがリテラルとソースキーの両方を持っている)」で 1 回だけ報告されます。

出力されるメッセージ:

inject entry on an attachment carries value:; an attachment delivers the keys its FeatureRecipe publishes, each named with from:, and a literal belongs in the component’s own inject block ("<mechanism>", "<in>")(アタッチメント上の inject エントリがリテラルを持っています。アタッチメントはその FeatureRecipe が公開するキーをそれぞれソースキーとして指定して配信し、リテラルはコンポーネント自身の inject ブロックに属します)

修正方法: 値がアタッチメントの FeatureRecipe が公開するものである場合は、value: をその provides: キーを指定する from: に置き換えます。値がコンポーネントに必要なリテラルである場合は、エントリをコンポーネント自身の inject: ブロックに移動します。そのメカニズムは、その Component 型の spec.inject 許可リストによって管理されます:

components:
api:
type: core/api
inject:
env:
- in: LITERAL_NAME
value: a-literal # the literal, delivered by the component's own block
features:
token:
type: core/token
inject:
env:
- in: TOKEN_NAME
from: name # a key the attachment's FeatureRecipe publishes

An inject: delivery is not a list of entries(インジェクションの配信がエントリのリストになっていない)

inject: ブロック内の各配信メカニズム(env、file、arg、またはそれらと並べて名前を付けたメカニズム)はエントリのリストであり、各エントリは in: と、from: または value: のちょうど一方を持ちます。名前からキーへのマッピングなど、それ以外のものを持つメカニズムはコンパイラが読み取れるものを何も配信しないため、破棄されるのではなく拒否されます。値がまったく書かれていないメカニズムは何も配信せず、拒否されません。

記述用スキーマはリストのみを認めるため、ファイルから読み込まれたドキュメントは、その種類のスキーマに一致しないドキュメントとして読み込み時に拒否されます。これはその検査を裏で支える検査です。2 つのドキュメントが解決される間に Aggregate と Release が持つすべての inject: ブロックを読み取るため、ファイル以外の経路で構築されたドキュメントも、配信が消えてしまうのではなく、そこから何かが構築される前に拒否されます。いずれかのドキュメントが持つすべてのブロックが対象です。Aggregate では、コンポーネント自身のブロック、アタッチメントのブロック、およびそのどちらかが描く接続上のブロック、Release では、そのアタッチメントが描く接続上のブロックです。

違反するメカニズムはそれぞれ個別の検出結果として報告され、それを記述したドキュメント内のそのメカニズムの位置が示され、メカニズムの名前が挙げられます。ビルド内のすべてが一度に報告されます。Aggregate の検出結果は Release の検出結果より先に報告されます。

出力されるメッセージ:

inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>")(inject の配信:形はエントリのリストでなければならず、各エントリは配信先と、ソースキーまたはリテラルのちょうど一方を持ちます)

位置は作成者が書いたキーのパスです。Aggregate では、コンポーネント自身のブロックは .spec.components.<component>.inject.<mechanism>、その接続の 1 つの上のブロックは .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism>、アタッチメントのブロックは .spec.components.<component>.features.<attachment>… で、コンポーネントやアタッチメントが宣言されている各サブシステムについて .subsystems.<name> が加わります。Release では、アタッチメントが描く接続上のブロックがそのアタッチメントを通じて示されます。バウンダリ全体にアタッチされたものは .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism>、コンポーネントにアタッチされたものは .spec.boundaries.<boundary>.components.<component>.features.<attachment>… で、ネストした各バウンダリについて .boundaries.<name>、コンポーネントが経由する各ルーティングエントリについて .aggregates.<module> が加わります。

対処方法: メッセージが示す各メカニズムをリストとして書きます。env: の下のエントリ DB_URL: host は - in: DB_URL となり、host が provides: キー(接続上では接続先のコンポーネントのもの、自身のブロック上ではコンポーネント自身のもの)を指す場合は from: host を、コンポーネント自身のブロック上でこちら側が与えるリテラルである場合は value: host を伴います。

The Feature filling an attachment slot does not satisfy the slot’s selector(アタッチメントスロットを埋める Feature がスロットのセレクタを満たしていない)

Component は、想定する Features のために名前付きのバインディングポイントを宣言し、スロットはそれを埋めるものの labels を制約する selector: を宣言できます。アタッチメントはスロットの名前を持つことでそのスロットをバインドします。その場合、アタッチメントが指定する Feature の labels がその制約と照合され、制約を満たさない充填はビルドを停止させます。制約を宣言していないスロットは、どの充填も受け入れます。

スロットを未バインドのままにしてよいかどうかは、別の対処法を持つ別の問題であり、上記の専用の停止で報告されます。この停止は充填が存在することを前提とし、その充填が許容されるかを問うものなので、未バインドのスロットは対象外です。

この一つの条件のもとで二つの結果が報告され、メッセージは最後の値の内容によってそれらを区別します。制約を満たさなかった充填の場合は、labels が一致しなかった Feature を示します。制約そのものを読み取れなかった場合は、代わりにその理由(ラベルマッチャーが評価できなかった式)を示します。これはアタッチされたものではなく、スロット自身の宣言の誤りです。

充填の labels が制約を満たさなかった場合に出力されるメッセージ:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them.(アタッチメントスロットのセレクターが満たされていません。スロットに宣言されたセレクターを、スロットを埋める Feature のラベルが満たしていません。スロットのセレクターが要求するラベルを Feature のラベルに追加するか、そのラベルをすでに持つ Feature でスロットを埋めてください。)

制約そのものを評価できなかった場合:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the component’s catalog entity.(アタッチメントスロットのセレクターが満たされていません。スロットに宣言されたセレクターを評価できませんでした。コンポーネントのカタログエンティティにあるスロット宣言のセレクターを修正してください。)

この指摘は、充填を記述したドキュメント内の充填のキーの位置に置かれ、そのドキュメントの作成者の責任として分類されます。Aggregate 内のコンポーネントの features: ブロックは開発者の誤りであり、Release だけが行う充填(そのコンポーネントのエントリ、またはそれを含むバウンダリ上)はオペレーターの誤りとして、Release 自身のパスで報告されます:

[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.

同じ充填を Aggregate 内のコンポーネントに記述した場合は [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity と報告されます。

ソケットが宣言するスロット(usesSchema エントリの featuresSchema 内)も、同じように各接続の充填をその selector: に照らします。接続がスロットに持つアタッチメントが制約と照合され、許容されない充填はビルドを停止させ、スロットに加えてソケットと接続も示します:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", filled on the connection "<alias>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them.(アタッチメントスロットのセレクターが満たされていません。ソケットのスロットに宣言され、接続上で埋められたセレクターを、スロットを埋める Feature のラベルが満たしていません。スロットのセレクターが要求するラベルを Feature のラベルに追加するか、そのラベルをすでに持つ Feature でスロットを埋めてください。)

この指摘は、充填を記述したドキュメント内の、その接続の features: 配下にあるアタッチメントのキーの位置に置かれます。Aggregate の接続エントリ、または Release だけが行う充填の場合は Release のエッジごとのエントリです。

文法が読み取れないスロットのセレクターは、何かがスロットを埋める前にも拒否されます。 aggrega validate は、カタログ全体に対しても、1 つの Component または Feature に対しても、そのエンティティ自身のドキュメントが宣言するすべてのスロットセレクター(Component 自身のスロット、そのソケットが宣言するスロット、Feature のスロット)を読み取り、何かがスロットを埋めているかどうかにかかわらず、文法が読み取れないものをこの同じ条件で拒否します。メッセージは上記の「評価できなかった」形式で、ソケットが宣言するスロットではソケットが追加されます:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the socket’s featuresSchema on the component’s catalog entity.(アタッチメントスロットのセレクターが満たされていません。ソケットのスロットで宣言されたセレクターを評価できませんでした。コンポーネントのカタログエンティティ上のソケットの featuresSchema で、スロットの宣言にあるセレクターを修正してください。)

Feature のスロットでは、対処法は代わりにその Feature のカタログエンティティを示します。まだ何もスロットを埋めていないため、不備はカタログエンティティにあります。CATALOG_ERROR として分類され、エンティティのファイルが示されます。

修正方法: 制約を満たさなかった充填の場合は、labels が制約を満たす Feature をアタッチするか(どの labels が求められているかはメッセージ内のセレクタが示します)、スロットを宣言している Component でそのスロットの selector: を広げてください。制約を評価できなかったとメッセージが示す場合は、セレクタ式が誤りです。Component のスロット宣言、またはソケットのスロット宣言で修正してください。

An attachment written under another name fits a slot its component leaves empty(別の名前で記述されたアタッチメントが、コンポーネントが空のままにしているスロットに適合する)

Component 自身のアタッチメント面は開かれています。どのスロットも宣言していない名前のアタッチメントは自由アタッチメントであり、正当です。ただし、その面上の一つの形は停止します。それは、スロット向けの充填が誤った名前で記述されたときにとる形だからです。一つのアタッチメントについて次のすべてが成り立つとき、ビルドは停止します:

  • コンポーネント自身に記述されている(Aggregate 内のコンポーネント自身の features: ブロック、またはその一つのコンポーネントに対する Release のエントリ);
  • その名前が、コンポーネントの型が宣言するスロットではない;
  • その Feature の labels が、型が宣言するスロットの selector: を満たす;
  • すべてのスコープが畳み込まれた後、そのコンポーネント上でそのスロットを何もバインドしていない。

放置すると、そのようなアタッチメントは自由アタッチメントとなり、本来意図したスロットは空のままです。そして空のままの任意スロットはビルドが成功し、何も配信しません。この規則は認証情報だけでなく、すべての Feature に適用されます。

面上のそれ以外はすべて自由なままです。Feature がどの宣言済みスロットにも適合しないアタッチメントはビルドされます。すでに何かがバインドしているスロットの横にある追加のアタッチメントも、適合する他のスロットが空のままでない限りビルドされます。サブシステムや Release のバウンダリからコンポーネントが継承するアタッチメントは判定されないため、共有の形(複数のコンポーネントが属するスコープで一度だけアタッチされた一つの認証情報で、どのコンポーネントもスロットを埋めていないもの)はビルドされます。selector: を宣言していないスロットはどの Feature 向けかを何も示さないため、この方法でアタッチメントがそのスロットに照らされることはありません。接続が持つアタッチメントもここでは判定されません。ソケットのスロットは閉じた集合であり、接続上のそれ以外の名前は「A connection carries an attachment under a name its socket declares no slot for(接続が、ソケットがスロットを宣言していない名前でアタッチメントを持っている)」で停止します。

出力されるメッセージ。条件の文が最初に来て、次にアタッチメントが記述された名前、コンポーネント、アタッチする Feature、適合する空のスロット、そして対処方法が続きます:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>"). Attach it as "<slot>" to fill the slot.(どのスロットも宣言していない名前で書かれたアタッチメントが、コンポーネントが空のまま残しているスロットに適合します。スロットを埋めるには、そのスロットの名前でアタッチしてください。)

Feature が複数の空のスロットに適合する場合、メッセージはコンポーネントの型が宣言する順にそれぞれを示し、選択を委ねます:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>", and the empty slot "<another-slot>"). Attach it under the name of the slot it is meant to fill.(どのスロットも宣言していない名前で書かれたアタッチメントが、コンポーネントが空のまま残しているスロットに適合します。埋める予定のスロットの名前でアタッチしてください。)

この指摘は、アタッチメントを記述したドキュメント内のアタッチメントのキーの位置に置かれ、そのドキュメントの作成者の責任として分類されます。Aggregate 内のコンポーネント自身の features: ブロック上のアタッチメントは .spec.components.<component>.features.<attachment> で開発者の誤りとして報告されます。Release だけが記述したもの(そのコンポーネントのエントリ上)はそこで、つまりコンポーネントを指定するバウンダリ配下の .spec.boundaries.<boundary>.components.<component>.features.<attachment> で、オペレーターの誤りとして報告されます:

[OPS_ERROR E0328] release.yaml at .spec.boundaries.main.components.app.features.metrics
attachment written under a name no slot declares fits a slot its component leaves empty ("metrics", on component "app", attaching the Feature "core/prometheus-exporter", which fits the empty slot "identity"). Attach it as "identity" to fill the slot.

空のスロット自体は、必須の場合には別の指摘となり、Aggregate 内のコンポーネントで「Required attachment slot not bound(必須のアタッチメントスロットがバインドされていない)」として報告されます。

ニアミスの勧告との違い。 「An attachment name is one edit from a declared slot(アタッチメント名が宣言済みスロットから 1 編集の距離にある)」の勧告は、名前の綴りに関するものです。アタッチメントの Feature がその selector: を満たさないスロットから 1 編集の距離にある名前が対象で、ビルドは成功して警告が報告されます。この停止は、名前にかかわらず Feature が何に適合するかに関するものです。名前は何でもよく、適合するスロットが空のままである必要があります。名前があるスロットから 1 編集の距離にあり、その Feature がそのスロットに適合する場合は勧告は出されず、スロットが空のままならこの停止が唯一の報告される指摘となります。

修正方法: スロットの名前でアタッチし、スロットを埋めてください。メッセージはスロット、または候補が複数ある場合はそのすべてを示します。本当に別のアタッチメントである場合は、スロットも埋めてください。適合するすべてのスロットがバインドされれば、追加のアタッチメントは自由だからです。または、複数のコンポーネントに届けることを意図している場合は、それらが属するサブシステムまたは Release のバウンダリでアタッチしてください。その Feature がそのスロットを決して埋めるべきでない場合は、スロットを宣言している Component でそのスロットの selector: を狭めてください。

An attachment delivers a key another inject source already claimed(アタッチメントが、別の inject ソースがすでに確保したキーを配信する)

三つの記述面が inject: ブロックを通じて一つのコンポーネントのインジェクションパイプに配信します。コンポーネント自身の inject: ブロック、その依存ブロックの各エントリ上の inject: ブロック、そしてアタッチされた各 Feature 上のブロックです。これらは配信メカニズムごとに一つのキー空間を共有するため、二つが同じキーを確保すると、どちらの値が届くかが曖昧になります。そのため、ある記述面が別の記述面を黙って置き換えることを許さず、ビルドは停止します。アタッチされた Feature は、その FeatureRecipe の injectMapping を通じて二つ目の方法でも配信できます。この経路はすべてのブロックが配信した後に同じ空間に合流し、下記の「Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping(アタッチされた二つの Features が一つのキーを配信し、後者がその FeatureRecipe の injectMapping を通じて配信している)」で報告されます。

この条件は、その空間におけるアタッチメントブロック側のものです。アタッチメント自身の inject: ブロックが、それ以前の配信がすでに保持しているキーを確保したときに報告されます。上記の「Duplicate delivery key across inject sources(inject ソース間で配信キーが重複している)」のエントリは同じ規則を開発者が記述する側から見たものであり、両者によってすべてのブロックの確保が網羅されます。

衝突した側を決めるのは順序です。 キーに対する最初の確保がそのキーを保持し、後の確保が報告されます。したがって、キーをすでに取られたアタッチメントにはそのことが伝えられますが、先に確保したアタッチメントには、何も置き換えなかった後の確保について伝えられません。何も配信しなかった確保はキーを空けたままにし、これには一切関与しません。

この指摘は、コンポーネントのブロック内のアタッチメント自身のエントリの位置に置かれ、そこが編集すべき位置です。メッセージは、キーと、そのキー空間が属するメカニズムを示します。衝突する各キーは個別に報告されるため、二つのキーを重複させているアタッチメントでは両方が示されます。

出力されるメッセージ:

duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>")(attachment-inject と別の inject ソースの間で配信キーが重複している)

修正方法: どちらの側も違反者ではなく、どちらも変更できます。管理している側のキーの名前を変更するか(Feature のマッピングはカタログドキュメントに記述されているため、多くの場合はコンポーネント自身の inject: エントリです)、二つの配信のうち一方を削除してください。アタッチメントが本当に値を供給することを意図している場合は、アタッチメント側ではなく開発者が記述した確保を削除してください。なお、Feature の FeatureRecipe の injectMapping がキーを書き込むのは別の経路であり、ここでは報告されません。コンポーネント自身の inject: ブロックまたはその接続の一つが配信したキーの書き換えはインターセプトであり一切報告されず、別のアタッチされた Feature が配信したキーへの書き込みは下記のエントリで報告されます。

Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping(アタッチされた二つの Features が一つのキーを配信し、後者がその FeatureRecipe の injectMapping を通じて配信している)

アタッチされた Feature は二つの経路でコンポーネントのインジェクションパイプに配信します。アタッチメント上に記述された inject: ブロックと、その FeatureRecipe の injectMapping です。後者の出力が配信キーを指定し、多くの場合、認証情報で選択された環境変数のようにアタッチメントが持つ値から決まります。アタッチされた二つの Features が一つの配信メカニズムのもとで一つのキーに到達し、そのうち後者がマッピングを通じて到達した場合、ビルドは停止します。そのまま実行すると、コンポーネントはたまたま最後に書き込まれた値を読むことになり、出力に何も示されないまま、ある認証情報が別の認証情報の代わりに提示されかねません。

これは、どこでアタッチされたかにかかわらず、すべてのアタッチされた Feature を対象とします。コンポーネント自身の features: ブロック、サブシステム、Release のバウンダリまたはコンポーネントエントリ、アノテーションの展開、そして接続の features: エントリです。二つの配信のうち先のものは、もう一方の Feature のマッピングでも、その inject: ブロックでもかまいません。ビルドはどちらの組み合わせもこの一つの条件のもとで報告します。

衝突した側を決めるのは順序です。 すべての inject: ブロックはどのマッピングがレンダリングされるよりも前に配信し、マッピングは一つの固定された順序でレンダリングされます。これは inject マッピングがコンポーネントのアタッチされた Features を巡回する順序で、コンパイルパイプラインで説明されています。したがって、キーに対する最初の配信がそのキーを保持し、後の Feature が報告されます。判断は存在のみによります。値は比較されないため、二つの Features が一つのキーに同じ値を配信しても報告されます。マッピングの出力がまったく持たないキーは配信ではありません。空の値で持つキーは配信です。空の値がそこにあったものを置き換えるからです。二つの異なる配信メカニズムのもとでの一つのキーは二つのキーであり、衝突ではありません。

報告されないもの。 FeatureRecipe の injectMapping が、コンポーネント自身の inject: ブロックまたはその接続の inject: ブロックの一つが配信したキーを書き換えるのはインターセプトであり(ホストを修飾するルーティング Feature や、アップストリームをリダイレクトするガードなど)、マッピングの値がその一つのエントリを置き換えます。Feature のマッピングが自身の inject: ブロックが配信したキーを書き換えるのは、その Feature が自身の配信を変換しているのであり、これも報告されません。

この指摘は、後の Feature 自身のエントリの位置に置かれます。コンポーネントの features: ブロック内、または接続が持つ Feature の場合は、それを記述したドキュメント内のその接続配下のエントリ(Aggregate 内の .spec.components.<component>.uses.<socket>.<alias>.features.<slot> など)です。メッセージは、キー、配信メカニズム、そして両方の Features をコンポーネント上で持つ名前で示します。接続が持つ Feature は、接続のエイリアスと埋めるスロットをドットでつないだ名前で示されます。衝突する各キーは個別に報告されます。

出力されるメッセージ:

duplicate delivery key across two attachments: an attachment’s FeatureRecipe writes a delivery key another attachment already delivered ("<key>", mechanism "<mechanism>", attachment "<attachment>", delivered first by attachment "<other-attachment>"). Give one of the two attachments a key of its own, or attach one fewer: the key this attachment delivers under is chosen by its FeatureRecipe, which can read the attachment’s own values and infra, and the other’s is chosen the same way or by its own inject block where it delivered through one. A Release sets an attachment’s infra and never its values, so where a key is chosen by a value, attach that attachment in the Aggregate with the value, and keep giving the rest from the Release.(2 つのアタッチメント間で配信キーが重複しています。あるアタッチメントの FeatureRecipe が、別のアタッチメントがすでに配信した配信キーを書き込みます。2 つのアタッチメントの一方に独自のキーを与えるか、アタッチメントを 1 つ減らしてください。このアタッチメントが配信に使うキーはその FeatureRecipe が選び、FeatureRecipe はアタッチメント自身の values と infra を読み取れます。もう一方のキーも同じ方法で選ばれるか、自身の inject ブロックを通じて配信した場合はそのブロックによって選ばれます。Release はアタッチメントの infra を設定しますが、values は決して設定しません。そのため、キーが値によって選ばれる場合は、そのアタッチメントを値とともに Aggregate でアタッチし、残りは引き続き Release から与えてください。)

修正方法: 二つの Features のうち一方に独自のキーを与えるか(認証情報の Feature の場合、通常はその values が指定するキーです)、二つのアタッチメントのうち一方を削除してください。両方が一つの変数を供給することを意図している場合は、コンポーネントがどちらを読むべきかを決め、そちらだけをアタッチしてください。Release が単独でアタッチする 2 つの認証情報は、Release がアタッチメントの values を書けないため、どちらもその Feature がデフォルトで指定するキーで届きます。一方を、そのキーを指定する値とともに Aggregate でアタッチし、同じエントリで Release からその取得元を与えてください。

A component declares an inject mechanism the attached Feature maps nothing to(コンポーネントが宣言したインジェクトメカニズムに、アタッチされた Feature が何もマッピングしていない)

Component の spec.inject 許可リストは、標準のもの以外の配信メカニズムを指定できます。これはコンポーネント自身の仕組みが理解するメカニズムであり、そこへ配信するものはすべてその値を生成する必要があります。このようなコンポーネントに Feature がアタッチされると、生成される各値がどのメカニズムで配信されるかを示すのは FeatureRecipe の injectMapping です。コンポーネントが宣言したのにマッピングがキーを生成しないメカニズムは、黙って実行されない配信になるため、代わりにビルドが停止します。

メカニズムについて何も述べないマッピングは、メカニズムがないと述べるマッピングではありません。 マッピングが配信のフラットな辞書としてレンダリングされる FeatureRecipe は、メカニズムについて何も主張しません。これは環境変数の配信を生成する Feature の通常の書き方です。評価するマッピングを持たない FeatureRecipe をバインドするアタッチメントも同様です。いずれもここでは報告されません。この条件は、メカニズムを指定しつつ、コンポーネントが宣言したものを省略しているマッピングのみを対象とします。

マッピングされていないメカニズムはそれぞれ個別の検出結果となるため、アタッチメントがどちらもマッピングしない 2 つのメカニズムをコンポーネントが宣言している場合は、両方が報告されます。検出結果は自身のファイル内のアタッチメントのエントリに位置付けられ、FeatureRecipe も示します。マッピングが記述されているのはそのドキュメントであり、まったく別の場所にあるためです。

出力されるメッセージ:

custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>")(カスタムのインジェクトメカニズムに一致するキーが injectMapping の出力にありません。メカニズムのキーを Recipe の injectMapping に追加してください)

修正方法: メッセージは両方を示しています。FeatureRecipe の injectMapping にメカニズムのキーを追加して Feature がその値を生成するようにするか、そのメカニズムで何も配信される想定がない場合は Component の spec.inject 許可リストからメカニズムを削除します。FeatureRecipe が他者のカタログに属する場合は、そのメカニズムをカバーするマッピングを持つ Feature をアタッチすることが 3 つ目の解決策です。

An attached Feature’s injectMapping output cannot be read(アタッチされた Feature の injectMapping 出力を読み取れません)

FeatureRecipe の injectMapping はテンプレートであり、その生成結果は YAML として読み取られます。配信メカニズム(env、file、arg、またはコンポーネント独自のメカニズム)をキーとする辞書か、環境変数の配信を並べたフラットな辞書のいずれかです。出力がそのどちらとしても読めない場合、そのキーはどれも配信できないため、ビルドは、アタッチされた Feature が何も配信しなかったかのようにコンポーネントをレンダリングするのではなく停止します。最も重要なのは認証情報の場合です。そうしなければ、受け取ることのなかったパスワードを期待するコンポーネントがパスワードなしで動作しかねず、出力にはそれを示すものが何もありません。

よくある原因は、テンプレートが値をそのまま引用符で囲んで記述していることです。値の中の二重引用符は引用符付きスカラーを途中で終わらせ、バックスラッシュは YAML が認識しない可能性のあるエスケープを開始するため、ほとんどの値で正しくレンダリングされるマッピングが、そのような文字を含む値(多くの場合パスワード)で壊れます。空の出力や、何も配信しない辞書として解析される出力は、この条件には該当しません。それは何も配信せず、そのことをそのとおりに示しているからです。

メッセージの上のフレームは、レンダリング中のコンポーネントを示し、続いて、コンポーネント上でアタッチメントが持つ名前と、マッピングが記述されている FeatureRecipe によってアタッチメントを feature "<attachment>" (recipe "<featurerecipe>") injectMapping output の形で示します。メッセージの下には、出力を読み取れなかった理由、つまり行と、YAML がそこで見つけたもの(yaml: line 2: found unknown escape character など)が示されます。テンプレートが作成者によって sensitive と宣言された値を読み取り、理由がその値の内容に依存する場合、理由は伏せられ、その旨を述べる文が代わりに示されるため、この停止が出力を壊した値を引用することはありません。マッピングは FeatureRecipe の作成者が記述するものであるため、ビルドはこの停止を CATALOG_ERROR タグで報告します。

出力されるメッセージ:

FeatureRecipe injectMapping output could not be read as a dictionary of deliveries(FeatureRecipe の injectMapping 出力を配信の辞書として読み取れませんでした)

修正方法: FeatureRecipe の injectMapping で、各値を toJson を通して記述します({{ .values.key }}: {{ .values.origin | toJson }})。こうすると値は JSON 文字列として記述され、どのような文字を含んでいても YAML がそのとおりに読み戻せます。FeatureRecipe が他者のカタログに属している場合は、マッピングが修正されるまで、二重引用符やバックスラッシュを含まないように値を変更することもできます。

An attached Feature’s injectMapping output writes deliveries under a key nothing delivers(アタッチされた Feature の injectMapping 出力が、何も配信しないキーの下に配信を記述しています)

FeatureRecipe の injectMapping 出力は、そのトップレベルのキーによってコンポーネントのインジェクションパイプにマージされます。env、file、arg はそれぞれのメカニズムとして配信され、それ以外のキーはその名前を持つ独自のメカニズムとして配信され、コンポーネントの Recipe はそれを .context.inject.<name> で読み取ります。all ビューは異なります。これはマージ後のメカニズムから構築され、出力からマージされることはないため、マッピングが all: の下に記述した値はどこにも届きません。出力自体は問題なく読み取れるため、この停止がなければ、それらの値を任意として読み取るビルドは値が欠けたまま成功します。そこに記述された認証情報はコンポーネントに届かず、ビルド内のどこにも、それを失ったマッピングを示すものがありません。

この条件は、all: が少なくとも 1 つのエントリを持つ場合に、単独であっても他のメカニズムと並んでいても適用されます。同じ出力内の他のメカニズムは問題ではなく、空で記述された all: は何も失わないため報告されません。たまたま all という名前のキーを単一の値とともに持つフラットな辞書は、all という名前の環境変数の配信であり、この条件には該当しません。

この検出結果は、自身のファイル内のアタッチメントのエントリに位置付けられ、キーと、マッピングが記述されている FeatureRecipe を示します(変更すべきドキュメントはそちらであり、まったく別の場所にあるためです)。あわせて、出力が持つことのできるキーも示します。そのようなキーはそれぞれ個別の検出結果になります。ビルドはこれを CATALOG_ERROR タグで報告します。

出力されるメッセージ:

FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads ("all", recipe "<featurerecipe>", an output may carry "env, file, arg, or a custom mechanism the host's Recipe reads under its own name")(FeatureRecipe の injectMapping 出力が、ホストのどの配信メカニズムも読み取らないキーを記述しています。recipe と、出力が持つことのできるキーも示されます)

修正方法: FeatureRecipe の injectMapping で、all: の下にあるエントリを、コンポーネントがそれらを読み取るメカニズムの下に移動します。通常は env:、またはコンポーネントの Recipe が読み取るメカニズムの名前です。FeatureRecipe が他者のカタログに属している場合は、代わりに、マッピングがその値を配信する Feature をアタッチしてください。

出力のレンダリング時

すべての契約が検証された後、コンパイラは Component の values、FeatureRecipe の injectMapping ブロック、および Recipe と FeatureRecipe のソースに対して Go テンプレートを評価し、その結果をレンダラーに渡します。

provides: template references a non-self-contained root (テンプレートが自己完結していないルートを参照しています)

Recipe の provides: テンプレートが、自己完結セットの外にあるルートを参照しています。provides ブロックは provides の評価時、つまり inject パイプがハイドレートされる前、かつノード間のエッジがたどられる前に評価されるため、参照できるのは自身のノードに属するデータだけです。すなわち .context.instance_id、ノードの provider が報告する場合の .context.rendered_name、.values、.infra、ノードの解決済みの .locals、および静的な文字列です。このチェックは肯定的な許可リストであるため、それ以外のルートはすべて停止します。.context.inject と .context.uses(ノード間)、.context.annotations.*、.context.labels、.context.metadata、.metadata.*(provides のサーフェスが公開しない、配置またはデプロイに結合したデータ)、そして .attachment_name(ベース Recipe の provides パスはアタッチメントを解決しません)です。これらのいずれかを参照すると、空の値を黙ってレンダリングするのではなく、明示的に停止します。

.locals はサーフェスに含まれます。ノードの locals は同じステージの前段で provides より先に解決されるため、provides テンプレートはそれを読み取り、解決済みの値を受け取ります。

出力されるメッセージ:

provides block references a root outside the self-contained set ("<expression>")

この停止は、エントリを宣言している Recipe と、その中の記述されたキー .spec.provides.<name> に位置づけられます。そのため、Recipe をバインドした component ではなく、編集すべきブロックを示します。サーフェスの外に及ぶエントリはすべて同じビルドで報告されます。複数ある場合、検出結果は provides entries that reach outside the data they are evaluated against の下にまとめられます。

修正方法: Recipe 自身の柱だけから値を取得するようにテンプレートをリファクタリングします。値が別のノードの出力に依存する場合、その依存はターゲットの provides ではなく、呼び出し側の uses[].inject ブロックに置くべきです。値が計算によるものであれば、式を locals: エントリに置き、provides からそれを読み取ります。これで式は一か所にまとまります。名前空間をまたぐホストを組み立てるためにデプロイ先の名前空間(またはその他の配置データ)を参照しようとしていた場合は、ここでは素のホストを公開し、利用側でルーティング用の feature によって修飾します。プロデューサーの provides は、デプロイ先に依存してはなりません。

FeatureRecipe の provides: も同じ locals のルールに従います。自身の locals: は provides: より先に解決されるため、FeatureRecipe の provides エントリも .locals を読み取れます。

locals: entry references a sibling defined later in the same block (エントリが同じブロック内で後に定義される兄弟エントリを参照しています)

locals: ブロックはエントリが記述された順に解決され、エントリが読み取れるのは自身より上で定義された兄弟だけです。ブロックが後で定義するエントリへの直接の .locals.<key> 参照は停止します。コンパイラは参照を解決させるためにブロックをソートしたり並べ替えたりすることはありません。そうすると、出力が記述された内容ではなく推論に従うことになるからです。停止がなければ、その参照は欠落キーのポリシーによって空文字列に解決され、派生したホスト名やシークレット名が、組み立ての元になったセグメントを黙って失うことになります。

この障害は locals: ブロックの両方の解決で判定され、そのうちの一方はピン留めです。 ブロックは二つの異なる目的で解決されます。アーティファクトのレンダリング中に Recipe 自身のテンプレートがそれを読み取るため、そして構造化された source: 座標を解決し、それが示すアーティファクトをピン留めするためです。障害は宣言されたキーの順序と記述されたテキストから判定され、必要なのはそれだけなので、両方の解決がこれに到達し、同じ状態を報告します。aggrega pull も、ロックファイルを埋めるビルドも、レンダリングとまったく同じようにこのブロックを拒否します。記述時に知っておくべき帰結が二つあります。座標の解決中にはブロックの全体が読み取られるため、source: のすべてのフィールドがリテラルで local を読まない場合でも、順序の誤ったエントリは停止します。また、source: が単なる文字列である Recipe、あるいは source: をまったく宣言しない Recipe は座標を解決しないため、その Recipe では出力のレンダリング時に障害が報告されます。

component の Recipe 自身の locals: ブロック内のエントリの場合に出力されるメッセージです。Recipe 内の記述されたキーに位置づけられ、問題のあるエントリはすべて一度のビルドで報告されます。複数ある場合、検出結果は locals entries that read a sibling they cannot の下にまとめられます:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<referenced>", resolved at this point "<the locals available here>", reached through the component "<component>"). define "<referenced>" above "<key>" in the locals block

自己参照も同じ状態です(キーは宣言されているが未解決)。並べ替えでは修正できないため、メッセージは移動の指示の代わりにその旨を示します:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly

一つの Recipe は多くの component にバインドされるため、共有ブロック内の一つの誤りは、それをバインドする component ごとに一度ずつ報告されます。それらの検出結果を区別するのが reached through the component です。 これらは同じドキュメント内の同じ記述済みエントリに関するものなので、位置は共通です。位置は編集する場所を、component 名は各検出結果がどの component に対応するかを示します。検出結果は一つにまとめられません。まとめると、何かが誤っていることは伝わっても、それがどの component に及ぶかが伝わらず、対処に必要なのはまさにその部分だからです。

Feature の recipe が宣言する locals: ブロックにおける同じ障害も、同様に報告されます。その recipe 内の記述されたキーに位置づけられ、アタッチメントが置かれた component によって示され、同じ障害を持つ兄弟エントリとまとめられます。recipe が複数の場所にアタッチされている場合、障害はそれぞれについて一度ずつ報告されます。各アタッチメントはそのブロックを独立にバインドするため、それぞれが一つの繰り返しではなく個別の発生となります。

その形式が自己参照を報告する場合、位置の句は後のエントリではなく参照しているエントリ自身を示します。キーがあるのはそこだからです。

修正方法: 参照されているエントリを、それを読み取るエントリより上に移動します。あるエントリが別のエントリを読み取る場合、locals: ブロックの並べ替えは動作の変更になるため、修正はメッセージが示す並べ替えそのものです。自己参照(エントリが自身のキーを示すもの)は並べ替えでは修正できません。代わりに .values と .infra から直接値を計算します。メッセージは移動の指示の代わりにこの旨を示します。

locals: key does not exist(locals のキーが存在しない)

テンプレートが、locals: ブロックでまったく宣言されていないキーに対して .locals.<key> を読み取っています。綴りの誤り、または名前が変更されたか削除されたキーです。このピラーを読み取るすべてのサーフェスがこの停止を発生させます。対象は locals: エントリ、provides: テンプレート、Recipe の source: テンプレート、そして構造化された source: 座標の解決です。座標の解決では、座標が指すアーティファクトをピン留めするためにブロック全体を読み取ります。locals ピラーはキー付きのオープンなマップであるため、その下の未知のキーはルートのチェックを通過し、停止がなければ空文字列に解決されます。この停止によって、その空の値が出力されるアーティファクトに到達することを防ぎます。

問題の参照が provides: テンプレート内にある場合に出力されるメッセージ:

template references a key the locals block does not declare (Recipe <recipe> provides[<key>] references <expression>, the locals block declares no <referenced>, it declares <the keys it does declare>). correct the key name(テンプレートが、locals ブロックで宣言されていないキーを参照しています。キー名を修正してください)

参照が locals: エントリ自体の中にある場合に出力されるメッセージです。上記の順序に関する停止で述べた理由により、ブロックがバインドされた経由のコンポーネントを含みます。共有された 1 つのブロックは、それをバインドするコンポーネントごとに 1 回ずつ報告され、これによってそれらの検出結果が区別されます:

template references a key the locals block does not declare ("<expression>", the missing key is "<referenced>", the block declares "<the keys it does declare>", reached through the component "<component>"). correct the key name(テンプレートが、locals ブロックで宣言されていないキーを参照しています。キー名を修正してください)

修正方法: キー名を、ブロックが宣言しているものに修正します。宣言されているキーはメッセージに一覧表示されます。この停止が上記の順序に関する停止と別になっているのは、対処法が異なるためです。存在しないキーは、どのように並べ替えても解決されません。

このチェックは参照のキー入力ではなく、参照が解決されるパスを読み取るため、ブロックの別名もたどります。with .locals の本体が再バインドするドットを経由して到達するキーや、.locals にバインドされた変数を経由して到達するキーも、直接の記述とまったく同じ条件でチェックされ、同じように停止します。括弧で囲んだブロックから読み取るキー({{ (.locals).nope }} や {{ ($.locals).nope }})も同様です。括弧が返すのはブロックそのものであり、それ以上のものではないためです。チェックを逃れる記述は 1 つだけです。テンプレートのテキストからは結果を特定できない呼び出しを経由して到達するキー({{ index .locals "nope" }} や {{ (default dict .locals).nope }})です。このような呼び出しが返すものは、記述内容ではなくテンプレートの実行時に決まるためです。このような呼び出しの結果からフィールドとして読み取った存在しないキー((default dict .locals).nope の形)は停止せず、テンプレートエンジンのプレースホルダーテキスト <no value> を出力します。index を経由して到達した存在しないキーは停止しますが、このチェックとしてではなく、後述の「A template indexes a map with a key the map does not hold(テンプレートがマップに存在しないキーでマップをインデックス参照しています)」として停止します。index は、マップに存在しないあらゆるマップキーで停止するためです。したがって、名前自体が計算されるキーに到達する方法としては引き続き index を使用でき、ブロックで宣言されていない計算された名前は、そのキーによって報告されます。

Template references a root the render context does not define(テンプレートがレンダーコンテキストで定義されていないルートを参照している)

テンプレートが、レンダーコンテキストで定義されていないトップレベルのルート(先頭のドットの後にある最初のパスセグメント)を参照しています。{{ .valeus.port }} のような綴りの誤りや、記述中のサーフェスに存在しないルートが該当します。このチェックはルートの名前に対するポジティブな許可リストであり、許可される集合はレンダーコンテキスト自体の形から導出され、別のリストとして並べて管理されることはありません。そのため、ビルドが拒否する集合とコンテキストが実際に提供する集合が食い違うことはありません。診断は問題の参照を示し、そのコンテキストが定義するルートを列挙します。

この停止は、参照がそのまま書かれていても、default、if、with、range のフォールバックで囲まれていても同じように発生します。そして重要なのは囲まれた書き方のほうです。ラッパーは定義済みルートの下にないキーに対してはフォールバックを提供できますが、存在しないルートに対しては決して提供できません。この停止がなければ、囲まれた形は何も知らせずに空の値へ解決され、ビルドが正常に完了してしまいます。定義済みルートの下にキーがない場合は影響を受けず、後述の「Missing template key — asymmetric policy(テンプレートキーの欠落 — 非対称ポリシー)」で説明する値テンプレートの missingkey=zero ポリシーに引き続き従います。そのため、{{ .values.optional_field | default "fallback" }} のような省略可能なキーのイディオムは引き続き動作します。

同じ停止は、形が宣言されたピラーの下にある 1 階層下のキーの入力ミスにも適用されます。 一部のピラーは、コンパイラが定義するキー集合を持ちます。Recipe と FeatureRecipe のレンダーコンテキストにおける .context、.metadata、.inject、.workload、.boundary、およびパステンプレートにおける .manifest です。これらのピラーが定義していないキーへの参照({{ .context.nmae }}、{{ .metadata.typo }}、{{ .workload.containres }}、{{ .boundary.nmae }})は、誤ったルートと同じように停止し、診断はそのピラーが定義するキーを列挙します。Feature のアタッチメント自身のテンプレートでは、.inject は env、file、arg、all に加えて、アタッチメント自身の inject: ブロックが指定する配信メカニズムごとにキーを 1 つずつ追加で定義します。vault_ref: メカニズムを書くアタッチメントは {{ .inject.vault_ref.VAULT_PATH }} で読み取られ、診断は .inject が定義するキーの中に .inject.vault_ref を挙げます。アタッチメントが指定していないメカニズムは、if や with の内側であっても停止します。参照はテンプレートの実行前に検査されるためです。アタッチメントが指定していない可能性のあるメカニズムを読むには、次のようにガードしてください:{{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}。このガードされた組み合わせは、アタッチメントがそのメカニズムを指定しているかどうか、また inject: ブロックをそもそも書いているかどうかにかかわらず、ビルドに成功します。その場合 .inject は何も保持しないので with は本体をスキップしますが、.inject に直接 hasKey を適用すると、マップではない値に対して停止します。ガードの内側でも、index は指定されたメカニズムが保持しないキーに対しては停止します。その他のピラーはオープンです。保持するものが、コンパイラが宣言する集合ではなくキー付きのデータだからです。レンダーコンテキストの .values、.infra、.locals、.provides、.features、.steps、およびパステンプレートの .parameters と .parent_boundary などが該当します。オープンなピラーは任意のキーを受け付けます。オープンなピラーの下にキーがない場合はこの停止にはならず、後述の「Missing template key — asymmetric policy(テンプレートキーの欠落 — 非対称ポリシー)」で説明するサーフェスの欠落キーポリシーに従います。そのため、{{ .values.optional_field | default "fallback" }} をはじめとする省略可能なキーのイディオムは引き続き動作します。

どのピラーが宣言済みでどのピラーがオープンかはサーフェスの性質であり、テンプレートが左右できるものではありません。コンパイラは、これから提供するレンダーコンテキストの形からそれを読み取ります。これにより、同じテンプレート上で入力ミスによる停止と省略可能なキーのレンダリングが両立します。

サーフェスは、ピラーが本来定義しているキーを絞り込むこともあり、その報告は綴りの誤りではありません。 あるキーが特定のサーフェス上で意味のない値、あるいは別のノードに属する値を持つ場合、そのサーフェスは誤ったものに解決する代わりに参照を拒否し、診断は定義しているキーを列挙します。知っておくべきケースが 2 つあり、どちらも {{ .context.rendered_name }} です。Feature アタッチメント自身のテンプレートでは、このキーはホストの provider 自身が報告するホスト component の名前を持ちます。そのため、provider が名前を報告しないホスト(アーティファクトセットのみを配置するホストや、そのような名前を導出しない provider でレンダリングするホスト)のアタッチメントでは拒否され、それ以外のすべてのホストでは許可されます。{{ .context.instance_id }} はそのサーフェスで許可され、アタッチメントが解決対象とするホスト component を示します。そのようなホストでは、ホスト自身のリソースはこの名前にちなんで命名されます。Recipe の locals: エントリでは、ノードの provider が何を報告しても、このキーは拒否されます。local は Recipe の source: テンプレートとコンテキストを共有しており、ノードがソースを提供するかどうかは名前が依存する要素の一つであるため、そこでは名前が提供されません。診断は .context.instance_id を、そこで .context が定義する唯一のキーとして列挙します。レンダリングされた名前は、代わりに provides: エントリまたはインラインテンプレートで読み取ってください。2 つのキーがそれぞれ何を示し、どこで読み取れるかについては ../templates/rendered-resource-names.md を参照してください。

ルート自体が定義されていない場合に出力されるメッセージ:

template references a root the render context does not define (template <template-name> references <dotted-path>, the render context defines <the roots that context defines>)(テンプレートが、レンダーコンテキストの定義していないルートを参照しています)

また、ルートは正しいものの、宣言済みピラーの下のキーが正しくない場合:

template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>)(テンプレートが、レンダーコンテキストの定義していないルートを参照しています)

修正方法: 参照を診断が列挙するものに修正します。ほとんどの報告は、.values、.infra、.context の綴りの誤り、または .context や .metadata の下のキーの綴りの誤りです。フォールバックラッパーを取り除いても停止は解消されず、ラッパーを追加しても抑止されたことはありません。ラッパーは、どの参照が誤っていたかを隠していただけです。データが本当に別のノードに属する場合、独自のルートを通すのではなく、inject パイプを通じてこのテンプレートに届けます。コンシューマ側で uses[].inject エントリによって配線し、.context.inject から読み取ってください。

このチェックは、レンダラーが評価するすべてのテンプレートサーフェスを、それぞれのサーフェスが定義する参照集合に照らして対象とします。Recipe と FeatureRecipe の valuesMapping、injectMapping、workload、artifacts: の本体、provides: と locals: のエントリ、source:、pipeline ステップの when: と with: の本体、assertions:、Aggregate 内の component レベルの self-inject value: テンプレート、そして Release の boundary パステンプレート(directory: / subDirectory:)です。これらのサーフェスのうち 2 つは、一部の拒否を独自の診断で示します。その誤りが「この参照は存在しない」よりも具体的だからです。パステンプレートが与えられていない変数を参照する場合は後述の「Path-template references a variable outside the allowlist」が扱い、boundary スコープの FeatureRecipe がコンポーネントごとのピラーを参照する場合は「FeatureRecipe template references a field outside its scope’s allowlist」が扱います。これら 2 つのサーフェスが拒否するそれ以外のもの(許可しているピラーの下のキーの入力ミスを含む)はこの停止として報告されるため、参照の実態と異なる内容を伝える診断はありません。

An artifacts: template reads a pillar the Recipe does not declare(artifacts テンプレートが Recipe の宣言していないピラーを読み取っています)

artifacts: エントリのテンプレートが、workload: を宣言していない Recipe で .workload またはその下のキーを読み取っているか、source: を宣言していない Recipe で .source またはその下のキーを読み取っています。どちらのピラーも artifacts のレンダーコンテキストには常に存在し、そのサーフェスが定義するルートです。したがって参照自体は正しい形式であり、このハルトは参照が誤っていることではなく、宣言 が存在しないことに関するものです。合成された workload から Deployment をレンダーする Recipe と、source から chart をレンダーする Recipe は異なる形であり、一方のために書かれた artifacts: 本体は、もう一方が決して埋めないピラーを参照します。

このチェックはエントリが評価される前に実行され、その順序こそがレポートを有用にしています。存在しないピラーはテンプレートに空の値として届くため、評価に任せた場合、ビルドは出力ファイルに何も埋め込まないか、何もないところからキーを読み取ることについてテンプレートエンジンが出すエラーで失敗するかのどちらかになり、いずれもピラーや欠けている宣言を示しません。先に拒否することで、ハルトはピラーを参照した正確な式を、記述されたとおりに引用して示せます。

宣言されていても空文字列にレンダーされる source: は、source がまったくないものとして扱われます。チェックが読み取るのは、source 自身のテンプレートが評価された 後 の source だからです。これはプロバイダがその後レンダーに使う値と同じであるため、source: が何も解決しなかった Recipe には、artifacts: 本体に提供できる source もありません。

出力されるメッセージは、artifacts: エントリがどこに書かれていても同じ形です。変わるのは文ではなくその後に続くキャプションで、エントリを保持しているドキュメントを示します。

テンプレート内の問題のある参照は すべて 示されるため、存在しない 2 つのピラーを参照する本体については、最初の 1 つだけでなく両方が報告されます。各参照は、エントリを宣言しているドキュメントに対して報告され、記述されたとおりに引用され、所属する出力のキャプションが付きます:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>)(アーティファクトテンプレートが、Recipe の宣言していないピラーを参照しています)

式の最初のセグメントがピラーを示しており、それによってどの宣言が欠けているかがわかります。.source.chart は source: を、.workload.containers は workload: を参照しています。

component 自身の Recipe が宣言するエントリ は、その Recipe の artifacts: ブロックに対して報告されます。

FeatureRecipe が宣言するエントリ(feature として component にアタッチされたもの、またはバウンダリで宣言されたもの)は、ホスト component のピラーではなく その FeatureRecipe が宣言するピラーに対してチェックされ、FeatureRecipe の artifacts: ブロックに対して報告され、それをバインドするアタッチメントを示すキャプションがもう 1 つ付きます:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>)(アーティファクトテンプレートが、Recipe の宣言していないピラーを参照しています)

アタッチメントのキャプションは、位置だけでは示せないことを示します。component は複数のアタッチメントを持つことがあり、バウンダリで宣言されたアタッチメントはそのバウンダリが保持するすべての component に及ぶからです。文自体はどちらの経路でも Recipe を示します。どのドキュメントを開くべきかは、位置とアタッチメントのキャプションを合わせて判断します。

1 つのテンプレートが複数の参照を示す場合、それぞれの参照は、共有するエントリを示す行の下に個別のレポートとして出力され、その行はドキュメントも示します:

artifact <output-name> references pillars its Recipe does not declare(このアーティファクトは、その Recipe が宣言していないピラーを参照しています)

artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare(このアーティファクトは、アタッチメントがバインドする FeatureRecipe の宣言していないピラーを参照しています)

これらのレポートはいずれも、どのドキュメントに関するものであっても同じハルト条件を持つため、テキストではなく条件でマッチするものからは区別がつきません。

修正方法: テンプレートが読み取るピラーを宣言するか、読み取るのをやめます。artifacts: 本体がその Recipe の形に属する場合は宣言するのが修正です。テンプレートのコンテナ、ポート、ボリュームの参照が想定する workload:、またはテンプレートが埋め込む chart やモジュールのパスを持つ source: を追加します。本体が別の Recipe 向けに書かれ、ここには当てはまらない断片を再利用している場合は、参照を削除するのが修正です。値が本当に別の場所から来る場合は、生成側ノードの provides: で公開し、この Recipe が埋めないピラーを参照する代わりに inject パイプから読み取ります。フォールバックラッパーで参照を保護してもハルトは解消されません(欠けているのはその下のキーではなくピラーです)。参照を同じ Recipe 内の別のエントリに移しても解消されません。1 つの artifacts: ブロック内のすべてのエントリは同じピラーに対して評価されるからです。

このハルトは上記の「Template references a root the render context does not define(テンプレートが、レンダーコンテキストが定義していないルートを参照している)」とは別のものであり、対処法が異なるため両者を区別することが重要です。あちらは、サーフェスがまったく定義していないルート、または形が固定されたピラーの下の誤入力されたキー(workload を 宣言している Recipe での {{ .workload.containres }} など)で発生します。こちらは、単に存在しないピラーへの正しく綴られた参照で発生します。

A template reads a rendered name the node’s provider does not report(テンプレートが、ノードの provider が報告しないレンダリング名を読み取っている)

テンプレートが {{ .context.rendered_name }}(バインドされた provider が、作成者の提供したソースまたは合成したワークロードから、そのノードのためにレンダリングする出力に付ける名前)を読み取っていますが、そのノードの provider はそのような名前を報告しません。参照は正しい形式であり、キーもレンダーコンテキストが定義するものです。欠けているのは、このノードに対する答えです。

この拒否が存在するのは、代替の挙動が停止よりも悪いためです。名前はプレーンな文字列としてテンプレートに届くため、名前を持たないノードでは参照が空にレンダリングされ、セグメントが 1 つ欠けたアドレス(ホスト名を意図した箇所に .svc.cluster.local)が終了コード 0 で出力され、ビルドには読み取れる手がかりが何も残りません。その成果物はデプロイされますが、それが指すものは存在しません。何かを評価する前に拒否することで、代わりに作成者が書いたテンプレートに対して不具合が報告されます。

ノードの provider がそのような名前を報告するかどうかは、すべての評価に先立って Recipe のバインディングによって確定するため、ここで推測されるものは何もありません。

報告は 2 種類あり、どちらになるかは参照を書いた場所ではなくノードによって決まります。 独自のソースを提供せず、名前を報告しない provider の下にあるノードは、リソースがその識別子にちなんで命名されるため、正しい値が存在し、報告はそれを示します。ソースを提供し、名前を導出しない provider の下にあるノードには代替がありません。そこで識別子を提示すると、そのノードのどのリソースも指さない値へ誘導することになるため、報告は代わりにその旨を伝えます。

ノードが独自のソースを提供しない場合に出力されるメッセージ:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). read {{ .context.instance_id }} instead: this node supplies no source of its own, so its resources are named after the node’s identity(テンプレートは、ターゲットがノードのためにレンダリングするリソースに付ける名前を読み取っていますが、このノードの provider はそのような名前を報告しません。準拠するテンプレートは、ノード自身の provider が提供する値を読み取ります。代わりにインスタンス ID を読み取ってください。このノードは独自のソースを提供しないため、そのリソースはノードの識別子に基づいて命名されます)

そして、ソースを提供し、そのような名前を導出しない provider の下にある場合:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). write a value that does not depend on a name this target derives: it reports none for the output it renders from supplied source, so there is nothing of that kind to read here(テンプレートは、ターゲットがノードのためにレンダリングするリソースに付ける名前を読み取っていますが、このノードの provider はそのような名前を報告しません。準拠するテンプレートは、ノード自身の provider が提供する値を読み取ります。このターゲットが導出する名前に依存しない値を記述してください。このターゲットは、提供されたソースからレンダリングする出力については名前を報告しないため、ここで読み取れるその種の値はありません)

参照が provides: エントリ以外のテンプレートにある場合、報告はさらに、それが書かれたフィールド(field "valuesMapping"、field "artifacts[probe.tf.json]")も示します。artifacts: エントリのキーは出力ファイル名であり、位置情報が自身のセグメントの区切りに使う文字を含むため、位置情報はエントリを保持するブロックまでで止まるからです。

対象となるテンプレート: Recipe がインラインで書くすべてのテンプレート、つまり provides: エントリ、valuesMapping:、workload: 本体、各 artifacts: エントリ、および各パイプラインステップの with: と when: です。対象外のテンプレート面が 1 つあります。$import: で提供される valuesMapping:、workload:、artifacts: エントリは、インポートがローカルファイルを指すかライブラリエントリを指すかにかかわらず、レンダリングで解決されるまで Recipe 内にテキストを持たないため、そのような本体内の参照は停止せずに空の値としてレンダリングされます。

修正方法: 報告が示すキーを読み取ってください。ノードの出力が、名前を報告しない provider の下でそのノードのために構築されたもの(合成されたワークロード、配置された成果物セット)である場合、{{ .context.instance_id }} がそれらのリソースが実際に持つ名前であり、フォールバックではなく正しい値です。ノードが独自のチャートやモジュールを提供し、報告が代替を示さない場合、求めていた名前はその provider が導出するものではありません。それに依存しないものを公開するか、提供したソース内でリソースに名前を付け、設定した値からその名前を読み戻してください。../templates/rendered-resource-names.md では、どの provider が名前を報告するか、またそれ以外の provider それぞれについて報告すべき名前が存在しない理由を説明しています。

A template reads its callers’ render facts without declaring it(テンプレートが、宣言せずに呼び出し元のレンダーファクトを読み取っている)

コンポーネントにアタッチされた FeatureRecipe 内のテンプレートが .context.used_by 配下の render_facts(アタッチメントのホストに接続するコンポーネントが自身のレンダリングについて報告した内容)を読み取っていますが、その FeatureRecipe は readsCallerRenderFacts: true を設定していません。

このキーは、アタッチメントがいつレンダリングされるかを決めます。キーがない場合、アタッチメントはアタッチ先のコンポーネントの直後にレンダリングされ、ビルドの順序で後に来る接続元コンポーネントはその時点ではまだレンダリングされていないため、それが出力したものは読み取れません。何かをレンダリングする前にテンプレートを拒否することで、一部の呼び出し元の出力だけを読み取り他を読み取らないテンプレートを持つビルドの代わりに、書いたフィールドに対して宣言の欠落が報告されます。

出力されるメッセージ:

template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>)(テンプレートは呼び出し元の render facts を読み取っていますが、FeatureRecipe は readsCallerRenderFacts を設定していません)

参照は、読み取り元の接続を基準として引用されます(.render_facts または .render_facts.<name>)。テンプレートは呼び出し元を 1 接続ずつ、{{ range .context.used_by }} の内側で、または選んだ 1 つの接続から読み取るためです。フィールドは、テンプレートが書かれたブロック(valuesMapping、workload、artifacts[<output-name>])を示します。パイプラインステップの with: や when: が同じファクトを読み取る場合は、FeatureRecipe の設定にかかわらず、代わりに次のエントリによって報告されます。キーを設定してもステップがそれを読み取れるようにはならないためです。複数のフィールドがファクトを読み取る場合は、共通点を示す行の下に、それぞれ個別の報告が出力されます:

attachment templates reading their callers’ render facts without declaring it(宣言せずに呼び出し元のレンダーファクトを読み取っているアタッチメントテンプレート)

修正方法: FeatureRecipe の spec に readsCallerRenderFacts: true を設定してください。これにより、そのアタッチメントはすべてのコンポーネントがレンダリングされた後にレンダリングされ、レンダリング内容については何も変わりません。FeatureRecipe エンティティのページを参照してください。キーこそが契約であり、この停止はキーを明らかに必要とするテンプレートを見つける手助けにすぎません。チェックは書かれたとおりのテンプレートを読むため、テンプレートの実行中に組み立てられる参照や、ファイルやライブラリからインポートされたコンテンツ内に書かれた参照は停止しません。そのような FeatureRecipe にも同様にキーを設定してください。.context.used_by と並んで別のリストから render_facts という名前のフィールドを読み取るテンプレートも停止し、その隣で {{ with .context }} の内側でホスト自身のファクトを .render_facts として読み取るテンプレートも停止します。ホスト自身のファクトは .context.render_facts と完全に書いてください。こう書けば呼び出し元のものと見なされることはありません。キーを設定すれば、レンダリングが後になること以外のコストなしにどちらも解消されます。

境界に対して 1 回だけレンダリングされる FeatureRecipe(executionScope: boundary)はここではチェックされません。そのリソースを生成するテンプレートには読み取る .context がなく、それへの参照は代わりにスコープの許可リスト外のフィールドとして拒否されます。

A pipeline step reads its callers’ render facts(パイプラインステップが呼び出し元のレンダーファクトを読み取る)

component にアタッチされた FeatureRecipe 内のパイプラインステップの with: または when: が、.context.used_by の下にある render_facts(アタッチ先ホストに接続している component が自身のレンダーについて報告したもの)を読み取っています。

パイプラインステップがそれらの接続を参照することはありません。ステップはホスト component 自身のドキュメントを書き換えることがあり、component 自身の出力は誰が接続しても変わらないため、ステップのテンプレートは .context.used_by なしで評価されます。これは readsCallerRenderFacts: true を設定しているかどうかにかかわらず、すべての FeatureRecipe に当てはまります。このキーが決めるのはアタッチメントがいつレンダーされるかであり、ステップが何を参照するかではありません。したがって呼び出し元のファクトを読み取るステップは何も読み取れないことになり、その読み取りを空の値としてレンダーする代わりに、何かがレンダーされる前にビルドが停止します。

出力されるメッセージ:

pipeline step reads its callers’ render facts, but a pipeline step does not read the components connecting to its host; it reads only the host’s own render facts (<reference>, written in <field>)(パイプラインステップが呼び出し元のレンダーファクトを読み取っていますが、パイプラインステップはホストに接続している component を読み取りません。読み取るのはホスト自身のレンダーファクトのみです)

参照は、上のエントリと同様に、読み取り元の接続を基準として .render_facts または .render_facts.<name> の形で引用されます。field はステップをその id で示します:pipeline[<step>].with または pipeline[<step>].when。複数のステップがファクトを読み取る場合、共通点を示す行の下に、それぞれ個別のレポートが出力されます:

pipeline steps reading their callers’ render facts(呼び出し元のレンダーファクトを読み取るパイプラインステップ)

修正方法: ステップでは、ホスト自身のレンダーファクトを .context.render_facts と省略せずに書いて読み取ります。これはホスト自身のレンダーから得られるため、読み取っても誰が接続するかに依存するものは生じません。呼び出し元のファクトは、代わりにアタッチメント自身のリソースを生成するテンプレート(valuesMapping:、workload:、artifacts:)で、readsCallerRenderFacts: true を設定したうえで読み取ります。詳しくは FeatureRecipe エンティティのページを参照してください。キーを設定するだけではこの停止は解消されません。チェックは書かれたとおりのテンプレートを読み取り、上のエントリで説明した制限があります。テンプレートの実行中に組み立てられる参照や、ファイルまたはライブラリからインポートされた内容に書かれた参照では停止しません。また、.context.used_by の隣にある別のリストから render_facts という名前のフィールドを読み取るステップや、その隣の {{ with .context }} 内でホスト自身のファクトを .render_facts として読み取るステップも停止します。

boundary に対して一度だけレンダーされる FeatureRecipe(executionScope: boundary)は、上のエントリで述べた理由により、ここではチェックされません。

A template reads its targets’ render facts without declaring it(テンプレートが宣言なしにターゲットのレンダーファクトを読み取る)

component にアタッチされた FeatureRecipe 内のテンプレートが、.context.uses の下にある render_facts(アタッチ先ホストが接続している component が自身のレンダーについて報告したもの)を読み取っていますが、FeatureRecipe が readsTargetRenderFacts: true を設定していません。

このキーは 2 つのことを決めます。1 つは、すべての component がレンダーされた後にアタッチメントをレンダーさせることです。キーがなければ、アタッチメントはアタッチ先の component の直後にレンダーされ、ビルドの順序で後に来るターゲットはその時点でまだレンダーされていません。もう 1 つは、アタッチメントが読み取る接続に各ターゲットのファクトを載せることです。キーがなければ、.context.uses のどのエントリにも .render_facts はまったく含まれません。何かがレンダーされる前にテンプレートを拒否することで、ターゲットのファクトを期待した箇所でテンプレートが何も読み取れないビルドになる代わりに、記述したフィールドに対して宣言の欠落が報告されます。

出力されるメッセージ:

template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>)(テンプレートがホストの接続先 component のレンダーファクトを読み取っていますが、FeatureRecipe が readsTargetRenderFacts を設定していません)

参照はテンプレートが記述したとおりのものです。1 つの接続のエイリアスの下に省略せずに書いた .context.uses.<alias>.render_facts または .context.uses.<alias>.render_facts.<name>、あるいはテンプレートが接続を 1 つずつ読み取る場合は {{ range .context.uses }}、{{ with .context.uses.<alias> }} の内部、または選んだ 1 つの接続から、その接続を基準とした .render_facts または .render_facts.<name> です。field はテンプレートが記述されたブロックを示します:valuesMapping、workload、artifacts[<output-name>]。パイプラインステップの with: または when: が同じファクトを読み取る場合は、FeatureRecipe の設定にかかわらず、代わりに次のエントリで報告されます。複数のフィールドがファクトを読み取る場合、共通点を示す行の下に、それぞれ個別のレポートが出力されます:

attachment templates reading the render facts of the components their host is wired to, without declaring it(宣言なしにホストの接続先 component のレンダーファクトを読み取るアタッチメントテンプレート)

修正方法: FeatureRecipe の spec に readsTargetRenderFacts: true を設定します。readsCallerRenderFacts: true ではこの停止は解消されません。これはファクトをホストの接続先ではなく、ホストに接続している component に載せるためです。このキーにより、アタッチメントはすべての component のレンダー後にレンダーされ、各ターゲットのファクトがその接続に載りますが、レンダーされる内容はそれ以外何も変わりません。FeatureRecipe エンティティのページを参照してください。キーこそが契約であり、この停止は明らかにキーを必要とするテンプレートを見つける手助けにすぎません。チェックは書かれたとおりのテンプレートを読み取るため、テンプレートの実行中に組み立てられる参照や、ファイルまたはライブラリからインポートされた内容に書かれた参照では停止しません。そのような FeatureRecipe にも同様にキーを設定してください。.context.uses を少しでも読み取り、かつ別の値から render_facts という名前のフィールドを読み取るテンプレート({{ range .context.used_by }} 内で呼び出し元のファクトを読み取るものを含む)も停止します。キーを設定し、テンプレートが呼び出し元のファクトを読み取る場合は readsCallerRenderFacts も設定してください。

boundary に対して一度だけレンダーされる FeatureRecipe(executionScope: boundary)は、上の呼び出し元のエントリで述べた理由により、ここではチェックされません。

A pipeline step reads its targets’ render facts(パイプラインステップがターゲットのレンダーファクトを読み取る)

component にアタッチされた FeatureRecipe 内のパイプラインステップの with: または when: が、.context.uses の下にある render_facts(アタッチ先ホストが接続している component が自身のレンダーについて報告したもの)を読み取っています。

ステップは、ホスト自身の Recipe が読み取るのと同じようにホストの接続を読み取りますが、そのターゲットのレンダーファクトは決して読み取りません。これは readsTargetRenderFacts: true を設定しているかどうかにかかわらず、すべての FeatureRecipe に当てはまります。ステップはホスト component 自身のドキュメントを書き換えることがあり、ホスト自身のレンダーはターゲットが公開するものを読み取り、ターゲットが出力したものは読み取らないため、ステップのテンプレートはそれらのファクトなしで評価されます。したがってそれらを読み取るステップは何も読み取れないことになり、その読み取りを空の値としてレンダーする代わりに、何かがレンダーされる前にビルドが停止します。

出力されるメッセージ:

pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host’s own render facts (<reference>, written in <field>)(パイプラインステップがホストの接続先 component のレンダーファクトを読み取っていますが、パイプラインステップが読み取るのはホスト自身のレンダーファクトのみです)

参照は上のエントリと同様に引用され、field はステップをその id で示します:pipeline[<step>].with または pipeline[<step>].when。複数のステップがファクトを読み取る場合、共通点を示す行の下に、それぞれ個別のレポートが出力されます:

pipeline steps reading the render facts of the components their host is wired to(ホストの接続先 component のレンダーファクトを読み取るパイプラインステップ)

修正方法: ステップでは、ホスト自身のレンダーファクトを .context.render_facts と省略せずに書いて読み取ります。ターゲットのファクトは、代わりにアタッチメント自身のリソースを生成するテンプレート(valuesMapping:、workload:、artifacts:)で、readsTargetRenderFacts: true を設定したうえで読み取ります。詳しくは FeatureRecipe エンティティのページを参照してください。キーを設定するだけではこの停止は解消されません。チェックは書かれたとおりのテンプレートを読み取り、上のエントリで説明した制限があります。

boundary に対して一度だけレンダーされる FeatureRecipe(executionScope: boundary)は、上の呼び出し元のエントリで述べた理由により、ここではチェックされません。

Cross-node type safety violation via selector:(selector によるノード間の型安全性違反)

この停止は、カタログ作成者が配線またはアタッチできる対象を制約するために記述する 2 つのラベル式を対象とします。どちらも同じ形で失敗するためです。つまり、カタログエンティティが宣言した式をラベルセットが満たさない場合です。

ターゲットがソケットの selector: を満たさない uses: エッジ。 usesSchema ソケットが、エッジの反対側にアタッチされたターゲット Component を除外する selector: フィールドを宣言しています。セレクタは、カタログ作成者が「このソケットは、ラベルがこの式に一致するターゲットのみを受け入れる」と表明する手段です。ソケット名の照合は満たしてもセレクタ式を満たさないエッジは、型安全性違反です。

出力されるメッセージ:

selector violation ("", declared on socket "", not satisfied by the labels of ""). Add the labels the selector requires to the target’s component type, or wire the socket to a component that already carries them.(selector 違反(ソケットで宣言された selector 式を、ターゲットのラベルが満たしていません)。selector が要求するラベルをターゲットのコンポーネントタイプに追加するか、そのラベルをすでに持つコンポーネントにソケットを接続してください。)

コンポーネントが Feature の appliesTo: を満たさないアタッチメント。 Feature は、アタッチ可能なコンポーネントを appliesTo: と appliesToAnyOf: で宣言します。単一の式の要件はすべて同時に成り立つ必要があり、選択肢はいずれか 1 つが成り立てば十分です。両方の宣言面が成り立つ必要があり、Feature が省略した面は何によっても満たされます。Feature の宣言が認めないラベルを持つコンポーネントへのアタッチメントは、上記のエッジの場合と同じ種類の違反です。

出力されるメッセージ:

selector violation ("", declared by Feature "", not satisfied by the labels of ""). Add the labels the Feature’s appliesTo requires to this component’s type, or attach a Feature whose applicability the component already satisfies.(selector 違反(Feature が宣言した appliesTo 式を、コンポーネントのラベルが満たしていません)。Feature の appliesTo が要求するラベルをこのコンポーネントのタイプに追加するか、コンポーネントがすでに適用条件を満たしている Feature をアタッチしてください。)

どちらの式も、ラベル文法がまったく読み取れない形で記述される場合があります。これは同じ停止として報告されますが、最後の値は、満たされなかったラベルセットではなく、読み取れなかった理由になります。これにより、評価できなかった式と、評価されて偽となった式を区別できます:

selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity.(selector 違反(Feature が宣言した appliesTo 式を評価できませんでした)。Feature のカタログエンティティにある appliesTo selector を修正してください。)

文法が読み取れないソケットのセレクターは、何かがソケットを配線する前にも拒否されます。 aggrega validate は、カタログ全体に対しても、1 つの Component または Feature に対しても、そのエンティティ自身のドキュメントが宣言するすべてのソケットセレクターを読み取り、ソケットを通じてエッジが配線されているかどうかにかかわらず、文法が読み取れないものをこの同じ条件で拒否します:

selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema.(セレクター違反:ソケットで宣言されたセレクターを評価できませんでした。コンポーネントタイプの usesSchema で、ソケットの宣言にあるセレクターを修正してください。)

Feature のソケットでは、対処法は代わりにその Feature の usesSchema を示します。まだ何もソケットを配線していないため、不備はカタログエンティティにあります。CATALOG_ERROR として分類され、エンティティのファイルが示されます。

この停止は、対象となるオーサリングキー(uses: ソケットエントリ、またはアタッチメントを指定する features: エントリ)を、それを宣言するファイルとともに保持します。そのため、報告される位置はドキュメントの先頭ではなく、編集すべきエントリになります。サブシステム内で記述された Component は、それが記述されたサブシステムの位置に、階層ごとに配置されます。アタッチメントは、それを記述したドキュメント内の、それを記述した features: エントリに配置され、そのドキュメントの作成者に帰属します。Aggregate 内のコンポーネント自身のブロックまたはサブシステムのブロックであれば開発者の不備です。Release のみが行うアタッチメントであれば、そのコンポーネントのエントリ、またはそのコンポーネントを含むバウンダリの features: ブロックとなり、オペレーターの不備です。両方のドキュメントがアタッチメントを記述している場合は、その type が指定されている位置に配置されます。Aggregate は常にこれを指定します。接続上に記述されたアタッチメントは、それを記述したドキュメント内の、その接続の features: 配下のキーに配置されます。すなわち Aggregate の接続エントリ、または Release のみが行うアタッチメントであれば Release のエッジごとのエントリです。宣言が認めないコンポーネントに Release のみがアタッチした Feature は、次のように表示されます:

[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics
selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.

また、同じアタッチメントを Aggregate 内のコンポーネントに記述した場合は [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics と表示されます。アノテーション駆動の展開によって生成されたアタッチメントは、どの features: エントリにも記述されていないため、コンポーネントを宣言するドキュメント内のコンポーネント自身の features: キーに、開発者の不備として配置されます。

エッジ違反の修正方法: uses: エッジを、ラベルがセレクタを満たす Component に向けるか、意図したターゲットのクラスを受け入れるようにカタログエンティティ内のセレクタ式を調整します。aggrega inspect でターゲット Component の metadata.labels を確認し、どのラベルを持っているかを確かめてください。

アタッチメント違反の修正方法: 宣言がラベルを認めるコンポーネントに Feature をアタッチするか、Feature の appliesTo: を広げます。Feature が実際に複数のコンポーネントクラスに対応する場合は、appliesToAnyOf: に選択肢を追加します。コンポーネントが条件を満たすはずなのに満たさない場合、欠けているのは通常ラベルです。aggrega inspect で確認し、式が求めるものを Component の metadata.labels に追加してください。

Unknown provider(不明なプロバイダー)

Recipe が capability: <name> を宣言していますが、<name> はコンパイラが提供するどのプロバイダーも指していません。コンパイラは、存在を知らないプロバイダーにレンダリングを振り分けることはできません。

出力されるメッセージ:

unknown provider: <provider-name>(不明な provider)

修正方法: プロバイダー名のスペルが正しいことを確認します。cloudformation、compose、helm、helm-chart、terraform が組み込みのプロバイダープラグインが提供する名前です。独自のエンタープライズプロバイダーを意図していた場合は、その名前を提供するプロバイダーレンダリング用の Plugin(pluginType: provider で、その名前を spec.provider.capabilities に含むもの)が、ビルドの対象となるカタログワークスペースに存在することを確認してください。

A capability is served by more than one provider plugin(ケイパビリティが複数のプロバイダープラグインによって提供されている)

ビルドが到達した(またはプルが解決した)ケイパビリティが、複数のプロバイダーレンダリング用 Plugin(pluginType: provider で、それぞれの spec.provider.capabilities にそのケイパビリティを列挙しているもの)によって提供されており、ワークスペースがどれでレンダリングするかを選択していません。ビルドはプロバイダーを任意に選ぶのではなく停止し、両方の候補を示します。同じケイパビリティに対して 2 つのプラグインを持つカタログは正当です。2 つの発行元がそれぞれ helm や compose 向けのプラグインを公開することがあり、カタログは両方を受け入れます。曖昧さは使用時点でのみ表面化します。この停止は、ロード時ではなく、ビルドまたはプルが競合するケイパビリティに実際に到達したときに発生します。

出力されるメッセージ。ビルドを停止させた規則が先頭に来て、その後に詳細(どのケイパビリティか、どの候補か、記述すべきバインディング)が続きます:

capability is served by more than one provider plugin; add a plugins.providers entry to select one: capability "<capability-name>" is served by more than one provider plugin (<plugin-1>, <plugin-2>); add a plugins.providers entry for "<capability-name>" selecting one(capability が複数の provider プラグインによって提供されています。plugins.providers エントリを追加して 1 つを選択してください。該当する capability を複数の provider プラグインが提供しているため、その capability に対して 1 つを選択する plugins.providers エントリを追加してください)

修正方法: ワークスペース設定に、ケイパビリティをキーとし、それをレンダリングするプラグインの識別子を値として選択する plugins.providers エントリを追加します。両方のプラグインはフェデレーテッドカタログに残したままにしてください。バインディングは、競合するケイパビリティについてこのワークスペースがどちらに振り分けるかを指定します。

The plugin serving a provider cannot assemble what that provider combines(プロバイダを提供するプラグインが、そのプロバイダが結合する出力をアセンブルできない)

プロバイダは、ディスパッチグループのノードごとの出力がどうなるかを宣言します。各ノードの出力をディスパッチパスにそのまま書き出すか、フラグメントを 1 つのドキュメントに畳み込むか、各ノードを 1 つの包含構造の中の固有の位置に配置するかです。プロバイダが出力を結合すると宣言する場合(マージされた compose ファイル、アンブレラチャートなど)、それを提供するプラグインは結合を行うエクスポートを提供する必要があります。この停止は、それが提供されていない場合に発生します。プラグインがノードごとのレンダリング(render_node)を公開しているのに対応する assemble_boundary がないため、グループのノードはレンダリングできても、その出力をマージできません。

この不一致の両側はどちらもプラグインに属します。ディスパッチグループの出力がどうなるかは、プラグインがロード時に自身について報告する内容の一部であり、結合を行うエクスポートは Plugin エンティティの spec.exports の下のエントリの 1 つで、同じ報告と照合されます。そのため、この停止は、エクスポートの提供範囲にないアセンブリを主張しているプラグインを指摘します。

ビルドはアセンブリをスキップせずに停止します。スキップすると、1 つの成果物が期待されていたパスに各ノードのフラグメントが書き込まれて成功が報告され、それ以降の処理では、そのフラグメントと、アセンブリを主張しないプロバイダが設計上出力するフラットなノードごとの出力とを区別できません。その結果、成果物の欠落はビルド時ではなく、出力が適用される場所で表面化することになります。

ディスパッチパスを持たないディスパッチグループは対象外です。パスなしで書き込まれる出力はノードごとの出力であり、そこでは何もアセンブルされないため、結合に関する主張が適用される対象がありません。

出力されるメッセージ。問題のあるディスパッチグループごとに 1 つの検出結果が報告され、プロバイダと、そのグループがアセンブルされるパスを示します:

provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>")(ディスパッチグループのアセンブルが期待されるプロバイダがバウンダリアセンブラを提供していません)

問題のあるディスパッチグループが複数ある場合、検出結果は dispatch groups whose provider offers no boundary assembler というレポートの下にまとめて報告されます。

修正方法: render_node と assemble_boundary の両方を公開するプラグインでケイパビリティを提供します。spec.exports の記述方法については ../entities/plugin.md を、アセンブリのエクスポートが受け取る内容については ../schema/plugins/wasm-provider.md を参照してください。プラグインを自作している場合は、両側を揃えるのは作成者の役目です。アセンブリのエクスポートを追加するか、アセンブリを主張しないと報告して、各ノードの出力をマージせずにディスパッチパスに配置させます。公開されたプラグインを利用している場合は、両方のエクスポートを提供するバージョンを選択するか、そのケイパビリティについてプロバイダがアセンブリを主張しないプラグインを選択します。

A boundary-level Feature’s output reaches no assembled file(バウンダリレベルの Feature の出力がどの組み立て済みファイルにも届かない)

バウンダリの features: の下にアタッチされ、その FeatureRecipe が executionScope: boundary を宣言している Feature は、バウンダリ全体に対して 1 回レンダリングされ、その出力はバウンダリ自身の directory: と subDirectory: がそれについて評価されるディレクトリに出力されます。出力を 1 つのドキュメントにまとめるプロバイダー(compose は 1 つの docker-compose.yaml に、cloudformation は 1 つのスタックにまとめます)は、そのような Feature の寄与を、そこでバウンダリのコンポーネントから組み立てるファイルの一部としてのみ書き出します。そのファイルが存在するのは、少なくとも 1 つのコンポーネントの出力が同じプロバイダーのもとで同じディレクトリに置かれる場合だけです。

バウンダリのコンポーネントが別の場所に置かれる場合、そのファイルは存在しません。たとえば、subDirectory: がコンポーネントを別の場所に送るネストしたバウンダリにコンポーネントがある場合("{{ .component_id }}" などで、各コンポーネントが自分のファイルを持つようにする場合)や、Feature の出力と共有されないディレクトリの下にある場合です。Feature のディレクトリには何も組み立てられないため、その出力はどこにも書き出されず(compose ブリッジであれば、どのファイルにも含まれないゲートウェイサービスとなります)、それでもビルドは成功を報告することになります。そのため、代わりにビルドは停止します。

プロバイダーが各寄与を独自のファイルとして書き出す Feature(helm、helm-chart、terraform)は影響を受けません。それらのファイルは、隣に何かが組み立てられるかどうかにかかわらず書き出されます。

出力されるメッセージです。違反する Feature ごとに 1 つの検出結果があり、バウンダリの features: の下にあるそのエントリの位置が示され、バウンダリ、Feature、その出力がルーティングされたディスパッチパス、プロバイダーが示されます。

boundary-level Feature’s output is routed to a dispatch path nothing assembles (boundary "<boundary>", feature "<instance>", dispatch path "<path>", provider "<provider>"). attach the Feature at a boundary whose output path also receives its components, or give the boundary’s components the directory the Feature’s output is routed to(バウンダリレベルの Feature の出力が、何も組み立てられないディスパッチパスにルーティングされています。出力パスがそのコンポーネントも受け取るバウンダリに Feature をアタッチするか、Feature の出力がルーティングされるディレクトリをバウンダリのコンポーネントに与えてください)

親バウンダリ bridge にアタッチされた compose ブリッジで、その唯一の子バウンダリが各コンポーネントを subDirectory: "{{ .component_id }}" の下に置く場合、次のように出力されます。

[OPS_ERROR E0365] release-compose.yaml at .spec.boundaries.bridge.features.gateway
boundary-level Feature's output is routed to a dispatch path nothing assembles (boundary "bridge", feature "gateway", dispatch path "bridge/compose", provider "compose"). attach the Feature at a boundary whose output path also receives its components, or give the boundary's components the directory the Feature's output is routed to

違反する Feature が複数ある場合、検出結果はレポート boundary-level Features whose output is routed to a dispatch path nothing assembles のもとにまとめて届きます。

対処方法: Feature のディレクトリを、そのバウンダリのコンポーネントも置かれるディレクトリにします。それらのコンポーネントを自身の出力パスで受け取るバウンダリに Feature をアタッチするか、Feature の出力がルーティングされるディレクトリをコンポーネントに与えます。子バウンダリであれば、独自の subDirectory: を持たずに directory: "{{ .parent_boundary.directory }}" とすることで、親のファイルを共有させます。メッセージは Feature の出力がルーティングされたディレクトリを示しており、それが共有すべきディレクトリです。

Path-template references a variable outside the allowlist(パステンプレートが許可リスト外の変数を参照している)

directory: または subDirectory: のテンプレートが、パステンプレート変数の許可リストに含まれない変数名を参照しています。たとえば {{ .parmaeters.region }} のようなタイプミスや、Recipe のレンダリングコンテキストには存在してもパステンプレートには公開されていないフィールド(.context.inject や .values など)です。directory: テンプレート内の {{ .component_id }} も同じ停止の対象です。この変数は存在し、subDirectory: テンプレートからは読み取れますが、バウンダリの directory: はコンポーネントごとではなくバウンダリ全体で一度だけ評価されるため、そこにコンポーネントごとの変数があると、出力されるパスがどのコンポーネントが最初に評価されたかに依存してしまいます。

パステンプレートは、レンダリング処理が始まる前のパース時に、パステンプレートコンテキストが定義する変数から各記述箇所が拒否する変数を除いたものに対して検証されます。また、コンパイラはパステンプレートを missingkey=error のセマンティクスで評価するため、許可リストにあっても評価時に未定義の参照は、空文字列を黙ってディレクトリパスにレンダリングするのではなく、明示的なエラーになります。

この停止は変数に関するものです。許可されている変数の下のキーのタイプミス({{ .manifest.recipe_nmae }})は、代わりに前述の「Template references a root the render context does not define(テンプレートがレンダーコンテキストで定義されていないルートを参照している)」として報告され、.manifest が定義するキーが示されます。変数自体は受け入れられ、キーだけが誤っていたためです。

出力されるメッセージ:

path template references a field not in the documented allowlist ("<dotted-path>", written in "<directory|subDirectory>", the render context defines "<the variables that field may read>")(パステンプレートが、文書化された許可リストにないフィールドを参照しています)

修正方法: フィールド名をパステンプレートの許可リストにあるものに修正するか、参照を削除します。directory: の許可リストは {{ .capability }}、{{ .boundary_name }}、{{ .parameters.X }}、{{ .manifest.recipe_name }}、{{ .parent_boundary.* }} で、subDirectory: ではこれに {{ .component_id }} が加わります。その他の記述箇所(Recipe の valuesMapping、FeatureRecipe の injectMapping など)は異なる形のコンテキストを使用します。.context.*、.values、.infra、.locals への参照は、パスの出力が値のレンダリングではなく構造に関わる事項であるため、意図的にパステンプレートには公開されていません。

Path collision: two contributors emit at incompatible paths(パスの衝突:2 つのコントリビューターが互換性のないパスに出力している)

パス宣言が同じアセンブリパスに評価される 2 つのバウンダリが、異なるプロバイダを経由しています。どちらもそこでアセンブルされ、それぞれが相手の知らないファイルを書き込むため、一方がディスク上で他方を黙って置き換えてしまい、置き換えられた出力を生成したビルドは成功したように見えます。

デフォルトの subDirectory: は各プロバイダに固有のサブパスを与えるため、2 つのプロバイダが 1 つのパスに到達するのは、宣言が同じに評価されるように書かれている場合だけです。たとえば、2 つのバウンダリが directory: を共有し、どちらも subDirectory: を同じリテラルに固定している場合です。

出力されるメッセージ。 検出結果は寄与したバウンダリごとに 1 つ報告されるため、出力がそのパスに到達したすべてのバウンダリが、1 つのメッセージ内のリストにまとめられるのではなく個別に示されます。問題は 2 つのプロバイダが 1 つのパスで出会うことなので、検出結果は常に 2 つ以上あり、それらの共通点を述べるレポートの下にまとめて報告されます:

assembly paths reached by more than one provider(複数のプロバイダが到達したアセンブリパス)

各検出結果は、パス、出力がそこに到達したバウンダリ、およびそのバウンダリが経由するプロバイダを示します:

dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>")(ディスパッチパスが複数のプロバイダ出力を生成しました)

api-net と db-net のバウンダリがどちらも directory: ./dist/shared と subDirectory: merged を宣言し、一方が helm、もう一方が compose を経由するビルドは、次のように出力します:

[OPS_ERROR E0048]
assembly paths reached by more than one provider
caused by (2):
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "db-net", provider "compose")
---
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "api-net", provider "helm")

レポートには短いコードが付き、その下の各検出結果にはカテゴリのみが付きます。これは収集された失敗を報告するすべてのレポートに共通の形です。その文法については error-translation.md を参照してください。

修正方法: 各バウンダリに別々の directory: を指定する(別のパスにアセンブルされるようにする)か、subDirectory: をデフォルトのままにして各プロバイダの出力が固有のサブパスに配置されるようにします。compose-bridge パターンは、意図的に 2 つのサブバウンダリを 1 つのアセンブリパスにまとめます。このパターンでは、両方のバウンダリが同じプロバイダを対象とし、カスケード解決された互換性のあるアノテーションを持つ必要があります。

A boundary’s output directory is not a directory beneath the output root(boundary の出力ディレクトリが出力ルート配下のディレクトリではない)

boundary の directory: と subDirectory: は評価されたうえで結合され、その出力が書き込まれるディレクトリになります。このパスは一度だけ正規化されます。out/a、out//a、./out/a、out/a/ は同じディレクトリです。正規化されたパスが出力ルート配下のディレクトリでない場合、何も書き込まれる前にビルドは停止します。該当するのは、出力ルートの外へ出るパス(..、../escape、a/../..)、絶対パス(/srv/out)、またはディレクトリをまったく指さないパスです。最後のものには、空の値や、サブディレクトリを無効にした directory: "." のように出力ルートそのものに正規化される値が含まれます。

パスは評価された状態で検査されるため、判定されるのは記述されたテキストではなくテンプレートの結果です。メッセージは、問題の原因となったフィールドを、そのフィールドが評価された値および生成されたパスとともに示します。ディレクトリ単独ですでに出力ルートの外に出ている場合、またはサブディレクトリが結合されない場合は directory:、それ以外の場合は subDirectory: です。

出力されるメッセージ:

boundary output directory does not name a directory beneath the output root (Release "<release>", boundary "<boundary>", directory: "<value>", output path "<path>"). write a directory beneath the output root, such as “deploy/prod” — no leading ”/”, no ”..” climbing above it, and not the output root itself(boundary の出力ディレクトリが出力ルート配下のディレクトリを指していません。出力ルート配下のディレクトリを「deploy/prod」のように記述してください。先頭の「/」、その上に出る「..」、出力ルートそのものは使用できません)

サブディレクトリに問題がある場合、3 番目の値は代わりに subDirectory: "<value>" となります。

修正方法: メッセージが示すフィールドを、出力ルート配下のディレクトリとして記述します。出力ルートの隣に置くつもりのディレクトリは、代わりにその内側に置きます。boundary の出力を directory: に直接書き込むには、subDirectory: "." を設定します。この場合も、ディレクトリ自体は独自のディレクトリを指している必要があります。

boundary レベルの Feature の名前が . または .. である

各 contributor に独自のディレクトリを与える provider(modules/ 配下の terraform、charts/ 配下の helm-chart)は、boundary にアタッチされた Feature を、インスタンス名だけを名前とするディレクトリに、boundary の component と並べて配置します。boundary の features: キーは . と .. を受け付けますが、どちらもディレクトリ名ではありません。. では Feature のファイルがすべての contributor を含むディレクトリに、.. ではその一つ上のディレクトリに置かれ、provider が Feature に与えた位置の外にファイルが配置されてしまいます。そのため、ビルドは停止します。それ以外の名前は、audit.v2 のようにドットを含むものも含めて影響を受けません。

出力されるメッセージ:

boundary-level Feature instance name is not a directory name (Release "<release>", boundary "<boundary>", feature "<instance>"). rename the Feature instance under the boundary’s features to an ordinary name, such as “audit”(boundary レベルの Feature インスタンス名がディレクトリ名ではありません。boundary の features 配下の Feature インスタンスを「audit」のような通常の名前に変更してください)

修正方法: boundary の features: 配下のインスタンスを通常の名前に変更します。

Instance-ID collision across boundaries assembling to the same path(同じパスにアセンブルされる boundary 間でのインスタンス ID の衝突)

同じ(パス、provider)の組にアセンブルされる 2 つの boundary が、同一のインスタンス ID を持つ component を提供しています。マージされたアセンブリでは 2 つの component フラグメントを区別できません。1 つの Helm チャートに web-server という名前の Deployment を 2 つ含めることはできず、1 つの docker-compose ファイルに api という名前のサービスを 2 つ含めることもできません。

出力されるメッセージ:

multiple contributors share an instance ID at the same dispatch path: dispatch path "<path>" provider "<provider>" already contains node "<instance-id>" (contributing boundaries: [<boundaries>]); component instance IDs must be unique within an assembly group(同じディスパッチパスで複数の contributor がインスタンス ID を共有しています。component のインスタンス ID はアセンブリグループ内で一意である必要があります)

修正方法: Aggregate 内の衝突している component のいずれかの名前を変更するか、2 つの boundary を別々の directory: パスに分け、各 component インスタンスがそれぞれ独自のアセンブリに配置されるようにします。

Two contributors write the same output path(2 つの contributor が同じ出力パスに書き込む)

1 つのアセンブリへの 2 つのコントリビューターが、同じ出力パスにファイルを生成します。これは前述のインスタンス ID の衝突とは別のものです。コンポーネントは異なる名前を持ち、アセンブリはそれらを区別できます。1 つのパスに行き着くのは、それらが生成するファイルです。これが最も多く起こるのは、プロバイダーが各コントリビューターの出力をコンポーネントごとの位置の下ではなく横に並べて書き出す場合で、Recipes が同じファイル名を生成する 2 つのコンポーネント(たとえば、どちらも main.tf という名前の 2 つの artifacts: エントリ)が 1 つのパスで出会います。アセンブラー自身の出力も、同じようにコントリビューターのファイルと衝突することがあります。

1 つのファイル名を出力する 2 つの contributor が衝突するかどうかは、provider がそれらをどこに配置するかによって決まります。各 contributor をアセンブリ内の独自の位置の配下にネストする provider では、同じ名前の 2 つのファイルは分離されます。contributor を並べて書き込む provider では分離されません。比較の対象は contributor が出力した名前ではなく、ファイルが最終的に書き込まれるパスであるため、ネストされる場合は報告されません。

ビルドは、2 つのファイルの一方を書き込んで他方を破棄するのではなく、停止します。暗黙的に解決する正しい方法はありません。一方のファイルの名前を変更したりサフィックスを付けたりすれば誰も記述していない名前を作り出すことになり、内容をマージすれば誰も書いていないドキュメントを作り出すことになります。衝突するすべてのパスが報告され、そこに書き込むすべての contributor が示されるため、1 回のビルドで衝突を 1 つずつではなく全体像として把握できます。

出力されるメッセージ。 衝突するパスごとに 1 件の検出結果が、そのアセンブリにいくつの boundary が供給されていても一度だけ報告されます。そのため、contributor が 2 つのパスで衝突したビルドでは両方が報告され、どちらの衝突も二重に報告されることはありません:

assembled output collision: two contributors write the same output path (output path "<output-path>", written by "<contributor-1> and <contributor-2>", assembled within "<boundary-1> and <boundary-2>")(アセンブルされた出力の衝突:2 つの contributor が同じ出力パスに書き込んでいます)

各 contributor はその種類によって示され、それがその名前の書かれている場所を表します。component インスタンスは component <name>、boundary にアタッチされた feature は feature <name>、アセンブリ自身のマージ済み出力は the <provider> assembly です。contributor は名前順に列挙されるため、同じ入力のビルドであれば毎回同じ文になります。

Recipe が boundary の共有出力に提供するファイルにも、この規則が適用されます。 Recipe の boundary: ブロックは、そのファイルを provider 自身のアセンブル済み出力と並べて、ファイル名ごとに一度書き込みます。同一のバイト列で 1 つの名前を宣言する複数の component は 1 つのファイルとなり、衝突することはありません。異なるバイト列で宣言すると、ここで衝突となり、そのファイルと宣言したすべての component が示されます。provider のアセンブリ自体が書き込む名前(たとえば terraform の aggrega.modules.tf。この場合 contributor の中に the terraform assembly が示されます)も同様です。複数の component が同一に宣言したファイルがアセンブリ自身のファイルと衝突した場合は、component <name-1> and component <name-2> のように、それらすべてとともに示されます。

アセンブリに供給された boundary も示されますが、1 つに特定されるのではなく列挙されます。directory: 宣言の評価結果が同じになる boundary は 1 つとしてアセンブルされ、衝突した contributor がそのうちどの boundary で宣言されたかは衝突からはわかりません。そのため、検出結果は宣言によってそれらを分離できる可能性のあるすべての boundary を示し、そのどれについても原因であるとは断定しません。同じ理由で、検出結果は Release ドキュメント全体に対して報告されます。その中の 1 つの boundary を示すと、そのパスに何も寄与していない可能性のあるドキュメントを参照させることになるためです。

複数のパスが衝突する場合、検出結果は、それらの共通点を述べるレポートの下にまとめて報告されます:

assembled output paths written by more than one contributor(複数の contributor によって書き込まれたアセンブル済み出力パス)

修正方法: 管理している側の Recipe で、生成されるファイル(artifacts: のキー、boundary: ブロックのキー、または Workload の変換が導出するファイル名)の名前を変更し、2 つが出会わないようにします。2 つの Recipes が 1 つの共有ファイルを宣言し、同じ設定を意図している場合は、それらの宣言をバイト単位で同一にします。2 つのコントリビューターが本当に別々の出力に属する場合は、それぞれの boundary に別個の directory: パスを与え、それぞれが単独でアセンブルされるようにします。

The same name is derived more than once inside the output(出力内で同じ名前が複数回導出される)

1 つのアセンブリで、出力するファイルの内部にある何かに同じ名前が 2 回使われ、しかもその場所には 1 つしか入る余地がない状態です。これは 2 通りで起こります。2 つのコントリビューターが同じ名前を導出する場合と、1 つのコントリビューター自身の出力がその名前を 2 回持つ場合です。これは上記の 2 つの衝突とは異なります。2 つのコントリビューターが関わる場合でも、コンポーネントの名前は異なり、ファイルも別々のパスに配置されるため、アセンブリの形状には何の問題もありません。問題はコンテンツ内の名前です。たとえば、ターゲットが 1 つのリソースを指すために使う識別子や、ある出力を別のものから参照させるために公開する際の名前などです。

どの名前が比較されるかは、provider がアセンブリの出力をどう扱うかによって決まります。 provider がその出力を単一のドキュメント(1 つのスタックテンプレート、1 つの compose ファイル)にマージする場合、その 1 つのドキュメント内の名前同士が比較され、出力が独自の別ファイルとして書き込まれるコントリビューターはその外側にあります。その名前は他の誰の名前とも出会わないため、それらの間で停止することはなく、何を名前変更してもそれは変わりません。provider が代わりに各コントリビューターの出力を独自のファイルとして書き込む場合(チャートのレンダリング、マニフェストの集合など)、アセンブリへのすべてのコントリビューターが他のすべてと比較されます。そのような出力内の名前は、いずれか 1 つのファイル内ではなく、それらのファイルを集合として読むもの全体で一意であるためです。

FeatureRecipe 自身のリソースは、ホストコンポーネントのリソースと同じ経路をたどります。アタッチメントは、ホストが属するアセンブリに寄与するためです。そのため provider がマージする場合、アタッチメントの名前はホストコンポーネントの名前およびほかのすべてのアタッチメントの名前と、2 つのコンポーネントの名前同士とまったく同じように比較されます。それらはすべて 1 つのドキュメント内に入り、等しい 2 つの名前のうち一方がそこで他方を置き換えてしまうからです。provider がマージしない場合、アタッチメントのリソースはアタッチ先のコンポーネントを名前に持つディレクトリの下に書き込まれ、その名前はやはりアセンブリへのすべてのコントリビューターと比較されます。クラスタ全体で一意でなければならないリソースの識別はここで検出されます。したがって比較はどちらでも同じであり、異なるのは置き換えられるはずの名前が最終的にどこに置かれるかだけです。

この停止の半分は、これらすべての影響を受けません。つまり、単一のコントリビューター自身の出力が名前を 2 回持つ場合です。これは 1 つのコントリビューターが書いた出力内で名前が 2 回使われているものなので、その出力がどこに書き込まれたかにかかわらず停止し、分離すべき 2 つのものは常にその内部にあります。

そのような名前の大半は provider 自身のもので、コンポーネントインスタンスとリソースから導出されます。そのため、導出元の部分が一致すれば 2 つのコンポーネントが 1 つの名前に行き着くことがあり、同様に、1 つのコンポーネントの 2 つのリソースが一致する部分から構築されれば、そのコンポーネントが同じ名前に 2 回行き着くこともあります。名前はファイル自体のバイト内にあるため、アセンブリからは見えません。provider が導出した名前を報告し、ビルドがそれらを比較します。

provider ではなくビルド自身の名前が 1 種類あり、同じ方法で報告されます。それは FeatureRecipe が出力するすべてのリソースに付けられる識別子で、aggrega.ai/component-id ラベルとして出力に現れます。名前の種類 component-id として報告されるため、自分の出力内で同じ文字列を見つけられます。FeatureRecipe がリソースを合成する場合、その識別子はリソースの名前の元にもなります。作成者が提供したチャートやフラグメントをレンダリングする場合は、そのレンダリング内の名前はホストコンポーネントのままで、識別子を持つのはラベルだけです。

コンポーネントにアタッチされた feature の場合、識別子は、固定の先頭部分の後に、feature のアタッチ先コンポーネントと features: の下に書いたキーを組み合わせて構成されます。ホストコンポーネントが値に含まれるのは、複数のコンポーネントにアタッチされた 1 つの feature 名がそれぞれに別のリソース集合を出力し、各集合に独自の識別子が必要だからです。

バウンダリにアタッチされた feature の場合、識別子は、独自の先頭部分の後に、feature の名前とバウンダリのパスの各セグメントを組み合わせて構成されます。どちらの場所でも置換ではなく構成が行われます。ラベルのアルファベットが受け付けない文字は置き換えられずに書き出され、各部分はどの書き出された部分にも含まれ得ない文字列で連結されるため、区別できる 2 つのアタッチメントは必ず 2 つの識別子になります。唯一残るのは長さの問題です。ラベル値として長すぎる構成済み識別子は、全体のダイジェストを使って短縮され、短縮された 2 つの識別子は理論上一致する可能性があります。この停止は、名前が比較される 2 つのコントリビューター間でのそのような一致を報告します。1 つのコンポーネント上の 2 つのアタッチメントは、ホストの provider がそれらをまとめてアセンブルする場合には常にそのような 2 つのコントリビューターです。それぞれの構築方法については ../providers/well-known-annotations.md を参照してください。

Kubernetes のレンダリングは独自の種類を報告します。それは、自身のレンダリングが生成する各リソースが metadata.name に持つ名前です。このような名前は、出力全体ではなく、その kind 内で(クラスタが名前空間内で保持する kind の場合はその名前空間内で)一意である必要があるため、名前の種類はそれがどちらのスコープかを示します。名前の種類は resource-names で始まり、続いてリソースの kind と、リソースが配置される名前空間を持ちます。その名前空間は、リソースが自ら指定するもの、指定がなければバウンダリに注釈されたものです。つまり resource-names:Service--default は、default に配置される Service の名前です。Kubernetes API がどの名前空間の外側にも保持する kind(ClusterRole、StorageClass、CustomResourceDefinition)と、同じレンダリング内の CustomResourceDefinition がスコープ Cluster で宣言するカスタム kind は、ドキュメントにどの名前空間が書かれていても、その kind のみを持ちます。resource-names:ClusterRole は、出力が持つすべての ClusterRole の名前です。英字と数字以外は置き換えられずに書き出され、2 つの部分はどの書き出された部分にも含まれ得ない文字列で連結されるため、異なる 2 つの組が 1 つの名前の種類になることはなく、kind 単独が kind と名前空間の名前の種類になることもありません。Service と Deployment は名前を共有でき、2 つの名前空間は名前空間付き kind の 1 つの名前をそれぞれ独立に保持するため、どちらも停止しません。名前自体はチャートが書いたとおりに報告されるため、テンプレートを検索する際の文字列として使えます。

したがって、1 つの出力への 2 つのコントリビューターがそれぞれ 1 つのクラスタ全体オブジェクトを 1 つの名前で書く場合、Release がそれらを 2 つの名前空間に配置していても停止します。両方を適用すると、その 1 つのオブジェクトが 2 回書き込まれるためです。また、1 つのチャートがそのようなオブジェクトを 2 つの異なる名前空間に書き、レンダリングがそれを 2 つのファイルとして出力する場合は、名前を 2 回持つ単一のコントリビューターとして停止します。レンダリング内の何によっても分類されない kind(CustomResourceDefinition をレンダリングが出力しないカスタム kind や、apiVersion を指定しないドキュメント)は、名前空間付き kind と同様にその名前空間内で比較されます。クラスタがそれを名前空間の外側に保持することを、レンダリング内の何も示していないためです。したがって、そのようなオブジェクトを 2 つの名前空間に書く 2 つのコントリビューターは一致しません。

名前は 1 つの出力へのコントリビューター間で比較され、2 つの出力間で比較されることはありません。2 つのバウンダリは、それぞれが独自のディレクトリ(自ら指定するもの、または directory: を指定しない各バウンダリに与えられるもの)を持つ場合に 2 つの出力になります。そして、2 つの出力が 1 つのクラスタに適用されるのか 2 つのクラスタに適用されるのかは、ビルド内の何からもわかりません。あるオペレーターの CustomResourceDefinition を 2 つのクラスタそれぞれに配布する場合、それは 2 つの出力における同じ名前であり、正しいものです。したがって、2 つのバウンダリがそれぞれ 1 つのクラスタ全体オブジェクトを 1 つの名前で書く場合、両方が 1 つのクラスタに適用されるとしてもビルドは成功します。そのように適用する場合は、オブジェクトをどちらか一方のみから出力してください。

この停止に最も多く至る構成は、1 つの component に 2 つの Features がアタッチされ、それぞれが作成者の用意したチャートを配信する場合です。両方のチャートは同じリリース名、つまりホスト component のリリース名に対してレンダリングされます。これは、チャートをアタッチしても、その作成者がすでに宣言しデプロイしたリソースの名前が変わらないようにするためです。そして、リソースにリリース名にちなんだ名前を付けることは、チャートが行う最も一般的なことの 1 つです。出力の形には何も問題はなく、2 つのリソースが単に 1 つの名前を持っているだけです。component の provider が個別のドキュメントを書き出す場合、各アタッチメントはそれぞれ固有のディレクトリの下に書き出し、両方を適用すると最後に適用された方だけが残ります。provider がグループを 1 つのドキュメントにまとめる場合、両方のアタッチメントがそのドキュメントに寄与し、2 つの名前の一方がその中で他方を置き換えます。自分が管理するチャートでリソースの名前を変更するか、2 つのアタッチメントを区別できるものを含む名前を付けてください。その際、テンプレートに届く必要があるのはアタッチメントです。両方のチャートはホストのリリース名に対してレンダリングされるため、アタッチメントの名前を変更するだけでは何も変わりません。FeatureRecipe の valuesMapping: を通じて .attachment_name をチャートに渡し、そのリソース名の構成元となっているチャート自身の値に設定してください。

2 つ目の構成は、2 つではなく 1 つの Feature で同じ停止に至ります。テンプレートがリソース名をリテラルとして書くチャートが、2 つの component にアタッチされる場合です。各ホストはそれぞれ固有のリリース名でチャートをレンダリングするため、2 つのコピーが 1 つの名前を持つ理由はリテラルだけです。リソースに .Release.Name にちなんだ名前を付ければホストが名前に戻ります。これは、リリースの識別情報からリソース名を構成するチャートがすでに行っていることです。

3 つ目の構成は、同じ形をもう一段内側のオーサリング面に移したものです。チャートではなく artifacts: を通じてリソースを配信する FeatureRecipe が、1 つの名前で 2 つの component にアタッチされ、その本体がリソース名をリテラルとして書く場合です。各アタッチメントの出力はホストを名前とするディレクトリの下に配置されるため、出力パスは異なり、出力の形には何も問題はありません。しかし両方の本体は同じ名前を持ち、両方を適用すると最後に適用された方だけが残ります。artifacts 本体内の名前は、チャートがレンダリングした名前とまったく同じように比較されます。2 つは同じクラスタ内の同じリソースを記述しているため、名前がどこから来たかは、両方を適用したときに起こることに何の違いももたらしません。この解釈は 2 つの名前が一緒に読まれることを前提としており、それは provider が各寄与者の出力を、ターゲットが 1 つのセットとして読むファイルとして書き出す場合に当てはまります。provider がアセンブリの出力を 1 つのドキュメントにマージする場合は、各アタッチメントのファイルはそのドキュメントの外にあり、その中の名前はそのファイルにスコープされるため、そのような 2 つのアタッチメントが出会うことはなく、ビルドは続行されます。

すべての名前が報告されるわけではないため、停止しなかったビルドは、出力が最終的に持つすべての名前が比較されたことを保証するものではありません。クラスタに名前付けを任せたリソース、つまり name の代わりに generateName を宣言するリソースはまだ名前を持たないため、報告する名前がありません。また、コントローラーが後で読むために別のフィールドに書き込まれた名前はリソース名ではないため、何もそれを比較しません。どちらの制約も出力されたドキュメントの読み取りに由来する性質であるため、どちらもレンダリングされたチャートテンプレートとまったく同じように artifacts 本体にも当てはまります。

artifacts: 本体はテンプレートであるため、ホストごとに異なる必要がある名前は、リテラルとして書くのではなく構成します。.context.rendered_name はホスト component 自身の provider がそれに付ける名前です。helm ではリリース名であり、Kubernetes の名前で許可される文字で表記されます。.attachment_name はアタッチしたときのキーであるため、{{ .context.rendered_name }}-{{ .attachment_name }} によって、リソースはすべてのホストとすべてのアタッチメントで固有の名前を得ます。provider がそのような名前を報告しないホストでは、代わりにホストの識別情報である .context.instance_id から構成してください。作成された 1 つの本体は、含まれる名前をそのまま持ってアタッチ先の各ホストに届き、リテラルはそのすべてで同じです。そのため、クラスタ内で一意である必要がある名前にはこの形を与えてください。

名前の意味は一切解釈されません。報告された 2 つの名前は、同じテキストであるかそうでないかのどちらかです。このため、誰が導出したかにかかわらず、同じ報告があらゆる種類の名前を扱います。

1 つの component について、1 つの名前が複数の報告に現れることがあります。component の各部分はレンダリングされる時点で報告されるためです。これは、1 つのリソースがそれが属する各報告で名前を挙げられているのであって、名前が 2 回使われているのではないため、停止しません。停止するのは 1 つの報告が 1 つの名前を 2 回持つ場合です。その報告は、名前が実際に 2 回使われている出力を記述しているためです。

この解釈は何を 1 つの寄与者と数えるかにかかっており、component-id の種類については、答えは component でもそれが置かれた境界でもなく、アタッチメントです。アタッチメントは、それについて書いた 2 つの座標の両方、つまりアタッチ先の component と features: の下のキーの組、または境界パスとその境界での名前の組によって識別されます。そのため、1 つの component 上の 2 つのアタッチメントは、異なる component 上の 2 つとまったく同じように 2 つの寄与者であり、2 つの境界に書かれた 1 つの feature 名は、名前が各境界で同じであっても 2 つの寄与者です。2 つの寄与者であることが、それぞれの構成でそれらの識別情報を比較可能にします。そもそも 2 つが比較されるかどうかは、ここでの他のすべての名前と同じ規則に従います。そのため、provider がマージする場合、出力が固有の別ファイルとして書き出されるアタッチメントはマージされたドキュメントの外にあり、自分自身とだけ比較されます。したがって、1 つの識別情報に至る 2 つのアタッチメントは、互いの出力が届く場所であればどこでも停止し、各検出結果は両方の座標を挙げるため、分離すべき 2 つのものを判別できます。両方の座標が構成された値の一部であるため、区別できる 2 つのアタッチメントは、収まる長さであれば必ず 2 つの識別情報に至ります。そのため、この停止に至る構成は、ターゲットに対して長すぎる値が短縮され、短縮された 2 つの値が出会った場合です。短縮された 2 つの識別情報が出会い、互いの出力が届かない場合、つまりマージする provider の下で 1 つの component 上の 2 つのアタッチメントがそれぞれ固有の別ファイルとして書き出される場合は、何もそれらを比較せず、2 組のリソースが 1 つの aggrega.ai/component-id を共有することになります。

停止すべきように見えて停止しないため、明示しておく価値のある構成が 1 つあります。2 つの component に同じ名前で feature をアタッチすることは完全にサポートされており、名前の変更は不要です。component は構成された値の一部であるため、api 上の metrics と web 上の metrics は 2 つの識別情報に至り、各 component のリソースは固有の識別情報を得ます。これは重要です。多くの component にわたって 1 つのアタッチメント名を設計上付与するカスケードでは、作成者に書ける別の名前が残らないためです。FeatureRecipe がリソースを配信するあらゆる方法は、出力するものにその識別情報を付与します。ソースをベンダリングしてそのままレンダリングするだけの方法も含まれるため、そのすべてが比較されます。FeatureRecipe が何も出力しない feature には、比較するものがありません。

ビルドは一方を残して他方を破棄するのではなく、停止します。正しい暗黙の解決策は存在しません。最初のものを残すと、宣言したリソースが出力から完全に除かれたままビルドが成功を報告し、除かれたものを参照していたものは何であれ、代わりに残った方へと気づかれないまま解決されてしまいます。衝突するすべての名前が、名前の種類と、それを導出したすべての寄与者の名前とともに報告されます。そのため、1 回のビルドで衝突を 1 つずつではなく全体像を把握できます。自身の出力が名前を 2 回持つ寄与者は、名前を複数回導出したものとして挙げられます。これにより、分離すべき 2 つのものが 2 つの component の間ではなく、その 1 つの component の内部にあることがわかります。

出力されるメッセージ。 衝突する名前ごと、contributor ごとに 1 件の finding が報告されるため、名前を派生した各 contributor は 1 つのメッセージ内のリストにまとめられるのではなく、個別に示されます。2 つの contributor が名前を派生した場合は少なくとも 2 件の finding があり、それらは共通点を述べるレポートの下にまとめて届きます:

dispatch groups whose contributors derive one name more than once in one key space(contributor が 1 つのキー空間で 1 つの名前を複数回派生している dispatch グループ)

各 finding は、その名前、名前の種類、名前を派生した contributor、および出力がマージされるアセンブリの provider とパスを示します:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<contributor>", provider "<provider>", dispatch path "<path>")(派生名の衝突:1 つのキー空間で 1 つの名前が複数回派生されています)

contributor はその実体に応じて示され、それが名前の記述場所を表します。component インスタンスには derived by component、boundary にアタッチされた feature には derived by feature が使われます。

contributor 自身の名前だけでは特定できない場合は 2 つ目の座標が続き、それがどれになるかは種類によって異なります。boundary にアタッチされた feature は boundary のパスを持ちます。1 つの feature 名が複数の boundary に記述される可能性があるためです:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by feature "<feature-name>", attached at boundary "<boundary-path>", provider "<provider>", dispatch path "<path>")(派生名の衝突:1 つのキー空間で 1 つの名前が複数回派生されています)

component は、名前を派生したレンダリングを行ったアタッチメントのキーを持ちます。component は記述したキーごとに 1 つのアタッチメントを持つためです:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<component>", carrying attachment "<attachment-key>", provider "<provider>", dispatch path "<path>")(派生名の衝突:1 つのキー空間で 1 つの名前が複数回派生されています)

component 自身のレンダリング、つまり provider がアタッチメントではなく component 自体に対して派生した名前は 2 つ目の座標を持たないため、finding は component の名前で終わります。

単一の contributor 自身の出力に同じ名前が 2 回含まれる場合、その contributor が唯一の finding となるため、上位のレポートなしに単独で届きます。また、他の contributor と衝突したのではなく、名前を複数回派生したものとして示されます:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived more than once by component "<contributor>", provider "<provider>", dispatch path "<path>")(派生名の衝突:1 つのキー空間で 1 つの名前が複数回派生されています)

ここでも 2 つ目の座標は上記と同じ条件で contributor の後に続くため、1 つのアタッチメント自身の出力内での重複は、それを持つ component だけでなく、そのアタッチメントを示します。

修正方法: 2 つの contributor が示されている場合は、Aggregate 内でそのうち一方の名前を変更し、そこから派生する名前がもう一方と一致しないようにします。名前の種類が component-id の場合、各 finding が変更すべき対象をすでに示しています。carrying attachment "…" はその component の features: ブロック内のキーであり、feature "…" attached at boundary "…" はその boundary の features: ブロック内の名前です。2 つの finding の違いが示す boundary だけである場合、2 つのアタッチメントが 2 つの boundary で 1 つの名前を持っています。一方の名前を変更するか、2 つの boundary に異なる directory: パスを指定して出力がマージされないようにします。2 つの名前がビルドによって合成されたものである場合、それらはターゲットに合わせて短縮された後にしか一致しえないため、ビルドに任せず、合成元の部分を自分で短くします。両方の名前が明示的に設定したもの(Recipe が provider に渡す値、または provider が読み取るアノテーション)から派生している場合は、2 つのうち管理できる方でそれを変更します。2 つの contributor が本当に別々の出力に属する場合は、それぞれの boundary に異なる directory: パスを指定し、各々が個別にアセンブルされて 2 つの名前が出会わないようにします。単一の contributor が名前を複数回派生したものとして示されている場合、衝突している 2 つはどちらもその 1 つの component の内部にあります。その Recipe が生成するリソースのうち名前が一致する 2 つを見つけ、一方の命名元(宣言されているキー、または構築元の値)を変更して、provider がそれぞれに異なる名前を派生するようにします。名前の種類が resource-names:ClusterRole のようなクラスタスコープの kind 単独である場合、示されたドキュメントは、どの namespace に配置されていてもクラスタ内の 1 つのオブジェクトを表します。1 つの contributor からのみ出力する(チャートが提供する値、たとえば定義をインストールするスイッチを通じて)か、2 つを別々のオブジェクトにする意図であれば、管理しているチャートまたは本体で一方に固有の名前を付けます。単一の contributor がこれについて 2 回示されている場合は、それを 2 つの namespace に書き出しており、2 つのドキュメントのうち一方を削除すべきです。

An authored export name is one the build derives for a cross-stack reference(記述したエクスポート名が、ビルドがクロススタック参照のために導出する名前と一致している)

cloudformation Recipe の Outputs: ブロックは記述された CloudFormation であり、その中のエントリは Name: を持つ独自の Export: を持てます。その名前は記述どおりに組み立て後のスタックに届きます。これとは別に、uses エッジがあるバウンダリから別のバウンダリへまたがる場合、プロバイダは消費される値を、release、バウンダリ、コンポーネント、提供キーから導出した名前の Export を持つスタックの Output として公開します。この停止は両者が一致したときに発生します。記述した名前が同じビルドで導出が生成した名前と同じであり、スタックは 2 か所から 1 つのエクスポート名を 2 回宣言することになりますが、エクスポート名は一意でなければなりません。

停止するのは一致した場合だけです。Outputs エントリでエクスポート名を宣言することはサポートされており、導出された名前のいずれとも一致しない名前は、導出された名前と並んで特に何も示されずに公開されます。ただし、クロススタック参照が消費するキーのために独自のエクスポートを公開するスタック出力のエントリは例外です。そこにある Export: は、導出された名前とまったく同じ名前を持たない限り停止します。このケースは The output a cross-stack reference publishes on already carries an Export(クロススタック参照が公開先とする出力にすでに Export がある) です。

この停止は、導出されたエクスポート名とその構成元である 4 つの部分をあわせて示すため、どのクロスバウンダリ参照がそれを生成したかを確認できます。また、宣言が置かれているスタック出力の名前も示します。これは Recipe が記述した名前ではなくプロバイダが組み立てる名前として示されます。プロバイダはコンポーネントとエントリを論理 ID が許す英字と数字にエンコードしてその名前を構築するため、どちらが記述された文字列とも異なるからです。検索すべきなのはエクスポート名です。 エントリはそれを停止メッセージとまったく同じ綴りで書いており、だからこそ両者が衝突になります。したがって、メッセージと自分のファイルの両方に現れる唯一の文字列です。

比較の範囲は 1 つのスタックです。そのスタックが宣言するエクスポート名を、そこへ公開するクロスバウンダリ参照のために導出された名前と比較します。2 つのスタック同士は比較されません。また、CloudFormation 組み込み関数として書かれたエクスポート名はデプロイ時に解決されるため、比較する名前がありません。アカウントとリージョンにすでにデプロイされているエクスポートとの一致はデプロイの性質であり、ビルドからは観測できません。

出力されるメッセージ。条件が失敗の種類を示し、プロバイダ自身の文が何が起きたかを述べます。周囲のレポートは、配線中の uses エッジも示します:

two things a plugin produced occupy one name in its output(プラグインが生成した 2 つのものが出力内の 1 つの名前を占有している) cloudformation-provider: an export name a cross-boundary link derives is already declared by another Outputs entry in the same stack: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and another Outputs entry of the same stack already declares that same export name — that declaration sits under the stack output <stack-output>, a name this provider assembles rather than one a Recipe wrote; each shadowing Outputs entry spells its export name exactly as the halt does, so searching your Recipes for that name reaches the entry — rename the export name the entry declares, or remove that entry’s Export block and let the link publish the export(クロスバウンダリリンクが導出するエクスポート名が、同じスタック内の別の Outputs エントリですでに宣言されている)

修正方法: 停止メッセージが示すエクスポート名で Recipes を検索します。それを宣言している Outputs エントリは同じ綴りで書いています。そのうえで、一致しなくなるようにそのエクスポート名を変更するか、そのエントリの Export: ブロックを削除してクロススタック配線にエクスポートを公開させます。エントリがエッジの消費する値と同じ値をエクスポートするために存在していた場合は、通常は削除が適切です。プロバイダはいずれにせよその値の Export を公開するため、記述したものは何も追加しません。エントリが、自分で選んだ名前でその値をインポートする別の消費者のためにエクスポートしている場合は、記述した Export: を残して名前を変更します。

The output a cross-stack reference publishes on already carries an Export(クロススタック参照が公開先とする出力にすでに Export がある)

uses エッジがあるバウンダリから別のバウンダリへまたがる場合、プロバイダは消費される値の Export を、生成側のコンポーネントと提供キーのために組み立てるスタック出力上に公開します。これは、cloudformation Recipe の Outputs: ブロックがそのキーの下にエントリを書いたときに到達するのと同じ出力です。その出力にすでにある Export: は、その Name: がプロバイダの導出する名前とまったく同じ場合にのみ保持されます。それは、同じ値に対する以前のクロススタック参照がすでに公開したエクスポートであり、すべての消費者が 1 つの名前をインポートすることになるからです。それ以外の Export: はすべて停止します。プロバイダのエクスポートを書き込めば記述した内容が上書きされ、記述したものを残せば、すべての消費者が参照の公開していない名前をインポートすることになるためです。

この停止は、その出力にある次の 4 つの形の Export: で発生します:

  • 異なる文字列である Name:;
  • CloudFormation 組み込み関数として書かれた Name:。デプロイ時に解決されるため、プロバイダはその内容を読み取れません;
  • 何も名前を指定していない Export: ブロック;
  • ブロックではなく単純な値として書かれた Export:。

それ以外の Outputs エントリで宣言したエクスポート名は、An authored export name is one the build derives for a cross-stack reference(記述したエクスポート名が、ビルドがクロススタック参照のために導出する名前と一致している) で別途比較されます。

出力されるメッセージ。条件が失敗の種類を示し、プロバイダ自身の文が何が起きたかを述べます。周囲のレポートは、配線中の uses エッジも示します:

two things a plugin produced occupy one name in its output(プラグインが生成した 2 つのものが出力内の 1 つの名前を占有している) cloudformation-provider: the stack output a cross-boundary link publishes its export on already carries an Export the link did not write: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and the stack output this provider assembles for that key and component <what-it-found>; remove that entry’s Export block and let the link publish the export every consumer imports(クロスバウンダリリンクがエクスポートを公開するスタック出力に、リンクが書いていない Export がすでにある)

<what-it-found> は、上記の形の順に次のいずれかです:

already declares the export name <name>(エクスポート名をすでに宣言している) already declares an export name that is not a string — one given as an intrinsic, which resolves at deploy time, so this provider cannot read what it spells(文字列ではないエクスポート名をすでに宣言している) already carries an Export block declaring no export name(エクスポート名を宣言していない Export ブロックをすでに持っている) already carries an Export that is not a block, where CloudFormation expects one carrying a Name(ブロックではない Export をすでに持っている)

修正方法: 停止メッセージが示すコンポーネントの Recipe で、示された提供キーの下に書かれた Outputs エントリを見つけ、そのエントリの Export: ブロックを削除します。するとクロススタック配線が、すべての消費者がインポートするエクスポートを公開します。このビルド外の消費者のために独自の名前でも値をエクスポートする必要がある場合は、別のキーの下の Outputs エントリにその Export: を書きます。そこでのエクスポート名は、ビルドが導出する名前でない限りサポートされています。

Chart-name mismatch on a merged helm-chart umbrella(マージされた helm-chart アンブレラでのチャート名の不一致)

2 つ以上のバウンダリが同じ helm-chart プロバイダのアセンブリパスに寄与していますが、それらの有効な aggrega.ai/chart-name アノテーション(バウンダリのアノテーションカスケードを通じて解決されたもの)が一致していません。Helm のアンブレラチャートのチャート名はちょうど 1 つであり、レンダラは競合する候補の 1 つを選べません。

出力されるメッセージ。 寄与するバウンダリごとに 1 件の指摘が報告され、各指摘はそのバウンダリが解決した値を持ちます。そのため、一致しない名前は 1 つの出力されたコレクションとしてではなく、指摘ごとに 1 つずつ届きます。それらが届くレポートは共通点を述べます:

merged dispatch groups whose boundaries disagree on the assembly name(バウンダリ間でアセンブリ名が一致しない、マージされたディスパッチグループ)

各指摘は、そのバウンダリが解決した値、読み取り元のアノテーション、バウンダリ、プロバイダ、マージ先のパスを示します:

merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>")(マージされたパスのアセンブリに、競合するアセンブリ名アノテーション値がある)

修正方法: 寄与するすべてのバウンダリで一致する aggrega.ai/chart-name アノテーションを宣言します(寄与するバウンダリが親バウンダリを共有している場合、カスケードの仕組みによりこれを DRY にできます。親で一度宣言してください)。または、バウンダリを別々の directory: パスに分け、それぞれが独自のアンブレラチャートを持つようにします。

FeatureRecipe template references a field outside its scope’s allowlist(FeatureRecipe テンプレートがスコープの許可リスト外のフィールドを参照している)

executionScope: boundary を持つ FeatureRecipe が、バウンダリに対して 1 回だけ実行されるテンプレート(その locals:、provides:、valuesMapping:、artifacts:、またはパイプラインステップの with: や when:)の中で、.context.instance_id、.context.inject、.context.uses のようなコンポーネント単位専用のフィールドを参照しています。これらはバウンダリスコープでは意味のある値を持たないフィールドです。逆の条件も成り立ちます。.boundary.* フィールドを参照するコンポーネントスコープの FeatureRecipe(デフォルト)も同じバリデータで失敗します。検証は、レンダリング作業が始まる前の解析時に、該当スコープのフィールド許可リストに対して実行されます。バウンダリスコープの FeatureRecipe の injectMapping はここではチェックされません。これはアタッチメントが届く各コンポーネントについて、そのコンポーネントのコンテキストで 1 回ずつ実行されるため .context.* を読み取り、その中の .boundary への参照は上記の「Template references a root the render context does not define(テンプレートがレンダーコンテキストで定義されていないルートを参照している)」で報告されます。

出力されるメッセージ:

FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>")(executionScope: boundary の FeatureRecipe テンプレートがコンポーネント単位専用のフィールドを参照しています)

valuesMapping が .context.instance_id を読み取るバウンダリスコープの FeatureRecipe では、次のように出力されます。

[CATALOG_ERROR E0039] scope-probe-fr at .spec.valuesMapping
FeatureRecipe template references a per-component-only field with executionScope: boundary (".context.instance_id", written in "valuesMapping", the render context defines ".values, .infra, .locals, .provides, .features, .metadata, .steps, .source, .boundary")

修正方法: スコープで利用可能なフィールドに合わせてテンプレートを書き直すか、FeatureRecipe の executionScope を変更します。boundary スコープの FeatureRecipes は .boundary.path、.boundary.boundary_name、.boundary.components、.boundary.*_uses_edges コレクション、.boundary.labels、.boundary.annotations、.boundary.feature_attachments を参照します。Component スコープの FeatureRecipes は .context.instance_id、.context.inject、.context.uses、.context.labels、.context.annotations を参照します。両方のスコープで .values、.infra、.locals、.provides、.steps、.metadata を共有します。Release のパラメータは、このサーフェスでは独立したピラーではありません。それを参照する values または infra のエントリを通じて FeatureRecipe テンプレートに届きます。

Self-inject value template references cross-node data(自己 inject の値テンプレートがノード間のデータを参照している)

コンポーネントレベルの inject: の value: テンプレートが .context.inject または .context.uses から値を取得しています。inject パイプはこのパスが構築しているものであり、コンポーネント自身の自己 inject 値の中にあるテンプレートはそこから読み取ることができません。

そうなる理由はこのサーフェスの .context にあります。これは instance_id、labels、annotations を持ち、それ以外は何も持ちません。したがって .context.inject と .context.uses はこのサーフェスのコンテキストが定義していないキーであり、この参照は上記の「Template references a root the render context does not define(テンプレートがレンダーコンテキストの定義していないルートを参照している)」として、何もレンダリングされる前のパース時に停止します。診断はテンプレートが属するメカニズムと配信キーを示し、ここで .context が定義しているキーを列挙します。そのため、同じレポートが、ノード間データへの実際のアクセスと、{{ .context.nmae }} のような単純なスペルミスの両方をカバーします。後者のほうがよくある間違いで、そうでなければ何もレンダリングされずに済んでいたはずのものです。

出力されるメッセージ(参照レベルの詳細)。周囲のレポートはノード、メカニズム、配信キーも示します:

template references a root the render context does not define(テンプレートが、レンダーコンテキストで定義されていないルートを参照しています) (template self-inject.<mechanism>[<key>] references .context.inject, .context defines .context.instance_id, .context.labels, .context.annotations)

コンポーネントレベルの inject: ブロックは Aggregate 内で記述されるため、レポートのすべてのフレームは developer ドメインにあります。

修正方法: コンポーネント間の配線を uses[].inject エントリに移動してください。ノード間のコンテキストが利用できるのはそこです。コンポーネントレベルの自己 inject の value: テンプレートは、コンポーネント自身の values と infra、その .context.instance_id / .context.labels / .context.annotations、および .metadata の範囲内に閉じたものにしてください。

Missing template key — asymmetric policy(テンプレートキーの欠落 — 非対称なポリシー)

キー欠落の扱いはテンプレートのサーフェスによって異なります。空のレンダリング結果が範囲の限られた場所、つまり作成者が読み返せる manifest のフィールドに収まる場合、欠落は許容され、その読み取りは何もレンダリングしません。空のレンダリング結果が代わりに誤った構造や誤った判定を生む場合、サーフェスは参照を空に解決するのではなく拒否します。

  • Aggregate におけるパラメータ補間(Aggregate 自身のテキストが持つ {{ .parameters.<key> }} 参照)は、これらのサーフェスのうち最も早いものです。カタログが解決される前の生のドキュメントに対して実行されるため、そのポリシーは他のどのサーフェスもまだ見ていないテキストに適用されます。Release が値を設定しなかったパラメータへの参照は何もレンダリングせず、そのような読み取りに対する default パイプや if ガードは、未設定のパラメータに対する場合とまったく同じように動作します。テンプレートが反復する参照は空として反復し続け、これは省略可能なリストを range で回す場合に望ましい動作です。ただし、テキストがそれを出力もする場合は例外で、後述の「A template reads and iterates a path that holds nothing(テンプレートが何も保持しないパスを読み取りかつ反復しています)」で説明するとおり停止します。親が存在しない参照(db パラメータが設定されていない場合の .parameters.db.host)は依然として停止します。下っていく先が存在せず、親を補えば停止の代わりに気付かれないまま誤った成果物が生まれるためです。ポリシーとしてではなく境界として述べておくべき点が 1 つあります: サーフェスが定義しないルートに基づく参照は、空としてレンダリングされず手を付けられないまま残るため、テンプレートエンジン自身のプレースホルダーテキスト <no value> として補間後のドキュメントに残ります。このサーフェスではこれによって停止するものはないため、すべてのパラメータ参照は .parameters を起点とし、紛れ込んだ <no value> はルートの綴り誤りと読んでください。
  • パステンプレート(Release の boundary の directory: / subDirectory:)は missingkey=error で評価されます。サーフェスが与えない変数への参照はパース時に停止し(上記の「Path-template references a variable outside the allowlist(パステンプレートが許可リスト外の変数を参照している)」を参照)、キーが宣言されている .manifest の下でのキーの打ち間違いも同様です。許可されているが評価時に未定義の参照、たとえば Release が提供しない .parameters のキーは、空文字列を気付かれないままディレクトリパスにレンダリングするのではなく、明示的なエラーを生じます。
  • assertions(Component、Feature、Recipe、FeatureRecipe 上)は missingkey=error で評価されます。未定義のキーへの参照は、エンティティ、インスタンス、アサーションを示す no-such-key 診断で停止します。この厳格さこそがアサーションを信頼できるものにしています。参照が空の値としてレンダリングされる述語は何もない値と比較して合格してしまい、1 つの打ち間違いで、そのアサーションが強制するために書かれたルールが気付かれないまま無効になります。素の参照はどのフォールバックも実行される前に停止するため、このサーフェスでは単純な default は省略可能なフィールドのフォールバックを提供しません。参照を hasKey でガードするか、存在チェックを直接行う optional ヘルパーを使用してください。index を通してキーを読んでもフォールバックにはなりません。index はマップが保持しないマップキーに対してそのキーを示して停止します。
  • 値テンプレート(Recipe の valuesMapping、locals: と provides: のエントリ、artifacts: の本体、Workload の本体、FeatureRecipe の injectMapping と pipeline.with、およびコンポーネントレベルのセルフインジェクトの value: テンプレート)は missingkey=zero で評価されるため、未定義のキーへの参照はビルドを停止しません。読み取りは何もレンダリングせず、成果物に届くのもその空の結果です。このサーフェスでもなお停止するのは、作成者が一度も指定していないコンテナを通り抜けて下っていく参照です(tls が記述されていない場合の .values.tls.ca)。下っていく先が存在しないためです。空としてレンダリングされるのは、すべてのコンテナが存在する参照の最後のキーだけです。コンテキストが定義しているものの何も保持していないトップレベルのフィールド(何も合成しない Recipe の .workload、アタッチメントのないコンポーネントの .features)も、全体として読み取った場合は同じように空としてレンダリングされます。1 つの参照は、どのように記述しても 1 つの参照です。.values.list、$.values.list、(.values).list は同じキーを指すため、1 つの記述で range することはすべての記述で range することであり、括弧で囲んだピラーから読み取ったキーは、直接の記述とまったく同じようにレンダリングされるか停止します。テンプレートが range するキーは、未設定の場合は空として反復し続け、テンプレートが出力もし range もするキーは、未設定の場合に停止します。後述の「A template reads and iterates a path that holds nothing(テンプレートが何も保持しないパスを読み取りかつ反復しています)」を参照してください。ガードは期待どおりに機能します。{{ .values.optional_field | default "fallback" }} は実際にフォールバックを与えます。未設定の値は default にとっては空、if にとっては偽として扱われるためです。不在とゼロ値の区別(「キーが存在しない」と「キーが存在し空である」の区別)が必要な作成者は、templates/sprig-functions.md に記載されている optional ヘルパーを使用し、あるキーはテンプレートごとに 1 つの方法で読み取ります。同じテンプレートが .values.<key> としても読み取るキーは存在するものとみなされるため、optional はフォールバックではなくその空の値を返します。このポリシーの対象外となるのは index を通した読み取りです。マップに存在しないキーでマップをインデックス参照すると、他のすべてのサーフェスと同様にここでもキーを示して停止します。後述の「A template indexes a map with a key the map does not hold(テンプレートがマップに存在しないキーでマップをインデックス参照しています)」を参照してください。
  • source: 座標(Recipe または FeatureRecipe 上の構造化された source: ブロックのテンプレート化されたフィールド:version、ref、chart、module_subdir)は missingkey=error で評価されます。何も提供しないキーへの参照は、空に解決されるのではなく、source フィールドを示して停止します。空の version や ref は作成者が指定したものとは異なる成果物をピン留めしてしまい、そのピンは以降のすべてのビルドが再現するものだからです。このサーフェスは、利用可能な関数セットが異なる場所でもあり、ブロック自体の作成者の記述順序が拒否する locals: 参照が何かが評価される前に停止する場所でもあります。以下を参照してください。
  • 型付きパラメータ契約は、必須パラメータの欠落と契約違反のケースを、補間が実行される前にパラメータ契約の層で検出します。上記の「Parameter type mismatch / contract violation(パラメータの型の不一致 / 契約違反)」を参照してください。

ヘルパーのセットは値テンプレート、パステンプレート、アサーションで共通です:Sprig の関数に Aggrega 独自のもの(optional と capitalizedWords)を加えたものです。Sprig の fail もその中に含まれるため、後述の「A value template failed while it ran(値テンプレートが実行中に失敗した)」で説明するとおり、値テンプレートは独自のメッセージでビルドを停止できます。アサーションはそのために書かれるサーフェスであり、ビルドを停止することがその目的のすべてです。この 3 つの間で異なるのはキー欠落のポリシーです。optional はパステンプレートでも利用でき、そこでは厳格なポリシーが先に発動することなく .parameters からキーを読みます。source: 座標の解決は関数セットそのものが異なり、下記に独自のサブセクションがあります。Aggregate におけるパラメータ補間は Sprig の関数のみを提供するため、そこではどちらの Aggrega ヘルパーも利用できません。座標と補間を含め、これらすべてのサーフェスで同じように読める関数が 1 つあります。index で、読み取るマップがキーを保持しない場合にそのキーを示して停止します。

パステンプレートの欠落時に出力されるメッセージは、その状態を説明するエントリである上記の「Path-template references a variable outside the allowlist(パステンプレートが許可リスト外の変数を参照している)」の下に引用されているため、ここでは繰り返さず 1 か所にのみ記載しています。

修正方法: パステンプレートの欠落の場合は、フィールド名を path-template-variables.md に記載された許可リスト内のものに修正してください。アサーションの欠落の場合は、参照を修正するか(報告の多くはキーの綴り誤りです)、フィールドが本当に省略可能な場合は hasKey でガードするか optional ヘルパーを使用してください。素の参照を default で囲んでも停止は解消されません。フォールバックが実行される前に参照が解決されるためです。index を通して読んでも同様に解消されません。index はマップが保持しないキーで停止するためです。空のレンダリングが望ましくない値テンプレートの欠落の場合は、optional ヘルパーを使用するか、欠落しているキーを、Release の値を伴う Aggregate 上の型付き parameters.* 宣言として、uses[].inject を通して配線された上流の Component の provides: エントリとして、または同じエンティティ上の locals: エントリとして提供してください。

Resolving a source: coordinate registers a narrower function set (source: 座標の解決では、より狭い関数セットが登録されます)

構造化された source: ブロックは、それが指すアーティファクトをピン留めできるように解決されます。この解決では Aggrega 独自のヘルパーのみ が登録されます。optional と capitalizedWords は利用でき、index は Recipe のレンダリング時とまったく同じく、マップが保持しないキーで停止します。Sprig の関数は利用できません。Recipe や FeatureRecipe がテンプレートを記述するサーフェスのうち、関数セットが異なるのはこのサーフェスだけです。そのため、同じ Recipe の他の場所では正しくレンダリングされる式がここでは拒否されることがあります。この狭い関数セットは意図的なものです。何がピン留めされるかは作成者が与える values と infra によって決まるべきであり、Sprig の関数には時計、環境、乱数源、ネットワークを読み取るものが含まれるためです。

source: フィールド内、またはそのフィールドが読み取る locals: エントリ内で Sprig 関数を呼び出すと、パース時に停止します。診断の先頭には E0111 が付き、エントリ、それを読み取る source: フィールド、解決できなかった関数、およびこのサーフェスが登録するヘルパーが示されます。

resolve: parse template at <name>:<version>.spec.locals.<key>, read by <name>:<version>.spec.source.<field>: resolve: source-template parse error (cause: template: <name>:<version>.spec.locals.<key>:1: function "<function>" not defined); a source field, and every locals entry it reads, is evaluated when the source is resolved with Aggrega’s own helpers only (optional, capitalizedWords and index), not the Sprig functions a render adds; write the value without that function, or move the value into a locals entry no source field reads(source フィールドと、それが読み取るすべての locals エントリは、source の解決時に Aggrega 独自のヘルパー(optional、capitalizedWords、index)のみで評価され、レンダリング時に追加される Sprig 関数は使われません。その関数を使わずに値を記述するか、どの source フィールドも読み取らない locals エントリに値を移してください)

source: フィールド自体がその関数を呼び出す場合も同じ形で報告され、フィールドのみが示されます。

対象範囲は、座標が読み取るエントリです。 座標の解決では、source: フィールドが読み取る各 locals: エントリと、そのエントリがさらに読み取る各エントリが評価され、それ以外は評価されません。どの source: フィールドからも到達しないエントリは、source の解決中に評価、パース、チェックのいずれも行われません。そのため、レンダリングに必要なローカル(Sprig の関数で計算を行うものや、.context.instance_id に基づいてリソース名を付けるものなど)はアーティファクトのピン留めに影響せず、Recipe のレンダリング時に評価され、そこに不備があればその時点で報告されます。フィールドがどのエントリを読み取るかはそのテキストから判定されます。そのため、特定のエントリを指さない形で .locals を読み取るフィールド({{ index .locals "version" }}、ブロック全体を optional に渡す、または変数に束縛するなど)では、代わりにすべてのエントリが評価されます。この経路で到達したエントリの診断にはその旨が示され、read by <field> の代わりに evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated と表示されます。

このサーフェスの外にある形が 2 つあります。 Recipe がどちらに該当するかを知ると、同じ式がある Recipe では受け入れられ、別の Recipe では拒否される理由がわかります。

  • 単純な文字列として記述された source:(マッピングではなく URI またはローカルパス)はそのまま扱われるため、評価するフィールドがなく、ここでは locals: ブロックはまったく解決されません。
  • source: を宣言しないエンティティ は座標を解決しないため、その locals: ブロックはそのエンティティ自身のレンダリングのためにのみ解決され、そこでは完全な関数セットが適用されます。

座標が読み取るすべてのエントリについて、参照順序の契約はここでも同じです。 座標の解決では、評価する各エントリについて、レンダリング時に拒否されるのと同じ参照が拒否されます。すなわち、ブロック内で自身より下に宣言された兄弟を読み取るエントリと、ブロックが宣言していないキーを読み取るテンプレートです。どちらも、上記の「locals: entry references a sibling defined later in the same block」と「locals: key does not exist」で説明した条件として報告され(どちらの解決が先に到達しても、同じ条件、同じ対処法です)、報告にはそのエントリが評価された対象の source: フィールドが示されます。どの source: フィールドも読み取らないエントリの不備は、Recipe のレンダリング時に同じ条件で拒否されます。

このサーフェスが見送るのは、座標がどうしても解決できないエントリです。 つまり、アーティファクトのレンダリング中にのみ存在するデータを読み取るエントリで、.context.instance_id がその代表的なケースです。このようなエントリはスキップされるため、座標が通らない分岐でそのようなエントリに到達する Recipe も、引き続きピン留めされます。座標自体がそのエントリを必要とした場合、解決は source: フィールドを示して停止し(上記でこのサーフェスについて説明した、先頭に E0110 が付く欠落キーの報告です)、読み取れなかったキーとともに、そのエントリがここで値を持たない理由を引用します。

resolve: evaluate template at <name>:<version>.spec.source.<field>: resolve: source-template evaluation failure at lock time (cause: template: … map has no entry for key "<key>"); it reads <name>:<version>.spec.locals.<key>, which could not be evaluated here (cause: template: … map has no entry for key "context")(ロック時の source テンプレートの評価に失敗しました。読み取り先の locals エントリはここでは評価できませんでした)

source: フィールドも、それが読み取る locals: エントリも、.provides を読み取ることはできません。 locals: ブロックは provides: ブロックに値を渡すものであり、その逆はありません。そのため、このサーフェスで .provides を読み取るテンプレートは、何もないものとして解決されるのではなく、逆参照として拒否されます。この拒否は後のフェーズで満たされるようなロック時の欠如ではなく、どのような順序でもこの参照は有効にならないため、座標がどこで解決されても同じ形で報告されます。診断の先頭には E0112 が付き、フィールド、またはエントリとそれを読み取るフィールドを示し、参照の何が誤っているかを述べ、式が代わりに読み取れるサーフェスを示します。

source-version template at <name>:<version>.spec.source.<field> references .provides, which is an invalid reverse reference (locals feed provides, never the reverse) — refactor to read only .values and .infra (and .locals over the same): resolve: source-template references .provides (invalid reverse reference)(spec.source のフィールドの source-version テンプレートが provides を参照していますが、これは無効な逆参照です(locals が provides に値を渡し、その逆はありません)。values と infra(およびそれらに基づく locals)のみを読むようにリファクタリングしてください: resolve: source テンプレートが .provides を参照しています(無効な逆参照))

停止が発生する場所: ロックファイルの書き込み時または更新時、つまり aggrega pull、またはロックファイルを書き込むビルド(--auto-pull、--upgrade、またはワークスペースの auto_pull 設定)です。各失敗は 1 つの診断として報告され、先頭には問題の内容を示すコードが付きます。パースできないテンプレートには E0111、.provides の参照には E0112、パースはできたが評価できなかったテンプレートには E0110 です。これはターミナルでも、aggrega serve に接続したエディタでも同じです。source: フィールドでのキーの欠落は、利用できない関数とは異なり、パース時ではなく実行時に報告され、フィールドと読み取れなかったキーが示されます。

対処法: optional はこのサーフェス と、すべての値テンプレート、パステンプレート、アサーションに登録されているため、移植性のある選択肢です。{{ default "25.0.8" .values.chart_version }} の代わりに {{ optional .values "chart_version" "25.0.8" }} を使います。置き換える前に意味の違いを確認してください。optional はキーが 存在しない ときに作動し、default は値が 空 のときに作動します。そのため、空文字列やゼロとして記述されたキーは、optional では記述された値が保たれ、default では置き換えられます。式が本当に Sprig 関数を必要とする場合(フォールバックを与えるのではなく文字列を加工する場合)は、座標が読み取る範囲の外に置いてください。つまり、どの source: フィールドも読み取らない locals: エントリに置くか、それを利用するサーフェス(valuesMapping、Workload の本体、artifacts: エントリ)に置きます。

A template indexes a map with a key the map does not hold(テンプレートがマップに存在しないキーでマップをインデックスしている)

テンプレートが index を通じてマップを読み取り({{ index .values "replicas" }}、またはテンプレートが計算したキー名を使う {{ index .context.inject.env $apiKeyVar }} など)、要求されたキーをマップが保持していない場合です。index はその時点で停止してキーを示します。これはテンプレートを評価するすべての面で起こります。値テンプレート、locals: と provides: のエントリ、パステンプレート、アサーション、構造化された source: 座標、Aggregate におけるパラメータ補間とそのパラメータの validate: 述語、そしてスキーマの x-aggrega-when: および x-aggrega-validate: 述語です。

これは index だけの性質であり、どの面の欠落キーポリシーもこれを変えません。 上記の「Missing template key — asymmetric policy(テンプレートキーの欠落 — 非対称ポリシー)」で説明しているとおり、開いたピラーの下で未設定のキーをドットで読み取っても、値テンプレートでは引き続き何も出力されません。また、作成者がそのようなキーを指定したかどうかを判定するテンプレートは影響を受けません。停止するのは、マップが保持していないキーを index に要求した場合です。index は、テンプレートが名前を計算したキー(たとえば、利用側の Recipe が選んだ変数名で読み取る認証情報)に到達する手段です。停止がなければ、その読み取りはビルドが成功する一方で、テンプレートエンジンのプレースホルダーテキスト <no value> を成果物に書き込んでしまいます。つまり、そのテキストをキーとしてサーバーが起動することになります。index が返すそれ以外の答えはすべてテンプレートエンジン自身のものです。リストや文字列内の位置、範囲外の位置、マップが保持するキー(値が null で <no value> を出力するものも含む)です。

出力されるメッセージ(レポートの最終行)。その上のフレームはノードとテンプレートが置かれたフィールドを示し、Recipe または FeatureRecipe の値テンプレートでは、先頭にこの条件のコードが付きます:

template: <template>:<line>:<column>: executing "<template>" at <index <map> <key>>: error calling index: template indexes a map with a key the map does not hold (key "<key>"). read a key that may be absent through a function that tests for it first, such as optional, get or hasKey

テンプレートの失敗を独自の条件で報告するサーフェス、つまり provides: エントリ(“A provides: template could not be evaluated(このテンプレートを評価できませんでした)”)、パラメータ補間(“A {{ .parameters.* }} reference cannot be interpolated(この参照を補間できません)”)、スキーマ述語(“An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated(この述語を評価できません)”)、source: 座標(“Resolving a source: coordinate registers a narrower function set(この座標の解決では、より限定された関数セットが登録されます)“)では、先頭にはその条件のコードが付き、上の行はその条件が示す理由となり、キーも含まれます。

修正方法: そのキーが正当に存在しない可能性があるかどうかを判断します。

  • 存在しない可能性がある場合。 先に存在を確認する関数を通じて読み取ります。{{ optional .values "replicas" 1 }} はキーが存在しないときはフォールバックを返し、存在するときはその値が何であれその値を返します。Sprig の get は存在しないキーに対して空文字列を返し、hasKey は読み取らずに判定します。optional はパラメータ補間と、パラメータやスキーマの述語を除くすべての面で登録されています。これらの面では Sprig の get と hasKey が使えます。source: 座標は optional を登録し、Sprig は登録しません。
  • 存在してはならない場合。 キーを指定します。メッセージが示すキーはテンプレートが要求したキーです。よくある原因は、別の名前で公開されたキー(key が Recipe の読み取る変数名と一致しない認証情報など)、テンプレートまたは作成した値でのキーの綴り間違い、そしてキーを届けるはずの接続が配線されていないことです。

A template reads and iterates a path that holds nothing(テンプレートが何も保持していないパスを読み取り、反復する)

テンプレートがパスをそのまま出力し、さらに同じパスに対して反復処理も行います。たとえば 1 つの valuesMapping 内に "user": "{{ .values.user }}" と "users": "{{ range .values.user }}…{{ end }}" がある場合です。そしてデータはそこに何も保持していません。つまり、キーが未設定であるか、null を保持しているか、あるいはコンテキストが定義しているものの何も保持していないトップレベルのフィールド(ワークロードを合成しない Recipe における .workload など)です。ビルドはテンプレートの実行前に停止し、そのパスを示します。これは未設定の値を何もないものとしてレンダリングするすべての箇所で起こります。すなわち、上記の「Missing template key — asymmetric policy(テンプレートキーの欠落 — 非対称なポリシー)」が挙げる値テンプレートと、Aggregate におけるパラメータ補間です。

それぞれの読み取りには、単独であれば答えがあります。出力される未設定の値は何もレンダリングせず、反復される未設定の値は何も反復しません。両方の方法で読み取られるパスには、どちらの答えも当てはまりません。何もないものとしてレンダリングすると range がテキストに対して失敗し、未設定のままにすると、ビルドが成功する一方でテンプレートエンジンのプレースホルダーテキスト <no value> が成果物に出力されてしまいます。そのため、どちらの答えも与えられず、代わりにビルドが停止します。

パスの出力とみなされるものの範囲は狭く、テンプレートが確実にそれを出力する箇所で線が引かれます:

  • 出力とみなされるのは、アクションがパスのみで構成され、それ以外に何も含まない場合です。{{ .values.user }}、{{ $.values.user }}、{{ (.values).user }}、またはパスに束縛された変数({{ $u := .values.user }} の後の {{ $u }})が、テンプレートが実行されるたびに必ず到達する位置にある場合がこれに当たります。
  • 出力とみなされないのは、読み取りが if、with、range の本体内、または else 分岐内にある場合です。その読み取りが実行されるかどうかは条件に依存し、その条件こそが何もないものに出会うのを防ぐテストである可能性があるためです。そのため、range .values.user の横にある {{ if .values.user }}{{ .values.user }}{{ end }} はこれまでどおりレンダリングされます。また、ガード自身のテスト、変数への代入、または関数の引数({{ .values.user | quote }}、{{ toYaml .values.user }})である場合も出力とはみなされません。その出力はプレースホルダーではなく関数の答えだからです。

実際に実行される本体の中で、何も保持していないパスを出力すると、やはり <no value> が書き込まれますが、これはこのチェックの対象外です。パスのある表記は他のどの表記とも同じパスであるため、ある表記での出力と別の表記での range はまとめて判定され、メッセージにはテンプレートが最初に書いた表記が引用されます。値を保持するパスはこれまでどおり出力・反復され、親が何も保持していないパスは、何もないものをたどって下る際にすでに発生する停止に委ねられます。

出力されるメッセージです。レポートの最終行として出力され、その上のフレームがノードとテンプレートを示し、先頭にはこの条件のコードが付きます:

template reads a path as a value and iterates it, and the data holds nothing at that path (path <path>). supply a value at the path, guard the printed read with an if or with over the path, or read it one way only(テンプレートがパスを値として読み取り、さらに反復していますが、データはそのパスに何も保持していません。パスに値を指定するか、出力される読み取りをそのパスに対する if または with でガードするか、一方の方法だけで読み取ってください)

Aggregate におけるパラメータ補間も、同じ行をこの条件のコードで報告します。provides: エントリはテンプレートの失敗を「A provides: template could not be evaluated(テンプレートを評価できなかった)」で報告するため、その場合は先頭にその条件のコードが付き、上記の行はそれが持つ理由となり、パスも含まれます。

修正方法: テンプレートが 2 つの読み取りのどちらを意図しているかを判断します。

  • パスが存在しなければならない場合。 パスを指定します。Aggregate の values:、Release の infra:、または Release が値を与えるパラメータで指定するか、それを管理するスキーマで必須として宣言し、パスがないことが記述された場所で報告されるようにします。
  • パスがなくてもよい場合。 出力される読み取りをガードします。{{ with .values.user }}{{ . }}{{ end }} または {{ if .values.user }}{{ .values.user }}{{ end }} は未設定のときに何も出力せず、その横の range は引き続き何もないものとして反復します。
  • 1 つの読み取りで十分な場合。 パスを一方の方法だけで読み取ります。必要なものも書き出す range を使うか、toYaml や join のように未設定の値に対して自ら答えを返す関数を通して出力します。

A value template failed while it ran(値テンプレートが実行中に失敗した)

Recipe または FeatureRecipe の値テンプレート(上記の「Missing template key — asymmetric policy(テンプレートキーの欠落 — 非対称ポリシー)」が挙げるテンプレートの 1 つで、Workload の本体、artifacts: の本体、locals: のエントリなどを含みます)が解析され、実行を開始し、テキストを生成する前に停止しました。停止させたのはテンプレートエンジン自身の理由であり、停止の報告はその下にそれを示します。何も与えられていないコンテナを通って下る参照(たとえば tls が記述されていないのに {{ .values.tls.ca }} を参照する場合)、2 つの型の値の比較(たとえば {{ if eq .context.instance_id 1 }} はテキストと数値を比較し、cannot compare text with a number で停止します)、あるいは Sprig の fail の呼び出しです。値テンプレートは独自のメッセージで入力を拒否するためにこれを呼び出せます。

これらのテンプレートでの 4 つの失敗は、代わりにそれぞれ独自の条件のもとで報告されます。provides: エントリは下記の「A provides: template could not be evaluated(テンプレートを評価できなかった)」で報告され、そのメッセージ内にこの文とエンジンの理由が含まれます。マップが保持しないキーの index による読み取りは、上記の「A template indexes a map with a key the map does not hold(テンプレートがマップの保持しないキーでマップを索引している)」で報告されます。何も保持していない 1 つのパスを出力しかつ反復するテンプレートは、実行前に拒否され、上記の「A template reads and iterates a path that holds nothing(テンプレートが何も保持していないパスを読み取り、反復する)」で報告されます。そして、解析できないテンプレートは実行前に停止するため、この条件には該当しません。

出力されるメッセージです。その上のフレームがコンポーネントインスタンスとテンプレート(recipe "<recipe>" workload template や Recipe "<recipe>" locals["<key>"] など)を示し、テンプレートエンジン自身の行がその下に続きます。

a value template failed while it ran(値テンプレートが実行中に失敗しました)

エンジンの行は template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> となり、fail の呼び出しであれば error calling fail: <the message the template wrote> となります。テンプレートは Recipe または FeatureRecipe の作成者が書くものであるため、ビルドはこの停止を CATALOG_ERROR タグで報告します。aggrega pull は、読み取る外部入力を見つけるために Release をレンダリングする際に同じ失敗に遭遇します。その場合、失敗を報告し、それでもロックファイルの依存関係のピンを書き込み、外部入力のピンが不完全である可能性を示します。ビルドはこれで停止します。

対処方法: レポートの末尾にあるエンジンの理由を読みます。テンプレート、行と列、停止した式が示されています。何も与えられていないコンテナであれば、それを与えるか、存在しないものの中に決して下らないよう読み取りをガードします({{ with .values.tls }}{{ .ca }}{{ end }}、または optional ヘルパー)。2 つの型が比較されている場合は、同種どうしで比較します(数値は引用符なしで書いた数値と、テキストは引用符付きで書いたテキストと比較します)。あるいは toString で一方をテキストに変換します。fail の呼び出しであれば、メッセージはテンプレート作成者のもので、その Recipe が何を必要としているかを示しています。それを与えるか、書いた内容を受け付ける Recipe にコンポーネントをマッピングします。

A governance plugin rejected the build(ガバナンスプラグインがビルドを拒否した)

オペレーターは、コンパイラが構築したグラフ、またはコンパイラが出力した成果物に対して、判定ロールでガバナンスプラグインをアタッチできます。このようなプラグインは読み取りを行い、判定を返します。ホストにはそこから返された変更を適用する経路がないため、判定ロールはビルドを拒否できますが、ビルドを準拠するように書き換えることはできません。拒否がそのロールにできることのすべてであり、何を変更するかは、それを読む人に委ねられます。

ビルドを停止するのは halt 判定だけです。warn と info の判定は報告され、ビルドは続行します。プラグインが返したすべての halt 判定が、プラグインが出力した順に報告されるため、1 回の実行ですべてを把握できます。

ビルドが出力するメッセージはプラグイン自身のものであり、返されたとおりそのまま表示され、返したプラグイン名だけが添えられます。そのため、どれだけ具体的で対処しやすいかは、コンパイラではなくプラグインが決めることです。判定が任意の詳細を伴っていた場合は、それぞれ名前付きで角括弧内に続きます。コード、ルール識別子、分類、ソース参照、位置、提案です。記録される条件は policy violation で、診断の先頭にある短いコードはこれに対応します。

拒否はドキュメントのいずれかではなくガバナンスのアタッチメントに帰属するため、ファイル位置は伴いません。拒否を生んだキーは存在せず、対処はポリシーを満たすか、アタッチメントを見直すかのどちらかです。

出力されるメッセージ:

policy plugin "<plugin>" rejected the build: <the plugin's own message> [code=<code>; rule_id=<rule>; classification=<class>; source_ref=<reference>; location=<where>; suggest=<suggestion>]

角括弧の部分は判定が詳細を伴う場合にのみ存在し、その中の各部分はプラグインが設定した場合にのみ存在します。

修正方法: プラグインのメッセージと、提供されていれば提案を読みます。指摘が正しい場合は、指摘された対象を変更します。この Release にポリシーを適用すべきでない場合は、アタッチメントの問題です。ガバナンスのアタッチメントはワークスペース設定の plugins.governance で設定され、どのプラグインをどのロールで実行するかはオペレーターが決めることであり、ドキュメントで上書きできるものではありません。

A governance attachment’s settings do not match the plugin’s declared schema(ガバナンスアタッチメントの設定がプラグインの宣言したスキーマに一致しない)

ガバナンスプラグインは、アタッチメントから渡される設定のスキーマを宣言できます。アタッチメントの with.settings に記述した設定は、プラグインがディスパッチされる前にそのスキーマに照らして検査されます。そのため、設定を誤ったアタッチメントは、不正な形の入力としてプラグインに届いてプラグインの解釈次第の結果が返ってくるのではなく、本来の設定の誤りとして報告されます。

この順序こそがこの検査の要点です。これにより、拒否とも明確に区別されます。プラグインは実行されておらず、判定も下されておらず、ビルドについて何も評価されていません。設定スキーマを宣言しないプラグインはどのような設定も受け入れるため、そのようなプラグインに対するアタッチメントがこの条件に該当することはありません。

検査はすべてのガバナンスロールを対象とします。 ir-verdict、render-verdict、label-transform、annotation-transform のいずれで記述したアタッチメントも、プラグインがディスパッチされる前に設定がスキーマに照らして検査されます。with.settings はどのロールでも同じ記述キーであり、どのロールも先にスキーマに照らしてそれを読み取ります。変換ロールはビルドがそれを適用する箇所で実行され、先にプルを行うビルドではそのプルの間に実行されます。そのため、そこでのメッセージは auto-pull: label-transform: のように、それをディスパッチしたステップから始まります。

出力されるメッセージ。アタッチメントを記述したロールとそれが示すプラグイン、続いて固定の文、そしてスキーマ検査の結果です:

ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema

そのロールで記述したアタッチメントでは、先頭の句は render-verdict になります。スキーマ検査の結果はスキーマバリデーター自身のレポートで、複数行にわたります。

修正方法: plugins.governance にある、そのアタッチメントの with.settings の設定を修正します。メッセージ中央の詳細は、問題のあるキーと、そこでスキーマが期待していたものを示します。プラグインが宣言する設定は、プラグイン自身のリファレンスに記載されています。

A pipeline step failed(パイプラインステップが失敗しました)

FeatureRecipe はパイプラインを宣言できます。パイプラインはステップの並びで、各ステップはノードが出力したドキュメントに対してプラグインのエクスポートをディスパッチし、Feature がコンポーネント自身の Recipe が生成した出力を整形できるようにします。これは、ドキュメントセットが保持していないものをパッチが指定した場合(これには後述の独自の報告があります)以外の理由でステップが失敗したときに報告される条件です。

失敗したものはステップの id とそのインデックスで示され、続く節がどの部分で失敗したかを示します。ステップの with 入力のレンダリング、呼び出しそのもの、ホストが読み取れなかった出力、プラグインが返したエラー、プラグインが出力した error 重大度の診断、パッチエンジンが拒否したパッチ、またはウォークに存在しないスコープを指定したパッチのいずれかです。

失敗したステップは丸ごとロールバックされます。 ドキュメントはステップの実行前の状態に戻され、ステップ自身の出力も併せて破棄されるため、後続ステップの when や with が部分的な結果を読むことはありません。その後、optional: true と宣言されたステップは警告として報告され、ウォークは続行します。optional でないステップはビルドを停止します。optional: が許容しないのは、宣言された契約への違反です。下のエントリを参照してください。

出力されるメッセージ:

pipeline step failed: step "<id>" (index <n>) with: <what the render could not do>(パイプラインステップが失敗しました) pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do>(パイプラインステップが失敗しました: 呼び出し) pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message>(パイプラインステップが失敗しました: エラー診断) pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused>(パイプラインステップが失敗しました: スコープとキー) pipeline step failed: unknown patch scope "<scope>"(パイプラインステップが失敗しました: 不明なパッチスコープ)

修正方法: ステップ id を読み、次にインデックスの後の節を読みます。ステップのどちら側を見るべきかがそこに示されています。with の失敗はステップ自身の with: ブロック内のテンプレートであり、作成者が修正するものです。エラー診断は入力に対するプラグイン自身の言葉です。拒否されたパッチと不明なスコープは、ノードが出力したものに対するプラグインの出力であり、プラグイン作成者が対処するものです。ステップの失敗が本当に許容される場合(必須の変換ではなく任意の付加処理である場合)は optional: true と宣言します。ただし、これが許容するのは失敗であり、壊れた契約ではないことに留意してください。

A pipeline step’s typed input or output does not satisfy its declared contract(パイプラインステップの型付き入力または出力が宣言された契約を満たしていません)

プラグインのエクスポートは、受け取る入力と返す出力に対するスキーマを宣言できます。両方とも検査されます。レンダリングされた with の値は呼び出しの前に、返された出力は呼び出しの後に検査されます。共有の契約が宣言していない重大度を持つ診断も、同じ扱いで拒否されます。

これは optional: true と宣言されたステップでも停止します。 この区別こそが、この条件がステップの失敗とは別になっている理由のすべてです。optional が許容するのは、役目を果たせなかったステップ、つまり失敗した呼び出しや異議を唱えたプラグインです。ホストがルーティングできない出力や、エクスポートが受け取ると述べた形にそもそもなっていない入力は許容しません。宣言された契約は約束であり、契約が破られたステップを黙ってスキップしたビルドは、何もしなかった Feature の上で成功を報告することになります。

出力されるメッセージ:

pipeline step "<id>" with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation(パイプラインステップの入力が宣言された入力契約を満たしていません: パイプラインステップの型付き I/O 契約違反) pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation(パイプラインステップが宣言された出力契約を満たさない出力を返しました: パイプラインステップの型付き I/O 契約違反)

また、契約が宣言していない診断の重大度については、ステップ失敗の枠の中で次のように届きます:

pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation(パイプラインステップが失敗しました: パイプラインステップの型付き I/O 契約違反)

ステップの with テンプレートが sensitive と宣言された値を読む場合、入力違反は値を示しません。 スキーマ検査の結果は、失敗した各位置とそれを拒否したキーワードに置き換えられ、理由を示す通知で締めくくられます(at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive))。そのため、修正すべきフィールドは引き続き示されます。vocabulary/compact-form-authoring.md の「What a refusal says about a declared value」を参照してください。

修正方法: 入力違反の場合は、エクスポートが宣言するスキーマに照らしてステップの with: ブロックを修正します。詳細にフィールドと期待された内容が示されます。出力違反と宣言されていない重大度はプラグイン側で修正するものです。ステップの宣言が誤っているわけではないため、optional にしてもどちらも解消しません。

A pipeline patch addresses a document the set does not hold, or one with no tree to address(パイプラインのパッチが、セットに存在しないドキュメント、または指定できるツリーを持たないドキュメントを指定しています)

パイプラインステップはスコープとキーでドキュメントを指定し、2 種類の指定が拒否されます。

セットにそれが存在しない場合。 ステップが、渡されたドキュメントに含まれないスコープとキーの組にパッチを当てました。何も編集されないため、何もないものにパッチを適用して成功を報告する代わりに、ウォークは停止します:

pipeline patch targets a document not present in the set: scope "<scope>" key "<key>"(パイプラインパッチがセットに存在しないドキュメントを対象にしています)

指定できるツリーを持たない場合。 一部のユニットには、パッチが指し示せる構造がありません。バイナリ本体、自由テキスト、provider が安全にたどれない領域などです。このようなユニットもメディアタイプとバイト列のタグ付きでステップに渡されるため、選択して丸ごと出力することはできます。できないのはパッチを当てることです。パスを解決する対象が何もないためです。このようなユニットに対するパッチは、黙ってスキップされずに停止します:

pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>"(パイプラインパッチが不透明な(非構造化)ユニットを対象にしています)

何が構造化されているとみなされるかは、固定の判定ではなく provider 自身によるユニットの解釈です。そのため、同じ内容がある provider では指定可能で、別の provider では不透明になることがあります。

どちらもウォーク自身による拒否であり、ビルドはパッチを当てたパイプラインを持つノードに対してこれらを報告します。そのため、上記のメッセージはそのノードを示す停止の下に届きます。その停止は、同じ 2 つの指定の誤りがビルドを停止する形であり、後述の「A pipeline step addresses documents the node does not have(パイプラインステップがノードに存在しないドキュメントを指定しています)」で説明しています。そこでは、ステップが何も指定できない 3 つ目の指定、すなわちどのホストコンポーネントにも対応しない箇所でホストコンポーネントのドキュメントを要求する場合も扱います。

修正方法: どちらも作成者ではなくプラグイン作成者が対処するものです。ステップは実行対象のドキュメントセットを受け取り、そこに含まれるキーを読めます。したがって、対象が存在しないのは、このノードが出力していないドキュメントをステップが指定しているということです。存在するドキュメントにパッチを当てるか、意図したドキュメントを先に出力して後のステップでパッチを当ててください。不透明なユニットの場合は、パッチをユニット全体の emit に置き換えます。不透明な本体は編集されるのではなく置き換えられます。

パッチの test 操作がドキュメントと一致しなかった

パッチは test 操作を持つことができ、これはそれ以降の操作が適用される前に、あるパスに何があるかを表明します。表明が成り立たない場合、エンジンはパッチ全体を拒否します。これにより、条件付きパッチは楽観的ではなく条件付きとなります。編集の前にテストするプラグインは、認識できないドキュメントには手を触れないと表明しているのです。

この条件では 2 つの形が報告されます。パスに何も存在しない場合は、メッセージがそのことを示します。あるいは値は存在するが表明された値ではない場合は、単なる拒否として報告され、表明された値も見つかった値も引用されません。

出力されるメッセージ:

jsonpatch: test operation failed: no value at path jsonpatch: test operation failed

パイプラインステップの出力がパッチを運んでいた場合、拒否はそのステップの失敗の下に、ステップ名とともに届きます。ラベル変換プラグインのパッチが運んでいた場合は、ラベルパッチの拒否の下に届きます。

修正方法: 誤りはドキュメントではなくプラグインにあります。ドキュメントが持たない値を期待したテストは、通常、プラグインが想定していない形に対して実行されていることを意味します。別の provider の出力や、同じパイプラインの前のステップがすでに変更したドキュメントなどです。パッチを自分で修正できる場合は、テストをドキュメントが実際に持つ内容に緩めるか、パッチ内でテストする代わりにステップの when ゲートでそのケースをスキップしてください。

workload: の form とその横のフィールドが一致しない

workload: は form: を宣言します。これは実行されるものの形を、特定のターゲットの語彙ではなく、すべてのターゲットが理解する言葉で述べたものです。一部のフィールドはある form でのみ意味を持ち、必要なフィールドなしに宣言された form には、一貫してレンダリングできるものがありません。どのターゲットも workload を変換する前に両方向がチェックされるため、不一致はターゲットごとにそれぞれの言葉で報告されるのではなく、記述した内容に対して一度だけ報告されます。

5 つの組み合わせが強制され、それぞれが両方の要素と記述すべき内容を示す独自の文を報告します:

workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule

それぞれは workload が読み取られていた component インスタンスに位置付けられ、変換の誤りとして報告されます。不一致は記述された 1 つのブロック内の 2 つのフィールド間にあるためです。

これらが記録される条件、つまり短いコードが解決される先は、persistentTemplate volume requires form: stateful、form: reference requires an endpoint、endpoint requires form: reference、form: scheduled requires a schedule、schedule requires form: scheduled です。

1 つの組み合わせは一方向のみです。 レプリカごとの claim テンプレートを持たない form: stateful の workload は通常のものであり、何も報告されません。規則は、claim テンプレートがその form だけが与えるレプリカごとの安定した識別子を必要とするということであり、form が claim テンプレートを必要とするということではありません。他の 2 つの組み合わせは両方向です。endpoint と schedule はそれぞれ、意味を持つ form がちょうど 1 つしかないためです。

2 つの endpoint の組み合わせは Workload スキーマにも含まれています。そのため、いずれかに違反する workload は、上記の文に到達する前に、スキーマ段階で E0214 のもとで拒否されます。reference 以外の形(stateless として読まれるため、form: の省略も含みます)上の endpoint: は、次のように拒否されます。

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here(workload の検証に失敗しました(スキーマ段階):endpoint の値がここでは許可されていない形に一致しています)

また、endpoint: のない form: reference は、代わりに .endpoint: missing required property: endpoint で終わります。対処方法は、その組み合わせの文が示すとおりです。

修正方法: 各文は 2 つのフィールドを示し、両方の解決策を提示します。form が必要とするフィールドを追加するか、form をそのフィールドが属する form に変更するか、編集で残されたフィールドを削除してください。schedule: の値を削除してキーを残すのが、最もよく起こる形です。

workload の schedule: がチェックの受け付ける式ではない

form: scheduled の workload は実行時期を示す schedule: を持ち、その値はどのターゲットが読む前にも構造がチェックされます。受け付けられる書き方は 2 つです。@hourly、@daily、@weekly、@monthly、@yearly の 5 つのマクロのいずれか、または数字と文字 *、,、-、/ のみを使う 5 フィールドの crontab 式です。

チェックが読むものと読まないもの。 チェックはフィールドを数え、その中の文字を調べます。範囲、ステップの計算、曜日の名前は評価しないため、数値が範囲外の 5 フィールドの式はここを通過し、拒否はターゲットに委ねられます。先頭に秒フィールドを持つ 6 フィールドの式は拒否されます。この面が受け付けるのは 5 フィールドであり、秒を必要とするターゲットは別の方法でそれを受け取ります。

出力されるメッセージ:

workload schedule is not a valid cron expression; use a 5-field crontab expression (e.g. “0 0 * * *”) or one of @hourly, @daily, @weekly, @monthly, @yearly

これが記録される条件は schedule is not a valid cron expression で、短いコードはこれに解決されます。

修正方法: まずフィールドを数えてください。フィールドが 4 つまたは 6 つの schedule が最もよくある原因であり、1 つのフィールド内の余分なスペースはそれを 2 つに分割します。曜日や月の名前は数字に置き換え、意図を表すマクロがある場合はそれを使ってください。

A workload suspend: is set on a form other than scheduled(workload の一時停止フィールドがスケジュール実行以外の形に設定されている)

suspend: true は form: scheduled の workload の定期スケジュールを保留します。スケジュールされたリソースはレンダリングされますが、再開されるまでそのスケジュールから実行が開始されることはありません。スケジュールを持つ形は他にないため、他の形ではこのフィールドが保留する対象がなく、フィールドを黙って破棄した workload をレンダリングするのではなく、ビルドが停止します。この検査は他の形の組み合わせの検査とともに、どのターゲットが workload を変換するよりも前に実行され、ここでも form: の省略は stateless として読まれます。

出力されるメッセージ:

workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend(workload が suspend を宣言していますが、form: scheduled ではありません。schedule を伴う form: scheduled を宣言するか、suspend を削除してください)

位置は、workload が読み取られていたコンポーネントインスタンスに示され、変換の不備として報告されます。記録される条件は suspend requires form: scheduled で、これがそのショートコードの解決先です。

この規則は一方向にのみ、かつ true の場合にのみ働きます。 suspend: のない form: scheduled の workload は通常のもので、そのスケジュールに従って実行されます。また、デフォルトである suspend: false は、どの形でも何も引き起こしません。

対処方法: workload を誰かが開始したときにのみ実行するつもりであれば、schedule: を持つ form: scheduled にし、suspend: true を残します。そうでなければ、書いたとおりの形を残し、他の形では読まれない suspend: を削除します。

A library $import: is not written in the bare-name form(ライブラリのインポートがベア名形式で書かれていない)

Recipe と FeatureRecipe の 3 つのフィールドは、本体をその場に書く代わりにライブラリから取得できます。artifacts.<name>: エントリ、valuesMapping:、workload: です。いずれも $import: にライブラリの裸の名前を書き、続けて #、さらにそのフィールドが読むサーフェス上のエントリのパスを書きます。それぞれ #/artifacts/、#/mappings/、#/workloads/ です。この形をしていない値はビルドが解決できるものを何も指さず、フィールドの解決時に拒否されます。

3 つのフィールドは意図的に互いを鏡写しにしているため、障害は 3 つすべてで同じように読め、変わるのはサーフェスだけです:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>"(artifacts の $import: が裸の名前の artifact-library 参照ではありません) valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>"(valuesMapping の $import: が裸の名前の mapping-library 参照ではありません) workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>"(workload の $import: が裸の名前の workload-library 参照ではありません)

@ で書かれたバージョンは、代わりに使うべき綴りとともに報告されます。ライブラリが見つからないという苦情に流れ落ちることはありません。これがこの形式で最も多い誤りだからです:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>"(artifacts の $import: がベア名形式の artifact-library 参照ではありません。バージョン区切りは ’@’ ではなく ’:’ です。修正後の値を使用してください)

ここで報告される形がもう 1 つあり、これは綴りの誤りではありません。 ArtifactLibrary のバンドル自身のファイル本体を、別のバンドルの $import: にすることはできません。1 つのファイルスロットは多数のファイルに展開できないため、ネストしたインポートは、作成者が書いていないものに解決されるのではなく拒否されます。代わりに、バンドルを消費する箇所で組み合わせてください。

コンポーネント自身の Recipe が書く artifacts: エントリは何かがレンダリングされる前に決定されるため、報告はその Recipe の artifacts: ブロックに位置付けられ、参照、バンドル、ネストしたインポートを本体に持つファイル、そしてインポートが書かれたエントリを示します。この形をしたバンドルのファイルはすべて 1 回のビルドで報告されます。複数ある場合、検出結果は artifacts entries whose library import the compiler cannot resolve の下にまとめられます:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/) ("<the value as written>", bundle "<bundle>", bundle file "<filename>", artifacts entry "<key>"). a bundle file body cannot import another bundle — compose the two at the artifacts entry that consumes them(artifacts の $import: が裸の名前の artifact-library 参照ではありません。バンドルファイルの本体は別のバンドルをインポートできません — 両者を消費する artifacts エントリで組み合わせてください)

FeatureRecipe が書く artifacts: エントリは、バンドルの解決時に同じ状態を報告し、この形をした最初のファイルを示します:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): bundle "<bundle>" file "<filename>" body is a field-root $import: (nested library import inside a bundle file is not supported; compose at the consumption site)(artifacts の $import: がベア名形式の artifact-library 参照ではありません。バンドルファイルの本体がフィールドルートの $import: です。バンドルファイル内でのライブラリのネストしたインポートはサポートされていません。利用する箇所で組み合わせてください)

コンポーネント自身の Recipe が書く valuesMapping: は何かがレンダリングされる前に決定されます。そのため報告はその Recipe の valuesMapping: キーに位置付けられ、使うべき綴りを含みます:

valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/mappings/(valuesMapping の $import: がベア名形式の mapping-library 参照ではありません。フラグメントの前後にライブラリとエントリを指定してください)

FeatureRecipe が書く valuesMapping: は、参照の解決時に、上の一覧の形式で報告されます。

コンポーネント自身の Recipe が書く workload: は何かがレンダリングされる前に決定されます。そのため報告はその Recipe の workload: キーに位置付けられ、使うべき綴りを含みます:

workload $import: is not a bare-name workload-library reference (#/workloads/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/workloads/(workload の $import: がベア名形式の workload-library 参照ではありません。フラグメントの前後にライブラリとエントリを指定してください)

FeatureRecipe が書く workload: は、参照の解決時に、上の一覧の形式で報告されます。

修正方法: 値を <Library>#<entry-path> の形に書き直し、選択されうるバージョンに下限が必要な場合にのみ、ライブラリ名の後に :<version> を追加してください。フラグメントがフィールドと一致しているか確認してください。workload: 上の #/mappings/… というエントリパスは、そのフィールドが読まないサーフェスを指すため、エントリの欠落としてではなく、ここで報告されます。スキーマの $ref: にも同じ識別子の形式が適用され、その拒否については上の「A $ref: is not written in a form the compiler can resolve(コンパイラが解決できる形式で書かれていない参照)」で説明しています。

ライブラリの $import: が、カタログに存在しないライブラリまたはエントリを指定している

$import: の書き方は正しいものの、指し示す先が存在しません。3 種類のライブラリそれぞれについて参照の 2 つの部分を扱う 6 つの条件があり、どれが報告されたかによって、どちらの部分を確認すべきかがわかります。ビルドから見える範囲にライブラリそのものが存在しないか、ライブラリは存在するもののそのエントリを公開していないかのどちらかです。

参照の解決対象となる集合は、ワークスペース自身のカタログに、ビルドの読み込み時にロックファイルが固定して取り込んだライブラリを加えたものです。そのため、Release の依存関係の閉包のどこからも依存が宣言されていないライブラリは、その中への参照がいかに正しく書かれていても、この集合には含まれません。

ライブラリが存在しない場合:

artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>")(artifact-library のインポートが、カタログに存在しない ArtifactLibrary を参照しています) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>")(mapping-library のインポートが、カタログに存在しない MappingLibrary を参照しています) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>")(workload-library のインポートが、カタログに存在しない WorkloadLibrary を参照しています)

エントリが存在しない場合:

artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>"(artifact-library のインポートが、ArtifactLibrary に存在しないバンドルを参照しています) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>"(mapping-library のインポートが、MappingLibrary に存在しないエントリを参照しています) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>"(workload-library のインポートが、WorkloadLibrary に存在しないエントリを参照しています)

コンポーネント自身の Recipe が書く artifacts: エントリは、バンドルの欠落を独自の形式で報告します。 このエントリは何かがレンダリングされる前に確定するため、報告はその Recipe の artifacts: ブロックの位置に示され、参照の 2 つの部分とあわせて、インポートが書かれたエントリを示します:

artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>")(artifact-library のインポートが、ArtifactLibrary に存在しないバンドルを参照しています)

コンポーネント自身の Recipe が書く valuesMapping: は、エントリの欠落を独自の形式で報告します。理由は同じで、これも何かがレンダリングされる前に確定するため、報告はその Recipe の valuesMapping: キーの位置に示され、参照の 2 つの部分を示します:

mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>")(mapping-library のインポートが、MappingLibrary に存在しないエントリを参照しています)

コンポーネント自身の Recipe が書く workload: は、エントリの欠落を独自の形式で報告します。理由は同じで、これも何かがレンダリングされる前に確定するため、報告はその Recipe の workload: キーの位置に示され、参照の 2 つの部分を示します:

workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>")(workload-library のインポートが、WorkloadLibrary に存在しないエントリを参照しています)

FeatureRecipe が書く artifacts: エントリ、FeatureRecipe が書く valuesMapping: または workload:、そしてビルドから見えないライブラリへのあらゆる参照は、参照の解決時に、上の 2 つの一覧に示した形式で報告されます。

どちらの部分が失敗した場合でも、各報告はライブラリとエントリの両方を示すため、何も開かずに 1 つの報告だけでライブラリの欠落とエントリの欠落を見分けられます。

修正方法: エントリが欠落している場合は、その名前をライブラリが公開しているものと照合します。エントリ名はそのライブラリ自身のマップのキーであり、大文字と小文字が区別されます。ライブラリが欠落している場合は、通常は参照が正しく、不足しているのは閉包の方です。そのライブラリへの依存関係を宣言して読み込まれるようにし、ロックファイルを更新して固定されるようにします。あるワークスペースでは到達でき、別のワークスペースでは到達できないライブラリも、同じ不具合を反対側から見たものです。

ライブラリの $import: が、レジストリの場所でライブラリを指定している

ライブラリの $import: は、ライブラリを識別子で指定し、たまたま公開されているレジストリで指定することはありません。名前がどのレジストリを通じて解決されるかはワークスペースの設定であり、どのバージョンが使われるかはロックファイルが決めます。そのため、ホストを含む参照は、本来ビルドが決めるべき 2 つの事柄をカタログのドキュメント内に固定してしまい、そのドキュメントは設定の異なるワークスペースでは機能しなくなります。

このような参照がこの停止に至る場面は、見た目よりも限られています。 Recipe や FeatureRecipe 自身の $import: フィールドは、より早い段階でスキーマによって拒否されます。スキーマは 3 つの位置のいずれにもレジストリのプレフィックスを認めていないためです。残るのは、どのスキーマも記述していない参照、つまりライブラリのエントリ自身の本体から読み出される参照です。これは、それを利用するエンティティが書いたものではなく、本体が解決されるまで見ることもできません。

valuesMapping: と workload: の各サーフェスから出力されるメッセージ(リゾルバは値のみを報告します):

library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>"(ライブラリの $import: にレジストリのホストが含まれています。ライブラリはベア名の識別子で参照してください)

artifacts: エントリはこの停止に至りません。ここでこの停止を探している場合は、その理由を知っておく価値があります。エントリ自身の参照は、他のすべての位置と同様にドキュメントの残りとともに拒否されます。また他の 2 つのサーフェスとは異なり、本体自体がインポートであるバンドルファイルは追跡されずに拒否されます。そのため、ホストを含む参照が届く元となる本体は存在しません。

修正方法: ホストとライブラリ名より前のすべてを削除し、<Library>#<entry-path> の形にします。問題の値が自分の公開するライブラリではなく、利用しているライブラリの中にある場合、修正はそのライブラリの作者が行うべきものです。修正が反映されるまでは、別のエントリをインポートするか、本体をその場に書くことでビルドが通るようになります。

1 つの Recipe の 2 つのアーティファクト出力が同じファイル名を持っている

Recipe の artifacts: ブロックはキーごとに 1 つの出力を指定し、キーでインポートされたバンドルはそのファイルをキーの下に追加します。2 つの出力が 1 つのファイル名に到達すると一方が他方を上書きすることになるため、どちらを残すかを選ぶ代わりにビルドを停止します。

これは残余に対するガードであり、そう明言することもその性質の一部です。 出力はそれが書かれたキーによって名前が付けられ、マッピングのキーは 1 つのドキュメント内で一意であり、記述サーフェスはキーを単一のファイル名に制限しています。そのため、記述された 2 つのエントリが衝突することはなく、キーが別のキーのバンドルが生成する入れ子の名前を綴ることもできません。このガードがなお対象とするのは、記述されたドキュメント自身の重複キー拒否を経ずに射影に到達した内容、つまりファイルから読まれたのではなくビルドの実行中に組み立てられた状態です。したがって、ここで報告される衝突は、目に見える行ではなく、ビルドがどのように組み立てられたかを指しています。

これは Recipe ごとに、その Recipe 自身の出力に対して発生します。この点が、組み立ての中で 2 つの異なるコントリビューターが 1 つのパスに到達する場合との違いです。そちらは上の「Two contributors write the same output path(2 つのコントリビューターが同じ出力パスに書き込んでいる)」であり、対処方法も異なります。

出力されるメッセージ:

artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once)(artifacts の出力ファイル名の衝突:2 つのアーティファクト出力が同じファイル名を持っています)

修正方法: メッセージが示す Recipe を開き、その artifacts: キーを、インポートしているバンドルが追加するファイルと照合します。キーが本当に異なっているのに衝突が解消しない場合、ドキュメントには問題がなく、ビルドを保守している担当者に報告する価値があります。

An ArtifactLibrary bundle file names no file of its own under the key it was imported at(ArtifactLibrary のバンドルファイルが、インポートされたキーの下に固有のファイルを指定していない)

バンドルをインポートする artifacts: エントリは、そのバンドル内のファイルごとに 1 つの出力に展開され、それぞれインポートが書かれたキーの下にネストされます。つまり、キーはディレクトリを指定し、バンドルが提供するすべてのファイルは固有の名前でその下に属します。そのディレクトリから上に出るファイル名、絶対位置を指定するファイル名、何も指定しないファイル名はこれに当てはまらず、利用側の Recipe が選んだことのない場所にファイルを配置する代わりに、ビルドは停止します。

「何も指さない」とは、キーの下にある 1 つのファイルの唯一の表記ではない名前すべてを指します。 . と ./、および x/.. のようにキーそのものへ戻る名前はキー自体を指すため、そのファイルはキーのディレクトリがあるべき場所に書き込まれることになります。末尾または重複した / を持つ名前、あるいは . や .. の部分を持つ名前(x/、a//b、./a、a/./b、a/../b)は、別の名前でも表せるファイルの 2 つ目の表記です。a//b と a/b が並べば 1 つのファイルに 2 つの名前があることになり、衝突が報告されないまま一方が他方を上書きします。空の名前も拒否されます。

これが防ぐのは、出力ディレクトリ外への書き込みではなく、気付かれないレイアウトの変更です。 ファイルが書き込まれる場所は別途保護されているため、十分に上へ出る名前はいずれにせよそこで拒否されます。その保護をすり抜けるのは、ちょうど 1 階層だけ上に出る名前です。これは出力ディレクトリ内の、誰も選んでいない位置に戻ってきます。これは書き込みが拒否されるより悪い結果です。このパス上のすべての衝突ガードは、名前を解決後の形ではなく組み立てられたままの形で読むため、そのような 2 つのファイルが衝突の報告なしに 1 つの出力へ解決されることがあり、どちらが残るかは誰も書いていないものによって決まるからです。

キーの中に素直に書かれたネストされたレイアウトは影響を受けません。 バンドルは rbac/role.yaml のような独自のサブディレクトリを持つことができ、それらを利用側のキーの下にネストすることこそがキーの目的です。..config や role.v1.yaml のように、部分の中にドットを含むだけの名前は通常の名前です。

利用側の Recipe と公開されたバンドルは通常異なる作成者によって書かれるため、メッセージは両方の側を対処法とともに示します。

コンポーネント自身の Recipe が書く artifacts: エントリは何かがレンダリングされる前に決定されるため、報告はその Recipe の artifacts: ブロックに位置付けられ、まずファイルを、次にそれが由来するライブラリと、それが利用されるエントリを示します。名前が拒否されたバンドルのファイルはすべて 1 回のビルドで報告されます。複数ある場合、検出結果は artifacts entries whose library import the compiler cannot resolve の下にまとめられます。

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under ("<filename>", ArtifactLibrary "<library>", artifacts entry "<key>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/“(ArtifactLibrary のバンドルファイル名が、その出力がネストされる artifacts キーの下に固有のファイルを指定していません。ArtifactLibrary バンドル内のファイルを、利用される artifacts キーの下の通常のファイル名(“config.yaml” や “rbac/role.yaml” など)に変更してください。”.” や ”..” の部分、先頭・末尾・重複した ”/” は使用できません)

FeatureRecipe が書く artifacts: エントリは、バンドルが解決される時点で同じ状態を報告し、それが書かれた recipe と最初の該当ファイルを示します。

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/“(ArtifactLibrary のバンドルファイル名が、その出力がネストされる artifacts キーの下に固有のファイルを指定していません。ArtifactLibrary バンドル内のファイルを、利用される artifacts キーの下の通常のファイル名(“config.yaml” や “rbac/role.yaml” など)に変更してください。”.” や ”..” の部分、先頭・末尾・重複した ”/” は使用できません)

対処方法: ArtifactLibrary 内のファイルを、キーの下の通常のファイル名に変更します。ライブラリが自分のものでない場合、上流で修正が行われる間は、別のバンドルをインポートするか、エントリをその場に記述することでビルドが通るようになります。まったく別の場所に置くべきファイルは、そこへたどり着く名前ではなく、それが属するキーでの 2 つ目の artifacts: エントリとします。

An imported artifact no longer matches the digest recorded beside its Recipe(インポートされたアーティファクトが、その Recipe の横に記録されたダイジェストと一致しなくなった)

ローカルファイルをインポートする artifacts: エントリは、Recipe がピン留めされるとき(aggrega pin、または同じ手順の実行を指示された pull や push によって)その内容がピン留めされます。ファイルのバイト列のダイジェストが、Recipe の横の entity.lock に記録されます。Recipe の boundary.artifacts: のエントリも同じ方法でピン留めおよび比較され、boundary/<key> の下に記録されます。これがメッセージで示される名前です。すべてのビルドはファイルを再度読み込んで再びダイジェストを計算し、不一致を拒否します。そのため、ピン留め後に編集されたファイルが、検証済みであるかのようにレンダリングされることはありません。aggrega pull --verify も同じ比較を行い、不一致を同じメッセージで報告します。

比較されるのは、レンダリング結果ではなくエントリの内容です。 アーティファクトの本体はテンプレートであり、評価するとコンポーネントインスタンスごとに異なる値が代入されるため、出力に対するダイジェストは値が異なるすべてのインスタンスで一致しなくなります。記録される内容は Recipe をバインドするすべてのインスタンスで同じテキストであり、だからこそ記録された 1 つのダイジェストが比較対象として適切なのです。

誰もピン留めしていない Recipe には横にピンがなく、ビルドはそれを比較しません。 ビルドにとってピンがないことは不一致ではなく、比較するものがないことを意味します。そのような Recipe に対する pull は、An entity reads an input the lock beside it records no pin for(エンティティが、横のロックにピンが記録されていない入力を読み込んでいる) で説明するとおり、代わりに停止します。ファイルが編集される前に書かれたロックファイルは、エンティティの行がインポートされたファイルも対象とするため、先に報告を行います。これは A local source no longer matches the pins recorded beside its Recipe(ローカルソースが、その Recipe の横に記録されたピンと一致しなくなった) で説明されており、同じセクションで、この比較がビルドで発生するのはどのような場合かも説明しています。

3 つのサーフェス(コンポーネント自身の Recipe、コンポーネントにアタッチされた Feature、バウンダリにアタッチされた Feature)が、異なるドキュメントに対して同じチェックを行います。そのため FeatureRecipe の内容は、ホストコンポーネントの Recipe の横ではなく、FeatureRecipe の横に記録されたダイジェストと照合されます。2 つのアタッチメントサーフェスでは、メッセージはアタッチメントも示し、それによってどのドキュメントを開くべきかがわかります。

出力されるメッセージ:

imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file(インポートされたアーティファクトの内容が entity.lock に記録されたダイジェストと一致しません。ファイルを意図的に変更した場合は、それをインポートするエンティティで aggrega pin を実行して新しいダイジェストを記録してください。そうでない場合はファイルを元に戻してください) imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>", attachment "<attachment>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file(インポートされたアーティファクトの内容が entity.lock に記録されたダイジェストと一致しません。ファイルを意図的に変更した場合は、それをインポートするエンティティで aggrega pin を実行して新しいダイジェストを記録してください。そうでない場合はファイルを元に戻してください)

対処方法: 答えは 2 つあり、どちらが正しいかは編集が意図的なものかどうかによります。意図的な場合は、Recipe に対して aggrega pin を実行してファイルの現在のバイト列からピンを取り直し、書き換えられた entity.lock をコミットします。意図的でない場合はファイルを元に戻します。記録されたダイジェストはピン留めされたバイト列の記録であり、変更されたファイルをレンダリングしたビルドは、何も検証していない内容を出荷することになります。

A local source no longer matches the pins recorded beside its Recipe(ローカルソースが、その Recipe の横に記録されたピンと一致しなくなった)

source: が横にあるディレクトリまたはファイルを指定する Recipe または FeatureRecipe は、エンティティがピン留めされるとき(aggrega pin、または同じ手順の実行を指示された pull や push によって)そのソースがピン留めされます。エンティティの横の entity.lock には、エンティティの公開物が含む内容にソースが提供するファイルごとに 1 つのダイジェストが、ファイルのパスをキーとして記録されます。ロックにそれらが記録されると、すべてのビルドはプロバイダがソースを読み込む前に現在のソースをそれらのピンと比較し、不一致を拒否します。そのため、ピン留め後に編集されたチャートやモジュールが、検証済みであるかのようにレンダリングされることはありません。aggrega pull --verify も同じ比較を行い、不一致を同じメッセージで報告します。ビルドは、ソースを解決していたコンポーネントインスタンスと、その下の Recipe ドキュメントを示します。

ソースは 1 つのファイル集合として比較されます。 内容が変わったファイル、ソースに追加されたファイル、ソースから削除されたファイルはいずれもエンティティのレンダリング元を変えるため、それぞれが、ファイルの現在のダイジェストと記録されたダイジェストとともに報告されます。ソースが提供しない、エンティティの横にあるファイル(Recipe の隣のメモや README など)は比較されません。./charts/{{ .values.flavour }} のようにテンプレートとして書かれたソースは、どのディレクトリを指すかが各 Release によって決まるため、エンティティのディレクトリ内のすべてのファイルを提供します。この形では、ディレクトリ内のどのファイルへの編集も報告されます。

ロックにソースのピンが記録されていない Recipe には、ビルドが比較するものがありません。 ビルドはそれを拒否しませんが、ピン留めを行わない pull や push は、An entity reads an input the lock beside it records no pin for(エンティティが、横のロックにピンが記録されていない入力を読み込んでいる) で説明するとおり拒否します。Recipe がもう宣言していないローカルソースについてロックに残っているピンは、Recipe が読み込むものを何もピン留めしないため、何とも比較されません。pull がレジストリから解決した Recipe は、代わりに、その公開物が含む内容についてロックファイルが記録するダイジェストによってカバーされます。

変更前に書かれたロックファイルが先に報告を行います。 ロックファイルはエンティティをそれが含む内容によって記録し、ソースのファイルはその一部であるため、ファイルが変わる前に書かれたロックファイルを持つビルドまたは aggrega pull --verify は、この比較が実行される前に停止し、The lockfile no longer matches what the release resolves to(ロックファイルが、リリースの解決結果と一致しなくなった) がエンティティと両方のダイジェストを示します。通常の aggrega pull は、An entity reads an input the lock beside it records no pin for(エンティティが、横のロックにピンが記録されていない入力を読み込んでいる) によって変わったファイルを示します。インポートされたファイルについても同様です。ロックファイルにエンティティ自身のエントリがない場合、ビルドと検証を行う pull が遭遇するのはこの比較です: Manifest が、Release が到達する Component または Feature の名前でもある参照で指定する Recipe または FeatureRecipe は、その参照のもとで Component または Feature として記録されるため、Recipe のファイルが変わってもロックファイル内の何も変わりません。

出力されるメッセージ:

the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files(エンティティのローカルソースのファイルが entity.lock に記録されたピンと一致しません(ファイルのダイジェストが記録されたピンと異なります)。ソースを意図的に変更した場合は、エンティティに対して aggrega pin を実行してファイルを記録し直してください。そうでない場合はファイルを元に戻してください) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and no pin is recorded for it). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files(エンティティのローカルソースのファイルが entity.lock に記録されたピンと一致しません(ファイルに対するピンが記録されていません)。ソースを意図的に変更した場合は、エンティティに対して aggrega pin を実行してファイルを記録し直してください。そうでない場合はファイルを元に戻してください) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> is no longer in the source and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files(エンティティのローカルソースのファイルが entity.lock に記録されたピンと一致しません(ファイルがソースに存在しなくなっていますが、ピンが記録されています)。ソースを意図的に変更した場合は、エンティティに対して aggrega pin を実行してファイルを記録し直してください。そうでない場合はファイルを元に戻してください)

対処方法: インポートされたファイルの場合と同様に答えは 2 つあり、どちらが正しいかは変更が意図的なものかどうかによります。意図的な場合は、Recipe に対して aggrega pin を実行してソースのファイルを再度ピン留めし、書き換えられた entity.lock をコミットします。意図的でない場合は、メッセージが示すファイルを元に戻します。

エンティティの公開物が含むすべてのファイルはエンティティ自身のディレクトリから読み込まれ、そこにあるシンボリックリンクはたどられずに拒否されます。たどると、リンクが指すバイト列が(エンティティのディレクトリ外を含め、指す先がどこであれ)リンク自身の名前で、ダイジェストが計算され、署名が適用される場合は署名されるアーティファクトに公開されてしまいます。逆にスキップすると、内容がディレクトリと気付かれないまま異なるアーティファクトが公開されてしまいます。そのため、ファイルへのリンク、ディレクトリへのリンク、どこも指さないリンク、自身を指すリンク、互いを指す 2 つのリンクといった、あらゆる形のリンクが同じように拒否されます。

拒否は、エンティティのファイルが読み込まれるあらゆる場所で行われます。aggrega pin、何かをパックする前の公開(ドライランを含む)、entity.lock をエンティティのファイルと照合する pull および検証を行う pull、ローカルソースをそのピンと比較するビルド、そしてプロバイダに何かを渡す前にローカルソースディレクトリを読み込むレンダリングです。メッセージはエンティティドキュメントの横からのパスでリンクを示し、診断はリンク自体に位置付けられます。

無視ルールで除外されたリンクは、エンティティが含むファイルではありません。そのため、それらのルールで除外される他のファイルと同様にスキップされ、たどられることはありません。これらのルールはエンティティがピン留めされた時点で entity.lock に記録されたものであるため、.aggregaignore に追加した行は、エンティティを再度ピン留めしたときに有効になります。

出力されるメッセージ:

a symbolic link sits among the files an entity carries (<path>). remediation: replace the link with a copy of what it points to, placed inside the entity’s own directory. A link met inside a source directory can instead be left out with a line in the .aggregaignore beside the entity, which takes effect when the entity is pinned again. A link is refused rather than followed because the bytes it points to would travel under the link’s name, from wherever it points(エンティティが含むファイルの中にシンボリックリンクがあります。対処法:リンクを、それが指すもののコピーに置き換え、エンティティ自身のディレクトリ内に配置してください。ソースディレクトリ内のリンクは、代わりにエンティティの横の .aggregaignore に行を追加して除外することもでき、これはエンティティを再度ピン留めしたときに有効になります。リンクがたどられずに拒否されるのは、指す先がどこであれ、リンクが指すバイト列がリンクの名前で運ばれてしまうためです)

対処方法: エンティティがリンクの指す先を必要とする場合は、リンクをエンティティのディレクトリ内のそのコピーに置き換え、エンティティを再度ピン留めします。リンクが自分の利便性のためにあり、エンティティがそれを読み込まない場合は、そのパスをエンティティドキュメントの横の .aggregaignore に追加し、再度ピン留めします。エンティティが何を含むかを決めるルールについては、Which files ship with an entity で説明しています。

An entity reads an input the lock beside it records no pin for(エンティティが、隣のロックにピンが記録されていない入力を読み取ります)

Recipe または FeatureRecipe は、自身のドキュメント外のバイトに依存できます。座標が完全に書き出されたリモートの source:、artifacts エントリが $import でインポートするファイル、そして隣にあるディレクトリまたはファイルを指す source: のファイルです。それぞれのピンはエンティティの隣にある entity.lock に記録され、その記録はエンティティ作成者の手順である aggrega pin です。そのため、pull はそれらのピンを自分では記録しません。Release がビルドする、自分のカタログディレクトリ内のエンティティについては、その手順が記録する内容とロックが保持する内容を比較し、ロックにピンが欠けている場合、または入力がもはや一致しないピンを保持している場合には、求められずに作成者のディレクトリへ書き込むのではなく停止します。自身のロックファイルを埋めるビルドは pull であり、同じように停止します。

push も、公開しようとしている 1 つのエンティティについて同じ比較で停止します。 バンドルがビルドされる前、かついずれかのレジストリに接続する前に、その手順がエンティティについて記録する内容と隣のロックを比較し、push 自体にその手順の実行が求められていない限り、同じように拒否します(ドライランも含みます)。メッセージの末尾で提案される内容は両者で異なります。各コマンドにはピンを記録させる独自の方法があるためです。報告される内容は変わりません。

ローカルソースは 1 つのファイル集合としてピンと照合されます。 ロックにピンが 1 つも記録されていない場合、ソースが提供する各ファイルはここで欠落として報告されます。記録されている場合、ピン以降に追加されたファイルは欠落として、変更または削除されたファイルは入力がもはや一致しないピンとして報告され、ビルドは同じ変更を A local source no longer matches the pins recorded beside its Recipe(ローカルソースが、その Recipe の隣に記録されたピンと一致しなくなりました) として報告します。Recipe がもはや宣言していないローカルソースについてロックがまだ記録しているピン(source: が削除された、またはリモートアーティファクトを指すようになった場合)は、Recipe が読み取るものを何もピン留めしないため、pull、push、検証付き pull、ビルドのいずれも停止させません。次回の aggrega pin がそれらを削除します。

メッセージは、欠けているすべての入力を種類別に示します。 それぞれは、URL と解決されたバージョンで示される remote source、それを使用する artifacts キーで示される imported file、またはエンティティの隣にあるパスで示される local source file のいずれかです。これにより、ピン留めが必要なのがソースかファイルかがわかります。Release 内のそのようなエンティティはすべて 1 回の実行で報告されます。

レジストリから解決されたエンティティは、その公開時にすでに照合されているため、pull でこの照合を受けることはありません。 そのエンティティは作成するディレクトリではなくコンテンツキャッシュに置かれるため、pull はその隣のロックを読み書きせず、そのソースは Release のロックファイルと照合されます。aggrega push で公開されたエンティティは、その時点で手順が記録するすべてのピンをロックが記録していない限り公開時に拒否されており、そのロックは公開されたバンドル内に含まれます。

pull および push から出力されるメッセージ:

an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded, imported file <key>: the recorded pin no longer matches it). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have every pull in this workspace record the pins itself instead, set pin_sources_at_pull: true in the workspace configuration(エンティティが読み込む入力に対するピンが、隣の entity.lock に記録されていません。対処: エンティティに対して aggrega pin を実行し、エンティティの隣に書き込まれる entity.lock をコミットしてください。このワークスペースのすべての pull でピンを自動的に記録させるには、ワークスペース設定で pin_sources_at_pull を true に設定してください) an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have this publication record the pins itself instead, re-run it with --pin-sources; to have every publication in this workspace record them, set pin_sources_at_push: true in the workspace configuration(エンティティが読み込む入力に対するピンが、隣の entity.lock に記録されていません。対処: エンティティに対して aggrega pin を実行し、エンティティの隣に書き込まれる entity.lock をコミットしてください。この公開でピンを自動的に記録させるには、pin-sources フラグを付けて再実行してください。このワークスペースのすべての公開でピンを記録させるには、ワークスペース設定で pin_sources_at_push を true に設定してください)

公開時のメッセージの中間の節は、公開に使用したインターフェースが受け付けるものを示します。ターミナルでは --pin-sources、デーモンでは pinSources フィールド、アシスタントツールでは pin_sources 引数です。

対処方法: エンティティが自分のものである場合は、aggrega pin を実行して書き込まれる entity.lock をコミットし、再度 pull または push してください。あるいは、バンドルのビルド前にその手順を実行する --pin-sources を付けて push してください。他者のもの(独自のディレクトリから利用するカタログ)である場合は、その公開者がまだピン留めしていません。すべての pull がピンを自動的に記録するようにワークスペース設定で pin_sources_at_pull: true を設定するか、1 回の pull に --pin-sources を渡してください。手順の詳細は aggrega pin で説明しています。

A provides: template could not be evaluated(provides テンプレートを評価できませんでした)

provides: エントリは、別のコンポーネントが依存関係の接続を通じて読み取る値を生成するテンプレートです。この状態は、評価できなかったエントリが報告するものです。パースできないテンプレート、このサーフェスが登録していない関数の呼び出し、レンダーコンテキストが提供しなかったものを経由してたどる参照、またはマップが保持していないキーの index 読み取りです。

これは、同じブロックに対して評価の前に行われる 2 つの拒否とは別のものです。自己完結したセット外のルートへの参照と、ブロック自体の記述順序が拒否する参照で、どちらも上で説明しています。それらは変更すべき式を示しますが、こちらは評価自体が報告した内容をそのまま伝えます。そのため、エントリ名が併記されます。

コンポーネントインスタンス、ブロック内のエントリ、評価が報告した内容を示す、出力されるメッセージ:

provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>)(provides テンプレートの評価に失敗しました)

評価が何を報告したかにかかわらず、先頭にはこの条件のコード E0056 が付きます。 評価がそれ自体の停止条件で止まった場合(よくあるのは、マップが保持していないキーの index による読み取りです)、その条件はこの条件の代わりにではなく、この条件の下に報告されます。caused by (2): の下で、この条件の文が先に、評価自体の報告がその文も含めて後に来ます。そのため、コードで照合する読み手は、失敗したすべての provides: エントリーを E0056 で識別し、評価が失敗した原因はその下の条件から読み取ります。その条件の文は、すべての条件の表でそれ自身のコードに対応します。存在しないキーの場合は E0327 です。

対処方法: メッセージが示すキーで Recipe の provides: ブロックを開き、報告された理由を確認してください。通常はパース位置または関数が示されます。このサーフェスでの欠落キーの扱いは、存在しない末尾のキーを失敗ではなく空としてレンダリングするため、ここでの失敗は構造的な不具合です。パースできないテンプレート、提供されなかったコンテナを経由してたどる参照、またはマップが保持していないキーの index 読み取りであり、報告された理由がそれを示します。値が本当に任意である場合は、存在しない可能性のあるものをたどるのではなく、optional ヘルパーを通じて読み取ってください。

A Recipe or FeatureRecipe does not publish a provides key its contract declares(Recipe または FeatureRecipe が、コントラクトで宣言されたキーを公開していない)

Component と Feature はそれぞれ、schema.provides の下に、それらをバインドするものが公開するキーを宣言します。これは、コンシューマーが接続を記述する際の対象となる出力コントラクトです。Component にバインドされた Recipe と、Feature にバインドされた FeatureRecipe は、そのコントラクトが挙げるすべてのキーを生成しなければなりません。生成しないものは拒否されます。そうしなければ、欠けたキーは何も届けないからです。コンシューマーの参照は、未設定の変数、空の引数、または存在しないファイルとして届き、その理由は何も示されません。

コントラクトはキーの存在だけであり、それ以上ではありません。 宣言されたすべてのキーが現れる必要があり、追加のキーは許可されます。値そのものは一切検査されません。値は文字列として渡される不透明なポインタであるため、コントラクトが宣言する型は、ビルドが行うチェックではなく、コンシューマーに向けた表明にとどまります。

不足はすべて報告されます。 3 つのキーが不足している Recipe は 3 件の検出結果を出し、それぞれがその Recipe の provides: ブロック内の該当エントリに位置付けられるため、3 件すべてを 1 回のビルドで修正できます。メッセージは、欠けているキー、そのキーをコントラクトで宣言している型、そして Recipe がバインドされたインスタンスを示します。最後のものは、1 つの Recipe が 1 つの型の複数のインスタンスに使われる場合に、2 件の検出結果を見分ける手がかりになります。

出力されるメッセージ:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares ("<key>", declared by component type "<type>", bound to component instance "<instance>")(Recipe または FeatureRecipe が、抽象エンティティの schema.provides コントラクトで宣言された provides キーを公開していません)

Feature と FeatureRecipe の組み合わせでは、同じ状態がアタッチメント自身の解決を通じて報告され、その組とキーが示されます:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares (<attachment context>, <the FeatureRecipe> does not publish provides key "<key>" declared by <the Feature>’s schema.provides contract)(Recipe または FeatureRecipe が、抽象エンティティの schema.provides コントラクトで宣言された provides キーを公開していません)

この場合は、ソート順で最初に欠けているキーを報告して停止します。そのため、この組み合わせではビルドごとに 1 つのキーが示され、Component の組み合わせではすべてのキーが示されます。どちらの場合もキーはソート順に走査され、これにより両者とも実行間で同じ結果になります。

修正方法: 欠けているキーを Recipe または FeatureRecipe の provides: ブロックに追加するか、それを公開するものが想定されていない場合は Component または Feature の schema.provides から削除します。テンプレートが何もレンダリングしないキーも、空文字列を値として公開されます。そのため、存在していて空のエントリはコントラクトを満たし、ここでは報告されません。空の値でビルドを停止させる必要がある場合は、アサーションでそれを拒否します。Recipe のアサーションは、解決済みの provides: の値を読み取ります。

An assertion stopped the build(アサーションがビルドを停止した)

Component、Feature、Recipe、FeatureRecipe は assertions: を持つことができます。これは、テキストを生成するのではなく入力を拒否することを目的とした名前付きテンプレートです。アサーションは fail を呼び出し、それを呼び出すことでビルドが停止します。引数は、それに遭遇する人に向けて作成者が書いたメッセージです。

アサーションは 2 つの時点で評価されるため、ルールは対象とする状態を読み取ります。Component や Feature のアサーションは、カタログの解決後かつ何かがレンダリングされる前に実行され、Recipe や FeatureRecipe のアサーションは、バインディングが確定した後かつそのバインディングがレンダリングされる前に実行されます。

何も供給しないキーへの参照もここで報告されます。 このサーフェスは厳格な欠落キー処理で評価します。これは、参照が空としてレンダリングされた述語が何もないものと比較されて黙って通過することを防ぐためです。そうでなければ、1 つのタイプミスで、アサーションが強制するために書かれたルールが無効になってしまいます。このため、このサーフェスでは単純な default はフォールバックを提供しません。フォールバックが実行される前に、素の参照が評価を停止するからです。参照を hasKey でガードするか、optional ヘルパーを使用します。index で読み取った場合も、「A template indexes a map with a key the map does not hold(テンプレートがマップに存在しないキーでマップをインデックスする)」で説明されているとおり、キーを示して停止します。

出力されるメッセージ。エンティティの種類と型、インスタンス、アサーションを示し、続いてアサーション自身が書いたメッセージを含みます:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote>(fail の呼び出しでエラー:アサーションが失敗しました)

また、何も与えていないキーについては、条件自身の文の後にテンプレートエンジンの文が続きます。

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": assertion failed: template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <.reference>: map has no entry for key "<key>"(アサーションが失敗しました:テンプレートの実行中、マップにそのキーのエントリがありません)

また、述語ではなく評価が失敗した場合:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>" parse: <what the parse reported>(アサーションの解析エラー)

機密と宣言された値はメッセージに現れません。 アサーションがそのような値を読み取り、その文を 1 つの引用符付き文字列として書き切った形で fail を呼び出す場合(fail "…" のように、何もパイプで渡さず、何も組み立てない場合)、その文はアサーションが読み取ったものを何も引用していないため、値の内容にかかわらず、メッセージにはその文が書かれたとおりに含まれます。メッセージが値を引用する場合、メッセージでは値の位置に <redacted> と表示されます。メッセージがそれ以外の方法で組み立てられ、かつアサーションの動作が値の内容に依存した場合、失敗した式以降のメッセージは failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds に置き換えられます。停止とそのコードは変わりません。何が宣言済みとみなされるか、またどの拒否がこの対象外かについては、vocabulary/compact-form-authoring.md の「What a refusal says about a declared value」を参照してください。

単独でチェックされた場合、エンティティは失敗したアサーションを警告として報告します。 Recipe のファイルを与えた aggrega validate、aggrega serve を通じたそのファイルのエディタチェック、および entity を与えた aggrega mcp の validate ツールは、Release が設定する値ではなくプレースホルダーとスキーマのデフォルトを使って Recipe を構築します。そのため、Release を待っているアサーションと壊れているアサーションを区別できません。そこでは、fail を呼び出すアサーション(Recipe 自身のもの、またはそれが実装する Component が宣言するもの)は、上記のメッセージを含み A Release must satisfy this assertion before a build of it can pass. という文で締めくくられる警告として報告され、チェックは成功します。何も供給しないキーへの参照や、解析できないアサーションは、失敗したアサーションではありません。いずれもアサーション自身のテキストの不備であり、そのチェックは他の不備と同様にそれを判定します。ビルドには常に Release があり、ここで説明したとおりアサーションで停止します。a failed assertion is a warning を参照してください。

修正方法: 最後のコロン以降のメッセージはアサーション作成者のものであり、何を変更すべきかを示すのはこのメッセージです。アサーションは、それに遭遇すれば答えがわかるように書かれています。報告が作成者の文ではなく欠落キーである場合は、アサーション自体に不備があります。参照を修正するか、上記のとおりガードします。ルールがこの Release に適用されるべきでない場合、それは自分のファイルではなく、アサーションを持つエンティティについての問題です。

A pipeline step addresses documents the node does not have(パイプラインステップがノードの持たないドキュメントを指定している)

パイプラインステップは、スコープとキーによってドキュメントを指定します。指定先が何も指さないケースは 3 つの条件で扱われ、いずれも、実際には行われなかった編集についてステップが成功を報告することのないよう、ビルドを停止します。

ノードがそれを出力していない。 パッチが、このノードの生成したドキュメントに含まれないスコープとキーの組を指定しています:

node "<instance>": pipeline PATCH targets a document the node did not emit(パイプラインの PATCH が、ノードの出力していないドキュメントを対象にしています)

指定すべきホストが存在しない。 ステップが、ホストとなるコンポーネントを持たない場所で、ホストコンポーネントのドキュメントにアクセスしようとしました。たとえば、唯一のスコープが自身の出力であるコンポーネント自身のパイプラインや、1 つのコンポーネントではなく境界にアタッチされた Feature です。こうしたパイプラインが実行される場所ではホストスコープは空であるため、そこへの指定は何にも解決されません:

node "<instance>": pipeline /host operation from a step with no host component(ホストコンポーネントのないステップからのパイプライン /host 操作です)

ドキュメントに指定可能なツリーがない。 一部のユニットには、パスで指し示せる構造がありません。バイナリ本体、自由形式のテキスト、ターゲットが安全に走査できない領域などです。こうしたユニットも、選択して丸ごと出力できるようステップには渡されますが、パッチを適用することはできません:

node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON(パイプラインの PATCH の対象が、解析可能な構造化 YAML/JSON ではありません) pipeline PATCH target is not parseable structured YAML/JSON (node "<instance>", document "<key>")(パイプラインの PATCH の対象が、解析可能な構造化 YAML/JSON ではありません)

いずれも、その下に走査自身による指定先の説明を伴って報告され、その操作を行ったパイプラインを持つコンポーネントインスタンスの位置に示されます。

3 つのうち 2 つは、走査の前にも報告されます。 ある場所にホストドキュメントがあるかどうかはパイプラインが記述された場所から決まるため、ホストドキュメントのない場所でホストドキュメントを操作すると宣言したステップは、ノードのレンダリングを待たず、ビルドがすべてのプラグインの宣言を把握した時点で指摘されます。境界にアタッチされた Feature は、ステップと併せて示されます:

pipeline /host operation from a step with no host component(ホストコンポーネントのないステップからのパイプライン /host 操作です) pipeline /host operation from a step with no host component ("<attachment>")(ホストコンポーネントのないステップからのパイプライン /host 操作です)

この 2 つの検出は、同じ指摘が 2 回行われるのではなく、1 つの条件を分担したものです。宣言から確定できることは宣言から確定し、実行時にしか分からないことは実行時に委ねられます。自身のスコープを宣言したステップでも、別のスコープに対する操作を返すことがあるためです。

これら 3 つは、パイプラインの走査自体が報告する指定の拒否のうち、ビルドを停止する形のものです。後者は上記の「A pipeline patch addresses a document the set does not hold, or one with no tree to address(パイプラインパッチが、セットに存在しないドキュメント、または指定可能なツリーを持たないドキュメントを指定している)」で説明しています。

修正方法: 3 つとも、利用者ではなくステップ作成者の問題です。対象が存在しない場合は、ノードが実際に出力するドキュメントにパッチを適用するか、意図したドキュメントを前のステップで出力して後のステップでパッチを適用します。ステップは自身に渡されたキーを読み取れます。ホストがない場合は、ステップをホストコンポーネントを持つ場所に移すか、代わりにその場所自身のドキュメントを指定するか、ステップを削除します。ツリーのないユニットの場合は、パッチをユニット全体の出力に置き換えます。不透明な本体は編集ではなく置き換えるものです。

A pipeline patch addresses output that has not been assembled yet(パイプラインパッチがまだ組み立てられていない出力を指定している)

一部のプロバイダは、ディスパッチグループのノードごとの出力を 1 つのドキュメントにまとめます。マージされた compose ファイルやアンブレラチャートなどです。このマージが行われるまでは個別のドキュメントは存在せず断片しかないため、それを指定するパッチには指し示す対象がありません。そのため、こうしたコンポーネントに対するパイプラインは全体が延期され、マージによってドキュメントが生成された後に再実行されます。これは通常の流れであり、作成者は何もする必要がありません。

この条件は、それでもパッチが断片に到達した場合にビルドに報告されるものです。対象となるのは、アタッチされた Feature 自身の出力です。コンポーネントのプロバイダがグループをまとめる場合、アタッチメントのパイプラインは全体が、マージによってドキュメントが生成されるまで保留されます。そして再実行に渡されるのは コンポーネントの ドキュメントのみです。Feature 自身の出力に対するステップは、コンポーネントのレンダリング中、つまりマージが行われる前にしか提供されないため、指定する対象がありません。これは Feature 自身の出力の扱いに関わらず成り立ちます。マージに加わる場合も独自のドキュメントとして書き出される場合も、そのスコープが再実行で渡されるスコープになることはありません。

出力(emit)は影響を受けません。 emit はドキュメントを編集するのではなく追加するものであり、すべてのプロバイダでノードごとに実行されるため、この条件の対象外です。

この条件は、プラグインとプロバイダの宣言に基づいて走査の前に報告され、さらにノードのレンダリング中にも下限の検査として報告されます。出力されるメッセージ:

pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>")(パイプラインの PATCH が、アセンブラープロバイダーの組み立て前のフラグメントを対象にしています) pipeline PATCH targets an assembler provider’s pre-assembly fragments (node "<instance>", <scope>-scope document "<key>" is rendered by an assembler provider). the post-assembly phase re-runs this PATCH once the documents are discrete(パイプラインの PATCH が、アセンブラープロバイダーの組み立て前のフラグメントを対象にしています。このドキュメントはアセンブラープロバイダーがレンダリングします。ドキュメントが個別になった時点で、組み立て後のフェーズがこの PATCH を再実行します)

修正方法: Feature 自身のドキュメントではなくコンポーネントのドキュメントを指定します。これがマージ後に再実行される形です。あるいは、ディスパッチグループをまとめないプロバイダにコンポーネントを配置するか、ステップを削除します。3 つのうちどれが適切かはステップが何を変更するために書かれたかによります。メッセージには指定したスコープが示されるため、判断できます。FeatureRecipe 自身の capability: を変更することはこれに含まれません。それはマージ後の再実行に渡されるスコープを変えず、この条件が扱うのはまさにその点だからです。

A pipeline step’s plugin does not claim the provider rendering what it addresses(パイプラインステップのプラグインが、指定先をレンダリングするプロバイダへの対応を表明していない)

パイプラインステップが使用するプラグインは、テスト済みのプロバイダを宣言できます。このリストは暗黙の「類似するもの全般」ではなく明示的な表明です。名前のないプロバイダに対してプラグインを実行すると、別の出力形式向けに書かれたパッチが適用されるおそれがあるため、ビルドは試行せずに停止します。

ステップの照合対象となるプロバイダは、そのステップが指定するドキュメントをレンダリングするプロバイダです。 コンポーネントのドキュメントに対するステップではコンポーネント自身のプロバイダ、Feature のドキュメントに対するステップでは Feature 自身のプロバイダです。コンポーネントにアタッチされた Feature では両方が生じ、それらは異なる 2 つのドキュメントに由来する異なる 2 つの値です。

空または存在しない表明リストは何にも一致しない ため、そのようなプラグインを使用するステップはすべてここで報告されます。ビルドが 問い合わせ できなかったプラグインは別のケースであり、ここでは報告されません。取得できない自己申告は空の表明ではなく表明の不在であり、そのようなステップは解決、読み込み、または自己申告の失敗そのものによって停止します。修正すべきはその失敗です。

この条件は、すべてのプラグインが自身について宣言する内容をビルドが把握した時点で、そのステップを呼び出す実行より前に報告されます。また、ビルドごとに 1 回ではなく、記述されたステップごとに 1 回報告されるため、作成者は 1 回のビルドでパイプライン内の問題のあるステップをすべて確認できます。Provider 名は完全一致で照合されます。

出力されるメッセージ。1 つ目はコンポーネント自身のパイプライン、2 つ目は Feature のパイプラインからのもので、後者はアタッチメントも示します:

pipeline plugin is not compatible with the rendering provider ("<provider>")(パイプラインのプラグインが、レンダリングするプロバイダーと互換性がありません) pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>")(パイプラインのプラグインが、レンダリングするプロバイダーと互換性がありません)

修正方法: この指摘は記述されたステップの位置に示され、示されたプロバイダが宣言を照合すべき対象です。プラグインが自分のものであれば、そのプロバイダでテストした上で、宣言する互換性にそのプロバイダを追加します。そうでなければ、そのプロバイダへの対応を表明しているプラグインのバージョンを選択するか、プラグインが対応を表明しているプロバイダでそのスコープをレンダリングするか、ステップを削除します。

A provider refused a node’s input (プロバイダがノードの入力を拒否しました)

プロバイダは、component 用に渡された入力をレンダリング前に検査し、見つけた内容を報告できます。停止の重大度の検出結果はビルドを停止します。警告および情報の重大度の検出結果はビルドの出力とともに表示され、出力されるバイトには何の影響も与えません。

これはコンパイラではなくプロバイダ自身による入力の解釈であるため、何に異議を唱え、それをどの程度具体的に伝えるかはプロバイダが決めることです。コンパイラは component とプロバイダを示し、プロバイダのメッセージを返されたとおりに伝えます。プロバイダが複数のメッセージを報告した場合はセミコロンで区切られてまとめて届くため、1 回のビルドですべてを把握できます。

入力が component 自身の Recipe に属する場合でも、アタッチされた Feature に属する場合でも同じ経路が使われるため、プロバイダの検査はどちらでも同じように読めます。

出力されるメッセージ:

provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages> (プロバイダがノードの入力を拒否しました)

修正方法: プロバイダのメッセージを読んでください。解決済みの入力のうち、受け入れられなかったものが示されています。入力は Recipe の値と component 自身の設定から組み立てられるため、修正箇所は通常そのいずれかにあります。プロバイダが何を必要とするかは、そのプロバイダのリファレンスページに記載されています。ドキュメントからは変更できないものにプロバイダが異議を唱えている場合は、その Recipe またはプラグインの作成者に確認すべき問題です。

A provider rendered the same input twice and produced different output (プロバイダが同じ入力を 2 回レンダリングし、異なる出力を生成しました)

同一の入力からは、ビルドは同一の出力を生成します。これは、レビューツールやデプロイツールがビルド結果を読む際の前提となる契約です。オプトインのビルドモードはこれを直接検査します。各 component を同じ入力から 2 回レンダリングし、出力されたバイトを比較します。2 回のレンダリング結果が一致しないプロバイダは、2 回の間で状態を持ち越しているか、あるいは入力の関数になっていないため、ビルドは停止します。

通常のビルドでは各 component を 1 回だけレンダリングするため、この状態は検査モードでのみ発生します。このモードが利用できることによって、通常のビルドは何も変わりません。

比較されるのはプロバイダが出力した生の出力、つまりレンダリングされた成果物の切り出し元となるバイトそのものです。そのため、最終ファイルまで残る差異だけでなく、生成されたもののどこにある差異でも検出されます。

出力されるメッセージ:

rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (同一入力の 2 回のレンダリングが異なる出力を生成しました:プロバイダのレンダリングが決定的ではありません)

修正方法: まず、メッセージが示す component の 2 回のビルドの間で何が異なるかを特定します。2 回ビルドして出力を比較してください。差異が、ソースとして使うチャートがレンダリングのたびに新たに生成する値(ランダムなパスワード、生成された鍵、Secret や ConfigMap 内のタイムスタンプなど)である場合、原因はプロバイダではなくそのチャートの出力にあり、次の 2 つのいずれかの方法で自分で解消できます。チャートがその値のために用意している設定を通じて、Recipe の valuesMapping: から値を指定し、チャートが値を生成しないようにします。あるいは、生成されたドキュメントが Release に含めてはならないもの(たとえばオペレーターが別途提供する Secret)である場合は、Recipe の omits: エントリでビルドから除外します。Recipe → omits: フィールドを参照してください。それ以外の場合、原因はドキュメントではなくプロバイダにあり、何を記述しても解消できません。メッセージが特定する component を明記して、そのプロバイダを提供するプラグインの発行者に報告してください。よくある原因は、タイムスタンプ、ランダムな値、または作成者が記述した順序ではなくマップの反復順に従う順序付けです。修正されるまでの間も通常のビルドモードには影響がなく、検査を通過したバージョンにプラグインを固定するのが実用的な対処です。

An omits entry left out nothing the source rendered (omits エントリがソースのレンダリング結果から何も除外しませんでした)

Recipe または FeatureRecipe の omits: リストのうち、ビルドに適用されるエントリ(when: がない、空、または true のもの)はいずれも、ソースがレンダリングしたものを少なくとも 1 つ出力から除外しなければなりません。対象は、チャートがレンダリングするドキュメント、compose ファイルが宣言する service、volume、config、または CloudFormation テンプレートが宣言するリソースです。ソースをレンダリングするプロバイダは、各エントリをレンダリング結果と照合し、各エントリが除外した単位の数を報告します。何も除外しなかったエントリはビルドを停止します。

何にも一致しないエントリは、もはや真ではないソースについての記述です。よくある原因は、エントリが示すものの名前を変更または削除したソースのアップグレードです。その場合、名前が変わったドキュメントや service は新しい名前で出力に含まれ、それはまさにエントリが除外するために書かれたものです。もう 1 つの原因はエントリ自体の誤りです。これを見過ごすと、エントリが除外するはずだったものが出荷されてしまうため、ビルドは停止してそのエントリを示します。

メッセージは、ノード、プロバイダ、エントリを宣言しているドキュメント、そのドキュメントの omits: リスト内でのエントリの位置(0 から数えます)、およびエントリが解決された kind、name、namespace を示します。namespace はエントリが指定している場合にのみ示されます。component にアタッチされた FeatureRecipe の場合、ノードはその component です。boundary にアタッチされた FeatureRecipe の場合は、メッセージの上の行がアタッチメントとその boundary を示します。複数のエントリが何にも一致しなかった場合は、記述した順序で最初のものが示されるため、毎回同じエントリが示されます。テンプレートが機密と宣言された値を読み取ったフィールドは、解決後の値ではなく <redacted> として表示されます。when: によって除外されたエントリはプロバイダに渡されず、検査もされません。

出力されるメッセージ。カテゴリは角かっこで囲まれた先頭部分に示されます:

an omits entry left out nothing the source rendered (node "<node-id>", provider "<provider>", "<document>" omits[<position>], kind "<kind>", name "<name>", namespace "<namespace>"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause (omits エントリがソースのレンダリング結果から何も除外しませんでした。ソースがレンダリングするものを示すようにエントリを修正するか、削除してください。通常の原因は、それを名前変更または削除したソースのアップグレードです)

先頭部分には、この状態の短縮コード E0334 が含まれます。

修正方法: エントリを、ソースが現在レンダリングするものと比較します。エントリを削除した状態でビルドし、component がレンダリングするものを確認してください。そのうえで、エントリの kind、name、namespace を修正するか、示していたものがなくなっている場合はエントリを削除します。チャートの場合、エントリはドキュメント自身の kind、metadata.name、およびエントリが namespace を指定している場合はドキュメントが属する namespace によってドキュメントを示します。compose ファイルの場合は、service、volume、config をそのキーで示します。CloudFormation テンプレートの場合は、ソースのいずれかのテンプレート内のリソースを、その Type と論理 ID で示します。Recipe → omits: フィールドを参照してください。

A provider’s omitted counts do not match the omits entries it was handed(プロバイダーが返した除外数が、渡された omits エントリと一致しない)

レンダリングされた単位を除外すると宣言するプロバイダーは、渡された omits: エントリごとに、そのエントリが一致した単位の数を報告します。エントリごとに 1 つの数を、エントリが渡された順に報告します。報告がない場合、数が少なすぎるか多すぎる場合、または 0 未満の数を含む場合は、エントリが何かを除外したかどうかを判断する手段がないため、ビルドは停止します。これは記述した内容が原因ではありません。返した出力が、自ら宣言した契約を守っていないプロバイダーを報告するものです。

出力されるメッセージ。メッセージはノードとプロバイダーを示し、続いて渡されたエントリの数と返された内容(数の個数、または 0 未満の数とその対象エントリ)を示します:

a provider’s omitted counts do not match the omits entries it was handed (node "<node-id>", provider "<provider>", handed <n> omits entries, returned <m> omitted counts)

先頭部分には、この状態の短縮コード E0336 が含まれます。

修正方法: そのプロバイダーを提供するプラグインの公開者に、メッセージが示すコンポーネントを明記して報告してください。プロバイダーが果たすべき内容は、プラグイン契約のレンダリングされた単位の除外に記載されています。

Assembled output still carries a cross-boundary placeholder(組み立てられた出力にバウンダリー間のプレースホルダーが残っている)

依存関係の接続が 2 つの組み立て済み出力の間をまたぐ場合、その接続が運ぶ値は、消費側がレンダリングされる時点では分かりません。値はもう一方の側が公開し、両方が組み立てられた後に解決されます。そのため、ビルドは消費側コンポーネントの入力にプレースホルダーを書き込み、組み立てが存在した時点でプロバイダーがそれを独自の形式の相互参照に置き換えます。

この状態は、その置き換えを経ても残ったプレースホルダーが報告するものです。残ったということは、解決が届かなかったことを意味します。値がプロバイダーの扱えない場所に置かれた(多くの場合、値全体としてではなく、より長い文字列に埋め込まれた)か、解決する相手側のないまたぎにスタンプが押されたかのいずれかです。プレースホルダーは有効な出力にはならないため、それを含むファイルを出力せずにビルドは停止します。

メッセージは、ファイルを書き込んだプロバイダーと、ファイルが置かれたパスを示します。パスは 1 つの組み立ての中でのみ一意であるため、この 2 つを合わせることで 1 つのファイルが特定されます。最初のファイルだけでなく、問題のあるファイルはすべて報告され、そのファイルが置かれた組み立てにいくつのバウンダリーが寄与していても、各ファイルは 1 回だけ報告されます。報告はその中のバウンダリーに対してではなく、Release ドキュメント全体に対して行われます。問題はバウンダリー宣言ではなく、値がファイルに届いた経路にあるため、変更すべきバウンダリー宣言はありません。

出力されるメッセージ:

assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>")

修正方法: 最も多い原因は、消費側が値をより長い文字列に埋め込んだことです。相互参照は、注入される値の全体として存在する必要があります。そのため、Recipe のマッピングを変更して値をそのまま渡し、代わりにターゲット独自の語彙でその周りを組み立ててください。値が全体として存在しているのにプレースホルダーが残る場合は、解決のプロバイダー側に問題があり、そのプラグインの公開者が対応すべきものです。

テンプレートは、プロデューサーの値を接続から直接 .context.uses.<alias>.provides で読み取れます。バウンダリースコープの FeatureRecipe では、.boundary の下にあるバウンダリーの接続から読み取ります。接続が異なる出力にレンダリングされる 2 つのコンポーネントを結び、プロバイダーが独自の参照でそれを配線する場合、それらの値はそれぞれプレースホルダーとしてテンプレートに届き、両方の出力が組み立てられた時点でプロバイダーが置き換えます。置き換え先はクロススタック参照か、値そのものです。そのため、テンプレートはこうした値をコピーすることしかできません。値をそのまま書くか、より長い文字列の中に書くか、quote のように値を変えない関数を通して書くかのいずれかです。

比較、分岐、長さ、または値を変える関数(eq、if、len、upper、trimPrefix)は、値ではなくプレースホルダーに対して判定され、しかもそのことは知らされません。ビルドはテンプレートを 2 回評価してこれを検査します。1 回はプレースホルダーに対して、もう 1 回は実際の値に対して評価し、各プレースホルダーを書き戻したうえで両者が一致しなければ停止します。これは、このような接続を読み取るすべてのテンプレートに適用されます。Recipe 自身のテンプレート、アタッチされた FeatureRecipe の injectMapping:、バウンダリースコープの FeatureRecipe のテンプレートです。

メッセージはテンプレート(フィールドと、それが属する Recipe)を示し、差異の原因となる provides の値ごとに、消費側のコンポーネント、接続のエイリアスとソケット、生成側のコンポーネントを示します。テンプレートがコピーしただけの値は示されません。

出力されるメッセージ:

a template does more than copy a value it reads off a cross-boundary link (template "<template>", provides key "<key>" that component "<consumer>" reads off its connection "<alias>" on socket "<socket>" to component "<producer>"). Copy the value as it stands, whole or inside a larger string, because the provider writes in its place what the value becomes in the other output, and branch on a value of the component’s own instead(テンプレートが、クロスバウンダリーリンクから読み取った値をコピー以上の方法で扱っています。メッセージはテンプレート、provides キー、それをソケット上の接続から読み取る消費側コンポーネント、生成側コンポーネントを示します。プロバイダーはその位置に、値がもう一方の出力で何になるかを書き込むため、値はそのまま、または長い文字列の中にコピーし、分岐にはコンポーネント自身の値を使ってください)

修正方法: メッセージが示す値をテストや変換をせずにコピーし、判断は接続が読み取る値ではなく、消費側コンポーネントが自ら記述する値(自身の values または infra のキーのいずれか)に基づいて行います。コピーされた値がもう一方のスタックで何になるかは、CloudFormation プロバイダー で説明しています。

A provider named a directory for a contributor that is not one directory(プロバイダーがコントリビューター用に指定したディレクトリが単一のディレクトリではない)

各コントリビューターを 1 つの外側の出力内の独自の位置に配置するプロバイダーは、それらの位置が置かれるディレクトリを宣言し、ビルドは各コンポーネントの識別子をそこに組み込みます。この値はちょうど 1 つのディレクトリを指す必要があります。パス区切り文字を含む値や、カレントディレクトリまたは親ディレクトリを指す値は、コンポーネントのファイルを自身の位置の下以外の場所に配置してしまいます。組み立ての外に出るか、組み立ての中で気付かないうちに配置が変わります。

ビルドはそのようなパスを組み立てずに停止します。メッセージは値を宣言したプロバイダーと値そのものを示すため、どのプロバイダーを変更すべきか、何を宣言したかが明確になります。

そのようなディレクトリを宣言しないプロバイダーには影響しません。 その場合、各コントリビューターは自身の名前でデプロイメントディレクトリの直下に置かれるため、外側のディレクトリを指定しないことは漏れではなく正当な選択です。

出力されるメッセージ:

provider named a directory for each contributor’s own sub-directory that is not a single directory name: provider "<provider>" declared nest_segment "<value>"; the value must name one directory, carrying no path separator and naming neither the current nor the parent directory

修正方法: この値を生成するカタログドキュメントはないため、自分のファイルで修正すべき点はありません。値はプロバイダーを提供するプラグインから来ています。メッセージが示す値を引用して、そのプラグインの公開者に報告してください。プラグインが自作の場合は、単一のディレクトリ名を宣言するか、何も宣言せずに各コントリビューターをデプロイメントディレクトリに置いてください。

A boundary-scope Feature is attached only to a component(バウンダリースコープの Feature がコンポーネントにのみアタッチされている)

FeatureRecipe は、コンポーネントごとに 1 回ではなく、バウンダリーごとに 1 回生成することを宣言できます。コンポーネントごとに 1 つではなく、バウンダリーが保持するすべてに対して 1 つの共有リソースを生成します。そのため、このようなアタッチメントはバウンダリーに記述する必要があります。その名前のアタッチメントをコンポーネントにのみ記述すると、レシピが生成対象とするスコープが指定されないため、どのバウンダリーで実行するか、どの値を読むか、出力をどこに書き込むかが決まりません。

コンポーネントにも併せて記述することは通常のことであり、報告されません。 バウンダリーで宣言されたアタッチメントは、その中にネストされたスコープ内のものも含め、そのバウンダリーが保持するすべてのコンポーネントに届くため、それを持つことは通常の形です。チェックされるのは、コンポーネント自身のスコープ、またはそれを囲むスコープがその名前を宣言しているかどうかです。検索はコンポーネントの位置から外側へ進み、宣言している最初のスコープで止まります。外側のスコープがすでに宣言しているアタッチメントをコンポーネント自身で再度記述した場合は、スコープのみの形式とまったく同じようにレンダリングされ、同じ理由で受け入れられます。

どのスコープにも置かれていないコンポーネントには、たどる対象がありません。 そのため、そのコンポーネント上のバウンダリースコープのアタッチメントはここで報告されます。このようなレシピが生成対象とできるスコープは存在しないため、これが正直な解釈です。

出力されるメッセージ。アタッチメントと、コンポーネントが置かれたスコープを示します:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>")

また、どのスコープにも属さず、そのような値を持たないコンポーネントの場合:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>")

修正方法: コンポーネントにのみ記述するのではなく、生成対象とするバウンダリー(コンポーネントが置かれたスコープ、またはそれを囲むスコープ)の features: の下にアタッチメントを宣言してください。コンポーネントごとの生成を意図していた場合は、代わりにバウンダリースコープを宣言しない FeatureRecipe を持つ Feature をアタッチしてください。

The sandbox refused a plugin(サンドボックスがプラグインを拒否しました)

すべてのプラグインは、何らかの処理を許可される前に、自身が何であり何を必要とするかを報告し、サンドボックスはその報告を自らが許可できる範囲と照合します。この状態は、サンドボックスが受け入れない報告の種類全体を対象としており、メッセージの文がそのどの部分が拒否されたかを示します。ホストが対応していないプラグインインターフェースのバージョン、ホストが語彙を持たないプラグインの種類、外部へのネットワークアクセスやファイルシステムアクセスを求めるプラグイン、ホストが提供する範囲外のホスト呼び出しを指定するプラグインや許可された範囲外の名前空間からインポートするプラグイン、エクスポートの欠落や不正な形式、閉じた値の集合の範囲外の値を持つフィールド、あるいはまったく読み取れない自己報告です。

拒否はプラグインの実行前に行われ、拒否されたプラグインは失敗が伝わる前に停止されるため、要求したものが一時的にでも許可されることはありません。

プラグインが持てないものの一部は、決して許可されないため、ここではチェックされません。 ホストはゲストに対して固定された時計を与え、ファイルシステムも環境も与えず、ゲスト自身の出力の行き先も与えません。そのため、これらのいずれかに到達しようとしたゲストは、事前に拒否されるのではなく、その試みの時点で失敗します。この状態が対象とするのは、プラグインが開始前に自身について行い、チェックされる報告です。

出力されるメッセージ。 各メッセージの末尾にはこの状態の文が置かれ、その前の部分がプラグインと、報告のうち拒否された部分を示します。ホストが対応していないインターフェースのバージョン:

plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox(プラグインが宣言する abi_version は、ホストが扱うバージョンと異なります: wasm: サンドボックスがプラグインを拒否しました)

ホストが語彙を持たないプラグインの種類:

plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox(プラグインが未知の plugin_type を宣言しています: wasm: サンドボックスがプラグインを拒否しました)

読み取れない自己報告:

wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox(wasm: プラグインの describe() の出力が有効な JSON ではありません: wasm: サンドボックスがプラグインを拒否しました)

種類が必要とするエクスポートを欠いたプラグイン。エクスポート名は、種類自体を読み取るのと同じレジストリから示されます:

<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox(プラグインが必要なエクスポートを宣言していません: wasm: サンドボックスがプラグインを拒否しました)

固定の集合に閉じたフィールドが、それ以外の値を持つ場合。同じ形式がアセンブリモード、およびエクスポートごとの operates と scope フィールドにも当てはまります:

plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox(プラグインのエクスポートが未知の scope を宣言しています: wasm: サンドボックスがプラグインを拒否しました)

対になるケイパビリティが両方のエクスポートなしで宣言されている場合、またはエクスポートがその宣言なしに存在する場合:

plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox(プラグインは境界をまたぐリンクの capability を宣言していますが、必要な 2 つのエクスポートの両方をエクスポートしていません: wasm: サンドボックスがプラグインを拒否しました)

Recipe が決して選択できないケイパビリティ名。コロンを含む名前を提供する provider、またはそのような名前と互換性のあるパイプラインステップがこれに当たります。Recipe の capability: は、最後のコロンまでを名前、その後をバージョン指定として読み取るためです。パーサーの parse:<format> とインポーターの import:<format> は拒否されません。これらの名前ではコロンが名前の一部であり、Recipe を介さずフォーマットによって検索されるためです。同じ拒否により、そのようなプラグインの公開用エンティティの生成も停止されます:

plugin "<plugin>" (plugin_type "provider") serves the capability "<name>", which contains a colon; a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so no Recipe can name "<name>": report the capability name without a colon: wasm: plugin rejected by the sandbox(プラグインがコロンを含む capability を提供しています。Recipe の capability 参照は最後のコロンまでが capability、その後がバージョンピンとして読まれるため、どの Recipe もその名前を指定できません。コロンを含まない capability 名を報告してください: wasm: サンドボックスがプラグインを拒否しました)

そして、プラグインが宣言するホスト呼び出しと、そのバイナリが実際に使用するホスト呼び出しとの照合です。これは双方向にチェックされるため、プラグインは使用しないインターフェースを公表することも、使用するインターフェースを隠すこともできません:

plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox(プラグインが describe() で宣言したホスト関数を、その wasm がインポートしていません: wasm: サンドボックスがプラグインを拒否しました) plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox(プラグインが、describe() で宣言していないホスト関数をインポートしています: wasm: サンドボックスがプラグインを拒否しました)

修正方法: エンティティファイルの内容がこれを引き起こすことはなく、記述を変更しても解消されません。拒否されているのはプラグイン自身の報告です。公開されているプラグインを利用している場合は、そのプラグインの公開者にメッセージを報告し、それまではホストが受け入れるバージョンを選択してください。自分のプラグインである場合は、メッセージにフィールドと両方の値が示されるため、修正は文が指す内容に従います。ホストが対応するインターフェースバージョンに対応し、ホストが知っている種類を宣言し、すべてのフィールドを閉じた集合の範囲内に保ち、種類が必要とするエクスポートを宣言し、バイナリが使用するホスト呼び出しを過不足なく正確に宣言してください。

A plugin is not the kind of plugin the socket expects(プラグインがソケットの想定する種類のプラグインではありません)

各アタッチメントポイントはディスパッチ先のプラグインの種類を示し、すべてのプラグインは自身の種類を報告します。この状態は、両者の不一致を報告するものです。たとえば、linter が想定される場所にアタッチされた provider を提供するプラグイン、インポーターが想定される場所にアタッチされたパーサー、ターミナルコマンドではないのにそれとして実行されたプラグインなどです。チェックはプラグインのロード時に行われるため、誤った種類のプラグインが、依頼されるはずだった処理に到達することはありません。

とにかく試みるのではなく停止する理由は、種類ごとにインターフェースが共通していないためです。別の種類のプラグインは、持っていないエクスポートを通じて呼び出されることになり、返ってきたものは、そのプラグインが生成したことのない形式に照らして読み取られることになります。

種類を想定せずにプラグインの自己報告を読み取る場合は影響を受けません。 設定済みのものを一覧表示する、プラグインのエンティティを生成するなど、プラグインが自身について述べる内容だけを知りたい処理は想定を示さないため、そこではこのチェックは省略されます。

出力されるメッセージ。プラグインと両方の種類を示し、想定される種類は宣言値に加えて言葉でも示されます:

wasm: plugin "<plugin>": expected a <kind in words> plugin (plugin type "<expected>") but its describe() reports plugin type "<reported>": wasm: declared plugin type does not match plugin describe()(wasm: 期待される種類のプラグインではなく、describe() が別の plugin type を報告しています: wasm: 宣言された plugin type がプラグインの describe() と一致しません)

修正方法: アタッチメントポイントが受け付ける種類のプラグインをアタッチしてください。想定される種類はメッセージに示されています。意図したプラグインである場合は、アタッチ先が誤っています。その種類に対応する場所に移動してください。自分が作成したプラグインで、想定される種類であるべき場合は、プラグインが自身について誤った種類を報告しています。これはアタッチする側の設定ではなく、プラグイン側の修正です。

A plugin failed while it was running(プラグインが実行中に失敗しました)

何かを求められたプラグインが、結果を返しませんでした。これには 3 つの条件があり、それらを区別するのは失敗がどのように伝わったかだけです。クラッシュしたプラグイン、自身の実行を停止したプラグイン、そして最後まで実行されたものの求められたことを実行できなかったと報告したプラグインです。これらは意図的に 1 つの分類にまとめられており、プラグインが失敗し得るあらゆる経路をビルドが同じように扱うようになっています。

クラッシュしたプラグイン。 プラグイン内部のほとんどの障害(到達不能命令、ゼロ除算、メモリ外の読み取り)は、外に出る途中で通常の失敗に変換され、この条件には到達しません。この条件は、その経路から漏れたクラッシュを受け止めるための安全網です。

自身の実行を停止したプラグイン。 終了を求めるプラグインは、プラグインモデルに用途のないことを行っています。プラグインは、呼び出された呼び出しを通じて結果を返すのであり、終了によって返すのではありません。停止するのはそのプラグイン自身の実行であり、ビルドプロセスには影響しません。

失敗を報告したプラグイン。 プラグインが返す結果エンベロープには、完了できなかったことを伝える場所があり、そう伝えるメッセージは結果として読まれるのではなく、失敗として伝えられます。

出力されるメッセージ。それぞれプラグインまたはエクスポートを示し、失敗が提供した内容を含みます。クラッシュでは回収された値が含まれます。

wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call(wasm: ゲストプラグインがエクスポートの実行中にパニックしました。回復された値を示します: wasm: ゲストプラグインが呼び出し中にパニックしました)

自ら停止したプラグインでは、停止時のコードが含まれます。

wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit(wasm: プラグインのエクスポート呼び出しが終了コード付きで proc_exit を呼び出しました: wasm: プラグインが proc_exit を呼び出しました)

報告された失敗では、プラグイン自身のメッセージが含まれます。

call "<export>": wasm: guest plugin reported an error: <the plugin's message>(エクスポートの呼び出し: wasm: ゲストプラグインがエラーを報告しました。プラグイン自身のメッセージを示します)

修正方法: 3 つのいずれも、エンティティファイルの内容が原因ではなく、記述を変更しても解消されません。いずれもプラグイン内部の障害です。メッセージが示すエクスポートを添えて、プラグインの公開者にメッセージを報告し、修正されるまでの間は動作していたバージョンにプラグインを固定してください。自作のプラグインの場合は、クラッシュや終了ではなく結果エンベロープで失敗を返し、ビルドが表示できるメッセージを受け取れるようにしてください。また、報告される失敗がプラグイン自身の熟慮した回答である場合、そのメッセージは読者が目にするものなので、入力のどこを受け入れられなかったのかを伝えるとよいでしょう。

A plugin returned something that is not the shape the socket reads(プラグインが、ソケットが読み取る形でないものを返しました)

各アタッチメントポイントは、受け取った結果を期待する形と照合し、それ以外のもの(形が宣言していないフィールド、宣言された型でない値を持つフィールド、あるいはそもそも整形式の結果でないバイト列)を拒否します。

読み取れる部分だけを読むのではなく拒否するのは、読み取れる部分だけを読むと、それが気付かれないためです。 アタッチメントが呼び出すエクスポートはアタッチメントごとに選べるため、結果がまったく異なる形のエクスポートを指定することもあり得ます。合わない部分を読み飛ばすと空の結果になりますが、空の結果はそれ自体が正当な回答です(判定が返されず、指摘も挙がらない)。その場合、両者は区別できなくなり、ビルドはプラグインが承認したかのようにそのまま続行してしまいます。

出力されるメッセージ。結果が返されたエクスポートを示し、読み取りが失敗した理由を含みます。両者を合わせると、アタッチメントが指定すべきだったエクスポートが特定できます。

call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read>(エクスポートの呼び出し: wasm: ゲストプラグインが、ソケットが読み取る形状ではない出力を返しました。読み取れなかった内容を示します)

修正方法: アタッチメントが指定するエントリ関数を、プラグインが宣言するエクスポートと照合してください。誤ったエクスポートを指すアタッチメントがよくある原因であり、メッセージの理由には該当しないフィールドが示されます。エクスポートが正しい場合、プラグインはアタッチメントポイントが読み取らない形を返しており、これはプラグイン側の修正です。エクスポートと理由の両方を引用して、プラグインの公開者に報告してください。

A plugin returned a diagnostic at a severity that is not declared(プラグインが、宣言されていない重大度の診断を返しました)

プラグインは結果とともに所見を返すことができ、各所見は閉じた集合から選ばれた重大度を持ちます。ビルドを停止して修正すべき点を示すもの、完了するビルドの横に表示されるもの、所見を記録するだけで何も変えないものです。その集合の外にある重大度は、ホストに処理経路がないものであり、ビルドは停止します。

経路を選ぶのではなく拒否するのは、どちらの代替案もより悪いためです。 処理できない所見を読み飛ばすと、それを何もしなくてよいものとして扱うことになります。プラグインがビルドを受け入れるかどうかを判断している場合、これは承認と読まれます。プラグインが挙げた異議は一度も表示されないまま、ビルドを通してしまいます。停止の重大度として扱えば、誰も選んでいない値でビルドを拒否することになります。どちらも気付かれないため、ホストは値が誤っていることを伝え、プラグインのほうを修正します。

このチェックは、所見が後で表示される各箇所ではなく、結果が読み取られる時点で一度だけ実行されます。そこはプラグインの識別情報がまだ手元にある唯一の時点でもあります。レポートに取り込まれた所見は、どのプラグインが挙げたものかをもはや保持していないためです。

出力されるメッセージ。プラグイン、エクスポート、問題のあった所見、その値、および宣言されている値を示します。

plugin "<plugin>" call "<export>": wasm: guest plugin returned a diagnostic whose severity the contract does not declare: diagnostic <index> has severity "<value>"; the declared severities are "halt", "warn" and "info"(プラグインのエクスポート呼び出し: wasm: ゲストプラグインが、契約で宣言されていない重大度の診断を返しました。該当する診断の番号とその重大度の値を示し、宣言されている重大度は halt、warn、info です)

修正方法: エンティティファイルの内容が原因ではありません。値はプラグインから来ています。メッセージが示す値を引用して、プラグインの公開者に報告してください。自作のプラグインの場合は、宣言された 3 つの重大度のいずれかを出力してください。メッセージにはそれらが示され、インデックスでどの所見を確認すべきかがわかります。

A provider returned two output files under one path(プロバイダーが 1 つのパスに 2 つの出力ファイルを返しました)

プロバイダーは出力をファイルのリストとして返し、各ファイルは書き込まれるパスを示します。ホストはそれらをパスをキーとして収集し、独自のシリアライザーを実行せずに各ファイルのバイト列をそのまま書き込みます。2 つのファイルが同じパスを示すと、その集合には 1 つのキーに 2 つの値が残ります。

どちらかを選ぶのではなく拒否するのは、後からではどちらを選んだのか区別できないためです。 後のものを残すと、プロバイダーが書くよう指示したファイルを破棄し、先のものを残すと後のファイルを破棄します。いずれにしてもディスク上の出力は整形式でありながら 1 ファイル足りず、ファイルが失われたことを記録するものは何もありません。さらに、残ったパスはいずれにしても残ったはずのパスなので、結果からは衝突が起きたことがわかりません。どちらが意図されていたかは、プロバイダーにしか答えられない問題です。

これは、プロバイダーがファイルを返すあらゆる場所、つまり 1 つのノードのレンダリング時と、ディスパッチグループの出力を 1 つの成果物に組み立てる時に発生します。条件も修正方法も両方で同じなので、どちらでも報告されます。

出力されるメッセージ。2 回返されたパスと、それが返されたノードまたはディスパッチパスを示します。

provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>")(プロバイダのゲストが 1 つのパスに 2 つの出力ファイルを返しました。準拠するゲストは各出力パスを最大 1 回だけ返します。該当するパスとノードを示します)

修正方法: エンティティファイルの内容が原因ではありません。パスはプロバイダーから来ています。メッセージが示すパスを引用して、プロバイダーの公開者に報告してください。自作のプロバイダーの場合は、各出力パスを最大 1 回だけ返してください。パスのリストをセットと照合しながら構築すれば、同じパスへの 2 つ目のファイルを生成時点で検出できます。両方が必要な場合は、2 つ目のファイルに別のパスを与えてください。

A provider reported a render fact whose value is not a list(provider が値がリストでないレンダーファクトを報告した)

provider は、ファイルとともに、レンダリングした出力に関するファクトを報告できます。各ファクトは名前と値からなり、その provider 自身が文書化した語彙に従います。component にアタッチされた Features は、テンプレートからそれらを読み取ります。すべてのファクトの値はリストであり、エントリが 1 つだけの場合も同じです。1 つの名前は component の複数のレンダー、つまりその component 自身の provider 呼び出しと、アタッチされた Features のレンダーによって報告されることがあり、それらのリストはその名前のもとで 1 つに結合され、読み取るテンプレートに渡されます。provider はレンダリング時に、自身の報告がその名前のもとで唯一のものになるかどうかを知ることができません。そのため、値がオブジェクト、文字列、数値、真偽値、または null である場合は、テンプレートがそのファクトを読み取るかどうかにかかわらず、すべてのレンダーにおいて provider が値を引き渡した時点で拒否されます。

出力されるメッセージ。ファクト、それが報告されたノード、報告した provider、および値の種類を示します。

provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact’s value as a JSON array, even with one entry (fact "<fact>", node "<node>", provider "<provider>", its value is <kind>)(provider ゲストが値がリストでないレンダーファクトを報告しました。準拠するゲストは、エントリが 1 つであってもすべてのレンダーファクトの値を JSON 配列として報告します)

修正方法: エンティティファイルの内容がこの原因になることはありません。値は provider から来ています。メッセージが示すファクトを引用して、provider の公開元に報告してください。provider が自分のものである場合は、そのファクトの値を JSON 配列として報告し(単一のオブジェクトはそのオブジェクトを含むリストになります)、provider が報告するファクトの説明でリストとして文書化してください。ゲストが出力したものに関するファクトの報告を参照してください。

接続が 2 つのディスパッチグループをまたぐ場合、各側の provider に配線が求められます。消費される側は識別子を公開し、消費する側はそれに対して解決を行い、それぞれが自身のグループの出力に適用する構造的な配線を返すことができます。各配線は、適用先の出力ファイルを指定します。後続のパスがそのファイルを分割し、操作を適用し、バイト単位で忠実に再構築します。

出力されたどのファイルとも一致しない名前では、そのパスに分割する対象がなくなります。そのため、配線を無視するのではなく拒否します。 配線が持つ操作こそが接続を解決するものであり、それを捨てると、組み立てられた出力は何も配線されていないエンドポイントを参照することになります。これはデプロイ時に、原因となった provider から遠く離れた場所で失敗し、配線ではなく接続の誤りのように見えます。

配線が指定できるファイルは、そのグループ自身のレンダーが返したファイルです。これらは同じ呼び出しで provider に渡されるため、provider が名前を推測する必要はありません。与えられた集合から 1 つを選択します。

出力されるメッセージ。配線が要求したファイルと、それが返されたエンドポイントを示します。

link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group’s own render returned (file "<file>", node "<node>")(リンクパッチがディスパッチグループの出力していない出力ファイルを指定しています。準拠するリンクパッチは、グループ自身のレンダーが返したファイルを指定します)

修正方法: エンティティファイルの内容がこの原因になることはありません。名前は provider から来ています。メッセージが示すファイルを引用して、provider の公開元に報告してください。provider が自分のものである場合は、独自に組み立てた名前ではなく、呼び出しで渡される組み立て済みファイルからファイル名を指定してください。手作業で組み立てたパスは、それを生成するレンダーが変わった瞬間に古くなり、その結果がこのエラーです。

A pipeline step’s file emission carries no file(パイプラインステップのファイル出力にファイルが含まれていない)

パイプラインステップは、パッチするドキュメントとともに新しいドキュメントを出力できます。各出力は種類を宣言し、ファイル種類の出力は書き込むファイル、つまりパスと内容を持ちます。

ここでは種類は正しいもののファイルが存在しないため、ステップは応答で実行しない意図を宣言したことになります。これが後述の未定義の種類による停止との違いです。ホストは emit_file 出力で何をすべきかを正確に知っていますが、その対象がありません。

何も出力せずに済ませるのではなく拒否します。ファイルを何も追加しない出力は、気付かれないからです。 ドキュメントを出力することがステップがパイプラインにある理由のすべてであることも多く、その出力は以前存在しなかったファイルです。そのため、これを飛ばしたビルドは、ステップが実行を報告しているにもかかわらず、ドキュメントが欠けた出力を生成することになります。

出力されるメッセージ。ノードと、ステップのどの出力に問題があったかを示します。

emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>)(emit_file 副作用にファイルが含まれていません。準拠する emit_file 副作用は、パスと内容を持つファイルを含みます)

修正方法: エンティティファイルの内容がこの原因になることはありません。応答はプラグインから来ています。メッセージが示すインデックスを引用して、プラグインの公開元に報告してください。プラグインが自分のものである場合は、すべての emit_file 出力でファイルメンバーにパスと内容の両方を設定してください。インデックスは、そのステップの応答のどの出力を確認すべきかを示します。

A pipeline step declares an emission kind the contract does not define(パイプラインステップが契約で定義されていない出力の種類を宣言している)

パイプラインステップが返す各出力は種類を宣言し、契約は 2 つを定義しています。1 つはファイルを書き込み、もう 1 つはカスタムリソースのドキュメントを追加します。種類はワイヤ上では自由な文字列であり、そのため既存のプラグインを壊さずに後から種類を追加できます。

その自由さこそが、未定義の種類を無視せずに拒否する理由です。 ホストが定義していない値は、その形だけでは、後のバージョンで定義される値と区別できません。そのため、それを飛ばすホストは、ステップが成功を報告する一方で、ステップが意図したものをすべてのビルドで黙って捨てることになります。拒否することで、拡張点を穴にすることなく開いたままにできます。このビルドが定義していない種類は、受け入れて無視されるのではなく、ステップが送った値を引用して未定義として報告されます。

出力されるメッセージ。ノード、どの出力に問題があったか、および宣言された種類を示します。

side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd (node "<node>", side effect <index>, kind "<value>")(副作用がプラグイン契約で定義されていない種類を宣言しています。準拠する副作用は emit_file または emit_crd を宣言します)

修正方法: エンティティファイルの内容がこの原因になることはありません。値はプラグインから来ています。メッセージが示す種類を引用して、プラグインの公開元に報告してください。プラグインが自分のものである場合は、メッセージに列挙された種類のいずれかを宣言してください。定義済みの種類のスペルミスがよくある原因であり、引用されて返される値が送信した値です。

A provider’s reassembly is handed a unit its own carve never produced(provider の再組み立てに、自身の分割が生成していない単位が渡された)

出力の形を直接アドレス指定できない provider は、自ら分割を行うことができます。出力ファイルをアドレス指定可能な単位に分け、それぞれをトークンの下に置いて返します。その後パイプラインステップがそのトークンで単位をアドレス指定し、再組み立てが編集された単位をバイト単位で忠実にファイルへ継ぎ戻します。この二つの半分は一つの契約です。ファイルが分割される際のトークンが、その再組み立てが解決するトークンです。

同じファイルの分割が生成していないトークンが再組み立てに渡されると、編集された内容を戻すバイト範囲が存在しません。 単位を捨てずに拒否するのは、捨てられた単位からは、整形式でありながらステップに求められた編集が欠けたファイルが生じるためです。何も失敗せず、何も不正な形式ではなく、編集だけが単に存在しない状態になります。

二つの半分が食い違い得るのは、それらが分かれている場合、つまり自ら分割を行い、残りは標準の構造的な再組み立てを借りるコーデックの場合だけです。そのとき、あるトークンの集合で分割し、別の集合に対して再組み立てを行うと、まさにこの状態になります。両方の半分を持つコーデックではこの状態に至りません。自身の再組み立てが自身のトークンに責任を持つためです。

出力されるメッセージ。何にも解決されなかったトークンと、それが指定された対象のファイルを示します:

reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens (token "<token>", file "<file>")(reassemble が carve の生成していないパッチ済みユニットのトークンを指定しています。準拠する codec は、ファイルを同じトークンで carve し、reassemble します)

修正方法: エンティティファイル内に原因はありません。provider が自分のものである場合は、一方の半分が生成するトークンを、もう一方が解決するトークンと一致させてください。両側でそれぞれ独立に導出するのではなく、一度導出して受け渡します。また、分割の前にファイルを書き換える場合は、同じ書き換え後の形に対して再組み立てを行ってください。provider が自分のものでない場合は、メッセージが示すトークンを添えて、その発行元に報告してください。

A workload declares a form compose cannot express(compose が表現できない形態を workload が宣言している)

compose provider は長時間実行されるサービスをレンダリングします。マシンごとに一つのコピーを実行する、スケジュールに従って実行する、あるいは一度実行して終了する、と宣言した workload には、単一マシンでのきれいな等価物がありません。そのため、通常のサービスを出力するのではなくレンダリングを停止します。通常のサービスでは、起動して実行を続けることになり、求められた内容を誤って表現してしまうためです。

出力されるメッセージ。条件は失敗の種類(ビルドが宣言したものに対する表現を持たない provider)を示し、provider 自身の文が与えられた形態を示します:

a plugin has no expression for a construct this build declares(このビルドが宣言する構成要素を表現する手段がプラグインにありません) compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form(指定された workload の形式には compose への対応付けがありません。compose がサポートするのは stateless と stateful のみです。compose はこの workload の形式を表現できません)

修正方法: ターゲットが本当に単一マシンの compose 環境である場合は、その処理を長時間実行されるサービスとして表現してください。compose がレンダリングするのは stateless と stateful の二つの形態です。その形態が意図どおりである場合は、そのバウンダリを、ターゲットに等価物を持つ provider でレンダリングしてください。マシンごとのコピー、スケジュール実行、完了まで実行するジョブは、いずれも他の環境に直接の表現があります。また、provider の選択は workload ではなくバウンダリが行うものです。

A container declares a field compose has no primitive for(compose にプリミティブのないフィールドをコンテナが宣言している)

compose に等価物のないコンテナのフィールドが二つあり、どちらも破棄されるのではなくレンダリングを停止します。

コンテナの起動時または停止直前に実行されるフック。 compose にはそれを実行する仕組みがなく、黙って実行されないフックは、ビルド時ではなく実行時に表面化する正しさの面での想定外となります。

名前付きオブジェクトから取り込まれる一括の環境変数。 compose はファイルから変数を読み込めますが、オブジェクトへの参照はファイルではありません。一方を他方として解釈し直すと、何も告げずにコンテナに渡される内容が変わってしまいます。

どちらも通常のコンテナと、メインのコンテナより前に実行されるコンテナの両方について確認されます。そのため、同じフィールドはどこで宣言されても停止し、メッセージはどのコンテナに由来するかを示します。

出力されるメッセージ。 どちらも同じ条件(ビルドが宣言したものに対する表現を持たない provider)を報告し、どのフィールドかは provider 自身の文が示します:

a plugin has no expression for a construct this build declares(このビルドが宣言する構成要素を表現する手段がプラグインにありません) compose: node "<node>" container "<container>": compose: node "<node>" declares container lifecycle hooks; compose has no lifecycle-hook primitive: compose has no lifecycle-hook primitive; container declares lifecycle hooks(ノードのコンテナについて、ノードがコンテナのライフサイクルフックを宣言しています。compose にはライフサイクルフックのプリミティブがありません。コンテナがライフサイクルフックを宣言しています)

a plugin has no expression for a construct this build declares(このビルドが宣言する構成要素を表現する手段がプラグインにありません) compose: node "<node>" container "<container>": compose: node "<node>" declares container envFrom; compose has no env-from-object primitive: compose has no env-from-object primitive; container declares envFrom(ノードのコンテナについて、ノードがコンテナの envFrom を宣言しています。compose にはオブジェクトから環境変数を読み込むプリミティブがありません。コンテナが envFrom を宣言しています)

修正方法: compose ターゲットでは、そのフィールドを削除し、別の方法でその処理を行ってください。起動時の処理はメインのコンテナより前に実行されるコンテナに、終了時の処理はコンテナ自身のシグナル処理に置きます。一括の環境変数は、明示的な変数として書き出すか、compose ターゲットが読み込めるファイルから供給できます。そのフィールドが意図どおりである場合は、そのバウンダリを、ターゲットにそのプリミティブがある provider でレンダリングしてください。

An omits entry names a kind or a namespace a compose file does not have(omits エントリが、compose ファイルにない kind または namespace を指定している)

compose ファイルをソースとする Recipe または FeatureRecipe の omits: エントリは、そのファイルのトップレベルの単位を一つ除外します。compose ファイルにはエントリが指定できる kind がちょうど三つあり(service、volume、config で、それぞれ services:、volumes:、configs: の下のキーで指定されます)、namespace はありません。それ以外の kind(チャートドキュメントの Secret や compose の network など)を指定するエントリ、または namespace を持つエントリは、ファイルが除外し得るものを何も指定していないため、何にも一致しなかったエントリとして扱うのではなくレンダリングを停止します。kind は厳密に比較されるため、service のつもりで Service と書くと拒否されます。何かが除外される前にすべてのエントリが確認され、書かれた順で最初に問題のあったエントリが示されます。

出力されるメッセージ。 どちらも provider が表現を持たない構成要素に関する条件を報告し、provider 自身の文がそのエントリと受け付ける kind を示します。テンプレートが機密と宣言された値を読み込んだフィールドは <redacted> と表示されます:

a plugin has no expression for a construct this build declares(このビルドが宣言する構成要素を表現する手段がプラグインにありません) compose: an omits entry (name "<name>") names kind "<kind>": compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind(omits エントリが対応しない kind を指定しています。compose が除外するのは service、volume、config のいずれかで、それぞれ services:、volumes:、configs: の下のキーで指定します。それ以外の kind は除外しません)

a plugin has no expression for a construct this build declares(このビルドが宣言する構成要素を表現する手段がプラグインにありません) compose: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a compose file has no namespaces: compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind; remove the namespace from the entry(omits エントリが namespace を指定していますが、compose ファイルには namespace がありません。compose が除外するのは service、volume、config のいずれかで、それぞれ services:、volumes:、configs: の下のキーで指定します。それ以外の kind は除外しません。エントリから namespace を削除してください)

修正方法: compose ファイルと同じ方法で単位を指定し(kind: service、volume または config と、そのセクションの下のキーを name: に)、namespace: を削除してください。compose → ソースモードを参照してください。

An omits entry names a namespace a CloudFormation template does not have(omits エントリが CloudFormation テンプレートに存在しない namespace を指定している)

CloudFormation テンプレートをソースとする Recipe または FeatureRecipe 上の omits: エントリは、1 つのリソースを除外します。そのリソースは、Type をエントリの kind として、論理 ID をエントリの name として指定します。テンプレートには namespace がないため、namespace を持つエントリはテンプレートが除外できるものを何も指定しておらず、レンダリングはそのエントリを何にも一致しなかったものとして扱うのではなく停止します。何かが除外される前にすべてのエントリが検査され、記述された順序で最初に namespace を持つエントリが報告されます。

出力されるメッセージ。 プロバイダーが表現を持たない構成要素についての条件を報告し、プロバイダー自身の文がエントリと、このプロバイダーが除外するものを示します。テンプレートが機密と宣言された値を読み取ったフィールドは <redacted> と表示されます。

a plugin has no expression for a construct this build declares cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry

修正方法: エントリから namespace: を削除します。エントリは Type と論理 ID だけでリソースを指定します。cloudformation → ソースとするテンプレートからリソースを除外するを参照してください。

A published port declares a transport compose cannot spell(公開ポートが compose で表記できないトランスポートを宣言している)

compose の公開ポートは、トランスポートをエントリの接尾辞として持ち、その接尾辞には 2 つの表記があります。それ以外のトランスポートを宣言するポートには、compose での表記がまったくありません。

接尾辞を削除するのではなく停止します。 公開ポートが暗黙のうちにデフォルトのトランスポートにフォールバックすると、クライアントが到達できないトラフィックを運ぶ状態で起動してしまうためです。これはまさにトランスポートの宣言が防ぐために存在する障害であり、変換の時点で再び持ち込まれることになります。

トランスポートを宣言しないポートは影響を受けません。 トランスポートを一度も持たなかったポートとまったく同じく、接尾辞なしで公開されます。

出力されるメッセージ。条件が障害の種類(プロバイダーが出力するものに表現を持たない値)を示し、その後にプロバイダー自身の文が続きます。

a plugin has no representation for a value it was given compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express

修正方法: compose ターゲットでは、ポートのトランスポートを compose が表記できる 2 つのいずれかとして宣言するか、宣言せずにエントリを接尾辞なしで公開させます。そのトランスポートが意図したものである場合は、そのトランスポートを表現できるターゲットを持つプロバイダーを通してそのバウンダリをレンダリングします。

A resources quantity cannot be converted to a compose value(resources の数量を compose の値に変換できない)

コンテナのプロセッサとメモリの数量、および nvidia.com/gpu の数は Kubernetes がリソースに使う表記で書かれ、compose はそれらを独自の単位で保持します(GPU 数は NVIDIA デバイス予約の数になります)。そのため、それぞれが数量として読み取られ、その値から変換されます。これを止めるものは 2 つあり、メッセージはどちらに該当したかを示します。そもそも数量ではない値と、compose が正確な形式を持たない数量です。後者は、負の量、バイトの整数でないメモリ量、コアの小数点以下 9 桁より細かいプロセッサ量、デバイスの整数でない GPU 数、または compose が保持できる最大値を超える量です。nvidia.com/gpu のリクエストとリミットが異なる数を要求するコンテナも停止します。compose は 1 つのサービスに 1 つの数を予約するためです。値を丸めたり近似値を出力したりするのではなく停止します。要求したものと暗黙のうちに異なるリミットは、それを超えたことで何かが停止されるまで誰も探さない種類の違いだからです。

出力されるメッセージ。 いずれも条件(プロバイダーが出力するものに表現を持たない値)で始まり、続いてリソース、値がリクエストとリミットのどちらか、Workload 内のパス、そして値を示します。数量ではない値の場合は、その後に数量でない理由と数量がとる形式が続きます。

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu> <request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value

compose が表現できない数量の場合は、その後にそのリソースについて compose が保持できる範囲が続きます。

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value

GPU のリクエストとリミットが異なる数を要求する場合は、両方のパスと両方の数が示されます。

a plugin has no representation for a value it was given compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value

Workload のテンプレートが作成者によって機密と宣言された値を読み取る場合、どのメッセージも拒否した値を引用せず、2 つの数も同様に省かれます。

修正方法: 値が数量でない場合は、Workload → リソースの数量に示された形式で記述します。m のような接尾辞だけの値は、テンプレートが補間する値が空のときに残るものなので、修正すべき入力はテンプレートが読み取ったものです。compose が表現できない数量の場合は、メッセージが示す範囲内の量を記述します。メモリはいずれかの単位でバイトの整数(1.5001Gi ではなく 1536Mi)、プロセッサ時間はコアの小数点以下 9 桁まで、GPU 数はデバイスの整数(0.5 や 500m ではなく 1)です。GPU のリクエストとリミットが一致しない場合は、両方に同じ数を記述するか、リミットだけを記述します。リミットは、同じ Workload に対して Kubernetes がスケジュールする数です。

A resource quantity the helm provider emits is not a quantity(helm プロバイダが出力するリソース量が量ではない)

helm プロバイダは、すべてのリソース量を出力するマニフェストにそのままコピーします。対象は各コンテナおよび init コンテナの resources.requests と resources.limits の値(拡張リソースを含む)と、各ボリュームの ephemeral.sizeLimit、persistent.size、persistentTemplate.size です。プロバイダは、Recipe のテンプレートが評価した Workload 上で、まずそれぞれを量の形式と照合します。形式から外れた値はここでビルドを停止させます。そうしなければビルドは問題なく成功し、チャートのインストール時にクラスタに拒否されることになります。

出力されるメッセージ。 条件から始まり、続いてノード、Workload 内のフィールドのパス、値、量ではないとされた理由を示し、量が取る形式を述べます。

a plugin has no representation for a value it was given helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei)

修正方法: Workload → Resource quantities に示す形式で値を記述します。フィールドがテンプレート化されている場合、修正すべき値はテンプレートが読み取った値です。m や Mi のような接尾辞だけの値は、補間する値が空のときにテンプレートが残すものです。また、Release のパラメータは記述されたとおりにフィールドへ届きます。

A service type the helm provider cannot render(helm プロバイダがレンダリングできないサービスタイプ)

helm プロバイダは、Workload の各 services エントリを、エントリの type をタイプとする Kubernetes Service としてレンダリングします。Loopback エントリは、そのポートをホスト自身のループバックアドレスからのみ到達可能にすることを求めますが、Kubernetes Service にはそれを実現するタイプがありません。NodePort Service がどのノードアドレスで待ち受けるかはクラスタ全体の設定であり、個々の Service の設定ではないためです。そのため、ビルドはサービスの宣言順で最初の Loopback エントリで、リソースが書き込まれる前に停止します。

エントリを別のタイプとしてレンダリングせずに停止します。Service が持つどのタイプも、ポートの到達範囲を変えてしまうためです。ClusterIP Service ではエントリが求める公開範囲が失われ、NodePort Service ではクラスタが許可するすべてのノードアドレスでポートが公開されます。これはエントリが避けるために存在する、より広い公開です。

出力されるメッセージ。 条件から始まり、続いてノード、Workload 内のサービスのパス、タイプを示します。

a plugin has no representation for a value it was given helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it

修正方法: helm ターゲットでは、ポートがクラスタ内でどこまで到達すべきかを表すタイプを宣言します。内部に留めるには ClusterIP、公開するには NodePort または LoadBalancer です。Loopback エントリは compose ターゲット向けで、compose はポートを 127.0.0.1 で公開します。Workload → services を参照してください。

A Kubernetes version the helm provider cannot render a chart for(helm プロバイダがチャートをレンダリングできない Kubernetes バージョン)

helm プロバイダは、コンポーネントまたはその境界の aggrega.ai/kubernetes-version アノテーションが指定する Kubernetes バージョン向けに、ソースからチャートをレンダリングします。値は helm template --kube-version がフラグを読むのと同じ方法で読み取ります。そのフラグが拒否する値("one.two"、"latest"、"1" のような単一の数値、"01.20" のような先頭にゼロが付いた数値)では、チャートが .Capabilities.KubeVersion として読むバージョンがないため、チャートのレンダリング前にビルドが停止します。

デフォルトバージョン向けにチャートをレンダリングせずに停止します。チャートはバージョンを読んで API バージョン、フィールド、あるいは仕組み全体を選択するため、指定したものとは異なるバージョン向けにレンダリングされたチャートは、その別バージョン向けの形を出力します。それはデプロイ先のクラスタで動作しない可能性があります。

空の値は拒否されません。 未設定として扱われ、チャートはデフォルト、つまり同じ helm リリースの標準の helm template がレンダリングするバージョン向けにレンダリングされます。

出力されるメッセージ。 条件から始まり、続いてノードとその配置先の境界、アノテーション、値、バージョンではないとされた理由を示し、記述すべき形式を述べます。

a plugin has no representation for a value it was given helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary

メッセージがノードとその境界の両方を示すのは、プロバイダがコンポーネントのアノテーションとその境界のアノテーションを合わせて読み、コンポーネント自身の値を優先するためです。つまり値はどちらに記述されていた可能性もあります。

修正方法: チャートのデプロイ先クラスタのバージョン("1.31" のようなメジャーとマイナーのバージョン、または "v1.31.2" のような完全なバージョン)をコンポーネントまたはその境界に記述するか、アノテーションを削除してデフォルト向けにレンダリングします。helm → The Kubernetes version a chart is rendered for を参照してください。

A health probe cannot be turned into a compose healthcheck(ヘルスプローブを compose の healthcheck に変換できない)

宣言されたヘルスプローブは compose の healthcheck になりますが、これを妨げる要因が 2 つあります。

ポートを公開しないコンテナ上で、HTTP でパスをチェックするプローブ。 チェックはコンテナのポートへのリクエストとして構築されるため、ポートが宣言されていなければ構築先のアドレスがありません。

チェック方法をまったく宣言しないプローブ — パスも、接続先のポートも、実行するコマンドもありません。チェックに変換するものが何もありません。これはスキーマの背後にある防御であり、実際に記述しがちな形ではありません。プローブはここに到達する前に、3 つのうち 1 つを持つかどうかチェックされます。

出力されるメッセージ。 どちらも同じ条件(プロバイダが必要とするものを正確に 1 つの値に解決できなかった)を報告し、どちらであるかはプロバイダ自身の文が示します。

a plugin could not resolve something it requires to exactly one value compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none

a plugin could not resolve something it requires to exactly one value compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec)

修正方法: チェックの対象となるポートを、プローブと同じコンテナに宣言します。HTTP のプローブは最初のコンテナポートを読むため、チェックを構築するにはポートが存在する必要があります。コンテナが本当に何も公開しない場合は、別の方法でチェックします。コマンドを実行するプローブにはポートが不要です。チェック方法が宣言されていないプローブには、3 つのうち 1 つを指定します。

A configmap volume has no file behind it(configmap ボリュームの背後にファイルがありません)

設定をマウントするボリュームは、compose 独自の仕組みを通じて名前で参照されて配信され、内容を保持するエントリは Recipe が出力するファイルから得られます。この条件は、一致するエントリのない参照が報告するものです。ファイルが存在しないため、マウントは背後に何もない状態で存在することになり、コンテナは空のパスを読み込んで起動してしまいます。

このチェックはコンポーネントごとではなく、組み立てられた出力全体に対して実行されます。これは意図的なものです。参照と内容を保持するエントリは異なる経路で届き、同じグループ内の異なるコンポーネントから来る場合があるため、両方がそろう最初の時点が組み立てられた出力だからです。コンポーネントごとのチェックでは、同じグループ内の別のコンポーネントが内容を供給する参照まで拒否してしまいます。

未解決の参照は最初の 1 つだけでなくすべてが安定した順序で報告されるため、1 回のビルドですべてが示されます。

出力されるメッセージ。条件が先頭に来て、続いて各サービス、そのサービスが行った参照、マウント先が示されます。

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを 1 つの値に解決できませんでした) compose AssembleBoundary: service "<service>" references config "<name>" mounted at "<path>"; declare each one as a top-level configs: entry from the Recipe’s artifacts: input: configmap volume requires a file emitted via the Recipe’s artifacts: input; none found(サービスがマウントする config を参照しています。それぞれを Recipe の artifacts: 入力からトップレベルの configs: エントリとして宣言してください。configmap ボリュームには Recipe の artifacts: 入力から出力されるファイルが必要ですが、見つかりませんでした)

修正方法: ボリュームが参照する名前で、Recipe の artifacts: 入力からファイルを出力してください。両者はその名前で照合されるため、ボリュームが求めるものと Recipe が出力するものの不一致がよくある原因です。内容を別の場所から得るつもりだった場合、ボリュームはそのための仕組みとして適切ではありません。環境に属する値は環境に置いてください。

What an omits entry left out is still named by the compose file(omits エントリが除外したものが、まだ compose ファイルから参照されています)

omits: エントリはソースとして取り込んだ compose ファイルからサービス、ボリューム、config を除外しますが、compose は宣言していないものを参照するファイルを拒否します。そのため、エントリのユニットが削除された後も、ファイルの残りの部分がそれらのいずれかに対して行っている参照はすべてレンダリングを停止させます。対象は、depends_on、links、volumes_from、extends、build.additional_contexts の値、または service: のネットワーク・IPC・PID・UTS モードで参照されるサービス、volumes: エントリのソースとして参照されるボリューム、configs: エントリで参照される config です。これらは各サービス、各サービスの pre_start フック、各ジョブの中で読み取られます。完全な一覧と、参照のように見えるだけの値については compose → Sourced mode を参照してください。

このチェックは、宣言している Recipe または FeatureRecipe 自身のファイルを読み取ります。そのため、同じ組み立て済みファイルへの別のコントリビューターが、除外されたものと同じ名前のユニットを宣言している場合でもレンダリングは停止します。参照は最初の 1 つだけでなくすべてが報告されます(サービスをキー順に、次にジョブ、各サービスのフックはそのサービスの後)。そのため、1 回のビルドですべてが示されます。

出力されるメッセージ。条件が先頭に来て、続いて参照している各エントリ、それが参照するユニット、参照が含まれるフィールドが示されます。

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを 1 つの値に解決できませんでした) compose: what an omits entry left out is still named by the file: service "<service>" names <kind> "<name>" at <field>; compose refuses a file naming a service, a volume or a config it does not declare: leave out what names it as well, change the reference through valuesMapping, or remove the entry(omits エントリが除外したものを、ファイルがまだ名指ししています。compose は宣言されていないサービス、ボリューム、config を名指しするファイルを拒否します。名指ししているものも除外するか、valuesMapping で参照を変更するか、エントリを削除してください)

エントリの名前が機密と宣言された値から組み立てられたユニットは、<redacted> と表示されます。

修正方法: 2 つのうちどちらを意図していたかを決めてください。参照しているサービスがまだそのユニットを必要とする場合は、ユニットを残します。つまりエントリを削除します。必要としない場合は、Recipe の valuesMapping: で参照を変更するか(そこに書いたリストはベースファイルのリストを置き換えるため、depends_on: [] で参照を消去できます)、参照しているサービスも独自のエントリで除外してください。

What an omits entry left out is still named by a CloudFormation template(omits エントリが除外したものが、まだ CloudFormation テンプレートから参照されています)

omits: エントリはソースとして取り込んだ CloudFormation テンプレートからリソースを除外しますが、CloudFormation は宣言していないリソースを参照するテンプレートを拒否します。そのため、エントリのリソースが削除された後も、残りのテンプレートがそれらのいずれかに対して行っている参照はすべてレンダリングを停止させます。対象は、Ref、リスト形式またはドット区切り文字列形式の Fn::GetAtt、リソースの DependsOn、Fn::Sub の変数で、各リソースの本体と各出力のどこにあっても読み取られます。完全な一覧と、参照のように見えるだけの値については cloudformation → Leaving resources out of a sourced template を参照してください。

このチェックは、宣言している Recipe または FeatureRecipe 自身のテンプレートをまとめて読み取ります。それらのテンプレートの別の 1 つがまだ宣言している論理 ID への参照は停止されませんが、除外されたリソースへの参照は、別のコンポーネントがその論理 ID のリソースを宣言している場合でもレンダリングを停止させます。参照は最初の 1 つだけでなくすべてが報告されます(ソースが持つ順にテンプレートごと、各テンプレートのリソース、次にその出力をキー順に)。そのため、1 回のビルドですべてが示されます。

出力されるメッセージ。条件が先頭に来て、続いて各参照について、それが含まれるテンプレート、参照するリソース、参照の方法、テンプレートのルートからのパスとしての位置が示されます。

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを 1 つの値に解決できませんでした) cloudformation-provider: what an omits entry left out is still named by the source’s templates: template "<template>" names resource "<logical-id>" (type "<type>") by <Ref|Fn::GetAtt|DependsOn|Fn::Sub> at <path>; CloudFormation refuses a template naming a resource it does not declare: leave out what names it as well, or remove the entry(omits エントリが除外したものを、ソースのテンプレートがまだ名指ししています。CloudFormation は宣言されていないリソースを名指しするテンプレートを拒否します。名指ししているものも除外するか、エントリを削除してください)

エントリのフィールドが機密と宣言された値から組み立てられた場合、そのリソースの論理 ID とタイプは <redacted> と表示され、その論理 ID を表すパスのステップも同様に表示されます。

修正方法: 2 つのうちどちらを意図していたかを決めてください。参照しているリソースが除外されたリソースをまだ必要とする場合は、それを残します。つまりエントリを削除します。必要としない場合は、参照しているリソースも独自のエントリで除外してください。パラメータにバインドされた値はそのパラメータへの参照だけを置き換えるため、リソースへの参照をそれで変更することはできません。リソースを参照する出力は除外できないため、出力が参照するリソースは残ります。

A valuesMapping key names no parameter of a sourced CloudFormation template(valuesMapping のキーが、ソースとして取り込んだ CloudFormation テンプレートのどのパラメータも指していません)

ソースとして取り込んだ CloudFormation テンプレートは、宣言している Parameters を通じて値を受け取り、それを取り込む Recipe または FeatureRecipe の valuesMapping は、埋めるパラメータごとに 1 つのキーを書きます。ソースのどのテンプレートも宣言していないパラメータを指すキーには行き先がないため、レンダリングはそれを破棄せずに停止します。これは CloudFormation 自身が未知のパラメータに対して報告する失敗であり、まだ修正できる段階で報告されます。パラメータを埋めるのは valuesMapping だけです。何もマッピングしていない値がこの方法で読み取られることはないため、コンポーネントやアタッチメント自身の、他の入力のために書かれた値がこれに該当することはありません。

出力されるメッセージ。条件が先頭に来て、続いて何も指さなかったすべてのキーと、ソースの各テンプレートが宣言しているものが示されます。

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを 1 つの値に解決できませんでした) cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping writes the key "<key>", and no template of the source declares a parameter of that name: template "<template>" declares "<parameter>", …; a sourced template takes values only through the parameters it declares, so rename the key to the parameter it is meant for, or remove it from the valuesMapping(Recipe または FeatureRecipe の valuesMapping が書き込むキーと同じ名前のパラメータを、ソースのどのテンプレートも宣言していません。ソースとして取り込んだテンプレートは宣言したパラメータを通してのみ値を受け取るため、キーを意図したパラメータの名前に変更するか、valuesMapping から削除してください)

修正方法: キーをメッセージに列挙されたパラメータと比較し(キーの綴り間違いがよくある原因です)、名前を変更するか、valuesMapping から削除してください。cloudformation → Values for a sourced template’s parameters を参照してください。

Another component references a CloudFormation parameter a sourced template’s binding filled(ソース取得したテンプレートのバインディングが埋めた CloudFormation パラメータを別のコンポーネントが参照している)

ソース取得したテンプレートのパラメータを、そのテンプレートをソースとする Recipe またはアタッチされた Feature の FeatureRecipe の valuesMapping で埋めると、そのソースのすべてのテンプレート内にあるそのパラメータへの参照がすべて置き換えられ、その宣言は削除されます。同じアセンブル済みスタック内の別の場所から来るコンテンツ(別のコンポーネントのフラグメントやソース取得したテンプレート、または Feature がアタッチされたコンポーネントのフラグメント)が、Ref、Fn::Sub の変数、あるいはルールの Fn::ValueOf を通じてまだそのパラメータを名指ししている場合、それはスタックがもはや宣言していないものを名指しすることになり、スタックのデプロイ時に CloudFormation がこれを拒否するため、アセンブリは停止します。スタックのいずれかのコンポーネントが独自のパラメータとして、またはリソースの論理 ID としてまだ宣言している名前は、スタックが解決できる参照であり、停止されません。

出力されるメッセージ。条件が先頭に来て、続いてすべての参照について、それが含まれるコンポーネントとテンプレート、パラメータ、そしてその Recipe またはアタッチされた FeatureRecipe の valuesMapping がそれを埋めたコンポーネントが示されます。コンポーネントにアタッチされた Feature はそのコンポーネント名で示され、境界にアタッチされた Feature は、そのリソースが aggrega.ai/component-id として持つ識別子(境界のパスとアタッチメント名から構成され、たとえば bfr--stack--aux)で示されます。

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを 1 つの値に解決できませんでした) cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping(ソース由来のテンプレートのバインディングが埋めたパラメータが、アセンブルされたスタックの別の箇所からまだ参照されています。パラメータをバインドするとそれを宣言するソースから宣言が削除され、スタック内のどのテンプレートもそれを宣言しなくなるため、この参照は CloudFormation が解決できるものを何も指しません。代わりにバインドしているコンポーネントが公開するものを参照するか、参照しているテンプレートでパラメータを宣言するか、valuesMapping からキーを削除してください)

修正方法: 参照しているコンポーネントがその値を必要とする場合は、値を埋めているコンポーネントに provides を通じて公開させ、それを参照します。または、参照しているテンプレートでパラメータを宣言して独自の値を受け取るようにします。あるいは valuesMapping からキーを削除します。そうするとパラメータは宣言されたまま残り、すべてのコンポーネントがスタックのデプロイ時に渡される値を読み取ります。cloudformation → ソース取得したテンプレートのパラメータの値を参照してください。

A value bound to a CloudFormation parameter cannot take the parameter’s type(CloudFormation パラメータにバインドされた値がパラメータの型を取れない)

パラメータにバインドされたリテラルは、スタックのデプロイ時にそのパラメータの Type に対して同じ値が渡された場合に CloudFormation が行うのと同じ方法で変換されます。そのような変換が存在しない場合、レンダリングは停止します。たとえば、Number または List<Number> にバインドされた数値でない値、1 つの値を取るパラメータにバインドされたリストやマッピング、そして AWS::SSM::Parameter::Value<…> パラメータにバインドされたあらゆるリテラル(その値は CloudFormation がテンプレートからではなく Parameter Store から読み取ります)です。テンプレートが Fn::Sub の変数として名指ししているパラメータにリストをバインドした場合も、変数は 1 つの文字列を置換するため、レンダリングは停止します。

出力されるメッセージ。条件が先頭に来て、続いてパラメータ、そのテンプレートと型、そして値が合わない理由が示されます。値そのものは引用されません。

a plugin has no representation for a value it was given(プラグインが、渡された値の表現を持っていません) cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit>(テンプレートのパラメータの型に対して、値が適合しません)

修正方法: パラメータの型の値をバインドします。Parameter Store の型の場合は、{{resolve:ssm:…}} 動的参照または組み込み関数をバインドします。あるいは、パラメータをバインドせずに残し、スタックのデプロイ時に値を渡します。

A value bound to a CloudFormation parameter is one its constraints refuse(CloudFormation パラメータにバインドされた値がその制約で拒否される)

パラメータにバインドされたリテラルは、テンプレートがそのパラメータに宣言する制約(AllowedValues、AllowedPattern、MinLength、MaxLength、MinValue、MaxValue)に照らしてチェックされます。これは CloudFormation がスタックのデプロイ時に渡された値に対して行うチェックをビルド時に移したもので、パラメータを埋めてもテンプレートが宣言したチェックが失われないようにするためです。組み込み関数と動的参照は、スタックがデプロイされるまで値が存在しないため、CloudFormation のチェックに委ねられます。

出力されるメッセージ。条件が先頭に来て、続いてパラメータ、そのテンプレートと制約が示されます。値そのものは引用されません。

a plugin has no representation for a value it was given(プラグインが、渡された値の表現を持っていません) cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits(テンプレートのパラメータにバインドされた値がその制約を満たしておらず、スタックのデプロイ時に CloudFormation が拒否します。パラメータが許容する値をバインドしてください)

修正方法: 制約が許容する値をバインドします。許容される値は、テンプレート自身のパラメータ宣言に記載されています。

A secret bound to a CloudFormation parameter would be written into the template(CloudFormation パラメータにバインドされたシークレットがテンプレートに書き込まれてしまう)

パラメータにバインドされた値はテンプレートに書き込まれ、スタックのテンプレートを読める人は誰でもそれを読めます。テンプレートが NoEcho と宣言しているパラメータにリテラルがバインドされた場合、レンダリングは停止します。また、Recipe または FeatureRecipe の valuesMapping が作成者が機密と宣言した値を読み取る場合、その出力のどれも元の値まで遡れないため、そのマッピングがバインドするすべてのリテラルでレンダリングは停止します。動的参照と組み込み関数は指定どおりに書き込まれます(組み込み関数内のテキストも含む)。そのため、マッピングが Fn::Sub 文字列に埋め込んだ機密値はそのテキストとしてテンプレートに到達し、シークレットそのものをテンプレートから除外できるのは動的参照だけです。

出力されるメッセージ。条件が先頭に来て、続いてパラメータと、代わりにバインドすべきものが示されます。値そのものは引用されません。次のいずれかです。

a plugin has no representation for a value it was given(プラグインが、渡された値の表現を持っていません) cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value(テンプレートのパラメータは NoEcho と宣言されており、バインドされた値がそのままテンプレートに書き込まれます。代わりに動的参照または組み込み関数をバインドするか、デプロイ時の値のためにパラメータをバインドしないままにしてください)

cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping reads a value declared sensitive, so a literal it produces is refused, and binding parameter(s) "<parameter>", … would write a literal into the template as it stands; …(Recipe または FeatureRecipe の valuesMapping が機密と宣言された値を読み取るため、それが生成するリテラルは拒否されます。パラメータをバインドすると、リテラルがそのままテンプレートに書き込まれます)

修正方法: シークレットを Secrets Manager に、または Parameter Store のセキュア文字列として保存し、組み込み関数のテキストに埋め込むのではなく、それへの動的参照({{resolve:secretsmanager:<secret>}} または {{resolve:ssm-secure:<name>}})をバインドします。あるいは、パラメータをバインドせずに残し、スタックのデプロイ時に値を渡します。cloudformation → ソース取得したテンプレートのパラメータの値を参照してください。

A dynamic reference is bound where CloudFormation does not resolve it(CloudFormation が解決しない場所に動的参照がバインドされている)

CloudFormation はリソースのプロパティ内の動的参照を解決しますが、EC2 のユーザーデータや AWS::CloudFormation::Init メタデータ内では解決せず、またテンプレートの Outputs はスタックを読む誰にでも表示されます。そのため、ソースのいずれかのテンプレートが UserData プロパティ、そのメタデータ、または Outputs で参照するパラメータに動的参照がバインドされていると、デプロイできない場所や露出する場所に到達する前にレンダリングが停止します。

出力されるメッセージ。条件が先頭に来て、その後にパラメータ、テンプレート、そしてそのテンプレートがパラメータを参照している場所が続きます。値は引用されません。

a plugin has no representation for a value it was given cloudformation-provider: the value bound to parameter "<parameter>" is a dynamic reference, and template "<template>" references the parameter in <where>, where CloudFormation does not resolve a dynamic reference or shows it to whoever reads the stack; bind an intrinsic function instead, or leave the parameter unbound for a deploy-time value

修正方法: パラメータをバインドせずにおき、スタックのデプロイ時に値を渡すか、テンプレートがその場所で必要とするものを返す組み込み関数をバインドします。

A rule reads a bound CloudFormation parameter by name(ルールがバインドされた CloudFormation パラメータを名前で読み取っている)

テンプレートの Rules 内の Fn::ValueOf は、Ref を介さずに論理 ID でパラメータを指定し、スタックのデプロイ時にそのパラメータに渡された値を読み取ります。パラメータをバインドするとソースのすべてのテンプレートからその宣言が削除され、それらのいずれのテンプレートにあるルールも何も指さなくなるため、レンダリングが停止します。

出力されるメッセージ。条件が先頭に来て、その後にルール、そのテンプレート、パラメータが続きます。

a plugin has no expression for a construct this build declares cloudformation-provider: rule "<rule>" of template "<template>" reads parameter "<parameter>" through Fn::ValueOf, which names a declared parameter by its logical ID, and binding the parameter removes its declaration from the source; leave the parameter unbound so the rule can read it at deploy

修正方法: valuesMapping からそのパラメータのキーを削除します。これによりパラメータは宣言されたまま残り、ルールはスタックのデプロイ時に渡された値を読み取ります。

The assembled CloudFormation stack cannot carry a transform(組み立てられた CloudFormation スタックがトランスフォームを保持できない)

組み立てられたスタックの Transform はすべてのコンポーネントのものから構築され、トランスフォームはテンプレート全体を処理します。そのため、効果がそのトランスフォーム向けに書かれたコンテンツに限定されないトランスフォームは、別のコンポーネントのコンテンツのデプロイ方法を変えることを許さず拒否されます。AWS::CodeDeployBlueGreen と AWS::Include は常に、アカウントで定義したマクロと AWS::ServiceCatalog は他のコンポーネントと並ぶ場合、AWS::LanguageExtensions は他のコンポーネントのサーバーレスコンテンツと並ぶ場合、AWS::Serverless-2016-10-31 はその Globals が他のコンポーネントのサーバーレスリソースに及ぶ場合、またはそのイベントソースのいずれかが他のコンポーネントの宣言するリソースを指す場合に拒否されます。完全な表は cloudformation → 組み立てられたスタックのトップレベルセクションにあります。

出力されるメッセージ。条件が先頭に来て、その後にスタック内のすべてのコンポーネント、トランスフォームとそれを宣言するコンポーネント、そして保持できない理由が続きます。

a plugin has no expression for a construct this build declares cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why>

修正方法: トランスフォームを宣言するコンポーネントを専用のバウンダリに配置し、そのスタックにトランスフォームが変更しうるものを含めないようにします。あるいは、メッセージが他のコンポーネントの宣言するコンテンツを挙げている場合は、そのコンテンツをトランスフォームを宣言するコンポーネントに移します。

Two components order one pair of transforms oppositely(2 つのコンポーネントが 1 組のトランスフォームを逆の順序で並べている)

組み立てられたスタックは、各コンポーネント自身の順序と CloudFormation が文書化している順序から構築した 1 つの順序でトランスフォームを実行します。2 つの順序が両立しない場合、つまり 2 つのコンポーネントが 1 組のトランスフォームを逆の順で列挙している場合や、CloudFormation が逆順と文書化しているのにコンポーネントが AWS::Serverless-2016-10-31 を AWS::LanguageExtensions より前に列挙している場合は、書き出す順序が 1 つに定まらないため、レンダリングが停止します。

出力されるメッセージ。条件が先頭に来て、その後にその組と、それぞれの順序を指定したものが続きます。

a plugin could not resolve something it requires to exactly one value cloudformation-provider: the transforms "<first>" and "<second>" are ordered both ways — "<first>" before "<second>" by <who>, and "<second>" before "<first>" by <who> — and the assembled stack’s Transform runs them in one order; declare them in one order

修正方法: 両方を列挙しているすべてのコンポーネントで、その組を 1 つの順序で宣言します。CloudFormation が順序を文書化している場合はその順序に従います。

Two entries reach one stack output name(2 つのエントリが 1 つのスタック出力名に行き着く)

スタックの出力名には英字と数字しか使えないため、出力名は記述された内容から、その文字集合が許さない文字を削除するのではなくエンコードすることで構築されます。したがって別々に記述した 2 つのエントリは別々のままであり、この停止はそれでも 2 つが 1 つの名前に行き着いた場合を報告するものです。2 つのエントリが記述されたところに 1 つの出力を生成すると、そのうち 1 つが黙って失われるため、レンダリングが停止します。

2 つ以上のエントリが衝突したすべての名前が報告され、各名前の背後にあるすべてのエントリが安定した順序で示されます。そのため、1 回のビルドで衝突の片側だけでなく全体を確認できます。

出力されるメッセージ。条件で始まり、プロバイダー自身の詳細が続きます。

two things a plugin produced occupy one name in its output cloudformation-provider: two entries an author wrote reach one stack Output name: <the entries that met> reach the Output name "<name>"; an Output name is built by encoding the component and the entry into the letters and digits a logical id admits, rather than by dropping what it does not, so two entries an author wrote apart stay apart — renaming either end clears the build

修正方法: エントリのいずれか、またはコンポーネントのいずれかの名前を変更し、2 つが同じ名前に行き着かないようにします。メッセージは両方を示しています。名前には記述した句読点や大文字小文字が削除されずにエンコードされて含まれるため、そのどちらの違いも名前に残り、異なって記述された 2 つのエントリは別の名前になります。

A CloudFormation fragment writes one key twice(CloudFormation フラグメントが 1 つのキーを 2 回書いている)

マッピングはキーごとに 1 つの値しか保持しないため、同じキーを 2 回書いたフラグメントは最後に来た本体を残し、もう一方を破棄することになります。そのマッピングがリソースや出力を保持するブロックである場合、破棄される本体は書かれたのに結果に含まれないリソースや出力になります。そのため、代わりにレンダリングが停止します。

キーが書かれた 2 か所の両方が報告されます。2 回書かれたキーは、通常は 2 つの異なるキーにするつもりだった 2 つの編集であり、どちらを変更すべきか判断するには作成者が両方を必要とするためです。

出力されるメッセージ。条件で始まり、プロバイダー自身の詳細が続きます。

two things a plugin produced occupy one name in its output cloudformation-provider: one mapping key is written more than once: the key "<key>" is written at line <first> and again at line <second>; a mapping holds one value per key, so one of the two bodies would be dropped — remove one, or rename one so each key is written once

修正方法: メッセージが示す 2 行でフラグメントを開きます。2 つの本体が 1 つのものを意図していた場合は、不要になった方を削除します。2 つのものを意図していた場合は、それぞれが固有のキーを持つように一方の名前を変更します。フラグメントはテンプレートであるため、キーがリテラルとして書かれずに組み立てられている場合は、ソースだけでなくレンダリングされたテキストを確認します。

A cross-boundary reference has no consuming stack to be written into(境界をまたぐ参照を書き込む消費側のスタックがない)

依存関係の接続が、別々にアセンブルされる 2 つの出力の間をまたぐ場合、消費側はプレースホルダー付きでレンダリングされ、参照は両側が揃った時点で書き込まれます。この条件は、消費側のアセンブル済み出力がスタックテンプレートをまったく持たない場合に発生します。参照を書き込むドキュメントが存在しないため、プレースホルダーを置き換えることができません。

出力されるメッセージ。条件が失敗の種類を示し、プロバイダー自身の文がどの入力かを示します:

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを厳密に 1 つの値に解決できなかった) cloudformation-provider: cross-boundary link resolve received no consumer stack template(境界をまたぐリンクの解決で消費側のスタックテンプレートを受け取らなかった)

修正方法: 消費側のコンポーネント内に記述した内容が原因ではありません。これはその境界がアセンブルしたものの形によるものです。まず、消費側が CloudFormation プロバイダーによってレンダリングされているかを確認してください。別のものをアセンブルする境界へとまたぐ接続には、参照を配置するスタックがありません。接続は、同じプロバイダーがアセンブルする 2 つの境界の間に置くべきものです。両側が CloudFormation であるべき場合は、消費側の境界がスタックテンプレートを生成していないため、その境界に寄与する Recipes を作成した人に確認してください。

A cross-boundary reference was spliced into a longer string(境界をまたぐ参照がより長い文字列に埋め込まれた)

CloudFormation のクロス参照はテキストではなくオブジェクトであるため、値全体を置き換えることしかできません。この条件は、より大きな文字列の中でプレースホルダーが見つかった場合に報告されます。つまり、注入される値全体として渡されるのではなく、その周囲に値が組み立てられている場合です。オブジェクトと置き換える対象がないため、ターゲットが読み取れない形で参照を出力する代わりにレンダリングを停止します。

出力されるメッセージ。条件が先頭にあり、続いて値と、その値が届いた接続が示されます:

a plugin has no representation for a value it was given(プラグインには、渡された値を表す手段がありません) cloudformation-provider: cross-boundary link value is interpolated into a larger string; only a whole-scalar injection can carry a cross-stack reference: output key "<key>" on socket "<socket>"(cloudformation-provider: 境界をまたぐリンクの値が、より長い文字列の中に埋め込まれています。スタック間参照を運べるのは、スカラー値全体の注入だけです。ソケット上の出力キーは上記のとおりです)

修正方法: 値の周囲で組み立てるのではなく、値全体を渡してください。消費側がより長い文字列(接続文字列や URL など)の中で値を必要とする場合は、参照が存在する前に Recipe のテンプレートで組み立てるのではなく、参照からターゲット自身の語彙でその組み立てを行ってください。埋め込みが発生するのは値を注入するマッピングなので、変更すべきはその行です。

Two rendered resources land at one output file(レンダリングされた 2 つのリソースが 1 つの出力ファイルに行き着く)

レンダリングされた各リソースは、そのリソースが何であるか、何という名前であるかから決まる名前のファイルに書き込まれます。これらを共有する 2 つのリソースは同じファイル名を持つため、一方が他方の位置を占めてしまいます。2 つのリソースがレンダリングされたのに 1 つのファイルを出力する代わりに、レンダリングを停止します。

同一にレンダリングされる 2 つのリソースは衝突ではありません。 内容がバイト単位で一致する場合、一方を残しても失われるものはなく、レンダリングは続行されます。そのため、同じ結果で 2 回インクルードされたテンプレートは報告されません。

出力されるメッセージ。条件が先頭にあり、続いてそれらを生成した両方のテンプレートと、行き着いたファイルが示されます:

two things a plugin produced occupy one name in its output(プラグインが生成した 2 つのものが、出力内の 1 つの名前を占めています) helm: node "<node>": rendered resources "<one template>" and "<the other>" both derive output "<file>" with differing content: two rendered resources derive the same output filename with differing content(helm: 上記のノードで、レンダリングされた 2 つのリソースが、内容が異なるまま同じ出力ファイルを導出しています。レンダリングされた 2 つのリソースが、異なる内容で同じ出力ファイル名を導出しています)

修正方法: 2 つのリソースに異なる識別を与えてください。通常異なるのは名前であり、ファイル名はそこから決まります。メッセージは両方のテンプレートを示すので、それらを開いてそれぞれが何を生成しているかを確認してください。2 つのテンプレートが同じ名前で同じリソースをレンダリングしている場合、一方が古いコピーであることがよくあります。両方が必要な場合、それらは 2 つのリソースであり、それぞれに固有の名前が必要です。

A synthesized StatefulSet has no single service to govern it(合成された StatefulSet を管理する単一のサービスがない)

インスタンスごとのストレージを宣言するワークロードは StatefulSet としてレンダリングされ、StatefulSet はそれを管理する 1 つのサービス、つまり各インスタンスに安定したアドレスを与えるサービスを指定します。そのサービスは、独自のクラスタアドレスを持たずに宣言されたものです。レンダリングを停止する形は 2 つあります。1 つも宣言されておらず指定するものがない場合と、複数宣言されておりどれが管理するのか答えがない場合です。どちらもターゲットが拒否する StatefulSet を生成することになるため、出力する代わりにレンダリングを停止します。

出力されるメッセージ。 どちらも同じ条件、つまりプロバイダーが必要とするものを厳密に 1 つの値に解決できなかったことを報告し、プロバイダー自身の文が 2 つの形のどちらに該当したかを示します。いずれもノードを示すフレームの下に出力されます:

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを厳密に 1 つの値に解決できなかった) synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service(合成された StatefulSet にはヘッドレスの管理 Service が必要(type: Headless のサービスを宣言すること)。見つからない:合成された StatefulSet にヘッドレスの管理 Service がない)

a plugin could not resolve something it requires to exactly one value(プラグインが必要とするものを厳密に 1 つの値に解決できなかった) synthesized StatefulSet declares more than one headless Service; the governing Service is ambiguous (declare exactly one type: Headless service): synthesized StatefulSet has more than one headless Service(合成された StatefulSet が複数のヘッドレス Service を宣言している。管理 Service が曖昧(type: Headless のサービスを厳密に 1 つ宣言すること):合成された StatefulSet に複数のヘッドレス Service がある)

修正方法: ワークロードにヘッドレス型のサービスを厳密に 1 つ宣言してください。1 つも宣言されていない場合は追加してください。インスタンスごとのストレージを持つワークロードにはこれが必要で、各インスタンスに固定のアドレスを与えるのはこのサービスです。複数宣言されている場合は、管理すべきものを残し、他は通常の型にするか削除してください。2 つ目のヘッドレスサービスは、通常ヘッドレスである必要がなかったものです。

A plugin reported a failure it did not classify(プラグインが分類しなかった失敗を報告した)

ビルドを停止するプラグインは 2 つのことを報告します。何が起きたかを述べる独自の文と、その文がどの種類の失敗を示すかです。種類はコンパイラが宣言する小さな集合(表現を持たない構造、1 つの値に解決できなかった入力、1 つの名前を求める 2 つの生成物、表現を持たない値)であり、この条件は、失敗がそのどれにも当てはまらない場合にプラグインが選ぶものです。

これは行き先ではなくフォールバックです。他の種類のいずれかが当てはまるのにこれを使うプラグインは、知っている以上に少ない情報しか伝えていません。文言は、単に何かがうまくいかなかったのではなく、プラグインが分類を辞退したことをはっきり述べます。そのため、過度に使われたフォールバックは正しい報告と区別できない形ではなく、判別できる形になります。

出力されるメッセージ。条件が先頭にあり、プラグイン自身の文が続きます:

a plugin reported a failure that none of the declared kinds names(プラグインが、宣言されたどの種類にも該当しない失敗を報告した) <the plugin's own sentence>

修正方法: プラグイン自身の文を読んでください。ビルド固有の情報はすべてそこにあります。条件自体が伝えるのは、プラグインがそれに該当する種類を持たなかったことだけです。プラグインが自作のものであれば、失敗の実際の種類を選んでください。そうでなければ、その文を公開元に伝えてください。

A plugin named a condition the socket does not declare(プラグインがソケットの宣言していない条件を指定した)

プラグインは独自の番号を作り出すのではなく、このコンパイラが宣言する条件を報告します。そのため、届く識別子は常に aggrega explain が応答できるものです。この停止は、それ以外のものを指定した報告によって発生します。何も登録されていない番号、廃止された番号、解決先の登録とは異なる綴りの短いコード、または 2 つの異なる条件を指す識別子の組です。

報告を黙って取り下げるのではなく、停止します。 識別子を破棄して汎用のプラグイン失敗条件をそのまま残すと、条件をまったく指定しなかったプラグインによるビルドとまったく同じに見えるため、修正する担当者は修正すべき点があったことを知ることができません。代わりに提示された番号を報告すると、何にも解決されない識別子を渡すことになります。

ビルドは停止の原因を引き続き受け取ります。 この停止は問題の番号を引用し、それがどの条件にも解決されない理由を述べ、より適切な識別がない場合にプラグインが用いる汎用の条件を挙げ、プラグイン自身の文をそのまま伝えます。

出力されるメッセージ:

wasm: guest plugin named a condition the socket does not declare: the guest named "<offered>", and <why it resolves to no condition>; a plugin names a condition this compiler declares, and reaches for one of <the generic conditions and their codes> when it has none better: <the plugin's own sentence>

修正方法: エンティティファイルの記述が原因ではありません。誤っているのはプラグインの報告であり、報告しようとしていた失敗は実際に起きています。メッセージの最後の部分であるプラグイン自身の文に基づいて対処してください。プラグインが自分のものであれば、このコンパイラが宣言する条件を報告してください。失敗がより具体的な条件のどれにも当てはまらない場合は、メッセージが挙げる汎用の種類のいずれかを使います。自分のものでなければ、問題の番号を公開者に伝えてください。

A source artifact is cached without a workspace root to anchor it(ソースアーティファクトが、基点となるワークスペースルートなしでキャッシュされようとしている)

取得したソースアーティファクトはワークスペースのアーティファクトキャッシュ配下のスロットに格納され、そのスロットへのパスはワークスペースルートを起点に組み立てられます。この条件は、ルートが空で渡されたことを報告します。その場合スロットのパスは相対パスになり、バイトの書き込み時にプロセスがたまたまいるディレクトリを基準に解決され、誰も選んでいない場所にキャッシュが置かれます。

これは解決されずに拒否されます。誤った場所に書き込まれたスロットは、スロットがないよりも悪いからです。後の読み取りは正しいスロットを探し、何も見つけられずに再取得します。その結果、何も保持していないように見えるキャッシュが残り、原因を示すものは他に何もありません。

出力されるメッセージ。条件自身の文で始まり、アーティファクトを識別する情報が続きます:

cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>)

修正方法: エンティティファイルの記述が原因ではなく、記述を変更しても解消されません。ワークスペースルートは、カタログに書かれるものではなく、ビルドを駆動しているものから渡されます。ワークスペース内からビルドを実行し、ルートが空で渡されるのではなく検出されるようにしてください。独自のソフトウェアからコンパイラを駆動する場合は、ワークスペースルートを明示的に渡してください。現在のディレクトリを基準とするキャッシュを本当に望む呼び出し元は、単一のドットを渡します。これは受け入れられ、その意図を明示します。

A value would place a cached file outside the cache(値によって、キャッシュされるファイルがキャッシュの外に置かれる)

キャッシュされたエンティティとキャッシュされたソースアーティファクトは、それぞれキャッシュが名付けるスロットに置かれ、そのスロットは値から組み立てられます。エンティティの参照と解決されたバージョン、またはソースの種類、url、chart、module_subdir、バージョン、ダイジェストです。各値はレイアウト内の 1 つの位置を指します。この条件は、その値のために書き込まれるものを、値が指す位置以外の場所(別のスロットの隣、またはキャッシュの外)へ移してしまう値を報告し、そこで何かが書き込まれたり読み取られたりする前に拒否します。

これらの値の多くは、キャッシュが制御しない場所から届きます。レジストリが提供した本文、ディスクから読み戻したレコード、Recipe や FeatureRecipe の作成者が書いた座標などです。バージョンではなくパスになっているバージョン、自身の位置より上へ遡る url のパスや module_subdir、ドットディレクトリに解決される参照は、いずれもここで拒否されます。1 つのディレクトリを指す値、および自身の位置かその下にとどまる url のパスや module_subdir は、そのまま扱われます。

遡る module_subdir は、何かが取得される前に拒否されます。 git-repository ソースでは、同じ値がプルでアーカイブするリポジトリのディレクトリも指し、リポジトリより上へ遡る値はプルにチェックアウトの隣のファイルを読ませてしまいます。そのためプルはリポジトリを取得する前に module_subdir を判定し、遡る値をこの条件で拒否して、そのキーとともに引用します。何も取得されず、チェックアウトの隣にあるものも読み取られません。値の中のバックスラッシュは、Windows のパスと同様に区切り文字として読まれます。そのため ..\shared は、あるマシンでチェックアウトの隣から読まれるのではなく、どのマシンでも拒否されます。値の先頭や末尾の区切り文字は取り除かれるため、/charts/app は charts/app を指します。

出力されるメッセージ。条件自身の文で始まり、書かれたとおりの値とそのキー、そして対処方法が続きます:

a value a cache location is built from would place cached files outside the place it names in the cache (version "../../../etc" for entity "demo/app/web"). a version, a name, a kind or a host names one directory of the cache, so it carries no / or \ and is neither . nor ..; a URL path or a module subdirectory may name directories beneath its place but may not climb above it. Correct the value where it was written, or, where a registry served it, ask its publisher to publish a version that carries a well-formed one

修正方法: 値が自分で書いたもの(Recipe や FeatureRecipe の source.version、url、module_subdir)であれば、1 つのディレクトリ、または自身の位置の内側にとどまるパスを指すように修正してください。メッセージには値と読み取り元のキーが引用されます。レジストリが提供した値であれば、公開されたエンティティが正しくないバージョンや座標を持っており、自分の変更では修正できません。メッセージは取得されたものを示しており、対処は公開者に委ねられます。

いくつかの操作は、指定された場所ではなく自ら決定した場所に、独自のファイルを書き込んだり削除したりします。ビルドの出力ディレクトリとそこに書き込まれるすべてのファイル、およびトレース付きビルドが置き換える .trace ディレクトリ。pull が書き込む Release のロックファイルと、その隣のプラグイン信頼レコード。aggrega pin が書き込み、ソースをピン留めする pull がピン留めする各エンティティの隣に書き込む、エンティティの隣の entity.lock。コマンドがワークスペースの設定を書き込む際のワークスペースの .aggrega-config.yaml。pull が埋め、aggrega cache clear と aggrega cache prune が空にするアーティファクトキャッシュとその各サブツリー。署名を検証した各アーティファクトについて pull がそのキャッシュに保持する署名バンドル。aggrega import が書き込むドラフト。aggrega plugin gen-catalog が出力ディレクトリ配下に書き込む Plugin エンティティ。そして、デフォルトの Release が記録されたときにエディタの言語サーバーが書き込む .aggrega/active-release マーカーと、それを保持する .aggrega ディレクトリです。操作をどのサーフェスが開始したか(コマンドライン、エディタの言語サーバー、アシスタントのツール)にかかわらず同じです。ワークスペース境界に、ここで適用されるルールと、意図的にワークスペースの外に到達するパスが記載されています。

これらの各場所には留まるべきディレクトリがあり、それがどれになるかは、操作がその場所を組み立てる基点のディレクトリによって決まります。

  • ワークスペース:ワークスペース内で組み立てられるすべてのものが対象です。これが通常のケースで、指定したディレクトリがワークスペース内にある場合にも当てはまります。ビルドの dist と .trace は、ビルドをどのフォルダから実行しても、常にここ(ワークスペースルートの配下)に組み立てられます。出力ディレクトリを指定しないインポートのドラフトも同様です。
  • 指定したディレクトリのうちワークスペースの外にあるもの:その配下で組み立てられるすべてのものが対象です。aggrega plugin gen-catalog または aggrega import に渡す出力ディレクトリ。指定した Release のディレクトリ、またはワークスペース設定が指定する Release のディレクトリのうちワークスペース外にあるもの(その隣のロックファイルと信頼レコードが対象)。そして、aggrega pin に指定したエンティティのディレクトリ、または --catalog で指定したか設定の catalog_dirs に列挙されたカタログディレクトリ(そこにある各エンティティの隣の entity.lock が対象)です。ディレクトリ自体は指定したとおりに使用され(リンクであれば、そのリンク先へ書き込まれます)、その配下に書き込まれるものはその中に留まります。
  • アーティファクトキャッシュディレクトリ自体:その配下のキャッシュに書き込まれるすべてのものと、aggrega cache clear と aggrega cache prune がそこで削除するすべてのものが対象です。デフォルトの .aggrega/cache も、設定がワークスペースルートの外へ出る形で記述した artifact_cache_dir(../shared-cache)も同様です。キャッシュ自身のディレクトリやその中のファイルのうち、キャッシュディレクトリの外へ出るリンクであるものは、たとえリンク先がワークスペース内の別の場所であっても拒否されます。そのため、キャッシュに書き込まれるものや、clear や prune が削除するものが、キャッシュ外のファイルに及ぶことはありません。キャッシュディレクトリ自体の位置が最初に判定されます。ワークスペースルート内に記述されたものは、ワークスペース内であればリンク先をたどり、ワークスペースの外へ出る場合はワークスペースに限定されて拒否されます。ワークスペースルートの外へ出る形で記述されたものは指定したとおりに使用され、リンクであればリンク先へ書き込まれます。

これらの各場所は、そこで何かが書き込まれたり削除されたりする前にチェックされます。パスのうち存在する最も深い部分は、途中のすべてのシンボリックリンクをたどった上で、留まるべきディレクトリそのものか、その配下でなければなりません。途中のどこかにそのディレクトリの外へ出るリンクがあると(別の場所のディレクトリにリンクされた dist、別プロジェクトのファイルにリンクされたロックファイル、他の作業と共有するディレクトリにリンクされた .aggrega/cache、gen-catalog 出力ディレクトリ配下で別の場所にリンクされたディレクトリなど)、書き込みや削除が外部に及んでしまうため、代わりに操作が停止し、そのパスはそのままの状態で残されます。これが最も重要になるのはビルドです。リンクである出力ディレクトリをクリアして書き直すと、本来であればマシン上の別の場所にあるディレクトリが削除され、書き直されてしまいます。

どこにもつながらないリンクは、実態どおり存在しないものとして扱われるため、そのリンクを含むディレクトリがチェックされます。操作がこれから作成しようとするパスの末尾にそのようなリンクがある場合、ファイルはリンク先に作成されることになるため、リンク先もあわせてチェックされます。パスが留まるべきディレクトリの内側を指すリンクは、通常どおりたどられます。

出力されるメッセージ。条件自身の文で始まり、続いて操作が書き込みまたは削除しようとしていたパス(writing または removing でどちらかを示します)、留まるべきディレクトリ、途中で遭遇したリンクとそのリンク先、そして対処法が続きます。dist がワークスペースの外へ出るリンクであるビルドは、最初に触れるもの、つまり前回の出力のクリアの時点で停止します。

a path this operation writes or deletes leads through a link out of the directory it must stay inside (removing <workspace>/dist/boundaries, which must stay inside <workspace>, the link <workspace>/dist leads to <elsewhere>/dist-target). nothing was written to or removed from that path. Remove the link, or make it lead to a place inside <workspace>, and run the operation again(この操作が書き込みまたは削除するパスが、リンクを経由して、内部にとどまるべきディレクトリの外へ出ています(削除対象のパス、とどまるべきディレクトリ、リンクとその参照先は上記のとおりです)。そのパスには何も書き込まれず、何も削除されていません。リンクを削除するか、ワークスペース内の場所を指すようにしてから、操作を再実行してください)

この診断にはカテゴリがありません。問題があるのは、記述したドキュメントではなく、ディスク上のレイアウトだからです。

対処法: メッセージが示すリンクを削除して操作を再実行し、その場所に実際のディレクトリまたはファイルが作成されるようにします。あるいは、リンクがメッセージの示すディレクトリの内側を指すようにすると、そのリンクはたどられます。エンティティファイルの内容が原因ではなく、記述を変更しても解消しません。

A name the operation writes holds a part Windows cannot hold(操作が書き込む名前に、Windows が保持できない部分が含まれている)

Windows では、一部の名前は書かれたとおりのファイルに届きません。Windows がデバイス用に予約している名前(CON、PRN、AUX、NUL、CONIN$、CONOUT$、COM0 から COM9、LPT0 から LPT9、および上付きの 1、2、3 で綴られた COM と LPT の名前)は、大文字小文字を問わず、どの拡張子が続いても、ファイルではなくデバイスを指します。したがって nul、Aux.yaml、com1.txt はすべてデバイスです。また、ピリオドまたはスペースで終わるパスの部分は、Windows が書かれたとおりに保持せず切り詰める場合があります。このような名前を書き込むと、そのバイトは名前が指すファイル以外の場所に置かれてしまいます。

そのため、Windows マシン上で、操作が自身で選んだのではない名前をディレクトリの下に書き込もうとするとき、このような部分を含む名前は、何かが書き込まれる前に拒否されます。対象は、キャッシュが読み取り用にアーカイブを展開する際の、ソースアーティファクトまたはカタログエンティティが持つアーカイブのエントリ、ビルドが出力ディレクトリにレンダリングするファイル、インポーターが aggrega import に返すドラフト(書き込み時と同様にドライラン時も)、そして aggrega edit-document が書き戻すドキュメント(どのインターフェースが編集を要求したかを問わず)です。名前のすべての部分が、バックスラッシュを区切り文字として読む Windows と同じ方法で判定されます。そのため、aux/x.yaml はディレクトリ aux のために、report. は末尾のピリオドのために、.. \evil.yaml は最初の部分(2 つのドットとスペース)のために拒否されます。ある名前のために拒否されたセットは、他の名前も一切書き込みません。アーカイブは展開されず、ビルドの出力はクリアも書き込みもされず、ドラフトはディスクに届きません。

Linux と macOS では、同じ名前が名付けられたとおりに書き込まれ、この条件が発生することはありません。書き込み先のディレクトリの外へ出る名前は別の問題であり、この条件が問われる前に、すべてのプラットフォームでその操作固有のメッセージとともに拒否されます。

出力されるメッセージ。条件自体の文で始まり、続いて名前、Windows が保持できない部分、名前の書き込み先となるはずだったディレクトリ、そして対処方法が示されます:

a name this operation writes holds a path segment Windows cannot hold as written (the name "aux/x.yaml", its segment "aux", beneath <directory>). It was not written. Windows reserves device names such as CON, PRN, AUX, NUL, COM1 and LPT1, in any letter case and whatever extension follows, and does not hold a segment ending in a full stop or a space as written; rename that segment where the name is produced(この操作が書き込む名前に、Windows がそのままでは保持できないパスセグメントが含まれています。名前は書き込まれませんでした。Windows は CON、PRN、AUX、NUL、COM1、LPT1 などのデバイス名を、大文字小文字や後続する拡張子にかかわらず予約しており、ピリオドまたはスペースで終わるセグメントを書かれたとおりには保持しません。名前が生成される場所でそのセグメントの名前を変更してください)

この診断にはカテゴリがありません。名前は、コンパイラが問題を帰属させる 1 つのドキュメントからではなく、それを生成したもの(アーカイブの公開者、Recipe やライブラリ、インポーター、編集が指定するパス)から来るためです。

対処方法: 名前の出どころで、メッセージが示す部分の名前を変更してください。アーカイブのエントリの場合、それは公開されたソースアーティファクトまたはエンティティであり、変更できるのはその公開者だけです。レンダリングされたファイルの場合は、Recipe または ArtifactLibrary が与える出力名です。ドラフトの場合はそれを名付けたインポーター、編集の場合はドキュメントのパスです。Windows マシン側の設定によって、その名前を書かれたとおりに使えるようになることはありません。

ビルドを停止しない条件

上記の条件はいずれもビルドを停止します。一部の条件は、ビルドを停止することなく独自の短いコードとメッセージを持ちます。どのページから来た場合でも手元のコードが必ず何かに解決されるよう、それらをここに掲載しています。

これらは 4 種類に分かれます。修正方法を探す前に、その違いを知っておく価値があります。

  • 勧告。 ビルドはこれを報告して処理を続行し、対処するかどうかにかかわらずレンダリング結果は同じです。それぞれは warnings.md で詳しく説明されています(何が発生させるか、コンパイルのどこで読み取られるか、何が出力されるか、どう対処すべきか)。以下の各項目では、ここで繰り返す代わりにどのセクションかを示します。
  • エディタが吸収する条件。 エディタ統合自体が応答し、ビルドの出力にも診断にも到達しません。
  • 先行する拒否の背後にあるセーフガード。 これが保護する規則は、それより前に停止する条件によって適用されるため、ビルドは先にそちらに遭遇します。
  • ビルド以外のコマンドでの拒否。 実際の対処法を伴う強制停止であり、遭遇したコマンドを終了させ、何も公開・書き込み・変更されません。しかしコンパイルのどの段階もこれに到達しないため、ビルドが報告することはありません。これらに遭遇するのは、アーティファクトの公開または署名、エンティティの入力のピン留め、レジストリの追加、ドキュメントの編集、外部のソース記述からドラフトの作成用ファイルへの変換、カタログ全体の検査(正しさの検査、または公開の慣例に照らした検査)の場面です。各項目では、どのコマンドに属するか、誰が修正を担うかを示します。

アノテーションバインディングが 1 つのパスを両方のピラーリストで宣言している

勧告です。Manifest のアノテーションバインディングが、同じドット区切りのパスを maps.infra リストと maps.values リストの両方で指定しています。この重複の宣言は合法であり、コンパイラはこれを取り締まりません。ルーティングのタイブレークは決定的にそのパスを infra 経由で送るため、そのパスの values 側は Aggregate から到達できなくなります。

メッセージは次のように始まります:

annotation binding declares one path in both pillar lists(アノテーションバインディングが 1 つのパスを両方のピラーリストで宣言しています)

これは、上記の「An annotation routes through a pillar its authoring side may not use(アノテーションが、作成側が使用できないピラーを経由してルーティングされている)」で説明する停止にビルドが遭遇する前に警告するものです。勧告は早期の表面であり、その停止が強制の表面です。この lint は warnings.md の「Binding-map-overlap lint」で説明されています。

アタッチメント名が宣言済みスロットから 1 編集の距離にある

勧告です。component が、その型の宣言済みスロットのいずれでもないものの、そのいずれかから 1 編集以内にある名前で Feature をアタッチしています。これはスロット名のタイプミスがとる形です。どのスロットも宣言していない名前でのアタッチメントは合法なので、何も停止しません。勧告が示すのはその結果、すなわちアタッチメントが意図したスロットの充足ではなく自由なアタッチメントになり、スロットが空のままになることです。接続の場合、同じタイプミスは合法ではなく、近いスロットを示して停止します。「A connection carries an attachment under a name its socket declares no slot for(接続が、ソケットがスロットを宣言していない名前でアタッチメントを持っている)」を参照してください。アタッチメントの Feature が近いスロットの selector: を満たす場合、勧告は発生しません。その組み合わせは「An attachment written under another name fits a slot its component leaves empty(別の名前で書かれたアタッチメントが、component が空のままにしているスロットに適合する)」の停止で判定され、スロットが空のままの場合に報告されます。

メッセージは次のように始まります:

attachment name is a near miss for a declared slot(アタッチメント名が宣言済みスロットの惜しい不一致です)

warnings.md の「Attachment-slot near-miss lint」で、組み合わせの閾値と意図的に検出しないものとともに説明されています。

uses: のソケット名が宣言済みソケットから 1 編集の距離にある

勧告です。component 自身の uses: ブロックが、その型が宣言していないものの、宣言済みソケットのいずれかから 1 編集以内にあるソケットを指定しています。開発者は Aggregate が宣言するトポロジーを所有しており、カタログが想定していないソケットを指定できるため、この表面では型が宣言していないソケット名も合法であり、何も停止しません。勧告が示すのはその結果です。綴りを誤った名前はセレクタもエッジごとの契約も持たない独自のアドホックな接続を生み、意図したソケットは未接続のままになります。

メッセージは次のように始まります:

uses socket name is a near miss for a declared socket(uses のソケット名が宣言済みソケットの惜しい不一致です)

warnings.md の「Uses-socket near-miss lint」で説明しています。所有するエンティティの usesSchema にないソケット名で実際に停止する隣接した 2 つの箇所は、上記の「uses: socket not declared in the owning entity’s usesSchema(所有するエンティティで宣言されていないソケット)」で扱っています。

Recipe が、その Component が宣言していない provides キーを公開している

勧告です。component にバインドされた Recipe が、component の型が spec.schema.provides: 契約で宣言していないキーを provides: で公開しています。Component が宣言する以上のものを公開することは合法であり、今後も合法です。契約はサブセットが必須、スーパーセットが許可です。勧告が示すのは、どちらの側からも見えない結果です。uses: エッジを越えて読み取る利用側は、ターゲットの Recipe が出力するものではなく、ターゲットの宣言された契約を参照します。そのため未宣言のキーは届かず、それを読み取る利用側のテンプレートは空でレンダリングされます。

メッセージは次のように始まります:

Recipe publishes a provides key its Component does not declare(Recipe が、その Component が宣言していない provides キーを公開しています)

逆のケースは勧告ではありません。Recipe が公開しないキーを Component が宣言すると、契約が満たされず停止します。warnings.md の「Undeclared-provides-key lint」で説明されています。

宣言されたパラメータがどこからも読み取られない

勧告です。Aggregate が spec.parameters: にエントリを宣言していますが、その Aggregate 自身のテキスト内のどの {{ .parameters.<key> }} 参照もそれを読み取っていません。そのため Release が何を指定しても、レンダリング結果は同じです。コンパイラは作成者がどのノブを公開するかを取り締まらず、パラメータはそれを読み取る参照より先に宣言されることも正当にありうるため、これは停止ではなく勧告となります。

メッセージは次のように始まります:

declared parameter is read by no reference in the Aggregate(宣言されたパラメータが Aggregate 内のどの参照からも読み取られていません)

warnings.md の「Unread declared-parameter warnings」で、デフォルト値が免除にならない理由や、読み取りの判定で見える参照と見えない参照を含めて説明されています。

provider バインディングが、ビルドが読み込むどのプラグインも提供しない capability を指定している

勧告です。plugins.providers のエントリが capability を指定してプラグインを指定しておらず、ビルドが読み込む provider プラグイン(カタログディレクトリ内、コンパイラ内、またはロックファイルに記録されたもの)のいずれもその capability を提供していません。これは capability の綴り誤りがとる形であり、そのようなエントリはどこからも読み取られません。バインディングは Recipe がその capability を求めたときにのみ参照され、プラグインを指定しないバインディングは、それがなくても capability の解決で選ばれないものを何も選びません。

ビルドが確実に判断できないため、停止ではなく助言にとどめます。バインディングはワークスペース全体に対して一度だけ記述されますが、ビルドは 1 つの Release を対象とするため、その機能を提供するプラグインは別の Release だけが読み込むものである可能性があります。プラグインを指定するエントリは別の基準で判定され、確実に誤っている場合は停止します。上記の「A plugins.providers binding names a plugin that does not serve the capability(バインディングが、その機能を提供しないプラグインを指定している)」を参照してください。

メッセージは次のように始まります:

plugins.providers entry names a capability no provider-rendering plugin the build reads serves(plugins.providers のエントリが、ビルドが読み込むどの provider レンダリングプラグインも提供しない capability を指定しています)

続いて capability と、存在する場合は 1 編集の距離にある提供済みの capability を示します。warnings.md の「Provider-binding unserved-capability warning」で説明されています。

エディタの位置がドキュメントの範囲外にある

エディタが吸収する状態です。カーソル位置に依存するエディタ機能(定義へ移動、ホバー、補完)は、まずドキュメントの解析済み構造の中でカーソルの位置を特定します。この状態は、その位置がドキュメントに存在しない行を指しているときにそのステップが報告するものです。これは編集の途中で一時的に発生し、エディタが送信した位置が、ドキュメントがすでに先へ進んだテキストに対して測られていた場合に起こります。

メッセージは次のとおりです:

position out of range(位置が範囲外です)

ビルドにも診断にも到達しません。 この状態に遭遇しうるすべての機能は、エラーを表に出すのではなく結果なしで応答します。これはエディタプロトコルが求める動作です。応答できないリクエストは何も返さず、エディタは次のキー入力の後に再度リクエストします。

ファイルに修正すべき点はなく、ビルドにも何も現れません。次の編集で回復せずに応答しないままの機能は、不具合として報告する価値があります。

スキーママージステップ自身の入力ガード

ビルドが到達しないガードです。Component または Feature が別のものを拡張し、両方がスキーマを宣言している場合、それらのスキーマは 1 つに結合されます。結合を行うライブラリは、構造的にマージできない入力を拒否します:

merger: invalid merge input(merger: 無効なマージ入力です)

これは結合ステップに属し、そのステップにはビルドが到達します。 拡張するエンティティとそのベースの両方がスキーマを宣言している場合は常に到達します。このガードが防ぐのは、空のチェーン、またはスキーマが欠けたチェーンエントリを渡されることです。しかし呼び出し側はそのどちらも渡すことができません。呼び出し側は存在が確認済みのスキーマだけからチェーンを組み立て、そのチェーンが空でない場合にのみ結合するからです。

このガードが残されているのは、公開されたライブラリによる不正な入力の拒否だからです。これを削除しても、ビルドが到達しうる停止は 1 つも消えません。むしろ、そのような入力を渡したコンパイラ外部の呼び出し側にとって、明確な拒否がクラッシュに変わることになり、明らかに悪化します。

チェーンそのものはこのステップの関心事ではありません。 ループするチェーンや深さの上限を超えるチェーンは、スキーマが結合される前に、単一の extends: の走査によって拒否されます。上記の「Cyclic extends chain(循環する継承チェーン)」と「An extends: chain runs past the depth bound(継承チェーンが深さの上限を超える)」を参照してください。

これが掲載されているのは、宣言されていて独自のコードを持つため、手元のコードが必ず解決できるようにするためです。記述できるものでこれを生じさせるものはなく、これに遭遇したということは上述の仕組みがもはや成り立っていないことを意味します。回避するのではなく不具合として報告する価値があります。

明示的な値がアノテーションの提供した値を置き換えた

アドバイザリです。アノテーション駆動の展開は、Aggregate または Release が持つアノテーションを、独自の設定を伴う Feature のアタッチメントに変換します。同じアタッチメントが明示的に書かれた設定も持つ場合(component 上、その上位のスコープ、または Release 内)、両者が共にカバーする各キーでは明示的な値が優先されます。これは意図されたルールであり、出力される結果は誤りではないため、ビルドは完了します。アドバイザリが示すのはその帰結です。そのキーに対するアノテーションの寄与は出力のどこにも見えなくなり、アノテーションを書いた作成者はそれが抑制されたことを知らない可能性があります。

何かを変えたものだけでなく、すべての置き換えを報告します。マージは抑制された値を上書きするため、比較する対象が残らず、両者が一致していたかどうかを判断できるものもありません。置き換えが起きたという記録が証拠のすべてです。これはアタッチメントのカスケード全体と展開が統合された時点で読み取られ、そこがその記録が存在する最も早い時点です。

メッセージは次のように始まります:

annotation contribution overridden by an explicit value(アノテーションの寄与が明示的な値によって上書きされました)

続いて、置き換えられたアノテーション、それを置き換えたキーの座標、置き換えられたアノテーションが書かれた場所が示されます。その前に置かれる位置は、検出結果があるドキュメントとその中のキーです:

<file> at <authored key>: annotation contribution overridden by an explicit value ("<annotation-key>", component "<component>", attachment "<attachment>", pillar "<pillar>", key "<the key at issue>", annotation declared at "<where the annotation was written>")(アノテーションの寄与が明示的な値によって上書きされました)

これらの値のうち 2 つは読み違えやすいものです。component は、置き換えたエントリが component を持つ場合にのみ示されます。スコープ全体に対して書かれたエントリは独自の component を持たず、持ったことのない component を示すと、誰も書いていないキーへ読者を導くことになります。また、annotation declared at は置き換えられたアノテーションが書かれた場所を示します。それを置き換えた component 上に書かれていない場合は、継承元のスコープになります。したがって、component のキーを別の見出しで繰り返したものではありません。

対処方法: 明示的な値が意図したものであれば、何もする必要はありません。このアドバイザリは、優先順位が驚きではなく選択となるように存在しています。意図したものでない場合、2 つの方法があり、影響範囲が異なります。明示的なエントリを削除すれば、アノテーションの値がそのキーまで流れます。あるいは、アノテーションを持つ component またはスコープからそれを削除すれば、寄与はまったく行われなくなります。これは、そのアノテーションが提供する他のすべてのキーにも影響します。両方が必要だが対象のキーが異なる場合は、意図より広く及んでいる方を絞り込み、両者が重ならないようにします。

接続が 2 つの異なるプロバイダーの組み立てられた出力の間をまたいでいる

依存関係の接続の両端が異なる出力に組み立てられる場合、境界をまたぐリンクをサポートすると表明しているプロバイダーは、それをネイティブに配線します。生成側で参照を公開し、消費側でそれを解決します。この配線は 1 つのプロバイダー固有の語彙で書かれ、プロバイダーは別のプロバイダーが公開した参照を解決できません。そのため、両端が異なるプロバイダーを通じてレンダリングされる接続は、どちらによっても配線されません。

これはアドバイザリであり、ビルドを停止しません。 接続は依然として値を運びます。注入コントラクトは、他のどこでもそうするのとまったく同じように、生成側のスカラー値を消費側へ渡します。したがって残るのは、壊れた接続ではなく、通常の方法で配線された機能する接続です。この検出結果が伝えるのは、期待していたかもしれないネイティブな配線が行われなかったということであり、対処してもしなくても出力は変わりません。

リンクを表明するプロバイダーが 1 つあれば報告されます。 両端が表明する必要はありません。1 つの表明があれば、ネイティブな配線が期待されていたのにそれが不可能だということであり、そのプロバイダーをアタッチした作成者こそがそれを望んだ人です。両方の表明を要求すると、一方のプロバイダーがリンクし他方がしない通常の混在デプロイメントでは何も報告されなくなりますが、まさにその場合のためにこれは存在します。

両端がどこに配置されたかは関係しません。 組み立てられた出力はそのパスとプロバイダーの組で識別されるため、プロバイダーが異なる 2 つの端は、配置に関係なく常に異なる出力にあります。読み取られるのは、2 つのプロバイダーとその 2 つの表明です。

そのような接続ごとに 1 回報告され、位置は接続が書かれたドキュメントとキーになります。

出力されるメッセージ(遠い側の端を先頭に、続いてソケットと各端のプロバイダーを示します):

cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>")(異なるプロバイダーによってレンダリングされるエンドポイント間の境界をまたぐリンクはサポートされていません)

修正方法: 接続がすでに運んでいるスカラー値で十分であれば、何もする必要はありません。これは不具合ではなく通知です。ネイティブな配線が必要な場合は、両端を 1 つのプロバイダーを通じてレンダリングする必要があります。一方の端を他方のプロバイダーを経由する境界へ移すか、両方の機能を 1 つのプロバイダーで提供します。どちらも不可能な場合は、値を運ぶ形式がそのデプロイメントの持つものであり、接続は機能します。

A command-line plugin runner was built without a way to find plugins(コマンドライン用プラグインランナーがプラグインを見つける手段なしで構築された)

ターミナルコマンドを提供するプラグインは、まずプラグインの参照をバイト列に変換する必要があるコンポーネントによって実行されます。この状態は、そのコンポーネントが変換を担う部分なしで構築されたため、参照から実行対象へ至る経路がないことを報告します。

これはビルドではなくターミナルコマンドに関するものです。そのため、コンパイルのどの段階もこれに到達しません。インストール済みコマンドがディスパッチされる箇所で発生し、その結果はいずれかのビルドの停止ではなく、そのコマンドの起動失敗となります。

同梱のコマンドラインツールには、これを発生させる経路はありません。 ツールがそのコンポーネントを構築する箇所はすべてルックアップを提供するため、このガードが作動するのは、他の何かがそれを構築し、ルックアップを省いた場合だけです。

出力されるメッセージ(この状態そのものを表す文です):

cliplugin: no plugin resolver configured(プラグインリゾルバが設定されていません)

対処方法: エンティティファイル内の何かがこれを引き起こすことはなく、カタログやワークスペースに何を書いても解消されません。公開されているコマンドラインツールを実行している場合、これは到達しうる状態ではありません。起動しないインストール済みコマンドは別の問題を報告しており、読むべきなのはそれが出力したメッセージです。プラグインランナーを独自のソフトウェアに組み込んでいる場合は、構築時にプラグイン参照をそのバイト列に解決するルックアップを提供してください。

A registry alias is already bound to another host(レジストリのエイリアスが既に別のホストに割り当てられている)

ビルドではなく、ワークスペースへのレジストリ追加時の拒否です。エイリアスは 1 つのレジストリエントリを選択する短い名前であるため、エントリ間で一意です。別のホストが既に保持しているエイリアスを登録しようとすると、既存の割り当てを覆い隠すことは許されず拒否されます。覆い隠すと、そのエイリアスを使うすべての参照の指し先が気付かないうちに変わってしまうためです。

同じホストを既存のエイリアスで再度追加することは競合ではありません。その場合はエントリがその場で更新されます。ホストの他の設定を変更するためにコマンドを再実行したときの動作がこれです。

出力されるメッセージ(エイリアスと、それを既に保持しているホストを示します):

workspaceconfig: registry alias "<alias>" is already used by host "<host>"; choose a different alias or address that host directly: registry alias is already used by another host(workspaceconfig: レジストリエイリアスはすでに別のホストで使用されています。別のエイリアスを選ぶか、そのホストを直接指定してください: レジストリエイリアスはすでに別のホストで使用されています)

対処方法: 修正はオペレーターがコマンドラインで行います。新しいレジストリに別のエイリアスを付けるか、エイリアスなしのままにしてホストで参照してください。エイリアスを新しいホストに移すつもりだった場合は、まず .aggrega-config.yaml 内のメッセージが示すエントリからエイリアスを削除してください。この拒否は、エイリアスの移動をレジストリ追加の副作用ではなく、意図して行う操作にするために存在します。

A registry serves a trust document that cannot be read as one(レジストリが信頼ドキュメントとして読み取れない信頼ドキュメントを提供している)

ビルドではなく、レジストリ追加時の拒否です。レジストリは、アーティファクトの署名に期待する署名 ID を公開できます。これにより、オペレーターに書き写させるのではなく、レジストリの追加時にそれらを固定できます。この状態は、信頼ポリシーとして使用できないドキュメントでレジストリが応答したことを報告します。

エンドポイントが応答したからこそ、これは厳格な拒否になります。 何も公開していないレジストリは通常の想定内の結果として許容されます。読み取れないものを公開しているレジストリは設定の誤りであり、そこから何も固定しなければ、固定されたように見えながら、レジストリは気付かないうちに未固定のままになってしまいます。

ここで報告されるのは 3 つの形です。まったくデコードできない内容(フォーマットが定義していないフィールドを含むドキュメントを含む)、正確な ID もパターンも指定していない ID エントリ、そして発行者のない ID エントリです。後の 2 つが拒否されるのは、そのようなエントリはどの署名にも一致しえず、固定を強化するように見えながら弱めてしまうためです。

出力されるメッセージ。 デコードできない内容:

registrytrust: advertised trust config is malformed: <what the decoder reported>(registrytrust: 公開されているトラスト設定の形式が不正です: デコーダが報告した内容)

照合対象のない ID エントリ:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp(registrytrust: 公開されているトラスト設定の形式が不正です: ID エントリには identity または identity_regexp を設定する必要があります)

そして発行者のないエントリ:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer(registrytrust: 公開されているトラスト設定の形式が不正です: ID エントリには issuer を設定する必要があります)

いずれも、それに遭遇したコマンドで囲まれます:

aggrega registry add: <the message above>

対処方法: 修正はユーザーではなくレジストリの運用者が行うものです。メッセージは該当するエントリと欠けているものを正確に示すので、それを運用者に伝えてください。それまでの間に作業を進めるには、公開されたポリシーを固定せずにレジストリを追加し、ID または鍵を自分で指定してください。コマンドはそれらを直接受け付けます。これは、ポリシーをまったく公開していないレジストリに対して行う方法と同じです。

A registry publishes no trust document(レジストリが信頼ドキュメントを公開していない)

障害ではなく通常の想定内の結果であり、何も停止しません。レジストリは期待する署名 ID を公開できますが、大半は公開していません。そのようなレジストリに問い合わせると、ないと応答し、レジストリの追加は続行されます。この結果は通知として報告され、代わりに ID は手動で固定されます。

これは、到達できなかったレジストリとは意図的に区別されています。このレジストリは応答し、その応答はポリシーを公開していないというものでした。両者を分けておくことで、意図的な不在を許容しつつ、到達性の問題は引き続きそれとして見えるようになります。

通知として報告され、レジストリ、その応答内容、代わりに行うべきことを示します:

Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key(通知: このホストはトラストポリシーを公開していません(HTTP 404)。—identity または —key で手動でトラストを固定してください)

この状態が記録される条件は registrytrust: registry advertises no trust config です。

公式ハブは例外です。組み込みのベースラインを持っているため、ドキュメントを公開していない場合は代わりにそのベースラインが固定されます。通知は、ID の固定を求めるのではなく、ハブの応答内容と、代わりにベースラインが使用されることを示します。

対処方法: 壊れているものはありません。このレジストリからの署名を検証したい場合は、通知のとおり、追加時に ID または鍵を指定してください。これはポリシーを公開していないレジストリに対する通常の手順です。指定しない場合、レジストリは署名に関する方針なしで追加され、そこからのアーティファクトは署名を持つ場合にのみ検証されます。

A registry is added offline with no trust policy to pin(オフラインでレジストリを追加しようとしたが、固定する信頼ポリシーがない)

ビルドではなく、レジストリの追加に対する拒否です。レジストリの追加は、その信頼が固定される唯一の時点です。レジストリが公開する署名 ID は一度だけ取得され、以後のすべての pull はその固定されたコピーに対して検証されます。ワークスペースがオフラインの場合はこの取得ができないため、レジストリに問い合わせることはありません。何も信頼しないエントリ(しかも以後のすべての pull がレジストリをそれに従わせることになるエントリ)を書き込む代わりに、公式ハブ以外のレジストリの追加は、ポリシーを自分で指定しない限り拒否されます。

次の 3 つの場合は拒否されません。 ID または鍵を指定すると、まさにそれらが登録され、取得は一切行われないため、オフラインでもオンラインと同じように動作します。公式ハブは組み込みのベースラインで追加されます。このベースラインは取得の有無にかかわらず備わっています。また、取得しないよう指定した場合(--fetch-trust=false)は、オンラインのときとまったく同じように、フラグからエントリが登録されます。

これはレジストリが追加されるあらゆる場面で発生します。aggrega registry add、aggrega config init --registry <host>、aggrega serve の aggrega/registryAdd および aggrega/configInit リクエスト(そのエラーメッセージは文の前に短いコードを含みます)、そしてそれらのコマンドを実行する aggrega mcp の登録ツールです。設定のシードは ID や鍵を受け取らないため、オフラインではハブしかシードできません。その他のレジストリは代わりに aggrega registry add で追加してください。

出力されるメッセージ(この状態そのものを表す文です):

a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with aggrega registry add <host> --identity <identity>=<issuer> or --key <public-key-file>(信頼ポリシーを手動で指定しない限り、公式ハブ以外のレジストリはオフラインでは登録されません。レジストリが公開しているポリシーを取得できないためです。オンライン時に一度登録するか、aggrega registry add の —identity または —key で信頼を手動で固定してください)

これは、発生したコマンドと対象のレジストリ名で囲まれて出力されます:

aggrega registry add: <host>: <the message above>

対処方法: ワークスペースがオンラインのときにレジストリを一度登録してください。その 1 回の実行だけ --offline=false を渡すか、offline 設定を解除します。これにより公開ポリシーが取得されて固定されます。以後の pull は固定されたコピーに対して検証されるため、その後に繰り返す必要はありません。オンラインにできない場合は、ポリシーを手動で指定してください。キーレスのレジストリには 1 つ以上の --identity <identity>=<issuer> エントリを、鍵を使うレジストリにはその公開鍵ファイルを指す --key を指定します。これは、公開内容から固定されるはずだったものと同じです。

A tag is already published with different content(タグが異なる内容ですでに公開されている)

ビルドではなく、公開に対する拒否です。公開されたバイト列は固定されます。何かをアップロードする前に、対象のバージョンが照会され、それが指すダイジェストと、手元の内容から生成されるダイジェストとが比較されます。すでに異なる内容を指しているバージョンは拒否されます。

バイト単位で同一の内容を再公開しても衝突にはなりません。 ダイジェストが一致し、何もアップロードされず、コマンドはそのバージョンがすでに公開済みであると報告します。そのため、一部だけ成功した公開を再実行しても安全であり、再実行によって公開が完了します。バージョンにまだない公開日と、push が署名する場合はその署名が付与され、どちらも欠けていないバージョンには何も付与されません。詳しくは Completing a publication an earlier push left partial を参照してください。

これを上書きするフラグはありません。 変更された内容は新しいバージョンで公開されます。これにより、利用者には、知らないうちに変わってしまうバージョンではなく、意図して移行できるバージョンが残されます。

出力されるメッセージ(バージョン、それが保持するダイジェスト、提示されたダイジェストを示します)。カタログエンティティを公開する場合は、バージョンの引き上げを検証するチェックも示されます:

aggrega push: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version (aggrega lint —pre-publish verifies the bump): oci: tag already published with different content(aggrega push: 指定された参照とバージョンは既存のダイジェストとしてすでに公開されています。提案されたダイジェストでの上書きを拒否します。新しいバージョンを公開してください(aggrega lint —pre-publish でバージョンの引き上げを検証できます): oci: タグは異なる内容ですでに公開されています)

データアーティファクトを公開する場合:

aggrega push-artifact: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version: oci: tag already published with different content(aggrega push-artifact: 指定された参照とバージョンは既存のダイジェストとしてすでに公開されています。提案されたダイジェストでの上書きを拒否します。新しいバージョンを公開してください: oci: タグは異なる内容ですでに公開されています)

対処方法: バージョンを上げて再度公開してください。カタログエンティティの場合、これは metadata.version と、エンティティが置かれているバージョンごとのディレクトリを指し、両者は連動して変わります。その前に、その変更が意図したものかを確認してください。触っていないはずのバージョンで 2 つのダイジェストが異なる場合、ディスク上の内容は公開された内容と一致していません。その理由を突き止めることは、上書き公開するよりも価値があります。メッセージに示される公開前チェックは、バージョンを直前のバージョンと比較するもので、引き上げが正しいことを確認する手段です。

An entity shares its directory with another entity(エンティティが別のエンティティとディレクトリを共有している)

ビルドではなく、pin と公開に対する拒否です。ワークスペースのルートに並べて置かれる 3 つ、すなわち Aggregate、Release、Manifest を除き、すべてのエンティティ種別は専用のディレクトリを持ちます。公開されたエンティティはバージョンごとに 1 つの座標にある 1 つのアーティファクトであり、それを作成するディレクトリもこれを反映します。pin の手順はディレクトリに 1 つだけ置ける entity.lock を書き込み、公開はエンティティをそのディレクトリからパッケージ化します。そのため、それ以外の種別のエンティティの横に別のエンティティがある場合、この両方の時点で拒否されます。つまり aggrega pin、作成者に代わって pin するよう指定された pull または push、そして pin するかどうかにかかわらず aggrega push によって拒否されます。拒否は何かを取得する前に行われ、何も書き込まれません。

複数のエンティティを含むディレクトリでも、読み込み、lint、検証、ビルドは行えます。 レイアウトが判定されるのは、ディレクトリから何かが生成されるときだけであり、それはメッセージが妨げとなっているエンティティを特定できる時点でもあります。pin しない pull はエンティティの横に何も書き込まないため、拒否されません。

横にあるエンティティとみなされるものは、同じディレクトリ直下にある他の YAML ドキュメントのうち、kind: がエンティティ種別であるものです。チャート自体のファイル、compose フラグメント、Kubernetes マニフェスト、README はエンティティではありません。また、サブディレクトリ(ローカルチャートや source/ ツリーなど)は、中身にかかわらずエンティティの横にあるとはみなされません。読み取られるのは各隣接ドキュメントの種別と名前だけなので、隣接ドキュメントが何を宣言しても結果は変わりません。

ディレクトリの名前は判定されません。 ディレクトリに単独で置かれたエンティティは、そのディレクトリがどこにあっても、宣言したバージョンで pin および公開されます。標準ライブラリのカタログが使う <name>/<version>/ レイアウトはチェックではなく慣例です。

出力されるメッセージ(エンティティ、その横にあるすべてのエンティティ、移動すべきファイルを示します):

the entity shares its directory with another entity, and an entity of its kind has a directory of its own (Recipe "<name>", beside it: Recipe "<name>" in <file>). remediation: give each entity a directory of its own — move <file> into a directory of its own, together with any file only that entity reads; only the Aggregate, Manifest and Release kinds may share a directory with other entities(エンティティが別のエンティティとディレクトリを共有していますが、この種類のエンティティは専用のディレクトリを持ちます(対象の Recipe と、その隣にある Recipe およびそのファイル)。対処: 各エンティティに専用のディレクトリを与えてください。示されたファイルを、そのエンティティだけが読むファイルとともに専用のディレクトリへ移動します。他のエンティティとディレクトリを共有できるのは Aggregate、Manifest、Release の種類だけです)

対処方法: メッセージに示された各エンティティを、それだけが読むファイル(ローカルチャート、インポートするファイル、そのエンティティの pin を記録している場合は entity.lock)とともに専用のディレクトリへ移動してください。そして、リモートソースを読むかファイルをインポートする各エンティティに対して aggrega pin を実行し、各ロックが自身のエンティティを記録するようにします。それぞれを <kind>/<provider-or-publisher>/…/<name>/<version>/ のように配置すると、標準ライブラリのカタログがすべてのエンティティを置く場所と同じになります。カタログディレクトリは走査によって見つけられるため、移動後もカタログに対するビルドは同じ出力を生成します。

An entity kind has no artifact media type(エンティティの種類にアーティファクトのメディアタイプがない)

ビルドではなく、公開時の拒否です。公開可能な各エンティティの種類には、そのアーティファクトが取る 2 つの形(ドキュメント単体、またはドキュメントとそれが宣言するファイルのアーカイブ)それぞれにメディアタイプがあり、エンティティのパッケージ化では種類によってそれを参照します。この状態は、エントリがない種類を報告します。

ビルドがこれに到達することはありません。 同じ参照が行われる唯一の別の場所では、エントリがないことを「これはライブラリではない」として扱って処理を続けるため、そこでこの状態が表面化することはありません。

出力されるメッセージ。この状態そのものを表す文を、コマンドとパッケージ化していたファイルが囲んでいます:

aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch(aggrega push: バンドル: oci: メディアタイプの振り分けで不明なエンティティの種類)

修正方法: 公開しようとしているファイルの kind: フィールドを、aggrega push --list-kinds が出力する種類と照合します。綴りの誤った種類やサポートされていない種類はここで報告され、フィールドを修正するだけで対処は完了します。その種類がその一覧に含まれている場合、それはエンティティではなくツールチェーンの不備であり、種類を明記して報告する価値があります。

A published archive carries an entry Windows cannot use(公開されたアーカイブに Windows で使用できないエントリが含まれている)

エンティティの公開時に出される注意です。何も停止させず、ビルドでは出されません。ドキュメントの横にファイルを持つエンティティはアーカイブとして公開され、アーカイブが持つ各名前(エンティティのドキュメント自身のファイル名、続いてそれが運ぶ各ファイル)は、上記の停止「A name the operation writes holds a part Windows cannot hold(操作が書き込む名前に Windows が保持できない部分が含まれている)」が Windows で適用する規則で判定されます。すなわち、大文字小文字を問わず、どのような拡張子が続いても Windows がデバイス用に予約している部分、またはピリオドか空白で終わる部分です。そのため、aux/x.yaml はディレクトリ aux により、report. は末尾のピリオドにより、スキーマファイルをインポートする con.yaml というドキュメントはそれ自身の名前により、この注意を受けます。何も運ばないエンティティは、製品が選ぶ名前で配置されるドキュメント単体として公開され、Plugin はアーカイブを公開しないため、いずれもこの注意を受けません。

すべてのプラットフォームで出され、何も拒否しません。 Windows 上のワークスペースはその停止のもとでそのようなエントリの配置を拒否するため、そのバージョンを使用できません。この注意は、Windows 上の誰かが気付く前に公開者がそれを知るための手段です。パブリケーション、またはそのドライランは、この注意がない場合とまったく同じように進むか停止します。

エンティティを公開するすべてのインターフェースがこれを出し、それぞれ独自の形を取ります。 aggrega push とその --dry-run は、エントリごとに 1 行を標準エラーに出力し、各行は warning: で始まります。アシスタントの publish-entity ツールはエントリを windows_unusable_entries として返し、応答のテキストでもそれらを示します。aggrega serve は aggrega/publishEntity に対してそれらを windowsUnusableEntries として返し、報告を求めたリクエストには警告行そのものを渡します。該当するエントリがない場合、各応答はそのフィールドを省略します。

メッセージは次のように始まります:

an entry this publication carries cannot be used on Windows(このパブリケーションが運ぶエントリは Windows で使用できません)

続いて、エントリと、そのうち Windows が保持できない最初の部分、そして対処方法が示されます。warnings.md の「A published archive carries an entry Windows cannot use(公開されたアーカイブに Windows で使用できないエントリが含まれている)」で説明しています。

修正方法: メッセージが示す部分を、ディスク上と、エンティティの宣言がそのファイルを指すすべての箇所で名前変更し、再度公開します。そのバージョンを Windows で使用する想定がない場合は、何も変更する必要はありません。

Two catalog identities publish to one repository location(2 つのカタログ ID が 1 つのリポジトリ位置に公開される)

ビルドではなく、カタログ全体のチェック時の拒否です。エンティティの公開先はその ID から導出されて小文字化されるため、大文字・小文字だけが異なる 2 つの ID は同じ場所に行き着きます。両方を公開すると、一方のエンティティのバイトがもう一方のバイトで上書きされ、しかもどちらのエンティティにもそのことは示されません。

このチェックはカタログ全体に対して一度に実行されます。衝突はどちらか一方のエンティティ単独の性質ではなく、ペアの性質だからです。どちらも単独では誤りではなく、どちらか一方だけを読んでも何もわかりません。

出力されるメッセージ。カタログ検査の枠で始まり、次にこの状態そのものを表す文、その後に衝突する各グループが続きます。各グループは共有される位置と、そこに行き着く ID を示します:

catalog validation failed: oci: distinct catalog identities map to the same OCI repository location:(カタログの検証に失敗しました: oci: 異なるカタログ ID が同じ OCI リポジトリ位置に対応しています:)

  • <location> <- <identity>, <identity>

修正方法: メッセージが示すエンティティのいずれかを、その metadata.name と、それに対応するディレクトリの両方で名前変更します。どちらを名前変更するかは自由に選べます。大文字・小文字だけが異なるペアがよくある形で、1 つの綴りを選んで一貫して使うことで、ペアの再発を防げます。名前変更はエンティティの ID に対する実際の変更であるため、古い名前を参照しているものもすべて合わせて変更する必要があります。これが、どちらかの名前が公開された後ではなく、公開される前に衝突を解決すべき理由です。

Keyless signing was asked for without the services it needs(キーレス署名が、必要なサービスなしで要求された)

ビルドではなく、公開中の署名時の拒否です。キーレス署名にはオフラインの形がありません。ID を取得し、それに対して短期間有効な証明書を発行させ、後で検証できる場所に署名を記録し、その後に鍵を破棄します。そのすべてが、稼働中のサービスとのやり取りです。この状態は、フローの起点となる ID が利用できなかったことを報告します。そのため、フローは開始して途中で放棄されるのではなく、開始前に拒否されます。

これを報告する形は 2 つあります。ID を供給するものがまったく設定されていない場合と、設定されているものが何も返さなかった場合です。

オフラインのワークスペースでは別の形で報告されます。すべてのネットワーク処理を対象とする拒否として報告されます。ID が要求されるより前に拒否が起きるためです。

出力されるメッセージ。 ID の供給元がない場合:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required(signing: キーレス署名には稼働中の ID プロバイダ、Fulcio、Rekor が必要です: ID トークンの供給元が必要です)

供給元が何も生成しなかった場合:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required(signing: キーレス署名には稼働中の ID プロバイダ、Fulcio、Rekor が必要です: ID トークンが必要です)

修正方法: 修正は運用者が、公開の実行方法の中で行います。自動化されたパイプラインでは、ID はパイプライン自身の認証情報から得られるため、通常はそれを発行する権限がジョブに付与されていなかったことを意味します。対話的に実行する場合、ID はサインインによって得られ、コマンドがその入力を求めます。稼働中の ID をまったく使いたくない場合は、代わりに保持している鍵で署名します。この方法ではこれらのサービスはいずれも不要で、それらに到達できない環境から使うべき方法です。

An unsigned publish targets a registry or a policy that requires a signature(署名のない公開が、署名を必要とするレジストリまたはポリシーを対象にしている)

ビルドではなく、公開時の拒否です。署名が必要な場合、署名のないコンテンツは公開されません。このチェックはバイトがアップロードされる前に実行されるため、部分的なものがレジストリに届くことはありません。

要求には 2 つの出所があり、対処法が異なるため、状態は 2 つあります。 1 つは公開先レジストリ自身の方針で、そこに公開されるすべてに適用されます。もう 1 つはワークスペースの署名ポリシーで、公開先にかかわらず、一連のアーティファクトの種類を対象とします。両方が当てはまる場合は、レジストリのものが報告されます。公開先を示すほうが、2 つのうちでより役に立つためです。

ここで署名のないコンテンツを公開するフラグはありません。 署名を明示的に無効にしても拒否は緩和されません。署名が任意のアーティファクトに対する既定値が変わるだけです。

署名はアップロードの後ではなく前に生成されるため、署名の失敗もここに該当し、何も公開されません。

出力されるメッセージ。 レジストリ自身の要求の場合:

aggrega push: registry "<host>" requires signatures; re-run signing the artifact (there is no flag to push unsigned content here): signing: registry requires signatures; refusing to push unsigned content(aggrega push: このレジストリは署名を必要とします。アーティファクトに署名して再実行してください(ここでは未署名のコンテンツを push するフラグはありません): signing: レジストリが署名を必要とするため、未署名のコンテンツの push を拒否します)

ワークスペースのポリシーの場合。アーティファクトを対象範囲に含めた種類を示します:

aggrega push: the signing policy requires a signature for kind "<kind>"; re-run signing the artifact (there is no flag to push unsigned content here): signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content(aggrega push: 署名ポリシーはこの kind に署名を必要とします。アーティファクトに署名して再実行してください(ここでは未署名のコンテンツを push するフラグはありません): signing: 署名ポリシーがこのアーティファクトの kind に署名を必要とするため、未署名のコンテンツの push を拒否します)

署名を生成できなかった場合。レジストリの状態として報告され、根本の失敗を引用します:

aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content(aggrega push: 署名に失敗しました: 根本の失敗: signing: レジストリが署名を必要とするため、未署名のコンテンツの push を拒否します)

署名の失敗のうち 1 つの形は個別に示されます。一般的な拒否では、役に立たない認証情報を取得し直すよう誘導してしまうためです:

aggrega push: sign <reference>:<version>: the identity token carries no verified email or subject claim — the OIDC flow/client did not return an email-scoped identity (re-exporting or re-acquiring the token will not help); configure the identity provider/client/scope to return one: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content(aggrega push: 署名: ID トークンに検証済みの email または subject クレームがありません。OIDC フロー/クライアントが email スコープの ID を返しませんでした(トークンを再エクスポートまたは再取得しても解決しません)。ID プロバイダー/クライアント/スコープを、これを返すように設定してください: 根本の失敗: signing: レジストリが署名を必要とするため、未署名のコンテンツの push を拒否します)

修正方法: 修正は運用者が行います。アーティファクトに署名して再度公開します。保持している鍵か、キーレスの方法か、ワークスペースが設定されているほうを使います。署名が必要になると想定していなかった場合は、メッセージがどちらの出所が要求したかを示しています。レジストリ自身の方針は .aggrega-config.yaml 内のそのレジストリのエントリにあり、種類を対象とする要求はワークスペース全体の署名ポリシーにあります。どちらを緩和するかは、何を署名なしで公開してよいかについての判断であるため、通常はポリシーを無効にするよりも、その対象範囲を絞るほうが適切です。

References signed together need different signing credentials(まとめて署名する参照が異なる署名資格情報を必要とする)

ビルドではなく、署名時の拒否です。複数の参照を指定した aggrega sign と、バッチファイルを指定した aggrega deprecate --from は、指定されたすべてを 1 つの資格情報、つまり 1 つの保持鍵または 1 つのキーレス ID で署名します。参照がどの資格情報を必要とするかは、そのレジストリの設定で決まります。そのレジストリに適用される signing.key_path があればそれが指す鍵が選ばれ、適用されるものがなければその参照はキーレスで署名されます。まとめて指定した参照が異なる資格情報を必要とする場合(あるレジストリには鍵があり別のレジストリにはない、あるいは 2 つの異なる鍵)、何も署名されず、メッセージはそれぞれの側のレジストリを示します。

このチェックは ID を要求する前、かついずれのレジストリも読み取る前に実行されるため、何も署名・添付されず、実行されない処理のために誰かにプロンプトが表示されることもありません。署名は一度取得されると誰からも取り消せないため、参照のいずれかが必要とする資格情報で署名するのではなく、実行そのものを拒否します。

--key で渡した鍵はすべての参照に対して優先されます。 各レジストリの設定にかかわらず、指定したすべての参照に適用されるため、そのような実行がここで拒否されることはありません。

この条件はバッチを署名するすべての場所で発生します。aggrega sign、aggrega deprecate --from、aggrega serve の aggrega/signArtifacts および aggrega/deprecateArtifact リクエスト(そのエラーメッセージでは文の前に短いコードが付きます)、そして aggrega mcp の sign-artifacts および deprecate-artifact ツールです。リスナー経由でサーバーに届いたツール呼び出しは、設定が指す鍵を使用しないため、その場合すべての参照は呼び出しが送る ID で署名され、ここで拒否されることはありません。

出力されるメッセージ。条件自体の文で始まり、各資格情報とそれで署名されるレジストリが続き、最後に対処方法が示されます:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own(aggrega sign: 署名: まとめて指定された参照には異なる署名資格情報が必要なため、何も署名されませんでした(一方のレジストリは signing.key_path が指定する保持鍵で署名し、もう一方のレジストリはキーレスで署名します: signing.key_path が適用されません)。対処: 資格情報ごとに 1 回ずつ、別々の実行で署名してください: まず一方のレジストリ上の参照、次にもう一方のレジストリ上の参照。各実行は単独で実行した場合と同じように署名します)

また、バッチ内のレジストリが署名を必須とする場合は、対処方法の末尾でそのレジストリを示します:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own, and <registry> requires signatures, so this refusal holds back signing that would otherwise have gone ahead rather than signing that cannot be done(aggrega sign: 署名: まとめて指定された参照には異なる署名資格情報が必要なため、何も署名されませんでした(一方のレジストリは signing.key_path が指定する保持鍵で署名し、もう一方のレジストリはキーレスで署名します: signing.key_path が適用されません)。対処: 資格情報ごとに 1 回ずつ、別々の実行で署名してください: まず一方のレジストリ上の参照、次にもう一方のレジストリ上の参照。各実行は単独で実行した場合と同じように署名します。また、名前の挙がったレジストリは署名を必須としているため、この拒否が差し止めているのは実行不可能な署名ではなく、本来なら進められたはずの署名です)

独自の鍵を持つ 2 つ目のレジストリは、「with a different held key」(別の保持鍵で)署名するものとして示されます。鍵のパスは出力されません。メッセージは変更可能な対象である設定名を示します。

対処方法: 参照をそのレジストリが必要とする資格情報ごとに分け、資格情報ごとに 1 回ずつ実行します。鍵で署名するレジストリ上の参照を指定する aggrega sign を 1 回、残りを指定するものをもう 1 回です。aggrega deprecate --from の場合は、資格情報ごとに 1 つのバッチファイルを用意します。これで各実行は単独で実行した場合と同じように署名します。代わりに 1 回の実行ですべての参照を 1 つの鍵で署名するには、その鍵を --key で渡します。

A detached signature does not verify against the key supplied(分離署名が指定された鍵で検証されない)

ペイロードに対する単体の署名を公開鍵で検証した結果が否定的だった場合で、処理は完全にオフラインで行われます。ペイロードが署名されたものと異なる、署名が改変されている、または鍵が署名を生成したものではない、のいずれかです。

出荷されているツールチェーンでこの条件に到達するものはありません。 これが属するチェックには自身のテスト以外に呼び出し元がないため、ユーザーが実行するコマンド(build、pull、publish)がこれを報告することはありません。ここに掲載しているのは、ビルドが出力し得るからではなく、コードが何かに対応するようにするためです。pull が実際に行う検証は完全な署名バンドルに対するもので、別の条件として報告されます。

出力されるメッセージ。検証器が報告した内容を引用します:

signing: signature does not verify: <what the verifier reported>(署名: 署名を検証できません: 検証器が報告した内容)

対処方法: エンティティファイル内の何かが原因ではなく、カタログやワークスペースに何を書いても解消されません。公開されているコマンドラインツールを実行している場合、これは到達し得ない条件であり、実際に目にしている署名の問題は上記のバンドル検証の条件のいずれかによって報告されています。独自のソフトウェアから署名パッケージを直接使用している場合、ペイロード、署名、鍵は互いに対応する 3 つでなければなりません。よくある原因は署名と検証の間でペイロードが再シリアライズされることで、その場合内容が同じに読めてもバイト列が異なります。

A resolved artifact is not a documentation bundle(解決されたアーティファクトがドキュメントバンドルではない)

別の種類のアーティファクト(カタログエンティティ、プラグインなど)に解決される参照は、ドキュメントとしてキャッシュされずに拒否されます。これにより、誤った参照は後で読み取れないバンドルとして失敗するのではなく、参照した時点で失敗します。

発生する場所。 ドキュメントバンドルは、マシン上のすべてのプロジェクトが共有するキャッシュに、ワークスペースで設定されたレジストリの予約済み docs 名前空間から取得されます。アシスタント向けサーバーは起動時、何かに応答する前に 1 回取得し、aggrega explain とエディタによるコードの説明は、それぞれ最初に必要になったときに取得し、aggrega scaffold --example も取得します。いずれの場合も、ワークスペースの署名チェックが許可するコピーがマシンにない場合に限られます。これは、すべての取得が返ってきたものに対して実行するチェックです。

セッションを停止させることはありません。 取得の結果はサーバーのログストリームに報告され、接続はいずれにせよ続行されます。拒否されたアーティファクトによって失われるのはドキュメントリソースであり、そのセッションではそれらが not-found を返します。aggrega scaffold --example はバンドルがなければ書き込むものがないため、そこではコマンドの拒否となり、何も書き込まれません。

出力されるメッセージ。参照と両方のメディアタイプを示します:

docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle(docscache: 参照@バージョンのメディアタイプは見つかったものであり、ドキュメントバンドルのメディアタイプが必要です: docscache: アーティファクトはドキュメントバンドルではありません)

対処方法: エンティティファイル内の何かが原因ではなく、オーサリングの変更では解消されません。取得に使われた参照が、ドキュメントバンドルではないものを指しています。バンドルの参照はワークスペースで設定されたレジストリから導出されるため、そのレジストリを確認してください。形式が正しく別のアーティファクトを指す参照は、解決には成功し、ここで初めて失敗します。

A page is absent from a documentation bundle(ドキュメントバンドルにページが存在しない)

ドキュメントバンドルはキャッシュされ、その内容は検証済みですが、要求されたページ(aggrega scaffold --example の場合はサンプルのディレクトリ)がその中にありません。バンドルがまったくない場合とは異なります。バンドルは存在し健全であり、その中にエントリがないということです。

ビルドには到達しません。 エディタやアシスタントにドキュメントページを提供するサーフェスは、これを、要求されたリソースに対する通常の not-found 応答に変換します。aggrega scaffold --example は何も書き込まず、これをサンプルとバンドルを名指しする拒否として報告し、続いて、バンドルが実際に含むサンプルを表示する aggrega scaffold --example --list を案内します。

2 種類の not-found 応答のどちらを受け取ったかは区別して知っておく価値があります。サーフェスはどちらも同じように表示しますが、こちらはバンドルがキャッシュされていて健全であり、ページがその中にないことを意味します。もう一方(キャッシュされていない、または唯一のコピーがワークスペースの署名チェックによって拒否されるために、ワークスペースが読み取れるバンドルがない)は、取得が完了しなかったことを意味し、その理由はサーバーのログストリームに示されます。

出力されるメッセージ。ページと、それを検索したバンドルを示します:

page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle

対処方法: ファイル内に問題はありません。バンドルにページがないのは、バンドルがそのページより古いか、要求されたパスがそのページの公開先のパスではないためです。バンドルはサーバーが自身のバージョンとして報告するバージョンで取得されるため、そのバージョン以降に追加されたページは含まれません。ページが一度も存在したことがない場合、要求はドキュメントが使用していないパスを指定しており、実際に使用されているパスは公開されているドキュメントで確認できます。

An edit would produce a document its schema refuses(編集によってスキーマが拒否するドキュメントが生成される)

ビルドではなく、ドキュメント編集時の拒否です。1 つの構造化された編集(コンポーネントの追加、Feature のアタッチ、エッジの接続、値の設定)が組み立てられてドキュメントに組み込まれ、その結果がドキュメントの種類に対応するスキーマで検証されます。その検証で問題が見つかると、編集は拒否され、何も書き込まれません。これは aggrega edit-document に属し、エディタが aggrega serve 経由で、あるいはアシスタントが到達する同じ機能にも属します。これらは 1 つの実装に対する薄いエントリポイントです。

種類はドキュメントから読み取られ、呼び出し元が指定することはありません。 呼び出し元が種類を指定すると誤った種類を指定する可能性があり、その場合、結果はドキュメントが準拠していないスキーマで検証されることになります。それは、このチェックが拒否するために存在するまさにその編集を許可してしまいます。

ファイルはバイト単位で元のまま残され、書き込みはアトミックです。そのため、拒否された編集は一度も試行されなかった編集と区別がつかず、修正したリクエストを元のドキュメントに対して再試行できます。

対象となるのは、形式が正しいリクエストです。 リクエストはこの機能が適用する編集を指定しており、生成されたはずのドキュメントは、手で入力した場合にもオーサリングスキーマが拒否するものです。そのため、これについてオーサリングの規則を改めて述べることはしません。Release に開発者の値を持たせるよう求めると、どちらの場合も同じスキーマによって拒否されます。そもそも編集を指定していないリクエスト(ドキュメント内の何にも到達しないノードパス、スカラーが必要な場所にマッピングとして書かれた値、すでに別の内容を持つエントリ)は、それ自体の理由で拒否され、各サーフェスがそれぞれのチャネルで報告します。

すでに無効だったドキュメントもこれを報告します。 チェックは編集が何も変更しなかった場合にも実行されるため、製品が読み取りを拒否するドキュメントに対する編集は、成功を報告するのではなく、その旨を示します。

このチェックは、ドキュメントを読み込むたびに適用されるものと同じです。そのため、パイプラインで 1 つのステップ id を 2 回宣言している Recipe または FeatureRecipe も拒否します。これはどのスキーマでも表現できない規則です。このとき、文の後に続く異議は、A pipeline declares one step id twice (パイプラインが 1 つのステップ id を 2 回宣言している) で説明しているとおり、その条件自身の文と助言から始まります。

出力されるメッセージ。文の後にスキーマ自体の指摘が続きます。ドキュメントの種類とファイル、次に位置、問題のあるキー、そしてそこでスキーマが示した内容で、最後に助言で締めくくられます:

the edit was refused because the resulting document would not be valid, and nothing was written: document envelope validation failed (<kind>, at <path>); <line>:<column>: <field-path>: … <the schema's own objection>. correct the document to match its kind’s schema

対処方法: メッセージが示す位置でドキュメントを開き、指摘を読んでください。そのキーでスキーマが何を求めていたかが示されています。変更すべきなのは通常、ドキュメントではなくリクエストです。その場所でスキーマが許可するエントリを求めれば、同じリクエストが問題なく適用されます。そのキーがそのドキュメントの種類ではまったく持てないものである場合、それは持つことのできるオーサリングサーフェスに属し、その種類のエンティティページに宣言されるフィールドが記載されています。意味的に許可されるかどうか(たとえば、依存ソケットがプロデューサーの宣言するものかどうか)はこの時点では判断されません。そのため、この拒否は常にドキュメントの形に関するものであり、接続を越えて何を消費できるかに関するものではありません。

An annotation key uses a prefix the platform reserves(アノテーションキーがプラットフォームの予約済みプレフィックスを使用している)

ビルドではなく、エンティティを公開の慣例に照らしてチェックする際の拒否です。aggrega.ai/ プレフィックス、および Feature 以外での feature.aggrega.ai/ はプラットフォームが所有します。その下に書かれたキーはプラットフォームが割り当てる意味を持つため、そこに書き込む独自のエンティティは、自身が保持していない名前空間を主張していることになります。

オーサリング中は助言し、公開ゲートでは拒否します。どちらの場合もこの 1 つの条件を示します。見つかる内容はどちらでも同じで、結果だけが異なります。ここに掲載している公開の慣例に関する規則の多くはこのように動作するため、一度だけここで述べ、以下のエントリで特に記載がない限りそのように扱います。既に公開されたバージョンと比較する 2 つの規則は、ローカルの内容に対してはまったく実行できないため、それぞれのエントリでその旨を記載しています。

メッセージは次のように始まります:

an annotation key on the entity uses a prefix the platform reserves

対処方法: キーを自組織が所有するプレフィックスの下に移動します。それでもワークスペースに予約済みプレフィックスの下に書き込む理由がある場合、この規則は aggrega-lint.md の「The discipline rules」で説明されているオプトアウトの 1 つです。

An entity’s name does not follow the shape its kind expects(エンティティの名前が、その種類が想定する形式に従っていない)

ビルドではなく、公開の慣例に照らしたエンティティのチェックでの拒否です。各エンティティ種類には名前の形式に関する慣例があり(クラウドネイティブ系の種類ではセグメント数、ライブラリ系の種類では PascalCase)、このエンティティが宣言する名前はその種類が想定する形式と一致しません。

メッセージは次のように始まります:

the entity’s name does not follow the documented name shape for its kind(エンティティの名前が、その種類について文書化された名前の形式に従っていません)

修正方法: エンティティの名前を、その種類が想定する形式に変更します。種類ごとの慣例は aggrega-lint.md の「The discipline rules」に一覧があり、意図的に独自の方法でエンティティに名前を付けるカタログ向けのオプトアウトも記載されています。

A schema uses a dynamic reference that cannot be resolved ahead of time(スキーマが事前に解決できない動的参照を使用している)

ビルドではなく、公開の慣例に照らしたエンティティのチェックでの拒否です。エンティティが持つスキーマが動的参照の構文を使用しており、その参照先はスキーマの記述時に固定されるのではなく、ドキュメントの検証中に選ばれます。ここでは参照は事前に展開されるため、そのような構文が解決の拠り所とする進行中の検証が存在しません。

メッセージは次のように始まります:

a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow(エンティティ内のスキーマが、ドキュメント間の参照解決では追跡できない動的参照の構文を使用しています)

修正方法: 動的な構文を、参照先を直接指定する通常の参照に置き換えます。スキーマがその構文を本当に必要とし、ドキュメントをまたいで参照されることがない場合は、このルールに aggrega-lint.md の「The discipline rules」で説明されているオプトアウトがあります。

A schema declares an identifier the platform owns(スキーマがプラットフォームの所有する識別子を宣言している)

ビルドではなく、公開の慣例に照らしたエンティティのチェックでの拒否です。エンティティが持つスキーマが独自の識別子を宣言していますが、正規の識別子はエンティティの ID から導出されるものです。宣言された識別子が導出された識別子を置き換えるため、正規の識別子に対して書かれた参照が解決されなくなります。

メッセージは次のように始まります:

a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity(エンティティ内のスキーマが独自の識別子を宣言していますが、そのスキーマの ID はプラットフォームが所有しています)

修正方法: 宣言された識別子を削除し、導出されるようにします。意図的に独自の識別子で公開するスキーマ向けのオプトアウトは、aggrega-lint.md の「The discipline rules」で説明されています。

A Component’s category label and its directory name different categories(Component のカテゴリラベルとディレクトリが異なるカテゴリを示している)

ビルドではなく、公開の慣例に照らしたエンティティのチェックでの拒否です。Component はカテゴリラベルを持ち、カテゴリディレクトリの下に配置されます。慣例では、この 2 つは同じカテゴリを示し、読者が閲覧するディレクトリとセレクタが照合するラベルが食い違わないようにします。

メッセージは次のように始まります:

the entity’s category label does not match the category directory the entity is filed under(エンティティのカテゴリラベルが、エンティティの配置されているカテゴリディレクトリと一致しません)

修正方法: 2 つのうち誤っている方を修正して一致させます。ファイルをラベルが示すディレクトリの下に移動するか、ラベルをディレクトリが示すカテゴリに修正します。カテゴリの閉じた集合とオプトアウトは、aggrega-lint.md の「The discipline rules」にあります。

A schema extension is written directly into schema content(スキーマ拡張がスキーマの内容に直接書かれている)

ビルドではなく、公開の慣例に照らしたエンティティのチェックでの拒否です。Component または Feature が Aggrega のスキーマ拡張をスキーマの内容に直接書いていますが、エンティティには同じことを宣言するための第一級の記述面があります。直接記述した形式も動作しますが、慣例では宣言用の記述面を優先します。エンティティのページが教えるのも、ツールが読むのもそちらだからです。

このグループでビルドも報告するルールはこれだけです。その場合はビルドを止めない助言として報告されます。公開ゲートで公開の慣例に照らしてエンティティをチェックすると、同じ検出結果が拒否に引き上げられます。

メッセージは次のように始まります:

the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema(エンティティが Aggrega のスキーマ拡張を usesSchema または featuresSchema の下で宣言せず、スキーマ内容に直接記述しています)

修正方法: 拡張をエンティティ自身のソケットまたはアタッチメントの記述面に移動します。そこが component.md と feature.md のエンティティページで宣言されている場所です。オプトアウトは aggrega-lint.md の「The discipline rules」にあります。

A Plugin pins neither runtime cap, so the platform’s own apply(Plugin がどちらのランタイム上限も固定していないため、プラットフォーム自身の上限が適用される)

エンティティを公開の慣例に照らしてチェックしたときに、記述中でも公開ゲートでも同様に出される助言です。何も止めることはなく、ビルドでは出されません。Plugin は、ホストがプラグインを読み込んで実行する際に適用するメモリ上限と時間制限を宣言します。どちらも宣言しない場合はプラットフォームのデフォルトで実行され、これは誤りではなくサポートされた結果です。したがって、これが報告するのは、デフォルトが有効になっていることと、明示的に固定できることです。

メッセージは次のように始まります:

the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply(Plugin エンティティが独自のランタイムリソース上限を宣言していないため、プラットフォームのデフォルトが適用されます)

修正方法: プラグインが実際に必要とする上限を固定するか、意図的にデフォルトのままにします。これにはオプトアウト設定がありません。エンティティに対する判断ではなくエンティティに関する事実を報告するものであり、緩和すべきものがないためです。フィールドは plugin.md で説明されています。

An attachment slot admits only secret material without saying it handles it(アタッチメントスロットが、扱うことを示さずにシークレットのみを受け入れている)

エンティティを公開の慣例に照らしてチェックしたときに、記述中でも公開ゲートでも同様に出される助言です。何も止めることはなく、ビルドでは出されません。アタッチメントスロットは、セレクタを通じてシークレットを持つ Feature だけが埋められるよう固定でき、それとは別に、埋めるものがシークレットを扱うことを記録できます。セレクタはどの埋め方が許容されるかを示し、記録は扱いを示します。前者を固定して後者を省略したスロットでは、扱いをスロットから読み取るのではなくセレクタから推測することになります。エンティティが宣言するすべてのスロットがチェックされます。エンティティ自身のアタッチメントブロックのスロットと、Component では、依存ソケットがそれを通じて配線される接続ごとに宣言するスロットです。ソケットのスロットに関する検出結果では、スロットとともにソケットの名前も示されます。

メッセージは次のように始まります:

an attachment slot admits only secret material and does not declare that it handles it(アタッチメントスロットがシークレットのみを受け入れており、それを扱うことを宣言していません)

修正方法: スロットを固定するセレクタの横で、スロットに扱いを宣言します。Plugin の上限に関するルールと同じ理由で、これにもオプトアウト設定はありません。エンティティに関する事実を報告し、判断は利用者に委ねるものだからです。

A Recipe publishes a provides key its Component does not declare, checked at publication(Recipe が、その Component が宣言していない provides キーを公開している、公開時のチェック)

エンティティを公開の慣例に照らしてチェックしたときに、記述中でも公開ゲートでも同様に出される助言です。何も止めることはなく、ビルドでは出されません。Recipe が provides: の下でキーを公開していますが、その Recipe が実装する Component は、スキーマの provides の柱でそのキーを宣言していません。接続をまたいで配線するコンシューマは、Recipe が出力するものではなく Component が宣言した契約を読むため、このキーは生成されても、何かがそれを消費しようとする箇所で拒否されます。

🔴 これを表す条件は 2 つあり、同じものではありません。 ビルドが報告する助言は、上の「A Recipe publishes a provides key its Component does not declare」で説明されています。こちらはエンティティを公開の慣例に照らしてチェックしたときに出され、独自のコードを持ちます。検出結果は同じ事実を 2 つの面で捉えたものです。どちらを扱っているかは、診断のコードで判別してください。

メッセージは次のように始まります:

the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused(Recipe が、実装する Component の宣言していない provides キーを公開しているため、そのキーを配線するコンシューマは拒否されます)

修正方法: Component にキーを宣言し、コンシューマが読む契約に Recipe の出力が含まれるようにします。または、何もそれを消費する予定がない場合は Recipe からの公開をやめます。オプトアウトは aggrega-lint.md の「The discipline rules」にあります。

Component のメトリクスアノテーションと provides キーが一致しない

エンティティが公開の慣例に照らしてチェックされるときに、作成中と公開ゲートのどちらでも出されるアドバイザリです。何かを止めることはなく、ビルドはこれを出しません。Component は、自身のプロダクトのメトリクスがどのように認証するかを、アノテーション observability.aggrega.ai/metrics-credential で none、target-key、separate-token のいずれかとして示すことができます。また、provides キー metrics_credential_required を宣言することもでき、各 Recipes はこのキーを公開して、あるインスタンスのメトリクスに資格情報が必要かどうかを示します。この 2 つはプロダクトについての 1 つの事実を 2 つの側から見たものです。そのため、メトリクスに資格情報が不要だと示す Component はこのキーを宣言せず、資格情報が必要だと示す Component はこれを宣言します。この条件は、2 つが食い違っている Component を報告し、その Component、アノテーションの値、および余分または欠けているキーを示します。

メッセージは次のように始まります:

a Component’s annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance’s metrics need a credential(Component のメトリクスの認証方法を示すアノテーションが、インスタンスのメトリクスに資格情報が必要であることを示す provides キーを宣言しているかどうかと一致しません)

修正方法: 2 つのうち誤っている方を修正します。メトリクスに資格情報が必要な場合は、provides ピラーで metrics_credential_required を宣言し、各 Recipe からそれを公開します。不要な場合はそれを削除します。あるいは、アノテーションをプロダクトを正しく表す値に変更します。Plugin の上限に関するルールがオプトアウト設定を持たないのと同じ理由で、このルールもオプトアウト設定を持ちません。どの値を読み取るか、どの Components を読み取らないかは、aggrega-lint.md の「The discipline rules」に記載されています。

接続とその到達先のターゲットが 1 つのキーを示していない

Release を公開の慣例に照らしてチェックしたときに出される助言です。何かを停止させることはなく、ビルドではこの助言は出されません。キーをチェックするサーバーは、検証するキーを自身のスロットに保持し、呼び出し側はそのサーバーに到達する接続上でキーを提示します。どちらの側も相手のキーを参照できないため、両者が 1 つのキーであるのは、作成者が両端に同じロケーターを書いた場合に限られます。この条件は、ターゲットが呼び出し側に要求するキーのスロットを宣言している接続のうち、両者が一致しないものを報告します。すなわち、接続が資格情報を持つのにターゲットのキースロットが未設定の場合、ターゲットのキースロットが設定されているのに接続が資格情報を持たない場合、または両方が設定されているもののロケーターの書き方が異なる場合です。

上記のルールとは異なり、このルールは 1 つのエンティティではなく Release 全体を読み取ります。そのため、Release をチェックしたときにのみ検出され、1 つのエンティティを単独でチェックする公開ゲートでは検出されません。どこで報告される場合も助言です。検出結果はコンポーネント、接続、ターゲット、2 つのスロットを示し、どちらのロケーターも引用しません。スクレイプ(scrape_target ソケット上の接続)は、ターゲットがそのメトリクスについて示す内容によって判定されます。ターゲットの observability.aggrega.ai/metrics-credential アノテーションが none の場合はまったく判定されず、separate-token の場合はターゲットのキーに対しては判定されず、それ以外の場合は他の接続と同様に判定されます。その他のソケット上の接続は、ターゲットが何を示しているかにかかわらず判定されます。

メッセージは次のように始まります:

a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one(接続とその到達先のターゲットが 1 つのキーを示していません。異なるロケーターが書かれているか、一方のみがキーを示しています)

修正方法: 両端で 1 つのパラメーター(接続の credential とターゲットの api_key)を読み取るようにします。こうすることで、呼び出し側が提示するキーとサーバーが検証するキーが別々に書かれることがなくなります。あるいは、接続がキーを提示しない想定であれば、その接続から資格情報を取り除きます。どのスロットを読み取るか、何を比較するか、およびオプトアウトは、aggrega-lint.md の「The discipline rules」に記載されています。

公開しようとしている変更が進化ルーブリックの許容範囲を破る

ビルドではなく、公開前に行われるチェックでの拒否です。公開しようとしているバージョンは、それ以前に公開済みのバージョンと比較され、両者の差分が文書化されたルーブリックに照らして分類されます。この条件は、その差分がルーブリックの認めないものであることを報告します。

比較対象となる公開済みの前バージョンが必要です。そのため、これと後述のバージョン引き上げの検査は、このグループの中でローカルのコンテンツだけでは実行できない 2 つのルールです。レジストリを参照しない場合は比較対象がなく、チェックは合格ではなくスキップとなります。

メッセージは次のように始まります:

the version being published changes the published predecessor in a way the documented evolution rubric objects to(公開しようとしているバージョンは、文書化された進化ルーブリックが認めない方法で公開済みの前バージョンを変更しています)

修正方法: 診断に示された分類を読みます。分類には、変更のどの点をルーブリックが認めなかったかが示されています。そのうえで、変更を互換性のあるものにするか、その変更を許容するバージョンで公開します。ルーブリックは aggrega-lint.md の「The version-bump rubric」に記載されています。

提示されたバージョンの上げ幅が変更に必要な幅より小さい

ビルドではなく、公開前に行われるチェックでの拒否です。公開しようとしている変更は進化ルーブリックに照らして分類され、それに対して提示されたバージョンが、その分類が求めるより小さな段階になっています。たとえば、削除や範囲の縮小がパッチとして提示された場合です。必要以上にバージョンを上げることは常に受け入れられます。ここで停止するのは上げ幅が不足している場合です。

上記のルールとは異なり、このルールは慣例プラグインではなくここで判定されます。 どの上げ幅が提示されたかは公開の時点でしか分からず、その時点ではコンパイルは実行されていないため、分類と提示されたバージョンとの比較はその時点で行われます。

メッセージは次のように始まります:

the version bump being published is smaller than the evolution check’s classification of the change requires(公開しようとしているバージョンの上げ幅が、進化チェックによる変更の分類が求める幅より小さくなっています)

修正方法: 分類が求めるバージョンで公開します。どのバージョンかは診断に示されています。変更が分類よりも小さいと考える場合は、aggrega-lint.md の「The version-bump rubric」にあるルーブリックに、変更が各クラスに分類される条件が記載されています。エンティティの初回公開には前バージョンがないため、比較はスキップされ、合格ではなく未実施として報告されます。

インポートがソースの変換の途中で停止した

ビルドではなく、外部のソース記述をドラフトの作成用ファイルに変換する際の拒否です。インポーターが変換を停止するほど深刻な診断を報告したため、生成された結果は部分的です。ソースの一部はドラフトの作成用ファイルになり、一部はなりませんでした。

部分的な結果は意図されたものであり、壊れた残骸ではありません。 この条件が示すのは結果であって原因ではありません。変換できなかったものは、その横に報告される診断に、インポーターが引き継げなかった構成要素ごとに 1 つずつ、インポーター自身の言葉で示されます。この条件により、呼び出し側は「インポートが停止して答えの一部を生成した」場合と「インポートが完全に失敗した」場合とを区別できます。これらは異なる状況であり、次に取るべき手順も異なります。

メッセージは次のように始まります:

the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files(インポーターがインポートを停止させる診断を報告したため、ソースは完全にはドラフトの作成用ファイルに変換されませんでした)

修正方法: その横に報告された診断を読みます。各診断は、インポーターが変換できなかったソース内の構成要素を示しています。修正は、渡したソースを直すか、ドラフトを手作業で仕上げることで行います。インポートは編集の出発点を生成するものなので、変換で残らなかった構成要素は Aggrega 側で直接作成するものです。コマンドが何を生成し、どこに書き込むかは aggrega-import.md に記載されています。

More than one importer recognises the source(複数のインポーターがソースを認識しています)

ビルドではなく、外部のソース記述をドラフトのオーサリングファイルに変換する処理での拒否です。インポートでフォーマットが指定されていなかったため、インポーターが宣言するシグネチャからフォーマットが認識されました。対象はワークスペースのカタログにあるインポーターとコンパイラのコアインポーターの両方で、それぞれがソースを読む構文、適用されるファイル名、パース結果のツリーが持つべきパスまたは持ってはならないパスを示します。そして、複数のフォーマットに対応するインポーターのシグネチャがソースに一致しました。インポートはそれらの中から選びません。ソースがどのフォーマットであるかはコンパイラではなくインポーターが表明するものであり、選択すれば推測となって、本来対象でないかもしれないインポーターにソースを渡すことになるためです。

これは、一つのフォーマットを複数のインポーターが提示する場合とは異なります。そちらは上記の「A parse or import format is advertised by more than one plugin(パースまたはインポートのフォーマットが複数のプラグインによって提示されています)」で説明しています。そちらではフォーマットは確定しており、それに対応するインポーター同士が競合するため、plugins.importer エントリがその中から選びます。ここではフォーマット自体が異なるため、アタッチメントでは解決せず、フォーマットを指定することで解決します。ソースを認識したインポーターは、提示するすべてのフォーマットとしてそれを認識するため、複数のフォーマットを提示し、そのシグネチャの一つが一致したインポーターもここで拒否されます。

メッセージは次のように始まります:

more than one importer recognises the source

メッセージの残りの部分は、ソースと、それが認識されたすべてのフォーマットをインポーターの識別子とバージョンの順に示し、続いて対処法を示します:

more than one importer recognises the source (source "<source>", recognised as "<format>", "<format>"). Pass —format to name the one to read it as (for example —format <format> or —format <format>)

対処法: フォーマットを指定します。aggrega import では --format、アシスタントのインポートツールとセッションの aggrega/import メソッドでは format を使います。いずれかのインポーターがそのようなソースを決して認識すべきでない場合は、そのインポーターのシグネチャを変更します。シグネチャは作成者が describe() の自己報告で宣言し、生成時にその Plugin エンティティに記録されます。あるいは、それがワークスペースのカタログにあるものであれば、ワークスペースが読むカタログから除外します。コアインポーターは常に試行対象に含まれるため、コアインポーターの一つが別のインポーターと並んで認識するソースは、フォーマットを指定することで解決します。フォーマットの認識方法は aggrega-import.md で説明しています。

No importer recognises the source(ソースを認識するインポーターがありません)

ビルドではなく、外部のソース記述をドラフトのオーサリングファイルに変換する処理での拒否です。インポートでフォーマットが指定されていなかったため、インポーターが宣言するシグネチャ(ワークスペースのカタログにあるものとコンパイラのコアインポーターの両方)からフォーマットの認識が試みられましたが、どのフォーマットのシグネチャもソースに一致しませんでした。インポートは推測しません。その形を読むと宣言していないインポーターにソースを渡せば、本来対象でないかもしれないソースからドラフトを作ることになるためです。

これは上記の「More than one importer recognises the source(複数のインポーターがソースを認識しています)」と対になるものです。 そちらでは複数のフォーマットがソースを主張し、こちらではどれも主張しません。どちらの場合もフォーマットを指定すれば解決し、指定されるまで何も書き込まれません。

メッセージは次のように始まります:

no importer recognises the source

メッセージの残りの部分は、ソースを示し、続いて対処法と、カタログのインポーターが提示するすべてのフォーマットを読み込まれた順に示します:

no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>)

フォーマットを提示するインポーターが一つもない場合、対処法は例の代わりにその旨を示します。

ディレクトリには別の対処法が示されます。任意のフォーマットを指定しても助けにならないからです。 ディレクトリは、そのインポーターが宣言するファイルパターンを通じてのみ読み取られ、ファイルパターンを宣言しないシグネチャはディレクトリ内のどのファイルにも適用されません。そのため、たとえば Langflow のエクスポートを 1 つだけ含むディレクトリはどのシグネチャにも認識されず、langflow フォーマットを指定しても、今度は An importer that declares no file patterns is handed a directory(ファイルパターンを宣言しないインポーターにディレクトリが渡される) により拒否されます。したがって、ディレクトリに対する拒否はそれをディレクトリとして示し、そのファイルの 1 つを単独でインポートするか、ファイルパターンを宣言するインポーターのフォーマットを指定することを提案します。提示されるのはそれらのフォーマットだけで、インポーター自身の宣言から読み取られます:

no importer recognises the source (directory "<directory>"). Import one of the directory’s files on its own, or pass —format naming a format whose importer reads a directory through the file patterns it declares (for example —format <format> or —format <format>)(どのインポーターもソースを認識しません(ディレクトリ)。ディレクトリのファイルの 1 つを単独でインポートするか、宣言したファイルパターンを通じてディレクトリを読み取るインポーターのフォーマットを —format で指定してください(例:—format または —format))

どのインポーターもファイルパターンを宣言していない場合、拒否はディレクトリのファイルの 1 つを単独でインポートすることを提案し、カタログ内のどのインポーターも、ディレクトリを読み取るためのファイルパターンを宣言していないことを伝えます。

対処法: フォーマットを指定します。aggrega import では --format、アシスタントのインポートツールとセッションの aggrega/import メソッドでは format を使います。それぞれ、受け取るフィールドに合わせて拒否の文言を組み立て、この条件の短いコードで始めます。セッションの応答では、データにこの条件の両方のコードも含まれます。ディレクトリの場合は、意図した 1 つのファイルを単独でインポートするか(ファイルを指定しないシグネチャは、名前が何であれ、単独でインポートされたファイルに適用されます)、拒否に列挙されたフォーマットの 1 つを指定します。ソースが認識されるべきだった場合は、そのフォーマットに対応するインポーターのシグネチャを変更します。シグネチャは作成者が describe() の自己報告で宣言し、生成時にその Plugin エンティティに記録されます。フォーマットの認識方法は aggrega-import.md で説明しています。

An importer that declares no file patterns is handed a directory(ファイルパターンを宣言していないインポーターにディレクトリが渡されました)

ビルドではなく、外部のソース記述をドラフトのオーサリングファイルに変換する処理での拒否です。指定されたソースはディレクトリであり、ディレクトリはインポーターが宣言したファイルパターンで選ばれるファイルだけとしてインポーターに渡されます。つまり、ディレクトリのどのファイルを読むかはインポーター自身が表明するものです。ソースのフォーマットに対応するインポーターはファイルパターンを宣言していません。このインポーターは一つのファイルを読み、ディレクトリのどのファイルが対象かについては何も示しません。

何も開かれません。 インポートはインポーターが解決された時点で、ディレクトリのどのファイルも読む前に停止し、ディレクトリ内のすべてのファイルをインポーターに渡すことはしません。

メッセージは次のように始まります:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory

メッセージの残りの部分は、フォーマット、インポーター、指定されたとおりのディレクトリを示し、続いて対処法を示します:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (format "<format>", importer "importer/<name>", directory "<directory>"). Import one of the directory’s files on its own instead; the importer reads a directory once it declares the file patterns its files are named by

対処法: そのフォーマットのファイルを一つ単独でインポートします。インポーターがそのフォーマットのディレクトリを読めるようにするには、作成者がファイルの命名パターンを宣言します。これは describe() の自己報告にある認識シグネチャの files で、生成時にその Plugin エンティティに記録されます。ディレクトリのインポートで何が読まれるかは aggrega-import.md で説明しています。

No file in the directory matches the importer’s file patterns(ディレクトリ内にインポーターのファイルパターンに一致するファイルがありません)

ビルドではなく、外部のソース記述をドラフトのオーサリングファイルに変換する処理での拒否です。指定されたソースはディレクトリで、フォーマットは確定しており、それに対応するインポーターはファイルパターンを宣言していますが、ディレクトリ内のどの深さのファイルもそのいずれにも一致しません。ソースを一つも渡さなければ、インポーターは空のソースに対して、どのファイルが読まれたかではなく内容についての文言で失敗することになるため、インポートは何も読まずにここで停止します。

フォーマットが指定されたのではなく認識された場合、そのディレクトリを認識したシグネチャを持つインポーターはファイルの一つに一致しています。そのため、これが起こるのは実行されるインポーターがそれとは別のもの、つまり plugins.importer エントリが選択した同じフォーマットの別のインポーターか、その別バージョンである場合に限られます。

メッセージは次のように始まります:

no file in the directory matches the file patterns the importer serving the source’s format declares

メッセージの残りの部分は、フォーマット、インポーター、指定されたとおりのディレクトリ、インポーターが宣言するすべてのパターンを示し、続いて対処法を示します:

no file in the directory matches the file patterns the importer serving the source’s format declares (format "<format>", importer "importer/<name>", directory "<directory>", file patterns "<pattern>", "<pattern>"). Name a directory holding a file one of those patterns matches, or the format of an importer whose patterns match the files this directory holds

対処法: そのフォーマットのファイルを含むディレクトリをインポートします(パターンはディレクトリ内のファイルパスの末尾と照合されるため、どの深さのファイルも対象になります)。あるいは、ディレクトリのファイルのフォーマットを指定します。ディレクトリのインポートで何が読まれるかは aggrega-import.md で説明しています。

A file read from the directory and a file named in the importer’s with.sources have the same name(ディレクトリから読み込んだファイルと importer の with.sources で指定したファイルが同じ名前を持つ)

ビルドではなく、外部のソース記述をドラフトのオーサリングファイルに変換する際の拒否です。指定されたソースはディレクトリであり、そのファイルはそれぞれディレクトリ内のパスを名前とする名前付きソースとしてインポーターに渡されます。インポーターをアタッチする plugins.importer エントリは with.sources に独自のファイルを指定しており、それらもそれぞれのベース名を名前とする名前付きソースとしてインポーターに渡されます。そして、1 つの名前が両方に使われています。名前はインポーターがソースを互いに区別する手段であるため、両方を渡すと一方が他方を覆い隠し、どちらなのかを示すものがなくなります。そのため、インポートは何も渡さずに停止します。

メッセージは次のように始まります:

a file read from the directory and a file named in the importer’s with.sources have the same name

メッセージの残りの部分は、その名前と with.sources のファイルを示し、続いて対処法を示します:

a file read from the directory and a file named in the importer’s with.sources have the same name (name "<name>", the with.sources file "<path>"). Each source reaches the importer under one name, so rename one of the two files, or leave the file out of the importer’s with.sources

対処法: 2 つのファイルのいずれかの名前を変更するか、ディレクトリがすでにそのファイルを含んでいる場合は、エントリの with.sources からそのファイルを外します。with.sources のファイルはベース名を保持するため、衝突するのはディレクトリの最上位にある同名のファイルです。下位のディレクトリにあるファイルは、名前にそのディレクトリを含みます。エントリの with.sources については Which importer turns a source into drafts で説明しています。

An import’s target names a capability no Recipe in the catalog binds to(インポートのターゲットが、カタログ内のどの Recipe もバインドしていないケイパビリティを指定している)

ビルドではなく、外部のソース記述をドラフトのオーサリングファイルに変換する際の拒否です。インポートにはターゲット(aggrega import の --target、またはアシスタントのインポートツールとセッションの aggrega/import メソッドの target)が与えられており、ドラフトされた各コンポーネントタイプをそのプロバイダーの Recipe にマッピングする Manifest をドラフトします。ターゲットはプロバイダーのケイパビリティであり、ワークスペースのカタログ内の各 Recipe がバインドする spec.capability と照合されますが、指定されたものにバインドする Recipe はカタログ内にありません。それに対してドラフトされた Manifest は何もマッピングせず、問題はオプション自体(多くの場合はスペルミス)であるにもかかわらず、すべてのコンポーネントタイプがカタログに存在しないものとして扱われてしまいます。

何も実行されず、何も書き込まれません。 インポートはカタログが読み込まれた時点で、ソースの形式が認識される前、かつインポーターが実行される前に停止するため、ドライランの場合も含め、ドラフトは生成されず、ファイルも書き込まれません。

メッセージは次のように始まります:

no Recipe in the workspace’s catalog binds to the capability the import’s target names

メッセージの残りの部分は、指定されたとおりのターゲットと、カタログの Recipes が実際にバインドしているケイパビリティをそれぞれ 1 回ずつソート順で示し、続いて対処法を示します:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (target "<target>", the catalog’s Recipes bind to "<capability>", "<capability>"). Name one of those capabilities as the target, or leave the target out and no Manifest is drafted; nothing was drafted or written

カタログに Recipe が 1 つもない場合、メッセージは一覧の代わりにその旨を示し、対処法はそのプロバイダーの Recipe をカタログに追加することになります。

対処法: メッセージに列挙されたケイパビリティのいずれか(たとえば Recipe の spec.capability に書かれているとおりの compose や helm)を指定するか、ターゲットを省略します。省略した場合、Manifest はドラフトされません。意図したプロバイダーの Recipe がまだカタログにない場合は、先にワークスペースが読み取るカタログフォルダーにその Recipes を追加します。ターゲットを与えたインポートが何をドラフトするかについては aggrega-import.md で説明しています。

A child Release inherits a boundary directory that resolves where its parent writes(子 Release が、親の書き込み先に解決される boundary ディレクトリを継承している)

アドバイザリです。ある Release が別の Release を拡張し、そこから boundary の出力ディレクトリを継承していますが、そのディレクトリにはテンプレート変数が含まれていません。そのため両方で同じパスに解決され、子をビルドすると親をビルドしたときと同じ場所に書き込まれます。

ディレクトリの継承は誤りではなく、サポートされた形です。 ディレクトリはテンプレートであるため、親が一度書けば、パラメーターを満たす子は何も重複させずに別の場所へ解決できます。子が親の boundary トポロジーを再記述する必要がないのは、まさにこのためです。限定的ながら実在するのは、この診断が示す残りのケースです。変数が含まれていなければ、異なる解決をする余地が残りません。

これはビルドを停止させることはなく、それは慎重さによるものではなく、ルールの性質によるものです。 同じ解決済みパスへの書き込みは、作成者が正当に意図し得るものです(出力を比較するためにレンダリング用の Recipes だけを入れ替える子や、サイジングだけを変更する子など)。そのため、推論に基づいて停止するルールは、推測で正当な入力を拒否することになります。

メッセージは次のように始まります:

inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to

対処法: 2 つが異なる場所に書き込むことを意図していた場合は、ディレクトリにパラメーター参照を入れ、各 Release にそれを満たさせます。1 つのパスに書き込むことが意図どおりであれば、変更は不要です。アドバイザリは何が起こるかを伝えただけであり、いずれの場合もビルドは出力を生成します。

ビルドが出力した短いコードから停止を見つける

停止する診断の角括弧で囲まれた先頭部分は、失敗の原因となったカテゴリを示し、失敗がここに掲載されている条件のいずれかに該当する場合は、その条件の短いコードも示します。短いコードは文字 E と 4 桁の数字からなり、[CATALOG_ERROR E0209] のようになります。番号は一度割り当てられると固定されるため、レポートや検索に貼り付けた短いコードは、記録した時点で示していた条件を引き続き示します。条件が持つ残り 2 つの識別子と、3 つのうちどれをいつ使うかについては sentinels.md で説明しています。

条件自体のメッセージ行は、その条件を述べる固定の文で始まります。その文の後に続くものはすべて発生ごとに異なり、問題のあるドキュメント、記述されたキー、問題の値、その発生に対する助言が含まれます。上記の各エントリは、それぞれが説明する条件について全体の形を引用しています。固定の文は毎回同じ部分であり、そのため照合に使うべき部分となります。

以下の表は、このページを対象としてこの 2 つを対応付けています。ここに掲載されている各条件について、ビルドが出力する短いコードとメッセージ行の冒頭の文を、記述上の修正方法を説明する上記のエントリと並べています。エントリの見出しは正確に引用されているため、このページでその見出しを検索すると該当するエントリにたどり着きます。すべての条件の表では、ここにエントリがないものも含め、コンパイラが宣言するすべての条件について短いコードを引くことができます。

1 つのエントリが 2 つの短いコードに対応している場合、そのエントリは 2 つの異なる条件を扱っており、それぞれが独自の文を登録しています。ビルドがどちらを報告したかを見分けるには、共有の見出しではなく文を読んでください。

aggrega explain <code> は、この検索をターミナル上で行います。条件のいずれかのコードを受け取り、その条件を、それを説明する上記のエントリとともに出力します。詳しくは aggrega explain を参照してください。

短いコード冒頭の文説明している項目
E0001cliplugin: no plugin resolver configuredA command-line plugin runner was built without a way to find plugins(コマンドライン用プラグインランナーがプラグインを見つける手段なしで構築された)
E0003malformed attachment requirementMalformed attachment requirement(不正なアタッチ要件)
E0004annotation contribution overridden by an explicit value明示的な値がアノテーションの提供した値を置き換えた
E0005policy violationA governance plugin rejected the build(ガバナンスプラグインがビルドを拒否した)
E0006required attachment slot unfilledRequired attachment slot not bound(必須のアタッチメントスロットがバインドされていない)
E0007selector violationCross-node type safety violation via selector:(selector によるノード間の型安全性違反)
E0008attachment slot selector unsatisfiedThe Feature filling an attachment slot does not satisfy the slot’s selector(アタッチメントスロットを埋める Feature がスロットのセレクタを満たしていない)
E0009pipeline step typed-I/O contract violationA pipeline step’s typed input or output does not satisfy its declared contract(パイプラインステップの型付き入力または出力が宣言された契約を満たしていません)
E0010pipeline step failedA pipeline step failed(パイプラインステップが失敗しました)
E0011pipeline patch targets a document not present in the setA pipeline patch addresses a document the set does not hold, or one with no tree to address(パイプラインのパッチが、セットに存在しないドキュメント、または指定できるツリーを持たないドキュメントを指定しています)
E0012pipeline patch targets an opaque (non-structured) unitA pipeline patch addresses a document the set does not hold, or one with no tree to address(パイプラインのパッチが、セットに存在しないドキュメント、または指定できるツリーを持たないドキュメントを指定しています)
E0013feature type mismatch between Aggregate and ReleaseFeature type mismatch between Aggregate and Release(Aggregate と Release の間での Feature 型の不一致)
E0014inject entry carries both `value:` and `from:`; schema requires exactly oneAn inject: entry carries both a literal and a source key(inject: エントリがリテラルとソースキーの両方を持っています)
E0015uses-edge inject dictates a delivery mechanism the socket does not permit許可リストに何も含まないソケットで uses エッジが配信を指定している。ソケットの許可リストにない配信メカニズムを uses エッジが指定している
E0016jsonpatch: test operation failedパッチの test 操作がドキュメントと一致しなかった
E0017annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeysAn annotation-transform plugin names a component it was not given, or injects a value no annotation takes(アノテーション変換プラグインが、渡されていないコンポーネントを指定しているか、どのアノテーションも受け付けない値を注入している)
E0018policy attachment settings do not satisfy the plugin's declared settings schemaA governance attachment’s settings do not match the plugin’s declared schema(ガバナンスアタッチメントの設定がプラグインの宣言したスキーマに一致しない)
E0019endpoint requires form: referenceworkload: の form とその横のフィールドが一致しない
E0020schedule is not a valid cron expressionworkload の schedule: がチェックの受け付ける式ではない
E0021persistentTemplate volume requires form: statefulworkload: の form とその横のフィールドが一致しない
E0022pipeline PATCH target is not parseable structured YAML/JSONA pipeline step addresses documents the node does not have(パイプラインステップがノードの持たないドキュメントを指定している)
E0023form: reference requires an endpointworkload: の form とその横のフィールドが一致しない
E0024schedule requires form: scheduledworkload: の form とその横のフィールドが一致しない
E0025form: scheduled requires a scheduleworkload: の form とその横のフィールドが一致しない
E0026imported artifact content does not match the digest recorded for it in entity.lockAn imported artifact no longer matches the digest recorded beside its Recipe(インポートされたアーティファクトが、その Recipe の横に記録されたダイジェストと一致しなくなった)
E0027artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)A library $import: is not written in the bare-name form(ライブラリのインポートがベア名形式で書かれていない)
E0028artifacts output filename collision: two artifact outputs carry the same filename1 つの Recipe の 2 つのアーティファクト出力が同じファイル名を持っている
E0029artifact template references a pillar the Recipe does not declareAn artifacts: template reads a pillar the Recipe does not declare(artifacts テンプレートが Recipe の宣言していないピラーを読み取っています)
E0030artifact-library import references a bundle not present in the ArtifactLibraryライブラリの $import: が、カタログに存在しないライブラリまたはエントリを指定している
E0031artifact-library import references an ArtifactLibrary not present in the catalogライブラリの $import: が、カタログに存在しないライブラリまたはエントリを指定している
E0032assembled output collision: two contributors write the same output pathTwo contributors write the same output path(2 つの contributor が同じ出力パスに書き込む)
E0033assertion failedAn assertion stopped the build(アサーションがビルドを停止した)
E0034duplicate delivery key across attachment-inject and another inject sourceAn attachment delivers a key another inject source already claimed(アタッチメントが、別の inject ソースがすでに確保したキーを配信する)
E0035provider expected to assemble its dispatch group provides no boundary assemblerThe plugin serving a provider cannot assemble what that provider combines(プロバイダを提供するプラグインが、そのプロバイダが結合する出力をアセンブルできない)
E0036merged-path assembly has conflicting assembly-name annotation valuesChart-name mismatch on a merged helm-chart umbrella(マージされた helm-chart アンブレラでのチャート名の不一致)
E0037cross-boundary link between endpoints rendered by different providers is not supported接続が 2 つの異なるプロバイダーの組み立てられた出力の間をまたいでいる
E0038derived name collision: one name is derived more than once in one key spaceThe same name is derived more than once inside the output(出力内で同じ名前が複数回導出される)
E0039FeatureRecipe template references a per-component-only field with executionScope: boundaryFeatureRecipe template references a field outside its scope’s allowlist(FeatureRecipe テンプレートがスコープの許可リスト外のフィールドを参照している)
E0040library $import: carries a registry host; reference the library by bare-name identityライブラリの $import: が、レジストリの場所でライブラリを指定している
E0041multiple contributors share an instance ID at the same dispatch pathInstance-ID collision across boundaries assembling to the same path(同じパスにアセンブルされる boundary 間でのインスタンス ID の衝突)
E0042locals entry references a sibling defined later in the same blocklocals: entry references a sibling defined later in the same block (エントリが同じブロック内で後に定義される兄弟エントリを参照しています)
E0043template references a key the locals block does not declarelocals: key does not exist(locals のキーが存在しない)
E0044mapping-library import references an entry not present in the MappingLibraryライブラリの $import: が、カタログに存在しないライブラリまたはエントリを指定している
E0045valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)A library $import: is not written in the bare-name form(ライブラリのインポートがベア名形式で書かれていない)
E0046mapping-library import references a MappingLibrary not present in the catalogライブラリの $import: が、カタログに存在しないライブラリまたはエントリを指定している
E0047assembled output retains an unresolved cross-boundary link placeholderAssembled output still carries a cross-boundary placeholder(組み立てられた出力にバウンダリー間のプレースホルダーが残っている)
E0048dispatch path produced multiple provider outputsPath collision: two contributors emit at incompatible paths(パスの衝突:2 つのコントリビューターが互換性のないパスに出力している)
E0049path template references a field not in the documented allowlistPath-template references a variable outside the allowlist(パステンプレートが許可リスト外の変数を参照している)
E0050pipeline /host operation from a step with no host componentA pipeline step addresses documents the node does not have(パイプラインステップがノードの持たないドキュメントを指定している)
E0051pipeline PATCH targets an assembler provider's pre-assembly fragmentsA pipeline patch addresses output that has not been assembled yet(パイプラインパッチがまだ組み立てられていない出力を指定している)
E0052pipeline PATCH targets a document the node did not emitA pipeline step addresses documents the node does not have(パイプラインステップがノードの持たないドキュメントを指定している)
E0053pipeline plugin is not compatible with the rendering providerA pipeline step’s plugin does not claim the provider rendering what it addresses(パイプラインステップのプラグインが、指定先をレンダリングするプロバイダへの対応を表明していない)
E0054provider rejected node inputA provider refused a node’s input (プロバイダがノードの入力を拒否しました)
E0055Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declaresA Recipe or FeatureRecipe does not publish a provides key its contract declares(Recipe または FeatureRecipe が、コントラクトで宣言されたキーを公開していない)
E0056provides template evaluation failedA provides: template could not be evaluated(provides テンプレートを評価できませんでした)
E0057provides block references a root outside the self-contained setprovides: template references a non-self-contained root (テンプレートが自己完結していないルートを参照しています)
E0058provider render is not deterministicA provider rendered the same input twice and produced different output (プロバイダが同じ入力を 2 回レンダリングし、異なる出力を生成しました)
E0059duplicate delivery key across self-inject and uses-injectDuplicate delivery key across inject sources(inject ソース間での配信キーの重複)
E0060template references a root the render context does not defineTemplate references a root the render context does not define(テンプレートがレンダーコンテキストで定義されていないルートを参照している); Self-inject value template references cross-node data(Self-inject の値テンプレートがノード間のデータを参照している)
E0061unknown providerUnknown provider(不明なプロバイダー)
E0062custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMappingA component declares an inject mechanism the attached Feature maps nothing to(コンポーネントが宣言したインジェクトメカニズムに、アタッチされた Feature が何もマッピングしていない)
E0063workload-library import references an entry not present in the WorkloadLibraryライブラリの $import: が、カタログに存在しないライブラリまたはエントリを指定している
E0064workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)A library $import: is not written in the bare-name form(ライブラリのインポートがベア名形式で書かれていない)
E0065workload-library import references a WorkloadLibrary not present in the catalogライブラリの $import: が、カタログに存在しないライブラリまたはエントリを指定している
E0066uses edge target does not existDangling uses target(存在しない uses ターゲット)
E0067active toggle did not resolve to a booleanAn active: toggle does not resolve to true or false(トグルが true または false に解決されない)
E0068max sub-aggregate nesting depth exceededSub-aggregate nesting depth exceeded(サブアグリゲートのネストの深さの上限を超過)
E0069mutator patch rejectedA label-transform plugin’s patch reaches outside node labels(label-transform プラグインのパッチがノードラベルの外に及んでいる)
E0070re-exported component alias forms a cycleA re-published component alias points back at itself(再公開されたコンポーネントのエイリアスが自身を指している)
E0071release edge retargets a developer-declared edgeRelease retargets a developer-declared edge(Release が開発者の宣言したエッジの接続先を変更している)
E0072sub-aggregate load failedA module a composition imports cannot be loaded, or imports itself(コンポジションがインポートするモジュールを読み込めない、またはモジュールが自身をインポートしている)
E0073flattened node ID collision: rename one of the colliding instances so their flattened IDs differTwo instances flatten to one identifier(2 つのインスタンスが平坦化されて 1 つの識別子になる)
E0074release per-edge configuration has no edge to apply toRelease per-edge configuration has no edge to apply to(Release のエッジ単位の設定に適用先のエッジがない)
E0075aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)An Aggregate reached graph building without being normalised(Aggregate が正規化されずにグラフ構築に到達した)
E0076sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`A sub-module’s components are placed in no boundary(サブモジュールのコンポーネントがどの境界にも配置されていない)
E0077uses edge target was pruned because its active toggle resolved to falseA uses edge targets a component an active: toggle removed(トグルによって除去されたコンポーネントをエッジが指している)
E0078producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption callA plugin asks the host to parse a source while a parse is already running for it(プラグインが、自身のためのパースがすでに実行中であるのに、ホストにソースのパースを依頼する)
E0079wasm: recorded command mirror does not match plugin describe()A Plugin entity’s recorded command set does not match the plugin(Plugin エンティティに記録されたコマンドセットがプラグインと一致しない)
E0080wasm: entity contract claim does not match plugin describe()A Plugin entity’s claims disagree with the plugin’s own self-report(Plugin エンティティの主張がプラグイン自身の自己申告と一致しない)
E0081wasm: guest plugin returned a diagnostic whose severity the contract does not declareA plugin returned a diagnostic at a severity that is not declared(プラグインが、宣言されていない重大度の診断を返しました)
E0082wasm: guest plugin reported an errorA plugin failed while it was running(プラグインが実行中に失敗しました)
E0083wasm: guest plugin panicked during callA plugin failed while it was running(プラグインが実行中に失敗しました)
E0084wasm: stamped host-function record does not match .wasm importsA Plugin entity’s recorded host functions do not match the binary(Plugin エンティティに記録されたホスト関数がバイナリと一致しません)
E0085wasm: plugin rejected by the sandboxThe sandbox refused a plugin(サンドボックスがプラグインを拒否しました)
E0086wasm: plugin invoked proc_exitA plugin failed while it was running(プラグインが実行中に失敗しました)
E0087wasm: declared plugin type does not match plugin describe()A plugin is not the kind of plugin the socket expects(プラグインがソケットの想定する種類のプラグインではありません)
E0088wasm: entity metadata.version does not match plugin describe()A Plugin entity’s recorded version does not match the plugin(Plugin エンティティに記録されたバージョンがプラグインと一致しない)
E0089every published version this reference could select has been withdrawnEvery version a reference could select has been withdrawn(参照が選択し得るすべてのバージョンが取り下げられている)
E0090format is advertised by more than one importer pluginA parse or import format is advertised by more than one plugin(parse または import 形式が複数のプラグインによって公開されている)
E0091format is advertised by more than one parser pluginA parse or import format is advertised by more than one plugin(parse または import 形式が複数のプラグインによって公開されている)
E0092capability is served by more than one provider plugin; add a plugins.providers entry to select oneA capability is served by more than one provider plugin(ケイパビリティが複数のプロバイダープラグインによって提供されている)
E0093manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguousA Manifest maps two version-distinct keys onto one type(Manifest がバージョンの異なる 2 つのキーを 1 つの型にマッピングしている)
E0094duplicate entity identity within a single catalog directoryTwo catalog entities in one directory share an identity(1 つのディレクトリ内の 2 つのカタログエンティティが同じアイデンティティを共有している)
E0095malformed recipe reference in a Manifest mapping valueManifest mapping value is not a shape a recipe reference accepts(Manifest のマッピング値がレシピ参照で受け付けられる形になっていない)
E0096manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type keyRecipe implements does not match the mapped component type(Recipe の implements がマッピングされたコンポーネントタイプと一致しない)
E0097no importer plugin advertises the requested formatNo plugin advertises a requested parse or import format(要求された parse または import 形式を公開するプラグインがない)
E0098no parser plugin advertises the requested formatNo plugin advertises a requested parse or import format(要求された parse または import 形式を公開するプラグインがない)
E0099no recipe resolved for component/feature instance: add an explicit Manifest mapping for its typeNo Recipe is mapped for a component or feature instance(コンポーネントまたはフィーチャーのインスタンスに Recipe がマッピングされていない)
E0100plugins.providers entry names a plugin no provider-rendering plugin serving the capability matchesA plugins.providers binding names a plugin that does not serve the capability(プロバイダーのバインディングが、その capability を提供しないプラグインを指定しています)
E0101no provider-rendering plugin version satisfies the recipe's provider version pinNo provider plugin version satisfies a Recipe’s provider pin(Recipe の provider ピンを満たす provider プラグインのバージョンがない)
E0102wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact pathプラグイン参照がレジストリホストまたはアーティファクトパスを含んでいる
E0103no catalog version satisfies the referenced version constraintNo catalog version satisfies a version constraint(バージョン制約を満たすカタログバージョンがない)
E0104wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI locationプラグインまたはレシピの参照がスコープを含んでいない
E0105recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI locationプラグインまたはレシピの参照がスコープを含んでいない
E0106resolve: invalid library reference URIA library reference is not written in the identity form(ライブラリ参照が識別子形式で書かれていない)
E0107resolve: minimal version selection conflict — incompatible library version requirementsTwo consumers of one library require incompatible versions(1 つのライブラリの 2 つの利用者が互換性のないバージョンを要求している)
E0108resolve: catalog lookup cannot load resolved sub-aggregate bodiesThe catalog view a build was given cannot load the bodies pinning needs(ビルドに与えられたカタログビューがピン留めに必要な本体を読み込めない)
E0109resolve: catalog lookup cannot load resolved recipe and plugin bodiesThe catalog view a build was given cannot load the bodies pinning needs(ビルドに与えられたカタログビューがピン留めに必要な本体を読み込めない)
E0110resolve: source-template evaluation failure at lock timeResolving a source: coordinate registers a narrower function set (source: 座標の解決では、より狭い関数セットが登録されます)
E0111resolve: source-template parse errorResolving a source: coordinate registers a narrower function set (source: 座標の解決では、より狭い関数セットが登録されます)
E0112resolve: source-template references .provides (invalid reverse reference)Resolving a source: coordinate registers a narrower function set (source: 座標の解決では、より狭い関数セットが登録されます)
E0113resolve: sub-aggregate inclusion depth exceededThe chain of module imports is deeper than the pin walk descends(モジュールのインポートの連鎖がピン留めの走査の深さを超えている)
E0114resolve: no entity in the catalog matches this URIA reference names no entity the catalog holds(参照がカタログ内のどのエンティティも指していない)
E0115compactform: ambiguous dispatch — $mode requiredA compact-form schema declares a field literally named type(コンパクト形式のスキーマが、文字どおり type という名前のフィールドを宣言している)
E0116compactform: constraint not valid for declared typeA compact-form constraint does not apply to the type it was written on(コンパクト形式の制約が、書かれた型に適用されない)
E0117compactform: $jsonschema content invalidA $jsonschema: escape carries content that is not a schema($jsonschema: エスケープがスキーマではない内容を持っている)
E0118compactform: cross-document $ref carries a registry host; reference the library by identityA $ref: addresses a library by registry location($ref: がレジストリの場所でライブラリを指定している)
E0119compactform: $ref unresolvableA $ref: is not written in a form the compiler can resolve($ref: がコンパイラで解決できる形式で書かれていない)
E0120compactform: unknown keywordA compact-form schema uses a keyword the compact form does not know(コンパクト形式のスキーマが、コンパクト形式の知らないキーワードを使用している)
E0121compactform: cross-document $ref target not foundA $ref: is not written in a form the compiler can resolve($ref: がコンパイラで解決できる形式で書かれていない)
E0122deprecation: build consumes a deprecated entityThe build consumes an artifact its publisher has deprecated(ビルドが、公開元によって非推奨とされたアーティファクトを使用している)
E0123docscache: artifact is not a documentation bundleA resolved artifact is not a documentation bundle(解決されたアーティファクトがドキュメントバンドルではない)
E0124docscache: page not found in documentation bundleA page is absent from a documentation bundle(ドキュメントバンドルにページが存在しない)
E0125egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cacheThe workspace is offline and the step needs the network(ワークスペースがオフラインで、ステップにネットワークが必要)
E0126externalinputs: acquisition is disabled for unpinned inputsA render requests an external input the lockfile does not pin (レンダリングがロックファイルでピン留めされていない外部入力を要求している)
E0127externalinputs: fetched bytes mismatch the pinned digestFetched bytes do not match a pinned digest (取得したバイトがピン留めされたダイジェストと一致しない)
E0128externalinputs: URL scheme is not allowedAn external input’s URL uses a scheme that is not allowed (外部入力の URL が許可されていないスキームを使用している)
E0129externalinputs: store blob mismatches its pinned recordA stored external input no longer matches its record (保存された外部入力がその記録と一致しなくなった)
E0130lockfile: out of date; it no longer matches what its Release resolves toThe lockfile no longer matches what the release resolves to(lockfile が、release の解決結果と一致しなくなっています)
E0131lockfile: file failed schema validationThe lockfile does not satisfy its schema(lockfile がそのスキーマを満たしていない)
E0132oci: manifest has multiple layers of the expected content media typeA manifest carries no layer of the expected kind, or more than one(マニフェストに期待される種類のレイヤーがない、または複数ある)
E0133oci: cached manifest digest mismatchFetched or cached bytes do not match the digest committed for them(取得またはキャッシュされたバイトが、それに対してコミットされたダイジェストと一致しない)
E0135oci: content digest mismatchFetched or cached bytes do not match the digest committed for them(取得またはキャッシュされたバイトが、それに対してコミットされたダイジェストと一致しない)
E0136oci: network unreachableThe registry could not be reached(レジストリに到達できませんでした)
E0137oci: artifact not found at remote sourceAn artifact is not at the source the build was told to find it(ビルドが探すよう指示されたソースにアーティファクトがありません)
E0138oci: authentication required or failedThe registry will not serve an artifact without credentials it accepts(レジストリは受け入れ可能な認証情報なしにはアーティファクトを提供しません)
E0139oci: tag already published with different contentA tag is already published with different content(タグが異なる内容ですでに公開されている)
E0140oci: manifest has no layer of the expected content media typeA manifest carries no layer of the expected kind, or more than one(マニフェストに期待される種類のレイヤーがない、または複数ある)
E0141oci: distinct catalog identities map to the same OCI repository locationTwo catalog identities publish to one repository location(2 つのカタログ ID が 1 つのリポジトリ位置に公開される)
E0142oci: referrer discovery could not be completedThe registry could not answer what is attached to an artifact(アーティファクトに何が添付されているかにレジストリが応答できなかった)
E0143oci: unknown entity kind for mediatype dispatchAn entity kind has no artifact media type(エンティティの種類にアーティファクトのメディアタイプがない)
E0144cached signature bundle does not match its recorded digestA cached signature bundle does not match the digest recorded for it(キャッシュされた署名バンドルが記録されたダイジェストと一致しない)
E0145plugin reference is not a Plugin entityA plugin reference is not a Plugin entity(プラグイン参照が Plugin エンティティではない)
E0146circular reference expansionA library reference expands into itself(ライブラリ参照が自分自身に展開される)
E0147registrytrust: advertised trust config is malformedA registry serves a trust document that cannot be read as one(レジストリが信頼ドキュメントとして読み取れない信頼ドキュメントを提供している)
E0148registrytrust: registry advertises no trust configA registry publishes no trust document(レジストリが信頼ドキュメントを公開していない)
E0149attachment name is a near miss for a declared slotアタッチメント名が宣言済みスロットから 1 編集の距離にある
E0150attachment does not conform to its declared slot shapeAttachment does not conform to its declared slot shape(アタッチメントが宣言されたスロットの形状に適合しません)
E0151component declared in more than one boundary: declare each component in exactly one boundaryA component is placed in more than one boundary(コンポーネントが複数のバウンダリに配置されている)
E0152duplicate Aggregate/Manifest identity (metadata.name) in the Release directoryThe Release directory declares one Aggregate or Manifest twice(Release ディレクトリで 1 つの Aggregate または Manifest が 2 回宣言されている)
E0153feature merge conflict: reconcile the Aggregate and Release declarations for the featureA feature attached by both the Aggregate and the Release cannot be merged(Aggregate と Release の両方でアタッチされたフィーチャーをマージできない)
E0154the compiler's own views of the catalog disagreeA guard needs a catalog entity the build resolved and cannot see (ガードが、ビルドが解決したのに参照できないカタログエンティティを必要としている)
E0155duplicate delivery key across inject sourcesDuplicate delivery key across inject sources(inject ソース間での配信キーの重複)
E0156invalid inject key: the from-key must name a provides key its source publishesInject from key is not in the target’s provides(Inject の from キーがターゲットの provides にありません)
E0158invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go templateA {{ .parameters.* }} reference cannot be interpolated (このパラメータ参照を補間できない)
E0160manifest annotation bindings collide on same Feature path+pillarTwo Manifest annotation bindings compete for one routing slot(2 つの Manifest アノテーションバインディングが 1 つのルーティングスロットを奪い合う)
E0161manifest annotation binding uses reserved prefixA Manifest annotation binding claims the reserved aggrega.ai/ prefix(Manifest のアノテーションバインディングが予約済みのプレフィックスを使用しています)
E0162missing required feature: attach a Feature of the required type to the componentRequired feature not attached(必須の feature がアタッチされていません)
E0163required uses socket not populatedRequired uses: socket not populated(必須の uses ソケットが設定されていません)
E0164parameter contract violatedParameter type mismatch / contract violation(パラメータの型の不一致/契約違反)
E0165required parameter not suppliedParameter type mismatch / contract violation(パラメータの型の不一致/契約違反)
E0167Recipe publishes a provides key its Component does not declareRecipe が、その Component が宣言していない provides キーを公開している
E0168authored pillar does not conform to its declared schemaAuthored values or infra do not conform to the declared schema(記述された values または infra が宣言されたスキーマに適合しない)
E0169self-inject on component without spec.inject allowlistSelf-inject on a component without an allowlist(許可リストを持たないコンポーネントでのセルフインジェクト); Self-inject mechanism not in the component’s allowlist(セルフインジェクトのメカニズムがコンポーネントの許可リストにない)
E0170aggregate/manifest reference unresolvableA Release’s aggregate: or manifest: reference resolves to nothing (Release の参照が何にも解決されない)
E0171unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declareuses: socket not declared in the owning entity’s usesSchema(ソケットが所有エンティティの usesSchema で宣言されていない)
E0172release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)A Release reached resolution without passing through the load path(Release がロードパスを経由せずに解決に到達した)
E0173declared parameter is read by no reference in the Aggregate宣言されたパラメータがどこからも読み取られない
E0174uses socket name is a near miss for a declared socketuses: のソケット名が宣言済みソケットから 1 編集の距離にある
E0175file load failed: the file could not be read, or its bytes did not parseA file cannot be read, or its bytes do not parse(ファイルを読み取れないか、そのバイト列を解析できない)
E0176signing: keyless signing requires a live identity provider, Fulcio, and RekorKeyless signing was asked for without the services it needs(キーレス署名が、必要なサービスなしで要求された)
E0177signing: no signature found for an artifact that requires oneAn artifact that must be signed carries no signature(署名が必須のアーティファクトに署名がありません)
E0178signing: keyless verification requires at least one trusted identityA keyless trust policy names no acceptable signer(キーレス信頼ポリシーが受け入れ可能な署名者を 1 つも指定していない)
E0179signing: signature does not verifyA detached signature does not verify against the key supplied(分離署名が指定された鍵で検証されない)
E0180signing: signature bundle does not verifyA signature does not verify(署名が検証されません)
E0181signing: signing policy requires a signature for this artifact kind; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature(署名のない公開が、署名を必要とするレジストリまたはポリシーを対象にしている)
E0182signing: cannot load pinned trust rootThe pinned trust root cannot be read(ピン留めされたトラストルートを読み込めない)
E0183signing: registry requires signatures; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature(署名のない公開が、署名を必要とするレジストリまたはポリシーを対象にしている)
E0184signing: unsupported held-key typeA pinned verification key is not the key profile the verifier accepts(ピン留めされた検証キーが検証器の受け入れるキープロファイルではない)
E0185signing: signature identity is not trusted for this registryA signature verifies but its signer is not one the registry trusts(署名は検証されますが、その署名者はレジストリが信頼するものではありません)
E0186no source adapter serves the source kindRecipe の source: が、取得方法を誰も知らない種類を指定している
E0187cacheslot: empty workspaceRootA source artifact is cached without a workspace root to anchor it(ソースアーティファクトが、基点となるワークスペースルートなしでキャッシュされようとしている)
E0188artifacts entry: shape must be a string scalar or {$import: <local-path>}An inline-or-import field is written in neither shape(インラインまたはインポートのフィールドがどちらの形にもなっていない)
E0189artifactlibrary: entry must be a mapping of filename to a string bodyA library entry’s body is not the shape that library holds(ライブラリエントリの本体がそのライブラリの保持する形になっていない)
E0190schemalibrary: forbidden JSON Schema keywordA schema uses a JSON Schema keyword the library does not admit(スキーマがライブラリで許可されていない JSON Schema キーワードを使用している)
E0191mappinglibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds(ライブラリエントリの本体がそのライブラリの保持する形になっていない)
E0192a document nests too many levels deepA document nests deeper than the reader will descend(ドキュメントのネストがリーダーの降りる深さを超えている)
E0193parameters: shape must be an inline object or {$import: <local-path>}A Release’s parameters: block is written in neither of its two shapes(Release の parameters: ブロックが 2 つの形のどちらでも書かれていない)
E0194schemalibrary: template not foundA $instantiate: reference cannot be resolved(インスタンス化の参照を解決できない)
E0195schemalibrary: template parameter missingA $instantiate: reference cannot be resolved(インスタンス化の参照を解決できない)
E0196schemalibrary: template parameter type mismatchA $instantiate: reference cannot be resolved(インスタンス化の参照を解決できない)
E0197valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape(インラインまたはインポートのフィールドがどちらの形にもなっていない)
E0198wellKnownAnnotations: a key is declared at a scope the provider's contract does not renderA provider declares a well-known annotation at a scope it does not render(プロバイダが、レンダリングしないスコープで既知のアノテーションを宣言している)
E0199workloadlibrary: entry body must be a string scalarA library entry’s body is not the shape that library holds(ライブラリエントリの本体がそのライブラリの保持する形になっていない)
E0200workload: shape must be a string scalar or {$import: <path-or-library-identity>}An inline-or-import field is written in neither shape(インラインまたはインポートのフィールドがどちらの形にもなっていない)
E0201assertion name declared twice across the extends chainextends: チェーン上でアサーション名が二重に宣言されている
E0202cyclic extends chainCyclic extends chain(循環する extends チェーン); Cyclic extends on Components or Features(Components または Features での循環する extends)
E0204FeatureRecipe: valuesMapping requires sourceA FeatureRecipe’s valuesMapping requires source(FeatureRecipe の valuesMapping には source が必要です)
E0205inheritance merge failedextends: チェーンを組み立てられない
E0207recipe output-component-labels constraint: key is also declared in outputLabelsA promoted component label is also declared literally(昇格された component ラベルがリテラルとしても宣言されている)
E0208recipe output-labels constraint: key uses a reserved namespaceAn output-label key uses a reserved namespace(出力ラベルのキーが予約済みの名前空間を使用している)
E0209Recipe: valuesMapping requires sourcevaluesMapping requires source(valuesMapping には source が必要です)
E0210Recipe: at least one input kind requiredAt least one input kind must be present (少なくとも 1 つの入力種別が必要です)
E0211filename collision across input kinds: two input-kind blocks produced a file under one output nameEmission-time filename collision across input kinds(出力時の入力種別間でのファイル名衝突)
E0212workload attachment slot is not referenceableA Workload references a slot whose fill publishes no locator(Workload が、充填がロケーターを公開していないスロットを参照している)
E0213workload featuresSchema cross-check failedA Workload attachment names a slot the entity does not declare, or a delivery the slot forbids(Workload のアタッチメントが、エンティティが宣言していないスロット、またはスロットが禁止している配信方法を指定している)
E0214workload validation failedWorkload が Workload スキーマを満たしていない
E0215document envelope validation failedYAML anchor aliased inside its own content(YAML アンカーが自身の内容の中でエイリアス参照されている); Divergent Release (extends + aggregate pointer)(分岐した Release(extends と aggregate ポインタの併用))
E0216validator/jsonschema: x-aggrega extension evaluation failedx-aggrega-when: または x-aggrega-validate: の述語を評価できない
E0218validator/jsonschema: schema resolution failedA declared schema cannot be resolved(宣言されたスキーマを解決できない)
E0220extends chain exceeds maximum depthextends: チェーンが深さの上限を超える
E0221merger: invalid merge inputスキーママージステップ自身の入力ガード
E0222registry alias matches more than one hostA registry alias matches more than one host(レジストリのエイリアスが複数のホストに一致する)
E0223a cross-cutting socket is bound by capability but attaches by uriA plugin binding sets a key the socket it attaches to does not read(プラグインのバインディングが、接続先のソケットが読み取らないキーを設定している)
E0224workspace configuration is invalidThe workspace configuration is invalid(ワークスペース設定が無効です)
E0225capability is bound to more than one provider pluginA capability is bound to more than one provider plugin(1 つの capability が複数のプロバイダープラグインにバインドされている)
E0226registry alias is already used by another hostA registry alias is already bound to another host(レジストリのエイリアスが既に別のホストに割り当てられている)
E0227a governance attachment declares no role or an unknown roleA governance attachment declares no role, or one that is not a known role(governance のアタッチメントがロールを宣言していない、または既知のロールではないロールを宣言している)
E0228a provider socket binding sets a field with no referent on that socketA plugin binding sets a key the socket it attaches to does not read(プラグインのバインディングが、接続先のソケットが読み取らないキーを設定している)
E0229position out of rangeエディタの位置がドキュメントの範囲外にある
E0246the digest recorded as trusted for this plugin does not match the digest its cached manifest reportsA trusted plugin’s recorded digest disagrees with the cached artifact(信頼済みプラグインの記録されたダイジェストがキャッシュ済みアーティファクトと一致しない)
E0247a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict roleA plugin recorded as a trusted gate is no longer attached(信頼されたゲートとして記録されたプラグインがアタッチされなくなっている)
E0248wasm: guest plugin returned an output that is not the shape the socket readsA plugin returned something that is not the shape the socket reads(プラグインが、ソケットが読み取る形でないものを返しました)
E0250provider named a directory for each contributor's own sub-directory that is not a single directory nameA provider named a directory for a contributor that is not one directory(プロバイダーがコントリビューター用に指定したディレクトリが単一のディレクトリではない)
E0251recipe source is an empty string, which names neither sourceless mode nor sourced modeRecipe の source: が空文字列である
E0252artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested underAn ArtifactLibrary bundle file names no file of its own under the key it was imported at(ArtifactLibrary のバンドルファイルが、インポートされたキーの下に固有のファイルを指定していない)
E0253annotation binding does not resolve against its target FeatureAnnotation binding does not resolve against its target Feature(アノテーションバインディングが対象の Feature に対して解決されない)
E0254annotation subkey does not conform to the target Feature's schema at the routed pillarA bound annotation value does not conform to the target Feature’s schema(バインドされたアノテーション値が対象 Feature のスキーマに適合しない)
E0255annotation routes through a pillar its authoring side may not useAn annotation routes through a pillar its authoring side may not use(アノテーションが、記述側が使用できない pillar を経由してルーティングされる)
E0256annotation binding declares one path in both pillar listsアノテーションバインディングが 1 つのパスを両方のピラーリストで宣言している
E0257declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validationA declared schema contract cannot be read as a schema(宣言されたスキーマ契約をスキーマとして読み取れない)
E0259attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares itA boundary-scope Feature is attached only to a component(バウンダリースコープの Feature がコンポーネントにのみアタッチされている)
E0260component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`A component the composition holds is placed in no boundary(コンポジションに含まれるコンポーネントがどのバウンダリにも配置されていない)
E0261boundary names a component the composition does not hold: correct the name, or remove the entryA boundary names a component the composition does not hold(境界がコンポジションに存在しないコンポーネントを指定している)
E0262component identity cannot be the name its emitted resources are stamped with: rename the componentComponent identity cannot be stamped on what it emits(コンポーネントの識別子を、それが出力するものに刻印できません)
E0263the target will not accept a name derived from this component's authored identity: rename the componentThe target will not accept a name derived from an authored identity(ターゲットが、作成された識別子から派生した名前を受け付けない)
E0264provider guest never accepted a component identity the compiler composed for itA provider never accepted a name the compiler composed(provider が、コンパイラの合成した名前を一度も受け付けなかった)
E0265provider does not support the node's input kindworkload: requires a provider that can synthesize(workload: には合成が可能な provider が必要です)
E0266a schema `$import:` could not be appliedA schema $import: cannot be applied(スキーマのインポートを適用できない)
E0267a schema block declares a key that names no data pillarA schema block names a key that is not a data pillar(スキーマブロックがデータピラーではないキーを指定している)
E0268reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokensA provider’s reassembly is handed a unit its own carve never produced(provider の再組み立てに、自身の分割が生成していない単位が渡された)
E0269provider guest returned two output files under one path; a conforming guest returns each output path at most onceA provider returned two output files under one path(プロバイダーが 1 つのパスに 2 つの出力ファイルを返しました)
E0270link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returnedA provider’s link wiring names an output file that was never emitted(provider のリンク配線が出力されなかった出力ファイルを指定している)
E0271emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and contentA pipeline step’s file emission carries no file(パイプラインステップのファイル出力にファイルが含まれていない)
E0272side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crdA pipeline step declares an emission kind the contract does not define(パイプラインステップが契約で定義されていない出力の種類を宣言している)
E0273template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider suppliesA template reads a rendered name the node’s provider does not report(テンプレートが、ノードの provider が報告しないレンダリング名を読み取っている)
E0274the plugin identity recorded as trusted no longer matches what this resolution reportsA gate recorded as trusted resolves to a different identity(信頼済みとして記録されたゲートが別の同一性に解決される)
E0275the edit was refused because the resulting document would not be valid, and nothing was writtenAn edit would produce a document its schema refuses(編集によってスキーマが拒否するドキュメントが生成される)
E0276the version being published changes the published predecessor in a way the documented evolution rubric objects to公開しようとしている変更が進化ルーブリックの許容範囲を破る
E0277an annotation key on the entity uses a prefix the platform reservesAn annotation key uses a prefix the platform reserves(アノテーションキーがプラットフォームの予約済みプレフィックスを使用している)
E0278the entity's name does not follow the documented name shape for its kindAn entity’s name does not follow the shape its kind expects(エンティティの名前が、その種類が想定する形式に従っていない)
E0279a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot followA schema uses a dynamic reference that cannot be resolved ahead of time(スキーマが事前に解決できない動的参照を使用している)
E0280a schema in the entity declares an identifier of its own, where the platform owns that schema's identityA schema declares an identifier the platform owns(スキーマがプラットフォームの所有する識別子を宣言している)
E0281the entity's category label does not match the category directory the entity is filed underA Component’s category label and its directory name different categories(Component のカテゴリラベルとディレクトリが異なるカテゴリを示している)
E0282the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchemaA schema extension is written directly into schema content(スキーマ拡張がスキーマの内容に直接書かれている)
E0283the Plugin entity declares no runtime resource cap of its own, so the platform defaults applyA Plugin pins neither runtime cap, so the platform’s own apply(Plugin がどちらのランタイム上限も固定していないため、プラットフォーム自身の上限が適用される)
E0284an attachment slot admits only secret material and does not declare that it handles itAn attachment slot admits only secret material without saying it handles it(アタッチメントスロットが、扱うことを示さずにシークレットのみを受け入れている)
E0285the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refusedA Recipe publishes a provides key its Component does not declare, checked at publication(Recipe が、その Component が宣言していない provides キーを公開している、公開時のチェック)
E0286the version bump being published is smaller than the evolution check's classification of the change requires提示されたバージョンの上げ幅が変更に必要な幅より小さい
E0287the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring filesインポートがソースの変換の途中で停止した
E0288a plugin has no expression for a construct this build declaresA workload declares a form compose cannot express(workload が compose で表現できない形式を宣言している); A container declares a field compose has no primitive for(コンテナが compose にプリミティブのないフィールドを宣言している); An omits entry names a kind or a namespace a compose file does not have(omits エントリが compose ファイルにない種類または名前空間を指定している); An omits entry names a namespace a CloudFormation template does not have(omits エントリが CloudFormation テンプレートにない名前空間を指定している); A rule reads a bound CloudFormation parameter by name(ルールがバインドされた CloudFormation パラメータを名前で読み取っている); The assembled CloudFormation stack cannot carry a transform(組み立てられた CloudFormation スタックが transform を持てない)
E0289a plugin could not resolve something it requires to exactly one valueA health probe cannot be turned into a compose healthcheck(ヘルスプローブを compose の healthcheck に変換できない); A configmap volume has no file behind it(configmap ボリュームの背後にファイルがない); What an omits entry left out is still named by the compose file(omits エントリが除外したものを compose ファイルがまだ参照している); What an omits entry left out is still named by a CloudFormation template(omits エントリが除外したものを CloudFormation テンプレートがまだ参照している); A valuesMapping key names no parameter of a sourced CloudFormation template(valuesMapping のキーが、ソースとなる CloudFormation テンプレートのどのパラメータも指定していない); Another component references a CloudFormation parameter a sourced template’s binding filled(別のコンポーネントが、ソースとなるテンプレートのバインディングが埋めた CloudFormation パラメータを参照している); Two components order one pair of transforms oppositely(2 つのコンポーネントが 1 組の transform を逆の順序で指定している); A cross-boundary reference has no consuming stack to be written into(バウンダリをまたぐ参照に、書き込み先となる利用側スタックがない); A synthesized StatefulSet has no single service to govern it(合成された StatefulSet を管理する単一のサービスがない)
E0290two things a plugin produced occupy one name in its outputAn authored export name is one the build derives for a cross-stack reference(記述されたエクスポート名が、ビルドがスタック間参照のために導出する名前と同じである); The output a cross-stack reference publishes on already carries an Export(スタック間参照が公開に使う出力にすでに Export が付いている); Two entries reach one stack output name(2 つのエントリが 1 つのスタック出力名に到達する); A CloudFormation fragment writes one key twice(CloudFormation フラグメントが 1 つのキーを 2 回書き込んでいる); Two rendered resources land at one output file(レンダリングされた 2 つのリソースが 1 つの出力ファイルに配置される)
E0291a plugin has no representation for a value it was givenA published port declares a transport compose cannot spell(公開ポートが compose で表記できないトランスポートを宣言している); A resources quantity cannot be converted to a compose value(resources の数量を compose の値に変換できない); A resource quantity the helm provider emits is not a quantity(helm provider が出力するリソース数量が数量ではない); A service type the helm provider cannot render(helm provider がレンダリングできないサービスタイプ); A Kubernetes version the helm provider cannot render a chart for(helm provider がチャートをレンダリングできない Kubernetes バージョン); A value bound to a CloudFormation parameter cannot take the parameter’s type(CloudFormation パラメータにバインドされた値がそのパラメータの型を取れない); A value bound to a CloudFormation parameter is one its constraints refuse(CloudFormation パラメータにバインドされた値がその制約で拒否される); A secret bound to a CloudFormation parameter would be written into the template(CloudFormation パラメータにバインドされたシークレットがテンプレートに書き込まれてしまう); A dynamic reference is bound where CloudFormation does not resolve it(CloudFormation が解決しない場所に動的参照がバインドされている); A cross-boundary reference was spliced into a longer string(バウンダリをまたぐ参照がより長い文字列に埋め込まれた)
E0292a plugin reported a failure that none of the declared kinds namesA plugin reported a failure it did not classify(プラグインが分類しなかった失敗を報告した)
E0293wasm: guest plugin named a condition the socket does not declareA plugin named a condition the socket does not declare(プラグインがソケットの宣言していない条件を指定した)
E0294components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identityTwo subsystems declare a component under one name(2 つのサブシステムが 1 つの名前でコンポーネントを宣言している)
E0295library reference: a reference to a library entry carries no whitespace or line breakA reference to a library entry carries whitespace(ライブラリエントリへの参照に空白が含まれている)
E0296release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never bothA Release chain’s links disagree about the routing shape(Release チェーンのリンク間でルーティング形状が一致しない)
E0297inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes toA child Release inherits a boundary directory that resolves where its parent writes(子 Release が、親の書き込み先に解決される boundary ディレクトリを継承している)
E0298oci: published bundle carries no entity documentA published bundle holds no entity, or holds two(公開されたバンドルにエンティティが含まれていない、または 2 つ含まれている)
E0299oci: published bundle carries more than one entity documentA published bundle holds no entity, or holds two(公開されたバンドルにエンティティが含まれていない、または 2 つ含まれている)
E0300oci: published bundle cannot be unpackedA published artifact cannot be read as an entity(公開されたアーティファクトをエンティティとして読み取れない)
E0301oci: published artifact is not an entity documentA published artifact cannot be read as an entity(公開されたアーティファクトをエンティティとして読み取れない)
E0302an input the entity reads has no pin recorded for it in the entity.lock beside itAn entity reads an input the lock beside it records no pin for(エンティティが、隣のロックにピンが記録されていない入力を読み取ります)
E0303the entity shares its directory with another entity, and an entity of its kind has a directory of its ownAn entity shares its directory with another entity(エンティティが別のエンティティとディレクトリを共有している)
E0304a path names content outside the entity's own directoryA path names content outside the entity’s own directory(パスがエンティティ自身のディレクトリ外のコンテンツを指している)
E0305the files of the entity's local source do not match the pins recorded for them in entity.lockA local source no longer matches the pins recorded beside its Recipe(ローカルソースが、その Recipe の横に記録されたピンと一致しなくなった)
E0306plugin artifact not found on this machineプラグインの .wasm がこのマシン上にない
E0307a value a cache location is built from would place cached files outside the place it names in the cacheA value would place a cached file outside the cache(値によって、キャッシュされるファイルがキャッシュの外に置かれる)
E0308a Feature reaches a component alongside a Feature it declares a conflict withTwo Features declared to conflict reach one component(競合すると宣言された 2 つの Features が 1 つのコンポーネントに到達する)
E0309a symbolic link sits among the files an entity carriesA symbolic link sits among the files an entity carries(エンティティが含むファイルの中にシンボリックリンクがある)
E0310a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`A registry is added offline with no trust policy to pin(オフラインでレジストリを追加しようとしたが、固定する信頼ポリシーがない)
E0311reference carries a malformed version pinA version pin is none of the forms a pin takes(バージョンピンがピンの取るどの形式にも当てはまらない)
E0312a provider socket binding names a capability containing a colon, which no Recipe can selectA provider binding names a capability containing a colon(プロバイダーのバインディングがコロンを含む capability を指定している)
E0313plugins.providers entry names a capability no provider-rendering plugin the build reads servesprovider バインディングが、ビルドが読み込むどのプラグインも提供しない capability を指定している
E0314plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reportsA plugin was built from a working tree with uncommitted changes(プラグインが未コミットの変更を含む作業ツリーからビルドされています)
E0315a connection carries an attachment under a name its socket declares no slot for接続が、そのソケットがスロットを宣言していない名前でアタッチメントを持っている
E0316a Release attachment takes the name of an attachment one of a component's connections carriesA Release attachment takes the name of a connection’s attachment(Release のアタッチメントが接続のアタッチメントの名前を取っています)
E0317a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makesA Release connection attachment names no Feature type(Release の接続アタッチメントが Feature タイプを指定していません)
E0318duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already deliveredTwo attached Features deliver one key, the later through its FeatureRecipe’s injectMapping(アタッチされた二つの Features が一つのキーを配信し、後者がその FeatureRecipe の injectMapping を通じて配信している)
E0319connection alias is already used by another connection of the same component1 つのコンポーネントの 2 つの接続が 1 つのエイリアスを使用している
E0320a path this operation writes or deletes leads through a link out of the directory it must stay insideA path the operation writes leads through a link out of the directory it must stay inside(操作が書き込むパスが、リンクを経由して留まるべきディレクトリの外へ出ている)
E0321a file this operation reads leads through a link out of the directory it must stay insideA file the operation reads leads through a link out of the directory it must stay inside(操作が読み込むファイルが、リンクを経由して留まるべきディレクトリの外へ出ている)
E0323template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFactsA template reads its callers’ render facts without declaring it(テンプレートが、宣言せずに呼び出し元のレンダーファクトを読み取っている)
E0324a reference a document makes to another file leads out of the directory it must stay insideA reference to another file leads out of the directory it must stay inside(別ファイルへの参照が、留まるべきディレクトリの外へ出ている)
E0325provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entryA provider reported a render fact whose value is not a list(provider が値がリストでないレンダーファクトを報告した)
E0326pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render factsA pipeline step reads its callers’ render facts(パイプラインステップが呼び出し元のレンダーファクトを読み取る)
E0327template indexes a map with a key the map does not holdA template indexes a map with a key the map does not hold(テンプレートがマップに存在しないキーでマップをインデックスしている)
E0328attachment written under a name no slot declares fits a slot its component leaves emptyAn attachment written under another name fits a slot its component leaves empty(別の名前で記述されたアタッチメントが、コンポーネントが空のままにしているスロットに適合する)
E0329a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one接続とその到達先のターゲットが 1 つのキーを示していない
E0330signing: the references named together need different signing credentials, so nothing was signedReferences signed together need different signing credentials(まとめて署名する参照が異なる署名資格情報を必要とする)
E0331signing: no verified signature is recorded for an artifact that requires oneNo verified signature is recorded for an artifact that requires one(署名を必要とするアーティファクトに検証済みの署名が記録されていない)
E0332signing: the recorded signature was made for a different artifactA recorded signature was made for a different artifact(記録された署名が別のアーティファクトに対して作成されています)
E0333signing: a recorded signature is not the one a pull would recordA recorded signature is not the one a pull would record(記録された署名が、pull が記録するはずの署名と一致しません)
E0334an omits entry left out nothing the source renderedAn omits entry left out nothing the source rendered (omits エントリがソースのレンダリング結果から何も除外しませんでした)
E0335provider does not support omitsThe provider does not support omits (プロバイダが omits をサポートしていません)
E0336a provider's omitted counts do not match the omits entries it was handedA provider’s omitted counts do not match the omits entries it was handed(プロバイダーが返した除外数が、渡された omits エントリと一致しない)
E0337no importer plugin version satisfies the plugins.importer entry's version pinplugins.importer エントリが、カタログに存在しないインポーターのバージョンを固定している
E0338importer is attached by more than one plugins.importer entryAn importer is attached by more than one plugins.importer entry(importer が複数の plugins.importer エントリによってアタッチされています)
E0339more than one importer recognises the sourceMore than one importer recognises the source(複数のインポーターがソースを認識しています)
E0340a name this operation writes holds a path segment Windows cannot hold as writtenA name the operation writes holds a part Windows cannot hold(操作が書き込む名前に、Windows が保持できない部分が含まれている)
E0341the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directoryAn importer that declares no file patterns is handed a directory(ファイルパターンを宣言していないインポーターにディレクトリが渡されました)
E0342no file in the directory matches the file patterns the importer serving the source's format declaresNo file in the directory matches the importer’s file patterns(ディレクトリ内にインポーターのファイルパターンに一致するファイルがありません)
E0343a file read from the directory and a file named in the importer's `with.sources` have the same nameA file read from the directory and a file named in the importer’s with.sources have the same name(ディレクトリから読み込んだファイルと importer の with.sources で指定したファイルが同じ名前を持つ)
E0344an entry this publication carries cannot be used on WindowsA published archive carries an entry Windows cannot use(公開されたアーカイブに Windows で使用できないエントリが含まれている)
E0345a container declares one environment variable twiceA container gives one environment variable two values(コンテナが 1 つの環境変数に 2 つの値を与えている)
E0346a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credentialComponent のメトリクスアノテーションと provides キーが一致しない
E0347template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFactsA template reads its targets’ render facts without declaring it(テンプレートが宣言なしにターゲットのレンダーファクトを読み取る)
E0348pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render factsA pipeline step reads its targets’ render facts(パイプラインステップがターゲットのレンダーファクトを読み取る)
E0349no Recipe in the workspace's catalog binds to the capability the import's target namesAn import’s target names a capability no Recipe in the catalog binds to(インポートのターゲットが、カタログ内のどの Recipe もバインドしていないケイパビリティを指定している)
E0350no importer recognises the sourceNo importer recognises the source(ソースを認識するインポーターがありません)
E0351provider does not support boundary artifactsThe provider does not support boundary artifacts (プロバイダがバウンダリアーティファクトをサポートしていません)
E0352boundary output directory does not name a directory beneath the output rootA boundary’s output directory is not a directory beneath the output root(boundary の出力ディレクトリが出力ルート配下のディレクトリではない)
E0353boundary-level Feature instance name is not a directory nameboundary レベルの Feature の名前が . または .. である
E0354a template does more than copy a value it reads off a cross-boundary linkA template did more than copy a value it read off a cross-boundary link(テンプレートが、クロスバウンダリーリンクから読み取った値をコピー以上の方法で扱いました)
E0355inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`An inject: delivery is not a list of entries(インジェクションの配信がエントリのリストになっていない)
E0356suspend requires form: scheduledA workload suspend: is set on a form other than scheduled(workload の一時停止フィールドがスケジュール実行以外の形に設定されている)
E0357a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothingA Manifest name mapping names nothing in the build(Manifest の name マッピングがビルド内の何も指していない)
E0358uses edge target names a component its module does not exportA uses target names a module’s component the module does not export(uses のターゲットが、モジュールがエクスポートしていないそのモジュールのコンポーネントを指定している)
E0359no source adapter is registered in this program for the source kindNo source adapter is registered in this program for a source kind(このプログラムにはソース種別に対応するソースアダプターが登録されていない)
E0360the netrc file could not be readThe netrc file cannot be read(netrc ファイルを読み取れない)
E0361the source URL carries a credentialA source URL carries a credential(ソース URL に認証情報が含まれている)
E0362inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`An inject: entry on a connection carries a literal(接続上のインジェクションエントリがリテラルを持っている)
E0363annotation subkey is not routed by the annotation's bindingAn annotation subkey is not routed by its binding(アノテーションのサブキーがそのバインディングでルーティングされない)
E0364a value template failed while it ranA value template failed while it ran(値テンプレートが実行中に失敗した)
E0365boundary-level Feature's output is routed to a dispatch path nothing assemblesA boundary-level Feature’s output reaches no assembled file(バウンダリレベルの Feature の出力がどの組み立て済みファイルにも届かない)
E0366FeatureRecipe injectMapping output could not be read as a dictionary of deliveriesAn attached Feature’s injectMapping output cannot be read(アタッチされた Feature の injectMapping 出力を読み取れません)
E0367a scalar annotation value does not route to exactly one path of its bindingA bare annotation value does not route to exactly one path of its binding(裸のアノテーション値が、バインディングのちょうど 1 つのパスにルーティングされません)
E0368FeatureRecipe injectMapping output writes a key no delivery mechanism of the host readsAn attached Feature’s injectMapping output writes deliveries under a key nothing delivers(アタッチされた Feature の injectMapping 出力が、何も配信しないキーの下に配信を記述しています)
E0369template reads a path as a value and iterates it, and the data holds nothing at that pathA template reads and iterates a path that holds nothing(テンプレートが何も保持していないパスを読み取り、反復する)
E0370a pipeline declares one step id twiceA pipeline declares one step id twice (パイプラインが 1 つのステップ id を 2 回宣言している)
E0371catalog document declares a kind a catalog does not holdA catalog document declares a kind a catalog does not hold (カタログドキュメントが、カタログが保持しない種類を宣言している)
E0372inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject blockAn inject: entry on an attached Feature carries a literal(アタッチされた Feature の注入エントリがリテラルを持っている)
E0373a document declares an API version this compiler no longer readsA document declares an API version this compiler no longer reads(このコンパイラが読み取らなくなった API バージョンをドキュメントが宣言している)
E0374a plugin declares a plugin ABI version this compiler no longer speaksA plugin declares a plugin ABI version this compiler no longer speaks(このコンパイラがサポートしなくなったプラグイン ABI バージョンをプラグインが宣言している)
E0375oci: artifact carries a media type this compiler no longer readsAn artifact carries a media type this compiler no longer reads(このコンパイラが読み取らなくなったメディアタイプをアーティファクトが持っている)
E0376egress: the server did not answer in timeA server did not answer in time (サーバーが時間内に応答しませんでした)
E0377registry: the repository listing did not end in timeA registry’s repository listing did not end in time (レジストリのリポジトリ一覧が時間内に終わりませんでした)
E0378oci: the registry kept asking to slow downA registry kept asking to slow down (レジストリが速度を落とすよう求め続けた)

リンターの領域(致命的ではない)

コンパイラは実行について厳密に主張を持たない設計です。未使用の値、孤立したシークレット、接続されていないターゲットなど、単に疑わしいだけのパターンでビルドを停止することはありません。こうしたパターンが引き起こすのはせいぜい勧告です。上記の「ビルドを停止しない条件」に挙げた少数のもの(何からも読み取られない宣言済みパラメーターなど)についてはビルド自身の勧告であり、残りはリンターの領域に属し、企業は独自の慣例を適用する Wasm プラグインを任意で導入できます。

孤立した資格情報

inject: 配信契約なしでアタッチされた認証情報の Feature は、コンパイルエラーではありません。コアコンパイラはその宣言を IR グラフ内に保持し、警告は出力しません。企業のリンタープラグインがこのパターンを検出して警告することもあれば、企業のレンダラーが独自の Black-Box の慣例に従って孤立したシークレットを暗黙的にマウントすることもあります。どちらの解釈も妥当であるため、コアコンパイラはどちらの立場も取りません。