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

エラーの概要

エラーの章群では、問題が発生したときにコンパイラが出力する内容をまとめています。シグナルには 2 種類あります。コンパイルを停止して 0 以外の終了コードを返す致命的な停止と、ビルドを妨げずにオーサリングやデプロイ上の懸念を知らせる停止しない警告です。このカタログはパイプラインのステップ別ではなくシグナルの種類別に整理されているため、エラーメッセージを手がかりに来た読者は該当する項目を直接見つけられます。

致命的な停止には、スキーマ違反、スキーマ合成の失敗(ピラーごとの JSON Schema 宣言が記述されたペイロードを拒否するもの)、参照欠落エラー(Recipe の implements: が存在しない Component を指している場合や、Release が宣言された Component タイプに対応する Recipe を持たない Manifest を指している場合)、そしてスキーマ検証で検出される範囲を超えてコンパイラが再検証する少数のフィールド間不変条件が含まれます。致命的な停止には、リモート取得の失敗も含まれます。これは、ピン留めされたカタログエンティティまたはソースアーティファクトをレジストリやリモートソースから取得できない場合(存在しない、認証されていない、到達できない、またはロックファイルとダイジェストが一致しない)で、aggrega pull の実行中および aggrega build のロックファイル検証中に FETCH_ERROR のタグ付きで報告されます。停止しない警告には、オーサリング上の問題の兆候(未使用の values キーや、Ghost Infrastructure を示す未使用の infra ノブ)と、ターゲットが反映できないフィールド(ノードをレンダリングするプロバイダーが処理しない Workload のフィールドや aggrega.ai/ アノテーション)が含まれます。

トピック別リファレンス

  • 致命的な停止 — コンパイルを停止させるエラーのカタログで、チェックが実行されるパイプラインのステップ別に整理されています。各項目には、エラーの発生条件、対処方法、および問題のあるオーサリング箇所が記載されています。
  • 警告 — コンパイル中に出力される停止しない警告と、コアコンパイラの外部でポリシー形式のルールを適用する外部リンタードメインのチェックです。
  • エラーの変換 — カテゴリ接頭辞(DEVELOPER_ERROR、OPS_ERROR、CATALOG_ERROR、TRANSLATION_ERROR、FETCH_ERROR、POLICY_ERROR、TRUST_ERROR)と、単一行および複数行の出力形式です。
  • エラーセンチネル — すべての条件が持つ 3 つの識別子(プログラムが errors.Is で照合する Go のセンチネル、条件が登録されているコード、診断が出力する短いコード)と、すべての短いコードを解決する表です。
  • 互換性 — ショートコードがリリースをまたいで約束すること:コードの番号が付け直されることはなく、別の条件に割り当てられることもありません。