aggrega build
aggrega build は、Aggregate と Release の組を、プロバイダーネイティブなアーティファクト(Helm マニフェスト、再配布可能な Helm チャート、docker-compose YAML)にコンパイルし、出力で説明するとおり、ワークスペースのルートにある dist/ の下に出力します。Release は唯一のエントリーポイントです。Release は Aggregate と Manifest を指定し、境界を宣言し、コンポーネントをプロバイダーにルーティングします。
共通フラグ
次の 2 つのフラグは、以下のフラグリファレンスだけでは伝えきれない動作を持ちます。
--catalog <dir>— カタログエンティティ(Component、Feature、Recipe、FeatureRecipe の各オーサリング種別と、ライブラリ種別、Aggregates、Plugins)を含むディレクトリで、再帰的に読み込まれます。各--catalogディレクトリは、設定済みのディレクトリより先に、指定された順序で検索されます。プロジェクトローカルのカタログを共有カタログと併せて検索するには、両方を渡す(--catalog ./catalog --catalog ../shared-catalog)か、catalog_dirsに列挙します。--detailを指定すると、優先度の高いディレクトリによって隠されたエンティティが、他のビルド警告とともに stderr に報告されます。存在しない--catalogディレクトリはビルドを停止させ、そのディレクトリ名を示します。catalog_dirsに列挙されたディレクトリが実際にはディレクトリでない場合も同様で、何かを読み書きする前にビルドを停止させ、そのエントリと、それを列挙している設定ファイルおよび行を示します。ローカルエンティティの読み込み元を参照してください。参照が何にも解決されなかったために停止したビルドは、停止の下の注記で、読み込み時にスキップされたカタログファイルの一つとして、それらのディレクトリ内で Aggrega の apiVersion を宣言している(インデントなしでapiVersion:から始まり、値がaggrega.ai/で始まる行を持つ)にもかかわらず読み込めなかった各ファイル、たとえば YAML として解析できないファイルを、パーサー自身の理由とともに示します。別の apiVersion を宣言している YAML ファイルや apiVersion を宣言していない YAML ファイルは Aggrega のドキュメントではなく、そこで示されることはありません。--detail— pull ステップが行ったことを報告します。これはaggrega pull --detailが出力するのと同じ一時的な pull イベント診断です。報告する内容があるかどうかを決めるのは、pull ステップが要求されたかどうか(--auto-pullによるか、auto_pullを有効にすることによる)であり、ロックファイルがすでに存在するかどうかではありません。要求された pull ステップはどちらの場合も実行され、存在しないロックファイルを埋め、既存のロックファイルのピンを尊重します。pull ステップが実行されない場合、このフラグは stdout に 1 行の注記を出力して処理を続行します。コミット済みのロックファイルに含まれない解決層を捏造することはありません。Release の依存関係の pull 後の解決状態については、aggrega inspectを使用してください。
--dry-run についてはビルドを書き込まずにプレビューするで、--trace と --trace-unredacted については後述のトレース出力と保留された値の表示で説明します。
ビルドの一部としてロックファイルを埋める
ビルドはデフォルトで依存関係に関して読み取り専用です。ロックファイルを必要とし、ロックファイルを書き込みません。--auto-pull と auto_pull ワークスペース設定は、ビルドにプル手順を追加します。これにより、1 つのコマンドで Release の依存関係を解決し、解決した内容に対してコンパイルします。
Release への編集はロックファイルが検知します。 ロックファイルは Release と、それが拡張する各 Release を、その内容のダイジェストで記録します。そのため、プル以降に編集された Release に対する読み取り専用ビルドは、何かがレンダリングされる前に停止し、そのファイルを示して aggrega pull --release <release> を実行するよう案内します。このコマンドは、他のすべてのピンを尊重しながら編集を記録します。ダイジェストはバイトをそのまま対象とするため、コメントや空白の変更も編集として扱われます。自動プルを行うビルドはそのプル手順を自ら実行するため、編集を記録してからビルドします。
Release のレンダリングは 1 回です。 Release がどの外部入力を消費するかは、そのドキュメントが宣言する内容ではなく、Release をレンダリングした結果から決まります。そのため、プル手順はそれを調べるために Release をレンダリングし、そのレンダリングがビルドのレンダリングになります。したがって、自動プルを行うビルドのコストはレンダリング 1 回分であり、ロックファイルがすでにある状態での通常のビルドと同じです。
レンダリングに影響するフラグはそのレンダリングに適用されます。 --trace、--verify-determinism、--disable-plugin-cache、--no-unsupported-field-warnings は、通常のビルドのレンダリングに作用するのと同じ条件で、自動プルを行うビルドが実行するレンダリングにも作用します。そのため、1 コマンドのビルドでトレースや決定性チェックを求めれば、それが得られます。--dry-run は例外であり、黙って無視されるのではなく拒否されます。ドライランは何も書き込まない一方でプル手順は書き込むため、この組み合わせは作業を始める前に停止します(書き込まずにビルドをプレビューするを参照)。
ビルドがロックファイルのピンをどのように読み取るか
ロックファイルのピンは、場所ではなく内容、つまりダイジェストを指します。エンティティの場合、ピンはその公開物が含むもの(ドキュメントとそれが参照するファイル)のダイジェストです。そのため、ロックファイルで説明しているとおり、カタログディレクトリにあるエンティティのコピーと、その公開物を保持するキャッシュエントリは同じピンを持ちます。ビルドは、ピン留めされた各依存関係を、すでにマシン上にあるソースから読み取ります。他の場面と同様にまずカタログディレクトリ、次に .aggrega/cache 配下のコンテンツキャッシュです。これらの読み取りではレジストリに問い合わせません。取得を行うのは、ビルドがプルステップを実行する場合のそのステップだけです。
ピンを保持しなくなったキャッシュエントリはスキップされます。 エンティティをその場で編集する(同じ version のまま本体を新しくする)と、コンテンツキャッシュにはその名前とバージョンで以前の本体が残ります。カタログディレクトリに内容のダイジェストがピンと一致するコピーがある場合、ビルドはそのコピーを読み取り、エントリは読み取りません。その旨を、エントリと両方のダイジェストを示して標準エラーに出力します。
reuse: cache entry for <name>:<version> holds <digest the entry holds>, not the pinned <pinned digest>; passed over for <catalog file>, which holds the pinned bytesどのカタログディレクトリにもエンティティがない場合、ピン留めされたバイトをそのまま保持する完全なキャッシュエントリが依存関係として読み取られます。そのため、公開済みのコピーを取得した後にカタログディレクトリから削除されたエンティティでも、そのコピーからビルドできます。
ピン留めされたバイトを保持するソースがどこにもない場合、ビルドは何もレンダリングしないうちに停止します。エラーは E0135、またはキャッシュエントリのマニフェストがロックファイルのピンと異なる場合は E0133 です。停止時には、ピン、キャッシュエントリとそれが保持するダイジェスト、そしてエンティティのカタログディレクトリ上の各コピーとそのダイジェスト(またはどのカタログディレクトリにも存在しないこと)が示されます。対処方法は、レジストリに到達できる状態でプルを実行することです。プルはピン留めされたバージョンを再取得し、取得したものがピンと一致することを確認します。レジストリがそのバイトをもう提供していない場合にプルが何を行うかは、ピンの維持と更新を参照してください。
外部入力を検出するために aggrega pull が実行するレンダリングや、aggrega serve または aggrega mcp を通じたビルドやプレビューも、同じ方法でピンを読み取ります。
ビルド時の外部入力
レンダリングはリモート URL からコンテンツを要求できます(たとえば、リモート参照を持つチャートの values スキーマなど)。しかしビルドは、レンダリングが読み取れるものに追加する目的で URL を取得することはありません。lockfile がすでにピン留めしている URL への要求は、ワークスペースの入力ストアから提供され、どのバイトもレンダリングに届く前に、記録されたダイジェストに対して検証されます。ピン留めされていない URL への要求は停止し、その URL と、それをピン留めするステップを示します。この停止を取得に変える設定はありません。ビルドが読み取る入力の集合を暗黙のうちに広げることこそ、再現可能なビルドが決してしてはならないことだからです。
ピン留めされた入力のストア上のコピーが失われている場合、その入力だけが、lockfile がすでに記録しているダイジェストによって再取得され、何かが書き込まれたり返されたりする前にそのダイジェストに対して検証されます。これによってレンダリングが見る内容が変わることはありません(ダイジェストは入力がピン留めされた時点で確定しています)。そのため、これはクロージャに追加するのではなくストアを修復するものであり、lockfile はバイト単位で変更されません。オフラインの方針では、これを行うための転送手段さえないため、代わりにコピーの欠落によって停止し、その方針を示します。
ピン留めは Release の依存関係が解決されるときに行われるため、ビルドが読み取れるものはビルドの開始前に確定しています。aggrega pull がそのステップであり、それが唯一のステップです。
プラグイン信頼レコード
ビルドのいくつかの動作は plugins-trust.yaml に依存します。これは Release のロックファイルの隣にコミットされるファイルで、判定を返す各アタッチメントがどのプラグインに解決されたかを記録します。対象は、ir-verdict または render-verdict ロールの plugins.governance アタッチメントと、すべての plugins.linter アタッチメントです。このファイルは aggrega pull が書き込み、そのフィールドはプラグイン信頼レコードのスキーマで説明されています。以下では、ビルド自体がこのファイルをどう扱うかだけを説明します。
ビルドは、それらのプラグインのいずれかが実行される前に、レコードとの照合を受けます。 キャッシュから提供されたプラグインのアーティファクトダイジェストが記録されたものと異なる場合、そのプラグインは実行されずに拒否されます。これはこうしたアタッチメントが通常たどる解決方法であり、記録されたダイジェストが管理しない他の解決方法については aggrega pull で説明しています。また、.aggrega-config.yaml 内のどのアタッチメントにも対応しなくなった記録済みエントリがあると、ビルドは停止します。ゲートを外してもレンダリングされるバイトは変わらないため、レビュー済みのゲートなしで生成された出力は、そのゲートが承認した出力とまったく同じに見えるからです。この停止はプラグイン名を示し、意図によって異なる 2 つの対処法を提示します。削除が誤りであれば再びアタッチし、誤りでなければ削除を明示的に要求します。また、そのまま実行できるコマンドを表示します。レコードにまだ含まれていないアタッチメントは初出であり、どちらの照合でも停止しません。
ビルドは、ロックファイルのエントリをそのエントリが記録するものと照合するのとまったく同じように、それらの各プラグインをそのエントリが記録する署名と照合します。 エントリが検証済みの signature を記録している場合、ビルドは何かをレンダリングする前に、その記録が示すキャッシュ内の署名バンドルを再ハッシュし、バンドルが存在しないか異なる場合は E0144 で停止します。コンテンツキャッシュから読み込むプラグインについては、署名がどのアーティファクトに対して作成されたかもそのバンドルから読み取り、ビルドが読み込んだものとは別のプラグインに対して作成されていた場合は、署名要件の内容にかかわらず E0332 で停止します。これは、別のエントリからコピーされた signature に見られる状態です。コンテンツキャッシュが提供したプラグインの場合、どちらの拒否も aggrega pull --release <release> を示します。次の pull でプラグインの署名が再検証され、プラグイン自身の署名が記録され、それが示すバンドルがキャッシュされ、ダイジェストと一致しなくなったキャッシュ済みコピーは書き直されます。ワークスペースの信頼設定が、ビルドがコンテンツキャッシュから読み込むプラグインに署名を要求している場合(署名がなければ aggrega pull が拒否するのと同じ設定の下での話であり、skip_signature_verification と advisory レジストリは pull と同様にビルドの続行を許します)、署名を記録していないエントリ、またはそのプラグインのエントリ自体がない場合、ビルドは E0331 で停止し、プラグイン、plugins-trust.yaml、および署名を要求している設定を示します。対処法は aggrega pull --release <release> で、これは毎回の実行時にレジストリでプラグインの署名を検証して記録します。カタログディレクトリのいずれか、またはコンパイラバイナリ内のコピーから提供されるプラグインが、この要件と照合されることはありません。ビルドの他の部分と同様に、この処理はマシン上に既にあるファイルを読み込むだけで、どのレジストリにも問い合わせません。
ビルドは、ロックファイルが持つすべての取り下げに加えて、このレコードが持つすべての取り下げを示します。 aggrega pull がそれらのプラグインのいずれかに対して記録したマーカーは、重大度にかかわらず、プラグイン、記録された重大度、発行者のメッセージを示す deprecation: 行として報告されます。そして build.halt_on_deprecated_severity が、ピン留めされた参照に適用するのと同じ規則によって、それがビルドも停止させるかどうかを決めます。Release について報告する他のすべての経路も同じ集合を同じ文言で示し、いずれもそれを理由に停止することはありません。対象は aggrega validate --release、aggrega lint --release、aggrega inspect --closure、言語サーバーの検証とクロージャの応答、そしてアシスタントツールの describe と validate です。存在するが読み取れないレコードは、何も記録していないレコードとして通過するのではなく、ビルドを停止させます。
aggrega build --upgrade はこのファイルを書き直します。 このフラグは --auto-pull を含意し、引数なしの完全リフレッシュを実行します。これはすべての依存関係を再解決するため、記録されたすべての ID を再解決して書き直し、どのアタッチメントにも対応しないエントリをすべて削除します。したがって、upgrade ビルドの後にこのファイルが変更されていた場合、それが理由です。このフラグの範囲はすべての依存関係であり、記録された ID はロックファイルのピンではないものの、再解決される対象に含まれます。aggrega pull --upgrade とは異なり、ビルドのフラグはターゲットを取らないため、1 つのプラグインに絞ることはできません。単一の ID を採用または削除するには、代わりに aggrega pull --upgrade --release <release> <plugin> を実行してください。これは他のすべてのピンと他のすべての記録済み ID をそのまま残します。
範囲がすべてに及ぶため、開始前に確認を求めます。 aggrega build --upgrade は、引数なしの aggrega pull --upgrade と同じ条件でリフレッシュを確認します。両者は同じ操作なので、同じ質問をします。非対話的に使用する場合は、--yes を渡して事前に回答します。標準入力が端末ではなく --yes もない場合、ビルドは誰も答えられない回答を待たずに拒否します。リフレッシュを行わないビルドは何も確認しません。
ワークスペースの解決と決定性
Release のスキーマで必須の manifest: 参照は、Release
ファイルからの相対で解決されます。相対の catalog_dirs エントリ(および相対のファイルシステムプラグインパス)は、
それを宣言した .aggrega-config.yaml のディレクトリを基準に解決されます。「相対」は
常にそれを書いたファイルからの相対を意味するため、パスは aggrega をどこから呼び出しても
同じものを指します。宣言元のファイルを持たない --catalog フラグは、
現在の作業ディレクトリを基準に解決されます。レジストリ
参照(oci://…、hub 参照)はそのまま残されます。
ワークスペースルートは、workspace: ブロックを持つ最も近い祖先の .aggrega-config.yaml のディレクトリ、または --workspace-root が指定するディレクトリです。この方法でルートが固定されている場合、ビルドは呼び出し場所に依存しません。プロジェクトルートから aggrega build を実行しても、サブディレクトリから実行しても、バイト単位で同一の IR とレンダリングされた成果物が生成されます。検索されるカタログと出力に記録されるソースパスが作業ディレクトリによって変わらないためです。(workspace: マーカーも --workspace-root もない場合は作業ディレクトリがルートとなり、出力はそこを基準にします。ただし、作業ディレクトリが何も基準にせず、--release が絶対パスで Release を指定している場合は例外です。このときルートは Release 自身のフォルダから改めて検出されるため、検索されるカタログと出力に記録されるパスは、コマンドをどこから実行しても、その Release が属するプロジェクトのものになります。configuration.md を参照してください。)その方法でもワークスペースが見つからず、何もワークスペースを指定していない場合、ビルドはルートとして使用したフォルダがワークスペース内にないことを標準エラーに警告し、そのフォルダをワークスペースにするコマンドを示します。また、先に依存関係を解決するよう求められたビルドは、何かを取得する前に拒否されます。その解決が埋めるキャッシュがそのフォルダに書き込まれ、そのフォルダをワークスペースにしてしまうためです。先に何も解決しないビルドはレンダリングを行いますが、同じ理由により、lockfile が固定していてキャッシュにもう存在しない外部入力は再取得されません。それを求めるプラグインには、オフライン状態の文と同様に、代わりに拒否の文が伝えられ、ビルドはそのプラグインがそれをどう扱ったかを報告します。存在しないフォルダを指定する --workspace-root または AGGREGA_WORKSPACE_ROOT は、ビルドが他の処理を行う前に拒否され、2 つのうちどちらが指定したかが示されます。
環境変数
build が読み取るワークスペース設定は、環境変数で上書きできます。環境変数はコミットされた設定より優先され、どのフラグよりも優先度が低くなります: AGGREGA_OFFLINE、AGGREGA_AUTO_PULL、AGGREGA_CATALOG_DIRS(OS のパスリスト区切り。絶対パスを指定してください)、AGGREGA_ARTIFACT_CACHE_DIR、AGGREGA_DEFAULT_REGISTRY、AGGREGA_WORKSPACE_ROOT。完全な一覧と優先順位のモデルについては environment-variables.md を参照してください。
出力
レンダリングされた成果物は、コマンドをどのフォルダから実行したかにかかわらず(ルートそのもの、その配下のフォルダ、あるいは --workspace-root または AGGREGA_WORKSPACE_ROOT でルートを指定した別の場所のフォルダのいずれでも)、ワークスペースルート配下の dist/ に出力されます。最後の行にはそのディレクトリがフルパスで示されます:
Build completed: 4 files written to <workspace>/distここで <workspace> はワークスペースルートを表し、行にはフルパスで示されます。ワークスペースが見つからず、何も指定されていない場合は、コマンドを実行したフォルダがルートとなり、そこに dist/ が書き込まれます。ワークスペースの外を指すリンクである dist は、その中のものが削除または書き込まれる前に拒否されます。境界を宣言しない Release は provider ごとに書き込みます: dist/<provider>/<files>。directory: を持たない宣言済みの境界は、境界ごと、provider ごとに書き込みます: dist/boundaries/<boundary-path>/<provider>/<files>。Release の境界に対してオペレーターが記述した directory: および subDirectory: のオーバーライドは出力先パスを変更します。(path, provider) ごとの集約により、同じ評価済みパスに解決される寄与元はマージされます。
ビルドが書き込まなかったファイル
ビルドは自身のファイルを書き込み、自身が書き込んでいないものは何も削除しません。ただし例外が 1 つあります。dist/boundaries/ はビルドが丸ごと再生成するため、書き込みの前に消去されます。これにより、別のバリアントのビルドがそこに残したファイルが、もはやそのファイルを生成しないツリーに持ち越されることはありません。dist/ 内のそれ以外のものはすべてそのまま残されます。以前のビルドが書き込み、今回のビルドがもう生成しないファイルも、境界の directory: が以前の実行でそこに置いたファイルも、自分でそこに置いたファイルも同様です。ビルドには、残ったファイルと意図的にそこに保管しているファイルを区別できないためです。
代わりに行うのは、それを知らせることです。ファイルを書き込み終えると、ビルドは dist/ そのものと、その配下でファイルを書き込んだディレクトリ、またはより深い場所に書き込むために通過したすべてのディレクトリを調べ、そこにある今回の実行で書き込んでいないファイルを、標準エラーへの 1 つの警告の中ですべて示します。ファイルは dist/ からの相対パスでソートして示されるため、同じツリーは毎回同じように報告されます:
warning: the output directory holds 2 file(s) this build did not write, in directories it wrote into; nothing was removed, so they sit beside this build's output: "app/stale-from-earlier-run.yaml", "beside-the-tree.txt"続いて、最後の行がその数を示します:
Build completed: 1 file written to <workspace>/dist, beside 2 files this build did not writeビルドが何も書き込まず、その配下にも何も書き込まなかったディレクトリは調べられないため、dist/ の下に保管している自分のフォルダーがファイルごとに列挙されることはありません。そのようなファイルが見つからなかったビルドは警告を出力せず、最後の行は出力に示したものになります。いずれの場合も、ビルドが書き込むファイルは同じバイト列です。2 つのビルドを比較する場合や、何もない状態から始める場合は、ビルドの前に dist/ を削除してください。
aggrega serve の aggrega/build リクエストと、アシスタントの build ツール(aggrega mcp)は同じステップを通じて書き込むため、同じファイルを同じ文で示します。デーモンは応答の notices の 1 つとして、ツールは advisories の最後の項目として示します。ドライランは何も書き込まないため、これらはいずれも報告しません。
YAML のインデント
レンダリングされるすべての YAML 成果物(docker-compose ファイル、Helm チャートのテンプレートと values、Kubernetes マニフェスト)は、統一されたインデント幅で出力されます。幅は .aggrega-config.yaml の build.yaml_indent で設定し、デフォルトは 2 です(これらの形式で慣例となっている幅です):
build: yaml_indent: 2 # default; accepts 2 through 9幅はすべてのレンダラーが共有する単一のマーシャル箇所で適用されるため、同じ入力に対する出力は実行間でバイト単位で同一に保たれます。[2, 9] の範囲外の値は設定スキーマの検証で拒否されます。
コンパイル済みグラフの受け渡し
--ir-graph は、このビルドが解決したグラフを JSON として標準出力に書き出します。これは追加的な動作です。成果物は引き続き dist/ に書き込まれ、サマリーも引き続き表示され、レンダリングされたバイトは変わりません。グラフは、ビルドがそこに出力する他のすべてのものより先に出力されます(1 つの JSON ドキュメントと末尾の改行 1 つ)。そのため、ストリームをデコードする利用側はそれを読み取って停止できます。
受け渡されるグラフはレンダリングが使用したものであるため、同じ Release を改めて解決したものではなく、隣にある成果物を生成したビルドそのものを正確に表します。--dry-run と組み合わせることができます。その場合、グラフが書き出され、その後に成果物のレポートが続き、ディスクには何も書き込まれません。
作成者が機密と宣言した値は、aggrega inspect で説明されている構造化された形式で、グラフから伏せられます。消費側コンポーネントのソケットがリーフを機密と宣言している場合は、接続の values と infra もこれに含まれます。--ir-graph と併せて --unredacted を指定すると、aggrega inspect --unredacted が定める条件のもとで、代わりにそれらの値が出力されます。この指定が及ぶのはグラフのみで、それ以外には及びません(トレースファイルには独自の --trace-unredacted があり、レンダリングされた成果物が伏せられることはありません)。そして、出力が届く先にはそれらの値が平文で含まれることになります。--ir-graph なしで指定すると、明らかにする対象が何もないため拒否されます。
同じフラグが同じ意味で aggrega inspect と aggrega validate にもあります。
書き込まずにビルドをプレビューする
--dry-run は、ビルドが実行するのと同じコンパイル(同じ依存関係ゲート、同じレンダリング、同じ provider)を実行し、出力する内容を書き込む代わりに表示します。各成果物は、配置されるパスと保持される内容とともに報告されます。
aggrega build --release releases/production.yaml --dry-run==> <workspace>/dist/main/helm/webapp-configmap-webapp.yaml <==apiVersion: v1kind: ConfigMap...
Total build time: 2.5sDry run: 1 file would be written to <workspace>/dist; nothing was written成果物はビルドが書き込む順序で報告されるため、同じ入力からは同じバイトが同じ順序で報告されます。また、報告されるパスはビルドが書き込むパスです。これはワークスペースルートの下にあり、上記で <workspace> と記した箇所はフルパスで示されます。
書き込まれないもの。 出力ディレクトリはそのままの状態で残されます。クリーンアップも行われないため、以前のビルドの出力はドライランの後もそのまま残ります。ロックファイルは書き込まれません。.trace/ にも何も書き込まれません。
外部入力は通常のビルドとまったく同じように扱われます。その条件は ビルド時の外部入力 で説明しています。したがって、ドライランは代替するビルドが読み取るのと同じピン留めされたクロージャを読み取り、表示される内容はそのビルドが書き込む内容です。
参照が拒否された場合、実行は到達できなかったすべての参照を示し、それらをピン留めするコマンドを案内します。
note: the lockfile does not pin every external reference this render requested, so the following were declined and the render stopped short of the artifacts it would otherwise emit: - https://charts.example.com/values-schema.json Run `aggrega pull --release releases/production.yaml` to pin the inputs the render needs, then run the dry run againaggrega pull を一度実行すれば、ドライランに必要なものはすべて揃います。それ以外の動作は変わりません。
ドライランにはロックファイルが必要で、ロックファイルを埋めることはありません。 ビルドはデフォルトで読み取り専用であり、ドライランはどの方法で埋め込みが要求されてもそれを守ります。--auto-pull と --upgrade は無条件に拒否されます(後述)。auto_pull ワークスペース設定はその 1 回の呼び出しに限り上書きされるため、デフォルトで埋め込みを行うワークスペースでもプレビューできます。ロックファイルがない場合、ドライランは通常の読み取り専用ビルドと同じ対処方法を示して停止します。まず aggrega pull を実行してください。
拒否されるフラグ。 3 つのフラグは書き込みを行うため、ドライランと組み合わせても誠実な結果になりません。書き込みを無視すれば要求された埋め込みが消えてしまい、書き込みに従えばドライランが行う唯一の約束を破ることになります。いずれの組み合わせも作業の前に停止し、渡したフラグと代わりに実行すべき手順を示します。
| 組み合わせ | 拒否する理由 |
|---|---|
--auto-pull | ロックファイルを埋めます。aggrega pull を独立した手順として実行してください |
--upgrade | すべての依存関係を再解決し、ロックファイルを書き換えます。aggrega pull --upgrade を独立した手順として実行してください |
--trace | ノードごとのファイルを .trace/ に書き込みます。トレース付きビルドは --dry-run なしで実行してください |
それ以外はすべて通常どおり組み合わせられます。--verify-determinism は各ノードを 2 回レンダリングし、いずれも書き込まずにバイトを比較します。--catalog、--quiet、--progress、--debug および警告フィルターは、書き込みを行うビルドとまったく同じように動作します。
用途と、用途でないもの。 ドライランは「この Release は何を出力するか」に答えます。これはレンダリングでしか答えられない問いです。したがって、レンダリングせずに正しさを検査する aggrega validate や、レンダリング前にグラフを照会する aggrega inspect の代わりにはなりません。求める答えが成果物そのものである場合、たとえば Release の変更が出力に与える影響をレビューする場合や、dist/ に何かをコミットする前に Recipe の編集を確認する場合に、ドライランを使用してください。
トレース出力
--trace フラグは、コンパイラのすべての中間状態を記録するノードごとのデバッグダンプを有効にします。出力はワークスペースルート配下の .trace/ に置かれ、dist/ と並びます(その配下に置かれることはありません。この兄弟配置は .git/、.terraform/、node_modules/ の慣例に従うもので、もう一方のディレクトリを純粋にデプロイ可能な状態に保ちます。つまり dist/ にはデプロイ対象だけが残ります)。
ディレクトリ構成は境界ごと、インスタンスごとです。
.trace/└── boundaries/ └── <boundary-path>/ └── <instance-id>/ ├── 01-pillars-initial.yaml ├── 02-provides-evaluation.yaml ├── 03-inject-hydration.yaml ├── 04-inject-mapping.yaml ├── 05-source-resolution.yaml ├── 06-source-locals.yaml ├── 07-values-mapping.yaml ├── 08-workload-synthesis.yaml ├── 09-artifact-evaluation/ │ └── <per-artifact-file>.yaml ├── 09b-feature-rendering-boundary.yaml ├── 10-engine-synthesis/ │ └── <per-synthesized-file>.yaml ├── 11-engine-emission.log └── 12-labels-injected.log各スロットは特定のコンパイラ状態を記録します。
01-pillars-initial.yaml— テンプレートが読み取るコンテキストの、ノードごとのスナップショットです。解決後、ステージごとの変更が行われる前に取得されます。.values、.infra、.context、.parameters、.metadataを含みます。02-provides-evaluation.yaml— provides の評価後に解決されたprovides:の出力です。03-inject-hydration.yaml— inject のハイドレーション後にマージされた.context.injectパイプです(上流のprovidesを消費側から見たものです)。04-inject-mapping.yaml— FeatureRecipe のinjectMappingによる書き換え後の.context.injectパイプです。05-source-resolution.yaml— provider が消費する、パース済みのsource:の内容です。Recipe がsource:を宣言している場合にのみ存在します。06-source-locals.yaml— 解決済みのlocals:ブロックです。ソース解決はsource:テンプレートを評価する前に.localsを公開するため、このスロットは Recipe がsource:を宣言しているかどうかにかかわらず書き出されます。07-values-mapping.yaml— レンダリングされたvaluesMapping:の出力(provider が受け取る辞書)です。Recipe がvaluesMapping:を宣言している場合にのみ存在します。08-workload-synthesis.yaml—workload:テンプレートが評価され、その出力がパースされた時点のコンテキストです。Recipe がworkload:を宣言している場合(インラインまたは$import:による読み込み)にのみ存在します。パース済みのWorkload自体はこのスロットには含まれません。処理途中ではなく確定した後の09-artifact-evaluation/以降に現れます。09-artifact-evaluation/— 評価された成果物ごとに 1 ファイルです。Recipe がartifacts:を宣言している場合(エントリがインライン、またはエントリごとに$import:で読み込まれる場合)にのみ存在します。09b-feature-rendering-boundary.yaml— ノードのレンダリングが終わる時点、つまりそのノードにアタッチされた FeatureRecipes がリソースを生成した後のコンテキストで、その横に解析済みのworkloadが置かれます。すべてのノードについて書き込まれます。10-engine-synthesis/— provider が Workload から生成した合成マニフェストごとに 1 ファイルです(helm/compose の workload モード)。provider が合成パスを実行した場合にのみ存在します。11-engine-emission.log— ノードの出力後サマリー(ファイル数、出力パス)です。12-labels-injected.log— ノードのレンダリング済み出力に書き込まれた来歴ラベルとアノテーションです。
03-inject-hydration.yaml 以降、ノードのコンテキストを示すスロットは、捕捉したパイプがいずれかの仕組みで少なくとも 1 つのキーを配信している場合は常に .context.inject ブロックを持ちます。仕組みとは env、file、arg、または inject マッピング、FeatureRecipe の injectMapping、あるいはコンポーネント自身の inject: ブロックが書き込む別名の仕組みです。そうした独自の仕組みだけで配信するノードもこのブロックを示し、その仕組みは自身の名前の下に、そのキーは all に現れます。機密と宣言された値は、どちらの場所でも <redacted> と表示されます。パイプが何も配信していないときに取得されたスロットには .context.inject ブロックはありません。
トレースライターはノンブロッキングです。トレースはコンパイルの経路上ではなく、コンパイルと並行してディスクに書き込まれます。コンパイルのレイテンシはトレースの I/O の影響を受けません。--trace のオン・オフにかかわらず、同じコンパイルは同じ実時間で完了します。
トレース内の機密宣言された値
作成者が機密と宣言したデータ(sensitive: true を持つスキーマのリーフ、またはそれを持つ provides キーから素材が来た配信キー)は、トレースに固定テキスト <redacted> として書き込まれます。キーは保持され、値だけが置き換えられるため、スロットには引き続き、ノードがどのリーフとどの配信キーを持つかが表示されます。同じブロック内の宣言されていない兄弟は値をそのまま出力します。置換は宣言にのみ従います。
FeatureRecipe が独自の injectMapping を通じて配信する値も伏せられます。これは空の inject リストを宣言したスロットが配信を委ねる経路であり、inject のみの認証情報の実現がたどる経路でもあります。そのようなマッピングが書き込む配信キーはそれ自体がテンプレートであるため、どの宣言もそのキーを名指ししません。代わりに読み取られるのはマッピング自身のテキストです。そのテキストが、アタッチされた Feature が sensitive: true と宣言する values または infra のリーフを参照する場合、マッピングが生成したすべての配信キーが <redacted> と表示されます。機密を何も持たないキーも含まれます。判定はキー単位ではなくアタッチメント単位だからです。宣言されたものを何も参照しないマッピングは、キーをそのまま出力します。
機密宣言されたデータからテンプレートが計算した値も、そのキー自体に宣言がなくても伏せられます。それを識別するのは作成者が書いた参照です。テンプレートが機密宣言されたリーフを読み取る locals: エントリは伏せられ、同様の source: フィールドも伏せられます。この判定は保守的です。オブジェクト全体に到達するテンプレートはその配下のすべての宣言済みリーフに到達するため、{{ range $k, $v := .values.creds }} は creds 配下に何か宣言されていれば出力を伏せます。また、すでに伏せられた兄弟を読み取る locals: エントリも順に伏せられます。同じ形で宣言されたものを何も読み取らない兄弟エントリは、そのまま出力されます。
uses エッジを越えて渡る値は、消費側ノードではなくターゲットの宣言に照らして伏せられ、エッジがその値を運ぶ両方の面で伏せられます。.context.uses.<alias>.provides はターゲットのコンポーネントが公開したものを再現するため、それらの値を支配するのはターゲットのスキーマです。ターゲットが機密と宣言した provides キーは、消費側が何も宣言していなくても、消費側のスロットで <redacted> と表示されます。エッジ自身の inject ブロックがそのキーを消費側コンポーネントの配信キーに振り向ける場合、.context.inject もその配信キーを伏せます。これはアタッチメントの inject マッピングがすでに従っているのと同じ規則で、同じ宣言を読み取ります。伏せはエッジ単位であるため、同じ provides キー名を公開する 2 つのエッジは独立して解決されます。ターゲットがそれを宣言した方は伏せられ、もう一方はそのまま出力されます。エッジの残りの部分(ターゲット、ソケット、ラベル、および inject マッピング自身のキー名)は、ターゲットの provides 宣言が支配するものではなく、そのまま出力されます。
エッジ自体に記述された接続ごとの values と infra は、代わりに消費側コンポーネントのソケットが支配します。つまり、そのソケットが宣言する valueSchema と infraSchema で、これらはその設定の検証に使われるコントラクトです。いずれかのコントラクトが sensitive: true と宣言したリーフは、.context.uses.<alias>.values または .context.uses.<alias>.infra で、キーは保持されたまま <redacted> と表示されます。コントラクトが宣言するデフォルト値をとっているリーフも同様です。宣言されていない兄弟要素はそのまま出力されます。ここではターゲットの宣言は関係せず、伏せは接続単位であるため、ソケットがそれを読み取り可能と宣言している接続上の同名のリーフはそのまま出力されます。
接続に記述されたアタッチメントは、その接続のエッジの下の .context.uses.<alias>.features.<slot> に表示され、それぞれが自身の Feature の宣言に照らして伏せられます。これは、コンポーネントがその Feature を直接保持する場合に支配するのと同じ宣言です。Feature が sensitive: true と宣言する values または infra のリーフは <redacted> と表示され、Feature が機密と宣言するアタッチメントの解決済み provides のキーも同様です。各キーは保持されます。アタッチメントの型、バージョン、ラベル、およびその Feature が宣言しないままにしているすべてのリーフと provides キーはそのまま出力されるため、公開されたロケーターは、それが指し示す素材の横で読み取れる状態に保たれます。伏せは接続とスロットの単位であるため、2 つの接続に記述された同じ Feature はそれぞれで解決されます。sensitive: true を宣言するスロット(コンポーネント上でもそのソケット上でも)は、アタッチメントが秘密の素材を扱うことを示すものであり、それ自体ではどのリーフも伏せません。どのリーフを伏せるかは Feature が宣言するものです。コンポーネント自身のアタッチメントは、トレースが .features ブロックを持たないため、スロットが表示するブロックには含まれません。workload: テンプレートがそこから読み取るものは、後述の再レンダリングで扱われます。
パース済みの Workload は再レンダリングであり、ビルドが出力したドキュメントのキャプチャではありません。それを持つスロット(09-artifact-evaluation/、10-engine-synthesis/、09b-feature-rendering-boundary.yaml)は、その横の workload_note エントリでその旨を示します。レンダリングされたドキュメントは、ある文字がどの宣言に由来するかを何も記録しないため、その内部で置換を行うキーが存在しません。代わりにトレースが示すのは、同じ workload: テンプレートを、機密宣言されたデータがすでに <redacted> と表示されるコンテキストに対して 2 回目に評価したものです。テンプレートは文字列があった場所で文字列を見るため、結果は出力されたドキュメントの形を保ちます。同じフィールドが同じ場所にあり、伏せられたデータ自身の位置に <redacted> が置かれ、その周囲のリテラルテキストは変わりません。
再レンダリングが出力されたものと異なる 2 つの点で、どちらも注記に記載されています。
- 値の内容で分岐するテンプレートは、異なるレンダリング結果になります。 特定の値に対する
eq、長さのテスト、ハッシュやエンコーディングは、いずれも<redacted>を見て異なる結果(異なる分岐、異なる長さ、異なるダイジェスト)を生成します。このため、トレースは出力されたドキュメントを示すとは決して主張しません。 - どの宣言も名指ししないデータは、変更されずにそのまま運ばれます。 置換の対象は、この軸が名指しするもの、すなわち宣言済みの
values/infraリーフ、マークされた配信キー、コンポーネント自身の Component が機密と宣言するprovidesキー、消費されるターゲットの宣言済みprovides、接続自身のvaluesまたはinfraのうちそのソケットが機密と宣言するリーフ、コンポーネント自身が保持するアタッチメント(.features.<name>で読み取られる)または接続に記述されたアタッチメントの宣言済みリーフやprovidesキー、およびそれらから計算されたlocals:やsource:の値です。これは、テンプレートが発生させた拒否が伏せられる対象と同じデータです。それ以外の経路でテンプレートに届くデータ、たとえば Recipe が宣言済みリーフから値を計算した、どの宣言も名指ししないprovidesキーなどは、出力されたドキュメントに現れるのとまったく同じように再レンダリングに現れます。
再レンダリングをまったく生成できない場合、スロットは workload: キーを保持し、ドキュメントをその旨を述べて --trace-unredacted を名指しする 1 行に置き換えます。この記述は意図的なものです。単に消えた投影は、workload: をまったく宣言しない Recipe と区別できなくなるからです。
.trace/ を安全なものとして扱う前に、知っておくべき制限が 1 つあります。dist/ は伏せ字化されません。 レンダリングされた成果物はデプロイ対象であるため、レンダリングが生成したとおりに出力され、トレースの再レンダリングがそれに及ぶことはありません。同じ入力は、--trace のオンとオフにかかわらず、バイト単位で同一にレンダリングされます。
.trace/ は素材を含むものとして扱い、dist/ と同じように取り扱ってください。
秘匿された値を表示する
--trace-unredacted を --trace と併用すると、トレースファイルには値の代わりに置かれるテキストではなく、機密と宣言された値そのものが書き込まれます。このフラグが存在するのは、デバッグ対象が秘匿された値そのものである場合があるためです。誤ったアタッチメントから届いた認証情報は、正しいものと両方が秘匿表示されていると見分けがつきません。
これは、ビルドが実際に出力したドキュメントを取得する方法でもあります。何も秘匿されていなければ置換するものもないため、workload: スロットには再レンダリングではなく出力されたドキュメントそのものが含まれ、workload_note エントリは存在しません。
このフラグには次の 3 つの性質があります。
- 書き込むすべてのファイルが、自らの内容を明示します。 実行によって生成される各トレースファイルの先頭には、フラグ名を示し、機密と宣言された値が以下に平文で現れることを述べるコメントが置かれます。そのため、後でバグ報告に添付されたり共有ディレクトリに残されたりしたファイルも、それ自体が警告を携えます。このコメントはファイル自体の形式において有効なので、ファイルは引き続きパースできます。
- 影響が及ぶのは
.trace/だけです。 レンダリングされた成果物は、このフラグの有無にかかわらずバイト単位で同一です。変わるのはデバッグファイルに表示される内容であり、ビルドが生成するものは決して変わりません。また、aggrega inspectのレイアウトや、失敗したビルドが出力する診断テキストも、どちらの状態でも同一です。 - このフラグは呼び出しごとにのみ有効です。 これに対応する設定項目はないため、一度有効にしたまま、その後ワークスペースをビルドするすべての人に適用し続けることはできません。
--traceなしでこれを指定すると、応えられない要求を受け入れるのではなく、両方のフラグ名を示すメッセージとともにビルドが停止します。
トレースとは別に、ビルドは機密と宣言された素材をリテラル値として持つ配信キーごとに 1 件のアドバイザリを出力し、コンポーネント、ターゲット、アタッチメント、配信キーを示します。これによってビルドが停止することはなく、--no-unsupported-field-warnings でも抑制されません。このフラグが対象とするのは、記述した内容のうちターゲットが対応できないものであり、別の種類だからです。
このキーワード、その 2 つの記述箇所、アドバイザリの正確な文言、そして宣言によって達成できることの上限の全容については、vocabulary/compact-form-authoring.md の「Declaring a leaf sensitive」を参照してください。
--trace を使う場面
- レンダリングされた manifest に期待する値が含まれない理由の診断:パスごとのダンプをたどり、値が欠けている最初のスロットを見つけます。
- コンパイラのアップグレード後の決定性の検証:同じ入力を
--trace付きで 2 回コンパイルすると、バイト単位で同一のトレースダンプが生成されます。スロットごとの差分があれば、それによって回帰箇所を特定できます。 - カタログ作成の反復作業:
04-inject-mapping.yamlと06-source-locals.yamlのスナップショットを比較すると、Recipe のテンプレートが評価時に何を参照しているかがわかります。
例
ローカルカタログに対して Release をコンパイルします:
aggrega build --release releases/production.yaml別のカタログディレクトリを指定してコンパイルします:
aggrega build --release releases/production.yaml --catalog ../platform-catalog/何も書き込まずに、Release が出力する内容を確認します:
aggrega build --release releases/production.yaml --dry-runデバッグ用にトレースダンプを付けてコンパイルします:
aggrega build --release releases/production.yaml --traceコンパイル後、パスごとの状態を .trace/boundaries/<boundary>/<instance>/ で確認します。.trace/ ディレクトリは --trace の実行ごとに上書きされ、以前のトレース状態はコンパイルをまたいで保持されません。
相互参照
aggrega-pull— OCI レジストリからローカルカタログへカタログエンティティを取得します。aggrega-validate— 成果物を出力せずに、カタログ、Release クロージャ、または単一エンティティの正しさを検査します。ビルドが実行する依存関係の検証を、レンダリングなしで行います。aggrega-lint— 同じ 3 つのスコープにわたってカタログの公開に関する慣例を検査します。aggrega-inspect— グラフの確定後、レンダリングに進まずに IR グラフを照会します。- エラー — CLI に表示される、分類されたエラーの表示形式です。
概要
aggrega build [flags]説明
Compile an Aggregate and Release pair into provider-native artifacts under eachboundary's output directory.
The Release is the single entry point: it names the Aggregate and the Manifest,declares the boundaries, and routes each component to a provider. What aprovider emits is the provider's own shape — Helm manifests, a redistributableHelm chart, docker-compose YAML — so the output directory holds whatever theproviders this Release routes to produce.
The output directory is dist/ beneath the workspace root, whichever folder thecommand is run from, and the closing line names it in full. A run that finds noworkspace uses the folder it was run from as the root, and writes dist/ there.
Build is read-only by default and needs a lockfile. Run "aggrega pull" first tocreate one, or pass --auto-pull to fill it in-process for this build.
Given identical input, build writes byte-identical output, which is what makesthe rendered tree reviewable as a diff.フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
--auto-pull | false | ビルドの前に pull ステップを実行します。Release の依存関係をプロセス内でロックファイルとキャッシュに解決し、それらに対してビルドします。これはワークスペースの auto_pull 設定が行うのと同じプロセス内での補充であり、ワークスペース設定を編集せずに単一のビルドで有効にするものです。単独では増分補充となり、既存のピンは尊重され、ピンのない参照は解決されて追加されます |
--catalog | [] | カタログディレクトリです。複数回指定できます。各 —catalog <dir> はカタログ検索スタックの先頭に追加されます(最初に一致したものが優先されます)。スタックはワークスペースの catalog_dirs、またはワークスペース設定が workspace.releases の下で独自のディレクトリを与えている Release の場合はその Release のディレクトリで構成され、ワークスペースルートに catalog という名前のディレクトリがある場合はそれで終わります。空として書かれた catalog_dirs リストは、ローカルカタログをまったく読み込みません。 |
--debug | false | 人が読める詳細な診断を stderr に出力します。フェーズごとの経過時間と、エンティティ数および依存関係数です。—quiet より優先され、詳細出力は常に出力されます。.trace/ に機械可読なノードごとの中間ファイルを書き込む —trace とは別物です |
--detail | false | ビルドはデフォルトで読み取り専用であり、解決の詳細は表示しません。pull ステップが実行されるとき(—auto-pull が渡されたか、ワークスペースが auto_pull を有効にしているため)、ビルドはロックファイルがすでに存在するかどうかにかかわらずプロセス内でロックファイルを補充し、このフラグは解決された各エンティティについてその補充が何をしたかを表示します。レジストリから新たに取得した、キャッシュスロットを再利用した、ローカルカタログで見つけた、コンパイラバイナリ内から提供した、または外部(Release 自身の Aggregate または Manifest で、Release が指定するファイルまたはエントリから読み込んだもの)のいずれかです。pull ステップが実行されない場合は、エンティティごとの行の代わりにその旨を示す 1 行を表示します。stdout のみで、永続化されません |
--disable-plugin-cache | false | このビルドでは永続的なディスク上のプラグインコンパイルキャッシュをスキップし、ビルド終了時に破棄されるメモリ内キャッシュでプラグインゲストを新たにコンパイルします。デフォルトはオフで、ビルド間で共有のディスク上キャッシュを再利用します。レンダリング出力は変わりません |
--dry-run | false | Release をレンダリングし、書き込む代わりに出力される内容を表示します。各成果物の出力先となるパスとその内容が stdout に出力され、出力ディレクトリとロックファイルは変更されません。外部入力は通常のビルドとまったく同じように動作します。ピン留めされた入力はコンテンツアドレス指定ストアから提供され(blob が欠けている場合はダイジェストによって再補充され)、ピン留めされていない外部 URL を要求するレンダリングはその URL を示して停止します。そのため、ドライランが示す内容はビルドが書き込む内容と同じです。書き込みを行う —auto-pull、—upgrade、—trace とは併用できません。依存関係の補充やトレース付きビルドは、それぞれ独立したステップとして実行してください。—policy-input とは併用でき、その場合に書き込まれるのはそのファイルだけです |
--ir-graph | false | このコマンドがすでに生成するものすべてに加えて、この実行で計算した IR グラフを JSON として stdout にも書き込みます。作成者が機密と宣言した値はそこから除外されます。それらを表示するには —unredacted を渡します。成果物は引き続き書き込まれ、サマリーも引き続き表示されます。グラフはその両方より前に書き込まれます |
--no-unsupported-field-warnings | false | サポートされないフィールドの警告クラスを抑制します。これは、作成したものをターゲットが反映できない場合にターゲットが出す通知です。ターゲットが表現できない Workload フィールド(compose のような忠実度の低いターゲットの場合など)や、ノードの入力種別に対してターゲットが処理しない aggrega.ai/ アノテーションが該当します。その他のレンダリング警告は引き続き表示されます。表示のみに影響し、レンダリング出力は変わりません |
--policy-input | — | 各ガバナンスロールがそこにアタッチされたプラグインに渡すペイロードを、1 行の JSON としてこのディレクトリに書き込みます。内容はビルドがプラグインに渡すものとまったく同じで、ビルドがプラグインに対して伏せる値はすべて伏せられています。annotation-transform、label-transform、ir-verdict では、このファイルはそのロールのポリシーが読み取る input ドキュメントです。render-verdict では、ポリシーエンジンがポリシーの読み取り前にペイロードを再構成する(各成果物の documents がそこから解析される)ため、組み込みエンジン上の render-verdict ポリシーは、warn または info で報告するようにアタッチしてビルドの中でテストします。.wasm を自分でビルドしたプラグインの場合は、aggrega plugin run-local --plugin <plugin.wasm> --export verdict_render --with @<dir>/render-verdict.json がそのファイルに対してプラグインを実行します。何もアタッチされていないロールも、ソースも設定も持たないアタッチメントが受け取るペイロードとして書き込まれるため、アタッチする前にポリシーを書くことができます。各ロールは <role>.json(annotation-transform、label-transform、ir-verdict、render-verdict)に書き込まれます。1 つのロールのアタッチメントが異なるペイロードを受け取る場合(あるアタッチメントが独自のソースや設定を持つ場合や、トランスフォームが次のアタッチメントの読み取る内容を変える場合)は、代わりにそれぞれが <role>.<position>.<plugin>.json に書き込まれます。position はワークスペース設定に列挙された順序でそのロールのアタッチメントを 1 から数えたもので、plugin はプラグインの参照からバージョンを除いた最後のセグメントであり、ファイル名に使えない文字はエスケープされます。ディレクトリにすでにある同名のファイルは置き換えられ、それ以外のものには触れません。ファイルはビルドが完了しても停止しても書き込まれ、あるロールの実行前に停止したビルドは、ファイルを書き込まなかった各ロールを示します。これらを要求しても、成果物も判定も変わりません。—dry-run と併用でき、その場合はこれらのファイルだけが書き込まれます。出力ディレクトリとロックファイルは変更されません |
--progress | false | stderr が端末でない場合でもビルド進捗表示を強制的に有効にし、各ステップの完了時にその所要時間とともに 1 行のプレーンテキストを表示します。デフォルトは auto です。対話的なフェーズチェックリストは stderr がエスケープシーケンスを解釈する端末である場合にのみ表示され、解釈しない端末には同じプレーンな行が出力され、リダイレクトまたはパイプされた出力には何も出力されません。—quiet と —debug はどちらも —progress より優先されます |
--quiet | false | stderr のビルド進捗表示を抑制します。stdout には影響しません。—progress より優先されます |
--release | — | Release YAML ファイルへのパスです(必須)。相対パスは、ワークスペースルートではなく、コマンドを実行したディレクトリを基準に解決されます。そのディレクトリがどのワークスペースにも属さず、ルートも指定されていない場合、絶対パスでは Release 自身のフォルダからワークスペースを探します |
--trace | false | 事後調査のために、ノードごとの中間ファイルをワークスペースルート配下の dist/ の隣にある .trace/ に書き込みます |
--trace-unredacted | false | 機密と宣言された値を、その代わりとなる |
--unredacted | false | 作成者が機密と宣言した値を、除外せずに表示します。出力が届く先(端末、パイプ、ファイル、画面録画)はすべて、それらの値を平文で保持することになります。影響するのは —ir-graph が書き込むグラフのみであるため、—ir-graph が必要です。.trace/ ファイルには代わりに —trace-unredacted を使用します |
--upgrade | false | auto-pull ステップを完全な更新にします。既存のロックファイルを破棄し、既存のピンを尊重する代わりに各依存関係を利用可能な最新バージョンに移行させながら、現在のレジストリの状態からすべての依存関係を再解決します。—auto-pull を暗黙的に含み、単独ではビルドの前に完全更新の pull を実行します。対象を取らないため、1 つの依存関係に絞り込むことはできません。単一のピンを採用または削除するには、代わりに aggrega pull —upgrade —release |
--verify-determinism | false | すべてのノードを 2 回レンダリングして出力バイトを比較し、いずれかのノードの 2 回のレンダリングが異なる場合はビルドを停止します。デフォルトはオフです。provider が決定論的にレンダリングすること(同一の入力がバイト単位で同一の出力を生むこと)を確認するために使用します。GitOps の差分とバイト単位で同一の出力の保証はこれに依存しています |
--yes | false | 非対話的な使用のために、—upgrade の確認に事前に回答します。影響するのはその 1 つのプロンプトのみです。更新を行わないビルドは何も尋ねないため、その場合に渡しても動作は変わりません |