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

aggrega pull

aggrega pull は Release のすべての依存関係を解決し、すべての依存関係を正確なバージョンとコンテンツダイジェストに固定する lockfile を書き出します。その後の aggrega build は lockfile が固定したものを使用して検証し、必要なものが lockfile に固定されていなければ、それを名指しして停止します。これにより、ビルドは再現可能になり、オフラインでも実行できます。

ビルドが消費するものはすべて、この一時点で固定されます。 カタログのエンティティ、Recipe が provider に指し示すソースアーティファクト、provider がレンダリング中に要求するリモートドキュメントは、同じコマンドで解決され、同じ lockfile の書き込みに記録されます。ネットワークにアクセスするのは aggrega pull のステップであり、build はアクセスしません。規則はこれがすべてであり、このページの残りはここから導かれる内容です。

動作

aggrega pull は 1 回のパスで 3 種類の依存関係を解決します。

  • カタログのエンティティ — Release が参照する Components、Features、Recipes、FeatureRecipes、スキーマライブラリとマッピングライブラリ、および Wasm プラグインです。これらは推移的に(extends:、implements:、aggregate:、Feature のアタッチメント、ライブラリの $import: / $ref: 箇所を通じて)解決され、まだローカルにない場合はレジストリから取得されます。
  • ソースアーティファクト — 個々の Recipe または FeatureRecipe が provider に指し示すリモートの source: です。Helm チャート(OCI または従来の HTTPS)や、HTTPS 経由の Compose フラグメントがこれにあたります。それぞれが取得、キャッシュ、固定されます。
  • 外部入力 — provider がレンダリング中にホストに要求するリモートドキュメントです。たとえば、チャートの values.schema.json 内で URL を指す $ref がこれにあたります。それぞれが取得され、コンテンツダイジェストの下に保存され、固定されます。

3 つのうち 2 つは、作成したドキュメントから読み取られます。3 つ目はそうではありません。外部入力は Release をレンダリングすることで見つかるため、このコマンドは Release をレンダリングします。コマンドを実行するうえでこの点を理解する必要はありません。解決が外部入力を見つける仕組みで、レンダリングのコスト、レンダリングを完了できない場合の動作、自身の lockfile を埋めるビルドとの関係とあわせて詳しく説明しています。

レジストリを指定せずに名前を挙げたカタログのエンティティは、ワークスペースの default_registry を通じて取得され、そのデフォルトが持つリポジトリパスが取得元になります。 default_registry: ghcr.io/acme の場合、core/api-server は ghcr.io/acme/component/core/api-server から取得されます。これは aggrega push が同じデフォルトを通じて公開する場所であり、署名もそこで探されます。パスは場所を示すだけです。pull が要求する署名、信頼する鍵と ID、提示する認証情報はホストごとに保持されるものであるため、ghcr.io の registries エントリがそのホスト上のすべてのパスを管理します。lockfile はこのようなエンティティを、ホストのみから取得したエンティティと同様に、ID、バージョン、ダイジェストで記録します。パスの書き方はレジストリホストの書き方で説明しています。

結果は Release の隣の <release-stem>.lock に書き出されます。受け入れまたは拒否の判定を返すプラグインをアタッチしたワークスペースでは、そのディレクトリに 2 つ目のファイルであるプラグイン信頼レコードも作成されます。

固定を求められた pull は、もう 1 種類のファイルを書き出します。 カタログディレクトリ内の Recipe と FeatureRecipe のうち、アーティファクトファイルをインポートするもの、完全に書き出したリモートの source: を指すもの、または隣にある source: を読み込むものの隣には、そのコンテンツのダイジェストを記録する entity.lock が置かれます。その記録はエンティティ作成者のステップである aggrega pin が行うもので、デフォルトでは pull はこれを行いません。pull は、そのような各エンティティのロックをこのステップが記録するはずの内容と照合し、固定が欠けている箇所で停止します。aggrega pull --pin-sources、または pin_sources_at_pull: true を設定したワークスペースでは、代わりにこのステップが実行されます。この場合、pull の影響は Release があるディレクトリの外にまで及びますが、作成したエンティティファイルが書き換えられることはありません。このファイルについてはエンティティロックで説明し、pull が書き出す内容のプレビューでは、何かが変更される前にワークスペース全体の対象を確認できます。

参照が何にも解決されなかったために拒否された pull は、どこで実行されても、ローカルエンティティの読み込み元を示します。 拒否には、ワークスペース自身による、ローカルエンティティを読み込んだディレクトリと、そのエンティティが読み込まれるようにするために変更すべき内容の説明が含まれます。これはローカルエンティティの読み込み元の注記が示すものです。この説明は、このコマンド、最初に依存関係を解決するビルド、aggrega mcp の pull ツール、エディタの依存関係解決のいずれからも同様に含まれます。これらすべてが実行する解決処理がこの説明を構成するためです。pull ツールの拒否には、ターミナルが拒否の先頭に短いコードを表示するのと同様に、その状態の短いコードと説明的なコードも含まれます。それらのディレクトリにあり、Aggrega の apiVersion を宣言している(インデントなしで apiVersion: から始まり、値が aggrega.ai/ で始まる行がある)ものの、たとえば YAML として解析できないなどの理由でロードできなかったファイルは、同じ拒否の中で、ロード時にスキップされたカタログファイルの 1 つとして、パーサー自身が示した理由とともに示されます。そのようなファイルは参照が指すエンティティを宣言しているファイルである可能性があり、しかもそこからは、どのエンティティを宣言しているかを示すものを何も読み取れないためです。別の apiVersion を宣言している YAML ファイルや、何も宣言していない YAML ファイルは Aggrega ドキュメントではなく、そこで示されることはありません。

ロックファイル

ロックファイルは、各依存関係をその URI、解決されたバージョン、コンテンツダイジェストに固定します。ロックファイルには、カタログエンティティ、スキーマライブラリとマッピングライブラリ(それぞれ、それを使用する Components と Features への逆参照を持ちます)、Wasm プラグイン、ソースアーティファクト、外部入力(それぞれ URL をキーとし、それを要求したプラグインを持ちます)、および Release ファイル自体のセクションがあります。ファイルは正規化された決定的な形式で書き出されます。

エンティティは、その公開物が含むものによって記録されます。 エンティティの行のダイジェストは、そのドキュメントと、それが名前を挙げる隣接するすべてのファイルを対象とします。Recipe または FeatureRecipe のローカルの source:、$import: が名前を挙げる各ファイル、隣にある entity.lock、Component または Feature がインポートする各スキーマファイルであり、aggrega push が公開するのと同じ集合です。各ファイルはそのパスとバイト列を寄与し、それ以外は何も寄与しません。アーカイブの圧縮方法、タイムスタンプ、パーミッションビット(実行ビットを含む)は寄与しません。ファイルの名前を挙げないエンティティは、その 1 つのドキュメントとして記録されます。したがって、同じエンティティは、カタログディレクトリから読み込まれた場合でもレジストリから取得された場合でも同じダイジェストを記録し、あるチェックアウトからコミットされたロックファイルは、同じコミットの別のチェックアウト上で、その umask にかかわらず、またそのチェックアウトのシステムがどのファイルが実行可能かを記録するかどうかにかかわらず検証に通ります。Recipe の下で編集されたチャート、それが宣言するソースに追加されたファイル、変更された entity.lock は、いずれもダイジェストを変更します。実行ビットが反転したスクリプトや、エンティティの隣にある何からも名前を挙げられていないメモは変更しません。Release が名前を挙げる Aggregate と Manifest も同じ方法で、それぞれ 1 つのドキュメントとして記録されます。ライブラリはそのバイト列のダイジェストによって記録され、これはどこから読み込まれてもそのドキュメントです。

Manifest がバインドするすべての Recipe と FeatureRecipe は、どの階層がバインドしていても 1 行になります。 Manifest の name 階層が 1 つのインスタンスまたは 1 つのアタッチメントに対して選択する実現は、type 階層がある型のすべてのインスタンスに対して選択するものとまったく同じように取得・記録され、その行の referenced_from はそれをバインドするエントリ(manifest.spec.mappings.components.name.<instance> または manifest.spec.mappings.features.name.<attachment>)を示します。ビルドはそれをその行に照合するため、それを記録していないロックファイルは、その実現とそのエントリを示してビルドを停止させます。2 つの階層については Flat URI mapping を参照してください。

接続のアタッチメントは、コンポーネント自身のアタッチメントとまったく同じく依存関係です。 接続上のアタッチメントが名前を挙げる Feature は、Aggregate 内のコンポーネントの uses: エントリに書かれたものであれ、Release 内の接続エントリに書かれたものであれ、コンポーネント自体に書かれたアタッチメントの Feature と同様に取得・記録され、その行の referenced_from は作成者が書いた接続エントリを示し、末尾は .uses.<socket>.<alias>.features.<slot>.type となります。Manifest がそれにバインドする実現も、features.type がバインドする場合でも、アタッチメントの名前 <alias>.<slot> をキーとする features.name がバインドする場合でも 1 行になります。ビルドは両方をそれぞれの行に照合します。いずれかを欠くロックファイルは、参照とそれを要求するエントリを示してビルドを停止させ、プル以降に内容が変更された Feature は、両方のダイジェストを示してビルドを停止させます。アタッチメント自体については the Aggregate’s connection entry を参照してください。

Component または Feature が拡張するベースは、他の何かがそれを指しているかどうかにかかわらず、1 つの行になります。 プルは各 extends: をチェーンの終端までたどり、すべてのベースをそれ自身の種別のもとに記録します。その行の referenced_from は、拡張する側のエンティティの spec.extends、つまり component(<name>:<version>).spec.extends を示します。ビルドはその行からベースを読むため、Manifest はラッパー自身の型をマッピングし、そのベースのための行は必要ありません。どのカタログディレクトリ、キャッシュ、レジストリにも存在しないベースは、チェーンがマージされる箇所で報告されます。An extends: chain cannot be assembled(チェーンを組み立てられない) を参照してください。

Release は名前だけでなく、その内容によって記録されます。 Release が要求するすべてのもの(ソースがどのチャートバージョンに解決されるか、どのコンポーネントがどの境界に配置されるか)はファイルの内容から解決されるため、release_documents は、Release とそれが拡張する各 Release のダイジェストを、それを名前で示す release とともに記録します。プル後に Release を編集すると、次のビルドは何もレンダリングされる前に停止し、編集したファイルを示して再度プルするよう促します。通常の aggrega pull --release <release> は、他のすべてのピンを尊重しつつその編集を記録します。ダイジェストはファイルのバイト列そのものを対象とするため、Aggregate や Manifest の場合とまったく同じく、コメントや空白の変更も含まれます。Release が parameters を通じてインポートするファイルは、この方法では記録されません。

pull は、署名をチェックするすべてのアーティファクトについて非推奨マーカーを探し、見つかったものを伝えます。 マーカー自身の署名が、pull が認める署名者(アーティファクト自身の署名者、またはレジストリの trusted_deprecation_identities にある ID)に対して検証された場合、そのマーカーは記録され、重大度とマーカーの署名者とともに通知されます。pull が見つけたものの認められなかったマーカー(読み取れない、署名されていない、ポリシーが信頼しない者が署名した、またはチェックできない署名を持つもの)は、理由とともに marker present but not honored として報告され、記録されません。完了できなかった検索(pull がアーティファクトのレジストリを開けなかった、またはアーティファクトに添付されているものの一覧が応答しなかった場合)は、理由とともに marker lookup did not complete として報告され、何も記録しません。マーカーが存在するかどうかについて、pull は何もわからなかったためです。レジストリ自身の信頼ポリシーがアーティファクトの種類に署名を要求し、かつ advisory でない場合は、この 2 つのいずれも、報告される代わりに pull を停止させます。マーカーを持たないアーティファクトは行を出力しません。また、ワークスペースまたはアーティファクトのレジストリについて署名検証が無効になっている場合は、マーカーは探されません。

<release-stem>.lock は、固定された依存関係のマニフェストをコミットするのと同じように、Release とともにコミットしてください。ロックファイルの差分は、どの依存関係のバージョンとダイジェストが変更されたかをレビュアーに正確に示します。ライブラリのダイジェストの変更は、影響を受ける利用側を示します。

あるプルが実行したこと、すなわち各エンティティがレジストリから新たに取得されたか(fetched-fresh)、キャッシュスロットを再利用したか(cache-reuse)、ローカルカタログで見つかったか(local)、コンパイラバイナリ内のコピーから提供されたか(in-binary)、外部であったか(external:Release 自身の Aggregate または Manifest で、その依存関係の 1 つとして解決されるのではなく、Release が名前を挙げるファイルまたはエントリから読み込まれたもの。プルがレジストリから取得した Aggregate は代わりに fetched-fresh になります)は、--detail によって stdout に出力される一時的なプルイベント診断であり、ロックファイルには書き込まれません。どのソースがエンティティを提供したかはプルするマシンのローカル状態に依存するため、これを永続化するとマシン間でのロックファイルのバイト同一性が損なわれます。これはこのプルが実行したことを報告するもので、後から復元することはできません(新たにプルされたエンティティは次回の実行でキャッシュされます)。Release の依存関係のプル後の解決状態については、aggrega inspect を使用してください。

エンティティロック

Recipe または FeatureRecipe は、自身のドキュメントの外にあるバイト列に依存することがあります。リモートの source: から取得するチャートやフラグメント、artifacts のエントリ(または Recipe の boundary.artifacts のエントリ)が $import で取り込むファイル、あるいはディレクトリやエンティティの隣のファイルを指定する source: のファイルです。それぞれのダイジェストは、エンティティファイルと同じディレクトリにある entity.lock という名前のファイルに記録されます。作成したエンティティファイル自体に書き込まれることはなく、導出された内容はその隣に置かれます。エンティティロックのスキーマで、このファイルをフィールドごとに説明しています。

誰が書き込むか。 書き込むのは 1 つのステップ、aggrega pin です。これはエンティティの作成者が実行し、Release を必要とせず、ロックが保持するすべての種類のピンを記録します。aggrega pull --pin-sources と aggrega push --pin-sources は、作成者に代わって同じステップを実行し、同じバイト列を書き込みます。ピン留めを求められていないプルは、ロックを一切書き込みません。Release がカタログディレクトリから構築する各 Recipe と FeatureRecipe について、ステップが記録する内容とロックが保持する内容を比較し、ピンが欠けているか入力と一致しなくなっている箇所で停止し、エンティティ、各入力とその種類、そして aggrega pin を示します。ローカルソースのファイルは 1 つの集合としてピンと照合されます。そのどれも記録していないロックはプルを停止させ、ピン留め以降に追加、変更、削除されたファイルも同様に停止させます。ワークスペースキー pin_sources_at_pull を使うとピン留めがすべてのプルのデフォルトになり、--pin-sources=false で 1 回の実行に限り停止の動作に戻せます。ピン留めは作成者の責務であるため、利用者の最初のプルで停止した場合は、エンティティの公開者がピン留めしていなかったことを意味します。利用者の対処は、他人のディレクトリを手で編集することではなく、このキーを使うことです。詳しくは aggrega pin で説明しています。

保持する内容。 3 つのリストがあり、各行が 1 つの入力を示します。

  • sourceDigests — 座標を完全に書き出した、つまり kind、url、chart、module_subdir、version、ref にテンプレートを含まないリモートの source: ごとに 1 行です。行には、ソースの kind と url、あれば chart または module_subdir、解決されたバージョン(git ソースの場合は ref が指したコミット)、取得したアーカイブのコンテンツダイジェスト、さらに OCI 経由で取得したチャートの場合はマニフェストダイジェストが含まれます。
  • artifactDigests — $import でインポートしたファイルが提供する artifacts または boundary.artifacts のエントリごとに 1 行で、エントリとファイルのバイト列のダイジェストを示します。artifacts のエントリはキーで、boundary.artifacts のエントリは boundary/<key> として示されるため、同じキーで書かれた各ブロックのエントリは別々にピン留めされます。
  • localSourceDigests — ディレクトリまたはエンティティの隣のファイルを指定する source: が、エンティティの公開物に含めるファイルごとに 1 行で、エンティティからのファイルのパスとそのバイト列のダイジェストを示します。このようなソースでは何も取得されず、ファイルはそのままの状態でダイジェストされます。テンプレートとして書かれたソースはエンティティのディレクトリ内のすべてのファイルを含めるため、それぞれに行があります。

保持しない内容:

  • 座標がテンプレートから埋められるリモートソース — たとえば .infra から読み取る version です。どのアーティファクトを指すかはエンティティを使う各 Release が決めるため、解決された各バージョンはその Release のロックファイルにピン留めされ、エンティティの隣には何も書き込まれません。
  • インラインの artifacts または boundary.artifacts のエントリ(エンティティファイルの一部です)と、ArtifactLibrary から取得したエントリ(内容はロックファイルが記録するライブラリのバージョンでピン留めされます)。

ピン留めするものがないエンティティには entity.lock が作られず、もう必要としなくなったエンティティに対してステップを実行すると、それは削除されます。

エンティティの隣にコミットします。 すべての Recipe と FeatureRecipe は同じファイル名を使い、置かれたディレクトリがどのエンティティに属するかを示すため、ロックはそのディレクトリとともに移動します。タイムスタンプを持たず、行は固定の順序で保たれるため、入力が変わらなければステップを実行してもバイト単位で同一のままであり、その差分は変化したソース、インポートされたファイル、またはローカルソースのファイルを示します。1 つのディレクトリは 1 つのロックを保持するため、ステップは隣に他のエンティティがある Recipe や FeatureRecipe を拒否し(Aggregate、Release、Manifest 以外のすべての種類は専用のディレクトリを持ちます)、ピン留めを求められたプルは何かを解決する前にそのようなエンティティを拒否します。この規則は 1 ディレクトリに 1 エンティティで説明しています。ピン留めしないプルはエンティティの隣に何も書き込まず、そのディレクトリを判定しません。

aggrega build はファイルをロックと照合します。 ビルドはロックを読み取り、3 つの比較を行います。

  • インポートされた各ファイルを再度ダイジェストし、その行と比較します。boundary.artifacts のファイルも artifacts のファイルとまったく同様です。ピン留め後に編集されたファイルは [CATALOG_ERROR E0026] でビルドを停止させ、行が示すとおりのアーティファクト名、インポートされたファイル、両方のダイジェストを示します。
  • ローカルソースのファイルを再度ダイジェストし、1 つの集合としてその行と比較します。これはプロバイダがソースを読む前に行われます。ピン留め以降に編集、追加、削除されたファイルは、そのソースを持つコンポーネントインスタンスの下で E0305 によりビルドを停止させ、該当する各ファイルと両方のダイジェストを示します。エンティティの隣にあってもソースに含まれないファイルは比較されません。ローカルソースの行を 1 つも記録していないロックでは比較するものがなく、これは A local source no longer matches the pins recorded beside its Recipe(ローカルソースが Recipe の隣に記録されたピンと一致しなくなった) で説明しています。
  • 各ソース行を、Release のロックファイルが同じソースについて記録するダイジェストと比較します。 不一致は [FETCH_ERROR E0135] でビルドを停止させ、ロックと両方のダイジェストを示します。この 2 つのファイルは同じソースの 2 つの解決(ピンステップのものとプルのもの)によって書かれるため、それらの解決が異なるバイト列を得た場合、または 2 つのファイルのいずれかが編集された場合に不一致になります。1 つのバージョンで異なるバイト列が得られるのは、上流がバージョンを再公開した場合の典型的な状況です。

変更前に書かれたロックファイルが先に停止し、プルがファイルを示します。 ロックファイルはエンティティをその内容によって記録し、ロックとこれらの比較が読むすべてのファイルはその一部です。そのため、インポートされたファイル、ローカルソースのファイル、またはロック自体が変化する前に書かれたロックファイルを持つビルド(または aggrega pull --verify)は、3 つの比較のいずれかが実行される前に The lockfile no longer matches what the release resolves to(ロックファイルが Release の解決結果と一致しなくなった) で停止し、エンティティと両方のダイジェストを示します。その後、通常の aggrega pull がファイルを示します。プルはロックをピンステップが記録する内容と照合し、ピンが一致しなくなった入力を拒否するためです: An entity reads an input the lock beside it records no pin for(エンティティが、隣のロックにピンが記録されていない入力を読み取る)。

ロックファイルにエンティティ自体の内容の記録がない場合、ビルドが行き当たるのはこの 3 つの比較です。 Manifest が、Release が到達する Component または Feature の名前でもある参照で指定する Recipe や FeatureRecipe は、独自のエントリを持ちません。その参照に対するロックファイルのエントリは Component または Feature を記録するため、Recipe のファイルが変化してもロックファイルは何も変わらず、ビルドと検証プルは上記のコードで変化したファイルを報告します。また、ロックファイルの source_artifacts エントリが変更され、エンティティの隣のロックが変更されていない場合にも、ビルドが行き当たるのはソース行の比較です。

halt への対処。 インポートしたファイルを意図的に変更した場合は、そのエンティティに対して aggrega pin を実行します。このステップがファイルの新しいダイジェストを記録し、次のビルドはそれを受け入れます。意図していない場合は、ファイルを元に戻します。変化したローカルソースにも同じ 2 つの対処があります。エンティティを再度ピン留めするか、halt が挙げたファイルを元に戻します。lockfile と一致しないソース行については、バージョン管理から entity.lock を復元するか、エンティティに対して aggrega pin を実行して書き直します。

aggrega pull --verify もこれを検査します。 検証用の pull は、Release がカタログディレクトリ内で到達する Recipes と FeatureRecipes の隣にある lock に対して同じ 3 つの比較を行い、ビルドが拒否するピンをすべて同じコード・同じ文言で報告し、1 つでもあれば 0 以外の終了コードで終了します。lock は書き込みません。

lock が比較されない場合。 カタログディレクトリではなくレジストリから解決された Recipe または FeatureRecipe には、ビルドが読む lock がありません。そのソースは Release の lockfile のみと照合されます。また、git の ref: で書かれたソースは、その ref が解決されたコミットで lock に記録される一方、ビルドはエンティティが指定するバージョンでソースのピンを探すため、その行はビルドでも検証用の pull でも比較されません。それでも lockfile はコミットをピン留めしており、すべてのビルドがキャッシュされたアーカイブをそれに照らして検証します。

プラグイン信頼レコード

ワークスペースがアタッチするプラグインの中には、レンダリング出力にまったく影響しないものがあります。ir-verdict または render-verdict ロールの plugins.governance アタッチメント、およびすべての plugins.linter アタッチメントは、受理か拒否かの判定を返すだけで、それ以外は何も返しません。これらのバイトが成果物に入ることはありません。そのため、これらはビルドがバイト単位で再現する対象には含まれず、まさにその対象を固定するロックファイルは、これらを置く場所として適切ではありません。

代わりに、これらのアイデンティティは 2 つ目のコミット対象ファイル、すなわちロックファイルの隣にある plugins-trust.yaml に記録されます。このファイルには該当するプラグインごとに 1 つのエントリがあり、プラグインのアイデンティティ座標、そのプラグインに選択されたバージョン、解決された成果物のコンテンツダイジェストを記録します。さらに、pull がその成果物について署名を検証した場合はその署名を、発行者が公開後にその成果物を非推奨にした場合は pull が検出して検証したマーカーを記録します。プラグイン信頼レコードのスキーマで、このファイルをフィールドごとに説明しています。

ロックファイルをコミットするのと同じ理由で、plugins-trust.yaml もロックファイルと一緒にコミットしてください。バージョン管理の外に置かれたレコードは、誰もレビューできず、何とも比較できません。コミットされていれば、それらの各アタッチメントがどのプラグインに解決されたかを示す共有された 1 つの記述となり、その差分は変更されたアイデンティティを示します。

このファイルは記録すべきものがある場合にのみ作成されます。 判定を返すプラグインを 1 つもアタッチしていないワークスペースは、そのようなアイデンティティを解決しないため、pull はファイルを書き込まず、ファイルについて何も表示しません。これはファイルの欠落ではなく、単に存在しないということです。pull がファイルを作成した場合は、作成したファイルを示し、コミットするよう案内します。後続の pull は、レコードにまだないアイデンティティを追加し、すでに記録されているアイデンティティはすべてそのまま残します。

このファイルへの変更はすべて通知され、それ以外は通知されません。 レコードを変更する pull は、変更されたエントリごとに 1 行を出力し、プラグインと変更の種類を示します。変更の種類は、初めて記録されたアイデンティティ、保持されていたものに代えて採用されたアイデンティティ(何が入れ替わったかわかるよう両方を示します)、エントリがすでに示している成果物に対して記録された非推奨、エントリから解除された非推奨、エントリに対して記録または解除された署名、あるいはエントリの削除です。前述の作成時の行はこれとは別で、エントリではなくファイルに関するものです。そのため最初の解決では両方が表示されます。つまり、このファイルは新しく、コミットが必要であること、そしてこれらが現在保持されているアイデンティティであることです。

レコードをまったく変更しない pull は、レコードについて何も表示しません。 したがって、このファイルに関する行が表示された場合は、コミット済みのファイルが変更されており、その差分は確認する価値があります。これはロックファイルの場合以上に重要です。ロックファイルが固定するものはすべてビルドがバイト単位で再現する対象にも含まれるため、そこでの変更は別の場所にも現れますが、判定プラグインのアイデンティティにはそのような場所がありません。入れ替えられたゲートが記録される場所は、このファイルだけです。

aggrega pull --dry-run は何も変更しないため、これらを一切通知しません。代わりに、pull が書き込む内容のプレビューで説明しているとおり、書き込む予定のファイルの中にこのレコードを列挙します。

非推奨はレコードがすでに保持しているエントリに追加されるものであり、エントリの書き換えとは異なります。 すでに信頼しているプラグインを発行者が非推奨にした場合、次の aggrega pull はそのプラグインの既存エントリにマーカーを記録します。成果物は変わっておらず、新たに採用されるものもないため、座標、バージョン、ダイジェストには手を触れません。つまり、通常の pull は deprecation ブロックを追加することがあり、アイデンティティを変更するのは明示的なアップグレードだけです。マーカーはエントリがすでに示している成果物に対してのみ記録され、公開されなくなったマーカーを pull が追跡することはありません。記録されたマーカーが消えるのは、それを持つエントリと一緒の場合だけです。すなわち、そのエントリが削除されたとき、または明示的なアップグレードでプラグインが再解決され、エントリがすでに記録しているバイトにマーカーが見つからなかったときです。

検証された署名も同じ方法でエントリに記録され、pull のたびに改めて判定されます。 pull は実行のたびに、これらの各プラグインの署名をそのレジストリのトラストポリシーに照らして検証し(レジストリが提供するプラグインは何にも固定されていないため、毎回バージョンで取得されます)、検証した内容を、ここでもアイデンティティには手を触れずにプラグインのエントリに記録します。記録されるのは、モード、一致した署名者、キャッシュした署名バンドルのダイジェストで、ロックファイルのエントリが持つものと同じ signature です。マーカーとは異なり、この判定結果はエントリが保持していた内容を置き換えます。pull が署名を検証しなかった場合、つまりプラグインに署名がなく署名も要求されていない場合や、skip_signature_verification または advisory レジストリによって受け入れられた場合、エントリには何も記録されません。検証した署名バンドルも改めてキャッシュされ、ダイジェストと一致しなくなったキャッシュのコピーは書き直されます。そのため、署名を失ったエントリ、別のプラグインの署名がコピーされたエントリ、キャッシュされた署名バンドルが削除または改変されたエントリ、あるいは削除されたレコードや署名が記録される前に書かれたレコードは、次の通常の aggrega pull で修復されます。ビルドはこうした各プラグインをその事実に照らして検査します。ビルドのページのプラグイン信頼レコードを参照してください。

解決されたアイデンティティが記録と一致しない場合、pull は停止します。 記録されたエントリはバージョンとダイジェストの両方を示しているため、どちらが変わっても同じ事態です。つまり、実行されるプラグインは、レコードがレビューされた対象のプラグインではありません。診断は、プラグイン、レコードが保持している内容、今回の解決で報告された内容を、両方の軸について同時に示します。そして pull はレコードに手を触れずに停止するため、レビュー済みのアイデンティティは比較対象として残ります。バージョンだけの変化(バイトが変わっていない再公開)でも、ダイジェストだけの変化(同じバージョンでの再プッシュ)とまったく同じように停止します。

aggrega pull --verify も同じ比較を行います。pull がコミットするファイルを一切書き込まないため、何も採用しません。それらのファイルが、現時点で pull が解決する内容を引き続き記述しているかどうかを報告し、このレコードもそうしたファイルの 1 つです。また、各エントリの署名を、pull 自身によるそのプラグインの検証結果とも照合し、pull が署名を記録、置換、または解除するエントリを報告します。さらに、レコードにエントリがなく、署名が記録されていないためにビルドが拒否するプラグインも報告します。詳しくは記録された署名を両方のファイルで比較しますを参照してください。

新しいアイデンティティを採用するには、名前を指定して要求します: aggrega pull --upgrade --release <release> <plugin> を実行し、プラグインは .aggrega-config.yaml のアタッチメントでの名前のとおりに、バージョンの接尾辞を付けずに指定します。これによりそのプラグインだけが再解決されてエントリが書き直され、ほかの固定された依存関係や記録済みアイデンティティには一切手を触れません。プラグインにロックファイルの固定がなくても機能します。名前で指定するターゲットには、それらのアタッチメントも指定できるためです。引数なしの aggrega pull --upgrade はすべての依存関係を再解決し、記録されたすべてのアイデンティティも再解決して書き直します。aggrega build --upgrade も同様です。これは引数なしの全面更新 pull を実行するもので、単一のターゲットを指定する手段はありません。

アイデンティティを削除する場合も、名前を指定して要求します。 .aggrega-config.yaml からプラグインのアタッチを外してもエントリは消えません。これは意図的なもので、通常の aggrega pull がエントリを削除することはありません。aggrega pull --upgrade --release <release> <plugin> を実行し、プラグインはレコードでの名前、すなわちアイデンティティ座標(後述の停止時に出力される文字列)で指定すると、そのエントリが削除され、ほかの固定された依存関係や記録済みアイデンティティには一切手を触れません。引数なしの aggrega pull --upgrade は、ほかのすべてを再解決するのと同じ処理の中で、どの判定アタッチメントからも参照されなくなったエントリをすべて削除します。

最後のエントリを削除しても、ファイルは削除されず、空のまま残ります。空のレコードは何も保持しないため、何もピン留めせず、何も停止させません。これはレコードがまったくない場合と同じです。ファイルを残しておくことで、削除がその diff に削除として現れます。

スキーマを満たさないレコードは、それを読み込むすべてのコマンドを停止させます。対象はビルド、リリーススコープの lint、そして pull で、自身で記録するものが何もない pull も含みます。空にされたレコードと破損したレコードは意図的に区別されています。空にすることは最後のエントリを削除する方法であり、空にされたレコードは何も通知しません。一方、内容がもはやパースできないファイルは空のレコードではなく障害です。これを空として読み込むと、ファイルを切り詰めることで比較を無効にできてしまいます。レビュー済みの識別情報を取り戻すには、バージョン管理から復元してください。

コンパイラバイナリ内のコピーから提供されるプラグインは記録されません。 pull が記録するのは、取得したもの、つまりレジストリからフェッチしたもの、またはキャッシュから読み込んだものです。バイナリからは何も取得されません。それらのバイトは、それを含むコンパイラのバージョンによって識別されるため、記録すべき独自の解決がありません。したがって、バイナリがすでに含んでいるプラグインをアタッチしても、そのエントリは作成されません。これはレコードが取得されたアーティファクトのみを対象としているためであり、解決が失敗したわけではありません。

ビルド、リリーススコープの lint、リリーススコープの検証は、ワークスペース設定をレコードと照合します。 これらのアタッチメントが実行される前に、aggrega build、aggrega lint --release、aggrega validate --release(および aggrega serve と aggrega mcp を通じて到達する同じ操作)は、設定が指定する判定アタッチメントを、レコードが保持するエントリと比較します。解決されたアーティファクトのダイジェストが記録されたものと異なるプラグインは、実行されずに拒否されます。設定されたどの判定アタッチメントにも対応しないレコードエントリは、実行を停止させます。レビュー済みで現在は存在しないゲートは、そのゲートが承認した出力と区別できない出力を残し、それはまさに出力を読む人には見えないことだからです。停止時にはプラグイン名が示され、意図に応じた 2 つの対処法が提示されます。削除が誤りであればプラグインを再度アタッチし、意図的であれば上記の明示的なアップグレードを実行します。そのアップグレードは、すぐに実行できる形で出力されます。逆方向、つまりレコードがまだ保持していないアタッチメントは、上記の初回検出にあたり、どちらの比較でも停止しません。署名の要件は、エントリのないアタッチメントも免れない唯一の照合です。同じ 3 つの操作は、キャッシュから読み込む各プラグインを、読み込み時にそのエントリが記録する署名と照合します。ビルドについてはビルドのページで説明しています。カタログ全体および単一エンティティの lint スコープは、レコードを参照しません。

検証がレコードと照合されるのは、ビルドが実行するのと同じチェックを実行するためです。 aggrega validate --release は、アーティファクトの書き込みを除き、ゲートプラグインを含めて aggrega build が到達するすべてのチェックに到達します。これにより「検証が通る」ことが「ビルドが通る」ことと同じ意味になります。そのため、実行するプラグインの識別情報は、ビルドの場合とまったく同じようにレコードと比較されます。aggrega validate の他のスコープはレコードと照合されません。カタログ全体、単一のエンティティ、またはプラグインバイナリの検証では、ワークスペースのプラグインアタッチメントをまったく読み込まないため、判定プラグインは実行されず、レコードが照合する対象もありません。

設定をレコードと照合することで確立されるのは、存在と識別情報であり、それ以上のものではありません。 レコードが指定するすべてのゲートがまだアタッチされていること、そしてそれぞれが記録されたアーティファクトから実行されることは確立されます。しかし、実行されたゲートが実際に判定を返したことは確立されず、その一つのケースはどこでも検出されません。それは、function がプラグインの宣言しているエクスポートを指定しているものの、それがソケットの読み取る判定エクスポートではなく、かつその出力がソケットの想定する形の外にトップレベルのフィールドを持たない(最も単純なのは空オブジェクト)アタッチメントです。これは実行され、拒否の根拠を何も返さず、ビルドを通過させます。その出力は承認したゲートの出力と区別できず、レコードとのどの比較でも気付くことはできません。レコードに誤りは何もないからです。実行されたプラグインはまさに記録されたものであり、単に何も実行しなかっただけです。隣接する 2 つのケースは停止するため、この限界は読んだとおり以上には広くありません。プラグインが宣言していないエクスポートを指定する function は、プラグインの読み込み時に拒否され、ソケットの形が宣言していないトップレベルのフィールドを持つ出力は、たまたま空である判定リストとして読まれずに拒否されます。したがって、記録された識別情報だけでは、ゲートが何かを判定したことの十分な根拠にはなりません。

記録されたダイジェストが適用されるのは、ワークスペースが aggrega pull の作成するキャッシュから解決するプラグインであり、それ以外の方法で解決するものには適用されません。 これは判定アタッチメントが通常たどる解決です。ロックファイルでは何もピン留めされないため、そのバイトはキャッシュから取得され、その読み込み時に解決されたダイジェストが記録されたものと比較されます。ワークスペースが他の方法で解決する判定プラグインはその読み込みに到達せず、レコードではなく、実際に解決した方法を規定するものによって規定されます。コンパイラバイナリ内のコピーから提供されるバイトは、それを含むコンパイラのバージョンによって識別されます。カタログエンティティの隣にある .wasm は自身のカタログディレクトリ内のファイルです。明示的なファイルシステムパスは指定したパスです。ロックファイルのピンを持つプラグインは、そのピンによって規定されます。設定をレコードと照合することのもう半分には、このような限定はありません。レコードが保持するすべてのエントリは、プラグインがどのように解決されるかにかかわらず、設定されたアタッチメントによって引き続き対応付けられている必要があります。したがってレコードは、指定するゲートが何によって提供されるかにかかわらずアタッチされたままであることを確立し、キャッシュから提供されるもののアーティファクト識別情報を確立します。

尊重と更新

デフォルトでは、aggrega pull は既存のロックファイルを尊重します。すでにピン留めされた依存関係は、ピン留めされた正確なバージョンに解決され(ピン留めされたダイジェストに対して検証されます)、まだピン留めされていない参照だけが解決されて追加され、Release がもはや到達しない参照のピンは削除されます。そのため、変更のない Release を再度 pull しても何も変わりません。同じロックファイルをバイト単位で同一に再現します(generated_at を含みます)。新しい依存関係を追加した場合や、手動編集でピンを削除した後に pull した場合は、その欠けた部分だけが解決され、他のピンはすべてそのまま残ります。

**再 pull がキャッシュから読み取る依存関係は、それを取得した pull が記録したとおりに記録されます。**その行はバージョン、コンテンツの digest、manifest_digest(最後のものはキャッシュ内でコンテンツの横に格納されたマニフェストから取得されます)を保持し、その pull がレジストリで検証した signature と deprecation も保持します。ビルドがその行を受け入れる限り、これらはいずれも再度照会されません。--detail はそのような依存関係を cache-reuse として報告します。そのため、依存関係がすべてキャッシュされており、ロックファイルが信頼設定の要求するすべての署名を記録し、かつビルドが受け入れる署名のみを記録している場合、再 pull はレジストリに到達できるかどうかにかかわらず同じロックファイルを書き込みます。

再 pull が署名を再度照会するのは、ビルドがその行を拒否する場合に限られ、そのような行は 2 種類あります。

  • **ロックファイルが記録していない必須の署名。**キャッシュが提供する依存関係に対して信頼設定が署名を要求し、ロックファイルの行に署名が記録されていない場合(行が編集された、以前の pull が埋めたキャッシュの上にロックファイルが新たに書き込まれた、または行を書き込んだ pull の後に要件が追加された場合)、再 pull はその依存関係のレジストリに、キャッシュ内でその横に格納されたマニフェストのダイジェストによって署名を問い合わせます。これは取得する依存関係に対して行うのとまったく同じです。そして検証済みの署名を行に記録します。その行はビルドが拒否する行(No verified signature is recorded for an artifact that requires one(署名を必要とするアーティファクトに検証済みの署名が記録されていません))であるため、再度 pull することでその拒否が解消されます。署名を添付しないレジストリ、または信頼設定が受け入れない署名は、依存関係を取得した pull を停止するのと同様に再 pull を停止します。署名のない依存関係を pull に受け入れさせる設定は、そのような行をそのまま残し、何も問い合わせません。該当する設定は、トップレベルの skip_signature_verification、レジストリ自身のエントリ上の同じスイッチ(ワークスペース全体の署名ポリシーが要求する種類を除く)、および advisory とマークされたレジストリです。
  • **ビルドが受け入れない記録済みの署名。**行が記録している署名について、キャッシュされた署名バンドルが、それをキャッシュした pull の後に削除または改変された場合、あるいは別の行からコピーされた signature で、バンドルは無傷でも別のアーティファクトのために作成されたものである場合、ビルドは署名要件の内容にかかわらずその行を拒否します(A cached signature bundle does not match the digest recorded for it(キャッシュされた署名バンドルが、記録されたダイジェストと一致しません)、A recorded signature was made for a different artifact(記録された署名は別のアーティファクトのために作成されたものです))。そのため再 pull は、要件の内容にかかわらず、取得する依存関係と同じ検証を通じて、その依存関係のレジストリに署名を再度問い合わせます。検証された内容が行の署名を置き換え、その署名が示すバンドルが再度キャッシュされ、ダイジェストと一致しなくなったキャッシュ済みのコピーは書き直されます。こうして行とキャッシュは、依存関係を取得した pull が残した内容を保持します。信頼設定が受け入れない署名は、依存関係を取得した pull を停止するのと同様に再 pull を停止し、署名が必要な場合に署名を添付しないレジストリも同様です。検証が何も記録しない場合(適用される場合の skip_signature_verification は何も問い合わせません。署名が不要な場合に署名を添付しないレジストリ、または何も検証されない advisory レジストリも同様です)、行の署名はクリアされ、ビルドは同じ設定のもとでそれを受け入れます。

ビルドが受け入れる署名を記録している行は再度問い合わせられません。署名を記録しておらず、何も署名を要求しない行も同様です。

**レジストリを指定せずに名前が付けられた依存関係は、ワークスペースがもはや default_registry を指定していない場合、問い合わせることができません。**その行は、署名を記録した pull によってレジストリに結び付けられており、デフォルトがなければ問い合わせるレジストリがありません。そのような行がビルドの受け入れない署名を記録している場合、再 pull はビルド自身の拒否とともに停止し、その行を再度問い合わせるためのレジストリが設定されていないことを示し、ロックファイルを元のまま残します。依存関係の取得元のレジストリを default_registry として設定し、再度 pull することで修復されます。

**この尊重が対象とするのは、レジストリまたはキャッシュが提供するものです。**ローカルのカタログディレクトリが提供するエンティティは、そのディレクトリから、ファイルが宣言するバージョンで解決され、ロックファイルがそのエンティティについて記録しているエントリはその過程で参照されません。ロックファイルはそのようなエンティティも記録するため、そこに表示されます。しかし、そのエントリを手動で編集しても、エンティティは書き込んだバージョンに固定されず、次の照合でエントリはファイルに合わせて書き直されます。ローカルで提供されるエンティティについて Release が解決するバージョンを変更するには、ロックファイルではなくカタログファイルを編集してください。

**ピンは場所ではなくバイトを示すため、ピンを保持しなくなったキャッシュエントリは信頼されずにスキップされます。**その場で編集されたエンティティ(同じ version のもとでの新しい本体)は、コンテンツキャッシュにその名前とバージョンのもとで以前の本体を残します。カタログディレクトリが最初に読み取られるため、カタログディレクトリがまだ提供しているエンティティはそのファイルからピン留めされ、古いエントリは読み取られません。pull が Release の外部入力を見つけるために実行するレンダリングは、ビルドと同じ方法で、ピン留めされたバイトを保持するカタログディレクトリから各ピンを読み取り、スキップしたエントリを aggrega build が出力する通知で報告します。カタログディレクトリがエンティティを提供せず、レジストリに到達できる場合、pull はピン留めされたバージョンを再度取得し、エントリを書き直し、エントリと両方のダイジェストを示してその旨を標準エラーに出力します。

reuse: cache entry for <name>:<version> held <digest the entry held>, not the pinned <pinned digest>; refreshed from the registry (pin unchanged)

取得されたバイトは、ピンのもとでのあらゆる取得と同様にピンに照らして検証されるため、そのバージョンのもとで別のバイトを提供するレジストリは、後述のとおり pull を停止します。ピン留めされたバイトを保持するソースがない場合(カタログディレクトリがエンティティを提供せず、キャッシュエントリが別のバイトを保持し、ピン留めされたバージョンを提供するレジストリがないか、実行がどのレジストリにも到達しない場合)、pull と aggrega pull --verify は E0135(キャッシュエントリのマニフェストがロックファイルのピン留めするものでない場合は E0133)で停止し、読み取った各ソースとその内容を示します。実行がレジストリに到達しなかった場合、停止時にはピン留めされたバージョンを再度取得する手順も示されます。

**ピン留めされたバージョンを更新するには、aggrega pull --upgrade --release <release> を実行します。**既存のピンを破棄し、すべての依存関係を条件を満たす最新のバージョンに再解決します。更新は明示的な操作であり、デフォルトではピン留めされた依存関係が変動することはありません。これは npm ci / cargo / go build の慣例(デフォルトはロックを実現し、更新はオプトイン)に倣ったものであり、aggrega build の自動 pull を安全にしているのもこの点です。ビルドはロックファイルがピン留めするものを正確に解決し、バージョンを暗黙のうちに変更することはありません。

この引数なしの形式は記録済みのピンをすべて破棄するため、何かを行う前に確認を求めます。非対話的に使用する場合は --yes で事前に回答してください。標準入力が端末でなく --yes もない場合は、誰も回答できない応答を待たずに拒否します。対象を指定する形式(aggrega pull --upgrade --release <release> <uri>)は指定しなかったすべてのピンを保持するため、確認を求めません。aggrega build --upgrade は引数なしの形式を実行し、同じ条件で制限されます。

固定されたバージョンのレジストリ上のバイト列が、ロックファイルに記録された digest と一致しなくなった場合(上流での不変性違反)、pull は変更されたバイト列を黙って採用せず、整合性エラーで停止します。意図的に固定し直すには --upgrade を実行してください。

lockfile を書き込まずに検査する

aggrega pull --verify --release <release> は、今 aggrega pull を実行すると lockfile、またはその隣にあるプラグイン信頼記録が変わるかどうか、という一つの問いに答えます。pull が行う解決を同じように行い、lockfile と記録をその結果と比較し、pull がコミットするものを書き込む前に停止します。lockfile、プラグイン信頼記録、およびすべての entity.lock はそのまま残ります。lockfile が存在しない場合と差異がある場合は、それぞれの差異を示して非ゼロで終了します。非推奨マーカーは、後述のとおり比較されません。--upgrade、--dry-run と併用することはできず、--pin-sources もそのフラグにどの値を与えても併用できません。verify は entity.lock に欠けているピンを記録することも、それで停止することもないため、このフラグは何も変えないからです。

記録されたピンを pull とまったく同じように尊重します。 lockfile がピン留めしている依存関係は、ピン留めされたバージョンで解決され、ピン留めされたダイジェストと照合されます。また、ローカルのカタログディレクトリが提供するエンティティは、尊重と更新で説明するとおり、そのディレクトリから解決されます。したがって、次のようになります。

  • pull 以降にレジストリが新しいバージョンを公開した参照は、ドリフトではありません。pull はそのピンを保持するため、lockfile は依然として pull が書き込むものと同じです。新しいバージョンを採用するには aggrega pull --upgrade を使います。
  • ピン留めされたバージョンで異なるバイト列を配信するようになったレジストリは、その変化をドリフトとして報告するのではなく、pull を停止させるのと同じ整合性エラーで verify を停止させます。
  • 手作業で編集された lockfile の行、編集された Release、ローカルのカタログディレクトリで編集されたエンティティは、いずれも報告されます。それぞれが lockfile と pull が現在解決する内容との差異だからです。

pull と同じようにキャッシュを読み込み、埋めます。 キャッシュがピンに基づいて保持しているエントリ(カタログのエンティティ、またはプラグインの .wasm)は、レジストリに問い合わせずにそこから読み込まれます。これにより、接続された状態の pull がキャッシュを埋めたワークスペースに対して、オフラインの状態で verify を実行できます。キャッシュが保持していないエントリは pull と同じように取得され、ピンと一致しなくなったエントリは pull とまったく同じように扱われます。したがって verify はキャッシュに追加することはありますが、ピンを動かすことはありません。

両方のファイルで、記録された署名を比較します

pull がアーティファクトについて検証した署名は、pull が書き込む内容の一部です。つまり、lockfile エントリの signature、および verdict ロールにアタッチされたプラグインについての plugins-trust.yaml のエントリにある署名です。ピンが一致すると、verify は記録されたすべての署名を pull が現時点で記録するはずの署名と照合し、何も記録されていない箇所に pull が記録するはずの署名、置き換えるはずの署名、またはクリアするはずの署名をそれぞれ A recorded signature is not the one a pull would record(記録された署名が pull の記録するはずの署名ではありません) として報告します。どちらのファイルにあるものでも、該当するエントリはすべて同じ実行で名前が示されます。

どの lockfile エントリを照会するかは、pull 自身の選択です。 再 pull は、尊重と更新で説明するまさにその箇所でエントリの署名をレジストリに問い合わせ、verify は同じ選択を読み取ります。

  • 次の二つはレジストリに問い合わせずに報告されます。 レジストリの応答に関係なく pull がそれらを書き換えるためです。信頼設定が署名を要求しているのに署名を記録していない、キャッシュから提供されるエントリ(pull はアーティファクトの署名を記録するか、署名を確立できない場合は停止します)と、記録された署名が別のアーティファクトに対して作成されたエントリ(pull はそれをアーティファクト自身の署名で置き換えます)です。
  • pull が再度照会する他のすべてのエントリは問い合わせの対象になります。 pull がそれを変更するかどうかは、レジストリの応答によってのみ決まるためです。この verify がバイト列を取得したエントリと、キャッシュされた署名バンドルが削除された、読み取れない、または改変されたエントリが該当します。verify は pull と同じようにレジストリに問い合わせ、応答が署名を記録する、置き換える、または消去する場合にそのエントリを報告します。検証した署名バンドルは pull と同じようにキャッシュされるため、キャッシュされたバンドルが削除されていても、レジストリが記録された署名を依然として配信しているエントリは合格し、キャッシュは修復された状態になります。

記録された署名をビルドが受け入れるエントリと、署名を記録しておらず、何も署名を要求していないエントリは、pull でも verify でも問い合わせの対象になりません。

プラグイン信頼記録も同じ pull と照合されます。 すべての pull は verdict ロールにアタッチされた各プラグインの署名をそのレジストリで検証し、verify も同様に検証して、その検証が署名を記録する、置き換える、または消去するエントリを報告します。記録にエントリが無いプラグインは、署名を記録していないためにビルドがそれを拒否する場合に報告されます。pull はその署名を持つエントリを書き込み、それまではビルドがプラグインを拒否するためです。それ以外は初回の検出であり、verify は記録がまだ保持していない識別情報を報告しないのと同様に、これを報告しません。オフラインの状態では、verify はこれらのプラグインについてレジストリに問い合わせず、代わりに何を報告するかは Offline で説明します。

非推奨マーカーは比較されません。 pull の後にアーティファクトに付けられたマーカーはレジストリの状態であり、ワークスペース内の何も変わらなくても変化します。それで verify が失敗すると、触れていないファイルに対する検査が失敗することになります。同じ理由で、記録されたマーカーはビルドを停止するのではなく、ビルドに助言します。したがって、verify が合格したエントリに pull がマーカーを記録することがあります。

pull が書き込む内容のプレビュー

aggrega pull --dry-run --release <release> は、通常の pull とまったく同じように依存関係を解決し、書き込む代わりに、書き込んだはずの内容を出力します。各ファイルのパスを示すヘッダーが 1 つずつあり、その後にそのファイルが保持するはずの内容が続きます。

aggrega pull --dry-run --release release.yaml

ロックファイルだけでなく、すべてのファイルを示します。 ロックファイル、--pin-sources のもとで記録済みのピンが変わる各 Recipe および FeatureRecipe の横にある entity.lock、そしてプラグイン信頼レコードが、すべて同じレポートに現れます。ロックファイルだけを示すプレビューでは、変わるのはロックファイルだけだと誤解させてしまうためです。同じ理由で、ピン留めされていないエンティティで停止する pull は、--dry-run のもとでも停止します。プレビューが示すのは、pull が行うはずのことです。pull がバイト単位でそのまま残すファイルはまったく現れません。レポートに名前があることは、そのファイルが変更されようとしていることを意味します。最後の行はその数を数え、pull が変更しないワークスペースでは数が 0 と報告されます。

ディスク上のものは何も変わりません。 ロックファイルが書き込まれたり作成されたりすることはなく、エンティティロックが書き込まれたり削除されたりすることもなく、信頼レコードが作成されたり修正されたりすることもありません。ある機能を複数のプロバイダープラグインが提供していて、そのどれを使うかが選ばれていない場合、実行は選択を設定に書き込むことを提案するのではなく、何を指定すべきかを示して停止します。プレビューは、ついでに設定ファイルを編集することはありません。

解決そのものは実行されるため、キャッシュは引き続き埋まります。 Release がどの外部入力を消費するかはそれをレンダリングした結果として決まり、解決を行わない実行では報告するものが何もないため、--dry-run は pull とまったく同じように取得と保存を行います。.aggrega/cache 以下の内容はロックファイルが記録するピンを通してのみ読まれるため、キャッシュを埋めてもビルドが解決するものは何も変わりません。dry run が示すのは、pull が書き込むはずの内容です。

このフラグのもとでは、単独の --upgrade は何も確認しません。 確認が存在するのは、完全な更新では記録済みのピンがすべて破棄されるためですが、プレビューは何も破棄しません。そのため、更新によって何が失われるかを知りたいときに使うべき形が aggrega pull --dry-run --upgrade --release <release> であり、応答なしで実行されます。

--verify とは併用できません。 verify はもともとこれらのファイルを一つも書き込みません。この組み合わせでは、フラグが何かを行ったように読めるのに実際には何も行わないため、無視されるのではなく拒否されます。

ピン留めを行うプレビューで常に完全には示せないことが 1 つあり、それが起きたときにはその旨を伝えます。 ピン留めを求められた pull は、各 Recipe および FeatureRecipe の横にある entity.lock を書き換え、その後 Release をレンダリングして外部入力を見つけます。プレビューはそれらのロックに手を加えないため、そこに記録されたピンが古くなっている場合(たとえば、ピン留め後にインポートしたファイルを編集した場合)、そのレンダリングは書き込まれていないロックがまだ記録している古いダイジェストに照らされ、停止します。レポートのそれ以外の部分は pull が書き込むはずの内容そのものであり、不足するのは報告されるロックファイルの外部入力のピンだけです。実行は、完全に見えるロックファイルを渡すのではなく、出力と診断の両方でその旨を伝えます。ワークスペースの最初の解決には影響しません。古くなる比較対象となる記録済みのダイジェストがまだ存在しないためです。

これらのピンが記述するコンポジション

lockfile はこの Release のビルドが消費するものをピン留めするため、解決処理はそのビルドが描くのと同じコンポジションを描きます。つまり、ドキュメントを解決し、ワークスペースのアタッチメントが宣言する変換を適用し、その結果に対して、ビルドが完成したグラフに対して行うチェックを実施します。ここから 2 つのことが導かれ、どちらも lockfile を読む最初のビルドではなく、lockfile を書き込むパスの時点で発生します。

これらのチェックが拒否するコンポジションは pull を停止させます。 ターゲットがソケットの selector: を満たさない uses: エッジ、appliesTo: が許可しないコンポーネントにアタッチされた Feature、およびこれらのチェックが報告するその他すべての違反は、同じドキュメントのビルドが出力するのと同じ診断とともにこのコマンドを停止させます。また、この停止は最初の指摘だけでなくすべての指摘を 1 回の実行で示すため、1 回のパスで修正すべき一覧全体が得られます。これは書き込みの前に起こるため、<release-stem>.lock と plugins-trust.yaml は元のまま残り、ビルドできない Release が正常に解決されたものとして記録されることはありません。これが対象としないのは判定を返すアタッチメントです。ここでは ir-verdict や render-verdict のアタッチメントは実行されないため、拒否の判定が停止させるのはこのコマンドではなく、それをディスパッチするビルド、Release スコープの lint、または Release スコープの検証です。

グラフを形作るロールのアタッチメントはこのパスの間に実行されるため、解決できないプラグインは pull を停止させます。 label-transform アタッチメントは何かがノードラベルと照合される前にそのラベルを決定し、annotation-transform アタッチメントは Feature アタッチメントに展開されるアノテーションを注入します。どちらもグラフの内容を変えるため、グラフを描くにはそれらをディスパッチする必要があり、ディスパッチするには各プラグイン自身のバイト列を保持している必要があります。このパスがバイト列を取得できないプラグインは、そのプラグインと、それについて見つからなかったものを示して実行を停止させます。これは、同じワークスペースのビルドがバイト列を取得できないときに行う拒否と同じです。ディスパッチされるのはこのパスが解決したばかりのアタッチメントリストであり、後のビルドが再構築できるよう lockfile が記録する設定と定義ファイルを伴うため、両方のパスは同じ入力に対して同じアタッチメントを実行します。

パイプラインのステップが指定する Plugin をどこも保持していない場合も、pull は停止します。 Recipe または FeatureRecipe の pipeline が指定する各 Plugin は、Release の他の依存関係とともに、カタログディレクトリ、コンパイラバイナリ内のコピー、コンテンツキャッシュ、またはレジストリから解決されます。そのいずれも保持していないものは、ビルドも読み込めないものです。そのため pull は何かを書き込む前に停止し、その Plugin と、そのパイプラインがそれを指定している Recipe または FeatureRecipe を示し、ビルドがそのステップに到達したときに発生させる条件(A plugin reference is not a Plugin entity(プラグイン参照が Plugin エンティティではありません))を報告します。これは Manifest がバインドするすべての Recipe と FeatureRecipe に当てはまり、この Release で何もアタッチしていないものも含みます。それぞれがレンダリングされるかどうかにかかわらず解決されピン留めされるためです。Plugin を公開するか、ビルド済みの .wasm を隣に置いてカタログディレクトリに配置し、再度 pull してください。

この停止と縮退した実行は、意図的に異なる結果になっています。 完了できないレンダリング(How the resolution finds external inputs と Offline の両方で説明しているもの)では、すべての依存関係のピンは正しいままなので、ピンは書き込まれ、不足分が報告されます。チェックが拒否するコンポジションは、解決されたものの不足ではなく、ビルドできない Release です。そのため、それについては何もピン留めされず、実行は停止します。

キャッシュ

取得したコンテンツは .aggrega/cache の下に保存され、カタログエンティティ用の entities/ サブツリー、ソースアーティファクト用の source-artifacts/ サブツリー、レンダーが消費する外部入力用の inputs/ サブツリーに分かれます。カタログエンティティのスロットは種別、座標、バージョンで(そのため、座標とバージョンが共通する Component と Recipe は 2 つのスロットを保ちます)、ソースアーティファクトのスロットは取得元、バージョン、コンテンツダイジェストのプレフィックスで、外部入力のスロットはコンテンツダイジェストで命名されます。ビルドがいずれかから読み取る内容は、ロックファイルの記録と照合されます。したがって、同一のバージョン固定は Releases をまたいで 1 つのスロットを共有します。各ソースアーティファクトのスロットには、正本となるアーカイブ、再生成される展開結果、小さなメタデータファイルが格納されます。展開結果は読み取りのたびに再生成されるため、ビルド出力はアーカイブとロックファイルに依存し、展開済みファイルの状態には依存しません。

キャッシュが値から導出する名前は、すべて Windows、Linux、macOS のいずれでも受け入れられるものです。 座標、バージョン、レジストリホスト、ダイジェストには、ファイル名に使えない文字が含まれます。座標の各部分の間の /、バージョンの前、sha256: の中、レジストリのポートの前の : です。そのため、各値(種別、座標、バージョン、レジストリホスト、ダイジェスト)はディレクトリ名やファイル名になる前に綴り直されます。小文字の英字、数字、.、_、- はそのまま書かれ、それ以外の文字はすべて + で始まるエスケープとして書かれます。バージョン 1.0.0 の Component core/devtool/adminer:1.0.0 はスロット entities/+zx000043omponent/core+zsdevtool+zsadminer+zx00003a1.0.0/1.0.0/ となり、コンテンツダイジェストで命名されるスロットは sha256+zx00003a<hex> となります。大文字もエスケープされるため、大文字小文字だけが異なる 2 つの座標は、大文字小文字を区別しないファイルシステム上でも 2 つのスロットを保ちます。con のように Windows がデバイス用に予約している名前は先頭の文字がエスケープされ、名前がピリオドで終わることはありません。異なる 2 つの値が同じ名前を共有することはなく、1 つの値はどのマシンでも同じ名前になります。aggrega cache status は、各エントリを綴り直された名前ではなく、名前の元となった値(カタログエンティティであれば座標、バージョン、種別)で一覧表示します。

アーカイブのエントリは発行者が付けた名前を保つため、Windows 上では Windows が保持できないエントリは拒否されます。 ソースアーティファクトやカタログエンティティのアーカイブに含まれるファイルは、キャッシュによって綴り直されず、アーカイブが与える名前で配置されます。展開が Windows 上で行われる場合、Windows がそのままでは保持できない部分(NUL や aux のようにデバイス用に予約された名前で、大文字小文字や拡張子の有無を問わないもの、またはピリオドや空白で終わる部分)を含むエントリは、そのエントリを示して E0340 で拒否され、そのアーカイブの内容は何も配置されません。Linux と macOS では、そのようなエントリは名前のとおりに配置されます。展開先ディレクトリの外へ出るエントリは、どのマシンでも拒否されます。

カタログエンティティのスロットは、マニフェストがあって初めてエントリになります。 スロットには、レジストリが提供したコンテンツと、その隣にそのコンテンツを記述するマニフェストが格納されます。コンテンツだけを持つスロット(2 つの書き込みの間で止まった取得や、手作業で置かれたファイル)はエントリではありません。pull と検証付きの pull は、到達可能であればエンティティのレジストリにそれを再度要求します。一方、取得を一切行わないビルドは、レジストリに到達できないときの pull と同様に、そのエンティティを欠落として扱います。

キャッシュに入るものは 2 つの点で検査されます。エンティティ自身のスキーマが記述する形と、キャッシュがそれに割り当てる場所です。 レジストリから取得した本体は、キャッシュされる前に、その種類のスキーマ(読み戻すときと同じ検査)にかけられます。そのため、レジストリが提供する公開済みのエンティティやライブラリが自身のスキーマに拒否される場合、キャッシュされて後で障害として現れるのではなく、取得したものを示して pull が停止します。また、キャッシュの場所の構築に使われる値のうち、キャッシュされたファイルを値が示す場所以外に置いてしまうもの(バージョンではなくパスであるバージョン、自分の場所より上へ出るソースの url パスや module_subdir)は、場所が構築される時点で、問題の値を示して拒否されます。作成した Recipe や FeatureRecipe に書かれた値も、そこからキャッシュの場所が構築される時点で同様に検査されます。git ソースの module_subdir は、後述のとおり、それより早くリポジトリの取得前に検査されます。

git リポジトリは、そのチェックアウトからアーカイブされます。 git-repository ソースでは、pull は固定されたコミットでリポジトリをチェックアウトし、module_subdir が示すディレクトリ、またはリポジトリ全体をアーカイブします。書かれたとおりでリポジトリより上に出る module_subdir(../shared や ..\shared)は、リポジトリの取得前に、値を引用した E0307 で拒否されるため、チェックアウトの外にあるものは何も読み取られません。リポジトリにコミットされたシンボリックリンクは、リンク先がリポジトリ内にある場合、そのリンク先のファイルまたはディレクトリとしてアーカイブされます。module_subdir 自体がそのようなリンクであってもかまいません。リポジトリの外へ出るリンクは、リンクとリンク先を示して E0321 で pull を停止させ、何もキャッシュされません。そのため、pull 元のリポジトリが、手元のマシンのファイルを pull によってアーティファクトにコピーさせることはできません。チェックアウトは pull の終了時に削除されるため、メッセージは、もはや存在しないディレクトリではなく、リポジトリ内の位置によるリンクと、ソースが示すリポジトリおよびリビジョンを示します。リンクを変更するのはリポジトリ側です。ワークスペース境界に、ここで適用される規則が記載されています。

キャッシュは、コマンドを実行したディレクトリではなくワークスペースに固定されます。そのため、1 つのワークスペースには 1 つのキャッシュがあり、サブディレクトリから実行した pull は、ルートから実行したビルドが読み取るのと同じストアを満たします。

ワークスペースが見つからず、指定もされていない pull は、何かを取得する前に拒否されます。 ルートを指定するものがなく、探索でも何も固定されない場合(実行したフォルダから、あるいは絶対パスで指定された Release であればその Release 自身のフォルダから)、そのフォルダがルートになり、その下に書き込まれたキャッシュがそこをワークスペースにしてしまいます。そのため pull は停止し、ロックファイルもキャッシュも書き込まず、そのフォルダと 2 つの対処法を示します。--workspace-root または AGGREGA_WORKSPACE_ROOT でワークスペースを指定するか、そのフォルダに workspace: ブロックを含む .aggrega-config.yaml を置いてください。ルートなしで起動したサーバー上で workspace_root なしに呼び出された aggrega mcp の pull ツールも、同様に拒否されます。これが当てはまる他のコマンドは設定に記載されています。

ネットワークに到達できない環境でのビルド

外部に接続するステップはこのコマンドだけなので、接続した状態で一度実行すれば、以降のビルドはすべてローカルで行えます。その実行でロックファイルが書き込まれ、ワークスペースのキャッシュにそれらのピンが指すバイト列が格納されるため、ビルドはそれ以外に何も必要としません。

切断されたマシンには次の 3 つを持ち込みます。

  • Release とそのロックファイル。 <release-stem>.lock を Release の隣にコミットします。各依存関係がどのバージョンとダイジェストに解決されたかをビルドに伝えるのがこのファイルです。
  • plugins-trust.yaml(ワークスペースが判定を返すプラグインをアタッチしている場合)。 ビルドは、設定が指定する判定アタッチメントを、そのいずれかが実行される前にこの記録と照合します。そのため、この記録を持ち込むことで、切断された環境のビルドを、レビュー済みの識別情報と、pull がそれらについて検証した署名に従わせることができます。プラグイン信頼記録の説明に従い、ロックファイルの隣にコミットします。
  • キャッシュディレクトリ。 エンティティ、ソースアーティファクト、ピン留めされた入力はすべてこの下に置かれ、ローカルの catalog_dirs ディレクトリが提供しないものはここから読み込まれます。

切断されたマシンでは通常どおりビルドします。完全なロックファイルに対するビルドはクロージャをキャッシュから読み込みますが、それでもそのマシンでオフライン設定を有効にしておく価値があります。ネットワークに到達しようとする処理が、まずタイムアウトを待たなければならない接続試行ではなく、その設定を示す即時の拒否に変わるからです。キャッシュにないもの、およびロックファイルがピン留めしていない外部入力があると、ビルドは不足しているものとそれをピン留めする解決処理を示して停止します。不足を補うために何かが暗黙的に取得されることはありません。

エアギャップ環境のマシンとオフラインのワークスペースは異なる主張であり、その違いは区別しておく価値があります。 エアギャップの内側にあるマシンは、レジストリのローカルコピーや、必要なものをすべて含む catalog_dirs カタログを保持している場合があり、その場合はそのマシン上の通常の pull を、外部に一切接続せずに満たすことができます。オフライン設定が表すのは、コマンドが何に到達してよいかであり、マシンが何を保持しているかではありません。何を拒否し、何をそのままにするかは Offline で説明します。

オフライン

オフライン設定(設定ファイルのトップレベルの offline キー、環境変数の AGGREGA_OFFLINE、またはコマンドラインの --offline)の下では、aggrega pull はネットワークアクセスを拒否します。この拒否は、取得の途中でのタイムアウトとしてではなく、接続が試みられる前に行われるため、オフラインの pull はどのレジストリにもリモートソースにも到達しません。コミットされたファイルやエクスポートされた変数がこの設定を有効にしていて、1 つのコマンドだけそれを解除したい場合は、--offline=false を指定するとその実行に限りネットワークが許可されます。

--upgrade はこの設定の下では即座に拒否され、ここで拒否されるオプションはこれだけです。 完全な更新はすべての依存関係をレジストリが現在提供している最も高いバージョンへ移すため、レジストリに現在何を提供しているかを問い合わせる必要があります。通常の pull はその必要がありません。すでに記録されているピンを尊重し、ピンのないものだけを解決するため、マシンが保持しているものから満たすことができます。拒否のメッセージは、3 つの場所のうちどこがこの設定を有効にしたか、そして 1 回の実行でネットワークを許可する方法を示します。

その後、解決はマシンがすでに保持しているもの、つまり catalog_dirs の検索スタックと .aggrega/cache 配下のキャッシュだけを利用します。すべての参照を満たすカタログとキャッシュに対しては、オフラインの pull は通常どおり完了し、通常のロックファイルを書き込みます。ロックファイルには各依存関係の URI、解決されたバージョン、ダイジェストが記録され、それらの場所のどれがバイトを提供したかは記録されません。そのため、同じバージョンを解決するオフラインの pull とオンラインの pull は同じロックファイルを書き込みます。

オフラインの pull がローカルで満たせない依存関係は、pull を停止させます。 そのエントリがスキップされることはありません。

  • どこにも解決されないカタログエンティティは pull を停止させ、その参照と参照元を示します。そのため、欠けている依存関係とそれを要求したものの両方が示されます。
  • リモートの source: は pull を停止させ、そのソースを示したうえで、ネットワークアクセスを許可するか、接続された環境からキャッシュを用意するよう案内します。
  • キャッシュが保持している依存関係のうち、必要な署名をロックファイルが記録していないもの、または記録された署名をビルドが受け入れないものは、その依存関係を示すオフラインの拒否によって pull を停止させます。署名を記録するにはそのレジストリに問い合わせる必要があるためです。これは Honoring vs. updating で説明しています。その 1 回の実行でネットワークを許可すれば署名が記録されます。ビルドが受け入れる記録済みの署名は再度照会されないため、オフラインの pull を止めることはありません。

外部入力は停止させない唯一のものであり、代わりにその旨を報告します。 外部入力を見つけるレンダリングは、まだ保存されていないものを取得できません。そのため、ピンされていない外部入力を持つ Release に対するオフラインの pull は完了し、解決したすべての依存関係のピンを書き込み、3 つのことを報告します。レンダリングが完了しなかったこと、何をピンしたか、そしてこの Release のビルドがその URL を示して停止することです。書き込まれた依存関係のピンは正しいものです。それらはレンダリングに一切依存していないため、読み手が再現するために破棄されるのではなく保持されます。

これは欠落ではなく意図的なものであり、切り替えるスイッチはありません。正しい作業を破棄する pull では成功した部分が失われ、何も報告しない pull では完全に見えて実際にはそうでないロックファイルが渡されます。その旨を報告することが、対処可能な状態を残す唯一の結果です。接続された環境から、またはキャッシュがすでにその内容を保持している環境から pull を再実行すれば、同じコマンドでピンされます。

したがって、オフラインの pull は、ドキュメントが指定するすべてのものについて結果を縮小するものではなく、ネットワークに触れることを拒否するものです。外部入力については、到達できなかったものを伝える、完了した解決となります。存在するロックファイルは、依存関係の解決が完了したものです。その外部入力が完全かどうかは pull 自身の出力が伝えるものであり、その後ビルドがそのロックファイルに求めるものです。

オフライン設定の下での --verify は対象範囲が狭くなり、その旨を報告します。 記録されたソース参照が現在どこを指しているかを確認するにはそのリモートに到達する必要があり、オフライン設定はそれを拒否します。そのため、オフラインの --verify はピンされた依存関係を確認してその観点をスキップし、確立していない一致を報告するのではなく、その旨を示す行を出力します。レジストリでしか確認できない記録済みの署名(キャッシュされた署名バンドルが削除または変更されたロックファイルエントリのもの)も同様にスキップされ、そのようなエントリごとに名前を示す行が出力されます。

verify: offline, so the signature the lockfile records for "<reference>" was not checked at its registry, which alone can say whether a pull would record it again; this verify does not cover it

レジストリの応答にかかわらず pull が書き換える記録済みの署名は、オフラインでも報告されます。それを知るのに応答は不要だからです。これは It compares the recorded signatures, in both files で説明しています。

レジストリが提供する、判定ロールにアタッチされたプラグインは、オフラインの verify とオフラインの pull の挙動が分かれる点です。 そのようなプラグインはロックファイルにピンされないため、すべての pull はその .wasm をレジストリから解決します。そのプラグインをアタッチするワークスペースに対するオフラインの pull はそこで停止し、そのプラグインを .wasm を解決できなかったものとして示します。コンテンツキャッシュがそれを保持している場合でも、またそのレジストリが advisory とマークされているか署名検証をスキップするかどうかにかかわらず、そうなります。一方、オフラインの verify はプラグインについてレジストリに何も問い合わせません。ビルドと同様にコンテンツキャッシュからプラグインを読み込み、キャッシュがその .wasm を保持していない場合や、公開されたマニフェストが示すダイジェストともはや一致しないものを保持している場合に停止します。それでも、プラグインの ID をプラグイン信頼記録と照合し、その .wasm に対してホスト関数を再確認し、どちらかが一致しない場合は、接続時の verify とまったく同じように停止します。レジストリの応答にかかわらず pull がそのエントリを書き換える場合、つまりビルドがそのエントリを理由にプラグインを拒否する場合には、そのプラグインを報告します。署名を記録していない場合(エントリが何も記録していないか、記録にそのプラグインのエントリがない)、またはエントリが記録する署名が別のアーティファクト向けに作成されたもので、pull がそれをプラグイン自身の署名で置き換える場合です。それ以外のすべてのエントリ(ビルドが署名を受け入れるもの、およびキャッシュされた署名バンドルが削除または変更されたもの)については、署名が確認されなかったことを示す行で名前を示し、その署名については何も報告しません。

verify: offline, so the signature of "<plugin>" was not checked at its registry, which alone can say whether a pull would record the same signature on its entry in the plugin trust record; this verify does not cover it

したがって、オフラインの verify は、接続時の pull であれば置き換えるかクリアする署名を持つエントリ(たとえば署名者が手で編集されたものや、レジストリがもはやアタッチしていないもの)を、その行だけを手がかりとして通過させます。エアギャップ環境での verify は引き続き利用できますが、その後に参照が移動したかどうかや、スキップされた署名が再び記録されるかどうかは伝えません。終了コードだけを読むチェックがそれらを確認できるのは、verify が接続された状態で実行された場合に限られます。

aggrega build との統合

  • 検証。 aggrega build は解決されたすべての依存関係を lockfile と照合して検証し、ドリフトがあれば停止します。ドリフトとは、内容がピンと一致しなくなったエンティティ、ライブラリ、プラグイン、Release が現在到達するのに lockfile がピン留めしていない参照、あるいは lockfile がピン留めしているのに Release がもはや到達しない参照、そして pull 以降に編集された Release ファイルです。これを解消するには、停止時に表示されるコマンド aggrega pull --release <release> を実行します。pull は Release を現在の状態のまま解決し、変化したピンを書き換え、それ以外のピンはすべて維持するため、変更していないものが浮動することはありません。変化したものが Recipe のローカルソース配下のファイルである場合、pull は エンティティロック で説明するとおり、まずそのエンティティに対する aggrega pin を示します。このコマンドが書き込んだ直後の lockfile はこの検査に合格します。コマンドが書き込む前に同じ検査を実行するためです。pull の直後にビルドがドリフトで停止した場合、そのビルドには pull と異なる入力が与えられています。たとえば一方にだけ渡された --catalog ディレクトリや、両者の間に編集されたワークスペース設定です。そのため、両方を同じ入力に対して実行してください。aggrega validate --release と、Release を解決するすべての aggrega inspect の選択も lockfile に同じ検査を適用し、同じ停止で拒否します。そのため、どちらもビルドが拒否する lockfile を見過ごすことはありません。
  • 自動 pull。 lockfile が存在せず auto_pull が true の場合、aggrega build はまず自動的に pull を実行します。auto_pull がデフォルトの false の場合、ビルドは停止して pull を求めます。ビルドが実行する pull は pin_sources_at_pull に従うため、ピン留めされていないエンティティに対しては pull と同様に停止します。ビルドが実行する pull ステップはこのページで説明するものと同じであるため、既存の lockfile を埋めるビルドは、移動したソース ref に対して aggrega pull と同様に停止します。Determinism and integrity を参照してください。
  • オフライン。 オフライン状態では、aggrega build はマシンがすでに保持しているものだけを使用し、接続を試みる前にネットワークアクセスを拒否します。キャッシュが内容を保持していない参照は、フェッチの途中で失敗するのではなくビルドを停止させます。また、lockfile がなく、その作成も求められていないビルドは、オンラインの場合と同様に、それを埋める pull を示して停止します。--auto-pull は拒否されません。これが求める作成はこのページで説明する pull であるため、すでにキャッシュされているか、ローカルカタログに存在するカタログエンティティに対しては、レジストリに到達せずに lockfile を書き込みます(リモートソースからチャートを取得する Recipe は再度解決されるため、キャッシュがそのチャートを保持していてもオフラインでは停止します)。どちらにも保持されていない参照、あるいはキャッシュされていても、必要な署名を lockfile が記録していない参照や、記録された署名をビルドが受け入れない参照は、その参照を示す pull 自身の拒否によって停止させます。--upgrade は、Offline で述べる理由により拒否されます。
  • カタログ検索。 pull は、--catalog が指定されていない場合でも .aggrega-config.yaml の catalog_dirs を尊重し、さらに設定が workspace.releases の下で Release 固有のディレクトリを指定している場合はそれも尊重します。そして aggrega build と同じ先勝ちの検索スタックを解決するため、pull がピン留めする依存関係はビルドが検索するものと一致します。一覧にあるディレクトリがディレクトリではない場合(たとえばそこに何も存在しない場合)、両方のコマンドは何かを解決または書き込む前にそれを拒否し、そのエントリと、それを一覧している設定ファイルおよび行を示します。ローカルエンティティの読み込み元 に示すとおりです。

解決が外部入力を見つける仕組み

このセクションの内容は上記のルールを何も変えません。何かがピン留めされる時点は依然として 1 つであり、それはこのコマンドです。ここで説明するのは、このコマンドが 3 種類のうち 3 番目にどのように到達するかであり、解決をパイプラインに組み込むとき、劣化した実行を読み解くとき、あるいはこのコマンドがそもそもなぜレンダリングを行うのかを考えるときに重要になります。

カタログエンティティとソースアーティファクトはそれぞれドキュメント内で名前が付けられますが、外部入力はそうではありません。 前の 2 つを解決するには、作成した内容を読むだけで済みます。外部入力はレンダリングの途中で provider によって名前が付けられ、どの URL が挙げられるかはレンダリングされる値によって決まります。values のエントリが存在しないと、チャートのスキーマのサブツリー全体がコンパイルされず、そのサブツリー内のすべてのリモート参照は要求されません。Release を読むだけでは、その集合を列挙できません。

そのため、このコマンドは 1 回のパスで 2 つのことを行います。ドキュメントが挙げるクロージャを解決してピン留めし、次にそのクロージャをレンダリングして、provider がどのリモートドキュメントを要求するかを確認します。レンダリングされたアーティファクトは破棄され、ピンは保持されます。どちらもこの 1 つのコマンドの内部処理であり、どちらも何かがピン留めされうる 2 つ目の時点ではありません。ロックファイルの書き込みは 1 回であり、そこにすべてのピンが含まれます。

解決を安価なステップとして自動パイプラインに組み込む前に、知っておくべき結果が 2 つあります。 レンダリングを行うため、ドキュメントを読むだけの解決よりもコストがかかります。また、ドキュメントのみの解決では起こりえない理由、つまりこの Release をレンダリングできない provider によって失敗することがあります。その場合でも依存関係のピンは書き込まれます。ピンはレンダリングに一切依存していないためです。診断は、停止したステージ、ピン留めされたもの、そしてビルドがピン留めされていない URL を挙げて停止することを示します。実行が無駄になることはなく、Offline では同じ結果に別の方法で到達する例を示しています。

レンダリングは、何かを書き込む前に、ビルドが適用する比較にもロックファイルをかけます。 レンダリングはビルド自体のシーケンスを実行するため、ビルドがディスク上で見つけたロックファイルを比較するのとまったく同じように、このコマンドが書き込もうとしているロックファイルを、同じ Release のビルドが解決する内容と比較します。その比較で拒否されたロックファイルは書き込まれず、その後にコマンドが書き込むはずだった他のものも書き込まれません。コマンドは、解決とビルドとで Release の依存対象について食い違いがあることを示し、続けて比較が挙げた各エントリを示して停止します。これはファイルの内容によって引き起こされることはなく、再度解決しても同じ食い違いに至るため、再試行せずに Release を添えて報告してください。これは書き込みを止める唯一のレンダリング失敗であり、同じ入力に対する同じ Release のビルドが、このコマンドが書き込んだロックファイルについてドリフトを報告しない理由でもあります。

レンダリングをスキップするスイッチはありません。 そのようなスイッチがあれば、単一の時点によって取り除かれる意外な事態を、オプションとしてそのまま残すことになります。つまり、レンダリングに必要な入力がピン留めされないまま Release がきれいに解決され、それがビルド時に初めて判明するという事態です。

--auto-pull はこれと同じ解決をビルドに組み込み、ビルドのレンダリングは 1 回です。 補完時のレンダリングが外部入力を見つけてピン留めするものであり、ビルドは 2 回目のレンダリングを行わずにそのレンダリング結果を提示します。そのため、1 コマンドのビルドのコストは、補完済みのロックファイルに対する通常のビルドと同じレンダリング 1 回分です。ビルドのレンダリングフラグのうちどれがこれに届くかは、aggrega build で説明しています。

この集合は Release のパラメーターによって決まり、これはコンポーネントのピンがすでに動作している方法と同じです。 解決とビルドの間に Release のパラメーターを編集することは Release の編集であるため、ビルドはドリフト比較の段階でそのファイルを挙げて停止し、ピン留めされていない URL をレンダリングが要求する前に止まります。対処法はこのコマンドです。別ファイルからインポートされたパラメーターは内容として記録されないため、代わりにそのファイルを編集した場合はレンダリングまで到達し、レンダリングがピン留めされていない URL を挙げて停止します。その際の対処法としても、このコマンドが示されます。

決定性と完全性

Recipe の source: では、Release の解決済みの values と infra(および同じものに対して定義された locals)に対してバージョンをテンプレート化できます。これらは pull 時に解決され、その結果がピン留めされます。pull が評価するのは、source: フィールドが読み取る locals: のエントリと、それらのエントリがさらに読み取るエントリだけであり、使用するのは Aggrega 独自のテンプレートヘルパーのみです。source が読み取るエントリが Sprig 関数を呼び出す場合、pull はそのエントリ、フィールド、関数を示して停止します。一方、どの source: フィールドからも読み取られないエントリはビルドに委ねられ、ビルドは Recipe のレンダリング時にそれを評価して検査します。Resolving a source: coordinate registers a narrower function set(ソース座標の解決では、より狭い関数セットが登録されます) を参照してください。変更可能な Git のタグやブランチは、それが指している具体的なコミットにピン留めされ、記述した ref はその横に記録されます。ビルド時には、キャッシュされたアーカイブのダイジェストがロックファイルに対して再検証されるため、改ざんされたキャッシュは検出されます。

記録された ref は、固定したコミットに保持されます。 ref が記録されるのは読みやすさのためではなく、後の実行が再びそれを問い合わせるためです。ビルドはそれがどのアーティファクトを指すかを問い合わせ、pull はそれが以前と同じ場所をまだ指しているかを問い合わせます。アップグレードではない pull は、記録された各 ref の指す先を再度問い合わせ、リモートで移動した ref があれば、その移動を採用せずに実行を停止します。その際、アーティファクト、ref、lockfile が固定しているコミット、現在解決されるコミットを示します。移動を採用するには aggrega pull --upgrade --release <release> を実行します。エンティティ URI を指定する対象指定のアップグレードでは採用されません。ソース参照は指定できるエンティティではないため、対象指定の実行は通常の pull とまったく同じようにそれを保持します。

この検査は、ビルド時のダイジェスト再検証では代わりに行えない唯一のものです。移動した ref を採用する pull は、取得したバイトと記録されたダイジェストを同時に書き換えるため、ビルドが比較する 2 つの値は一緒に移動して一致してしまいます。その結果、lockfile がレビューされた時とは異なるソース内容をビルドすることになり、それを報告するものは何もありません。

このように保持されるのは lockfile が記録している ref だけです。ref は記述すれば必ず記録されます。version: だけでソースを指定する Recipe には ref がないため、後の実行が再度問い合わせるものはありません。自分で書いたバージョンが知らないうちに移動することはないので、これが正しい動作です。何が記録されるかは lockfile リファレンス に記載されています。

コミットではなく ref を書いてください。 build は、git をソースとするアーティファクトを、記述した ref を lockfile が記録した ref と照合して見つけます。そのため ref: v1.2.3 はそのタグが固定されたコミットに対してビルドされ、コミットを Recipe に書く必要はありません。代わりに変更可能なタグを version: に指定しても機能せず、そう意図されてもいません。version: は書かれたとおりに照合され、git ソースについては lockfile はコミットを固定するからです。

lockfile は、レジストリやリモートソースから取得した内容を固定し、カタログディレクトリから解決した各エンティティのダイジェスト(The lockfile で説明するとおり、エンティティファイルとその横で指定されるすべてのファイルが対象)と、解決時に読み込んだ各 Release ファイルのダイジェストを記録します。./ または ../ で始まるソースのファイルと、エンティティがインポートするアーティファクトファイルも、The entity lock で説明するとおり、そのエンティティの横の lock に 1 つずつ固定されます。これにより、移動したものが特定されます。ビルド間でのワークスペースのその他の部分の完全性は、ソース管理システムの責任です。決定性の保証の範囲については、バイト単位で同一の出力 を参照してください。

認証

レジストリの認証情報は Docker の認証情報設定からのみ読み込まれます。DOCKER_CONFIG が指すディレクトリ内の config.json(その変数が未設定の場合は ~/.docker/config.json)と、そのファイルが credsStore または credHelpers を通じて委任する認証情報ヘルパーや OS のキーチェーンです。aggrega login <registry> はそこに認証情報を書き込み、docker login <registry> も同様です。プライベートな OCI カタログやチャートレジストリの場合は、aggrega pull の前にどちらかを実行してください。podman login と helm registry login が書き込むファイルは読み込まれません。

読み取れない認証情報設定は、その内容を示さずに報告されます。 config.json が有効な JSON でない場合、エントリの auth 値がコロンで連結されたユーザーとパスワードを base64 エンコードしたものでない場合、またはファイルが指定する認証情報ヘルパーが応答できない場合、レジストリへの接続は失敗し、メッセージはレジストリと認証情報ファイルを示しますが、ファイルやエントリの内容は決して示しません。aggrega login と aggrega logout も、有効な JSON でない config.json を同じ方法で報告し、その中身を何も変更しません。ファイルを修正してください。読み取れないエントリは aggrega login <registry> で置き換えることもできます。

従来の Helm チャートリポジトリまたはチャートアーカイブ(helm-https-chart)、compose フラグメント(compose-https-fragment)、HTTP または HTTPS でアクセスする Git リポジトリ(git-repository)は、curl や Git も読み込むユーザーごとの認証情報ファイルである netrc ファイルで認証します。これは、この 3 種類が読み込む唯一の認証情報ストアです。~/.config/helm/repositories.yaml や Git の認証情報ヘルパーは読み込まれません。SSH でアクセスする Git リポジトリは SSH エージェントを通じて認証し、netrc ファイルは読み込みません。

machine charts.example.com
login deploy-bot
password <token>

読み込まれるファイル。 NETRC 環境変数が設定されている場合は、それが指すファイルです。それ以外の場合はホームディレクトリの .netrc です。Windows では、%USERPROFILE% に _netrc が存在すればそれを、存在しなければそこにある .netrc を読み込みます。ファイルがない場合は認証情報がないだけで、エラーにはなりません。存在しても読み込めないファイルや netrc 形式に従っていないファイルは、E0360 でコマンドを停止させ、そのファイル(形式の誤りの場合はその行も)を示しますが、ファイルの内容は決して示しません:The netrc file cannot be read(netrc ファイルを読み込めません)。Linux と macOS では、マシンの他のユーザーが読み取れる netrc ファイルについて、そのファイルを示す警告が 1 回出ます。自分だけが読み取れるようにしてください(chmod 600)。

どのエントリがリクエストに応答するか。 各リクエストはそのホスト(ポートを除いたホスト名、大文字と小文字は区別しない)で検索され、そのホストを指定する最初の machine エントリ、またはどれも指定しない場合は default エントリが応答します。エントリの login と password は、http でも https でも HTTP ベーシック認証情報として送られます。どちらかが欠けたエントリは何も送りません。インデックスがチャートを別のホストに置いているリポジトリでは、リクエストごとに応答します。インデックスのリクエストにはリポジトリのホストのエントリが、チャートのリクエストにはチャートのホストのエントリが使われます。認証情報なしで送られるリクエストは匿名で読み取れる必要があり、401 または 403 で応答するサーバーは pull を未認可の取得として停止させます。その対処方法には、追加すべきエントリと、それが探されたファイルが示されます。

認証情報はどこにも書き込まれません。 取得の実行時に読み込まれ、リクエストとともに送られます。lockfile、Recipe の横の entity.lock、ソースキャッシュ、そしてすべてのメッセージは、ソースの URL を記述されたとおりに保持します。

ソース URL は認証情報を持ちません。 ソースの url がホストの前にユーザーを書いている Recipe または FeatureRecipe(https://user:token@charts.example.com/…、またはトークンだけを書いた https://token@charts.example.com/…)は、ドキュメントの読み込み時、何かを取得する前に E0361 で拒否されます。Recipe の検証もそれを拒否し、それに到達するすべての pull、pin、ビルドも同様です。メッセージはホストを示しますが、認証情報は決して示しません:A source URL carries a credential(ソース URL に認証情報が含まれています)。代わりに認証情報を netrc ファイルの machine エントリに入れてください。SSH では、ユーザーだけを書いたもの(ssh://git@github.com/…)は秘密ではなくアカウントを示すため受け入れられますが、そこにパスワードを書いた場合は同様に拒否されます。

このチェックは URL のホストより前の部分だけを読みます。 クエリ文字列やパスに含まれるトークン(…/index.yaml?access_token=…)は検出されないため、そこには書かないでください。URL は、lockfile、entity.lock、ソースキャッシュ(キャッシュのディレクトリ名を含む)に記述されたとおりに記録されます。

環境変数

pull が読み込むワークスペース設定は、環境変数で上書きできます。環境変数はコミットされた設定より優先され、どのフラグよりも優先度が低くなります。対象は AGGREGA_OFFLINE(Offline を参照し、それより優先されるフラグについては --offline を参照してください)、AGGREGA_CATALOG_DIRS(OS のパスリスト区切り。絶対パスを指定してください)、AGGREGA_ARTIFACT_CACHE_DIR、AGGREGA_DEFAULT_REGISTRY、および AGGREGA_SKIP_SIGNATURE_VERIFICATION(目立つ動作をします。pull が署名を検査するはずだった箇所では、検証がグローバルに無効化されているという警告をログに出力します)です。完全な一覧と優先順位のモデルについては environment-variables.md を参照してください。

関連項目

  • ./aggrega-build.md — ロックファイルを検証し、設定されている場合は自動的に pull します。
  • ./aggrega-serve.md — デーモンはこれと同じ解決を aggrega/resolveDependencies で提供し、autoPull フィールドでそれを求めるリクエストに対しては aggrega/build の中でも提供するため、 エディタはセッションを離れずに実行できます。いずれの場合も、リクエストが指定したときにのみ実行され、 このコマンドと同じロックファイルを書き込みます。
  • ./aggrega-push.md — カタログのエンティティをレジストリに公開します。
  • ./aggrega-lint.md — aggrega push の前に行う公開ゲートです。
  • ../../architecture/13-catalog-and-registry.md — カタログ、ロックファイル、キャッシュのモデルの全体像です。

概要

aggrega pull [<uri>...] [flags]

説明

Resolve the Release's catalog and source dependencies into the cache and write the per-Release lockfile.
By default, pull reconciles the lockfile against the current dependency resolution while honoring
the pins it already records. That pin discipline governs what a registry or the content cache
serves: such an entity is fetched at its pinned version and verified against its pinned digest,
and if the registry no longer serves the pinned bytes, pull halts rather than silently re-pinning.
An entity a local catalog directory supplies is resolved from that directory instead, at the
version its file declares, and its recorded pin is not consulted — so editing a pin by hand does
not hold a locally-supplied entity at that version, and the reconcile rewrites the entry to match
the file. A reference with no pin — newly added, or removed from the lockfile by hand — is
resolved fresh and added. Entities no longer among the resolved dependencies are pruned.
Re-running pull on an unchanged dependency set is a no-op.
Use --upgrade with no positional arguments to discard the existing lockfile and re-resolve
every entity from current registry state, floating each dependency to the highest available
version. That form drops every recorded pin, so it asks for confirmation first; --yes answers in
advance, and on a non-interactive stdin it refuses rather than waiting for an answer nobody can
give. Pass one or more entity URIs after --upgrade to upgrade only those: each named pin
is dropped and re-resolved fresh while every other pin — and the recorded external inputs —
is held unchanged. A named target may also be a plugin that returns an accept-or-reject verdict;
such a plugin carries no lockfile pin, and its identity is recorded beside the lockfile instead.
Naming one the workspace still attaches adopts the identity it resolves to. Naming one the
workspace no longer attaches drops its recorded identity — the one way to clear an entry that
outlived the attachment it was recorded for. A bare --upgrade does both for every plugin at once.
A URI given without --upgrade is a usage error.
Each Recipe and FeatureRecipe this Release builds from one of your catalog directories carries
the pins for its own inputs in the entity.lock beside it: a remote source: written out in full,
a file an artifacts entry imports, and each file of a local source:. Recording them is the
entity author's step, aggrega pin.
By default pull records none of them, and halts on an entity whose lock is missing any, naming
the entity, each input and its class, and the command that records them. A local source's files
are held to their pins as one set: a file added, changed or removed since the pin halts the pull
the same way.
Pass --pin-sources, or set pin_sources_at_pull in the workspace configuration, to have pull run
that same step instead; --pin-sources=false restores the halt for one run.
Which files of a local source directory belong to its entity was decided when the entity was
pinned, by the ignore rules of the plugin that served its capability for the author, and its
entity.lock records that decision. Where the plugin this workspace binds for that capability
declares different rules, pull prints a warning naming both plugins and the difference, and
carries on: the entity's files are the ones its recorded rules kept.

フラグ

フラグデフォルト説明
--catalog[]カタログディレクトリです。複数回指定できます。各 —catalog <dir> はカタログ検索スタックの先頭に追加されます(最初に一致したものが優先されます)。スタックはワークスペースの catalog_dirs、またはワークスペース設定が workspace.releases の下で独自のディレクトリを与えている Release の場合はその Release のディレクトリで構成され、ワークスペースルートに catalog という名前のディレクトリがある場合はそれで終わります。空として書かれた catalog_dirs リストは、ローカルカタログをまったく読み込みません。
--detailfalse解決された各エンティティについて、この pull が行ったことを表示します。レジストリから新たに取得した、キャッシュスロットを再利用した、ローカルカタログで見つかった、コンパイラバイナリの内部から提供された、または外部(Release が指定するファイルまたはエントリから読み込まれた、その Release 自身の Aggregate または Manifest)のいずれかです。標準出力のみで、ロックファイルには書き込まれません
--dry-runfalse依存関係を解決し、この pull が書き込む内容を、書き込む代わりに表示します。各ファイルのパスとその内容が標準出力に出力され、ロックファイル、—pin-sources によって記録済みのピンが変わる各 Recipe および FeatureRecipe の横にある entity.lock、プラグイン信頼記録はいずれも変更されません。実際に変更されるファイルのみが示されます。解決そのものは通常とまったく同じように実行されるため、コンテンツキャッシュは引き続き埋められ、ピン留めされていないエンティティで停止する pull はここでも停止し、引数なしの —upgrade はピンを破棄しないため確認を求めません。ドライランが示すものは、pull が書き込むものです。—verify とは併用できません。—verify はもともとこれらをいずれも書き込みません
--include-prereleasefalse未実装です。受け付けられますが無視されるため、これを渡すスクリプトは、効果を持つようになった時点でも動作し続けます
--pin-sourcesfalseこの Release がビルドする Recipes と FeatureRecipes に対してエンティティ作成者のピン手順を実行し、それぞれの横にある entity.lock に、読み込むすべての入力のピンを記録します。対象は、完全に書き出されたリモートの source:、artifacts エントリがインポートするファイル、ローカルソースの各ファイルです。ロックがこれらを記録していないエンティティで停止する代わりにこれを行います。aggrega pin と同じ手順で、同じバイト列を書き込みます。エンティティの横に書き込むため、エンティティが書き込み可能な場所、つまりカタログディレクトリのいずれかにあるドキュメントである場合にのみ実行されます。キャッシュから解決されたエンティティにはそのような場所がなく、ピン留めされることはありません。ワークスペースの pin_sources_at_pull を両方向に上書きします。設定にかかわらず、—pin-sources はこの実行でピン留めし、—pin-sources=false はこの実行で停止します
--progressfalsestderr が端末でない場合でも pull の進捗表示を強制的に有効にし、各ステップの完了時にその所要時間とともにプレーンな行を 1 行ずつ表示します。デフォルトは auto です。対話型のフェーズチェックリストは、stderr がエスケープシーケンスを解釈する端末の場合にのみ表示され、解釈しない端末では同じプレーンな行が表示され、リダイレクトまたはパイプされた出力には何も表示されません
--quietfalsestderr への pull の進捗表示を抑制します。標準出力には影響しません。—progress より優先されます
--release—Release YAML ファイルへのパスです(必須)。相対パスは、ワークスペースルートではなく、コマンドを実行したディレクトリを基準に解決されます。そのディレクトリがどのワークスペースにも属さず、ルートも指定されていない場合、絶対パスでは Release 自身のフォルダからワークスペースを探します
--upgradefalse現在のレジストリの状態から依存関係を再解決し、それぞれを利用可能な最高バージョンに更新します。引数なし(位置引数の URI なし)の場合はロックファイルを破棄してすべてのエンティティを再解決し、記録済みのピンをすべて破棄するため、先に確認を求めます。1 つ以上のエンティティ URI を指定した場合は、それらのみを再解決し、その他のすべてのピンと記録済みの外部入力を変更せずに保持し、確認を求めません(—verify とは排他的です)
--verifyfalse既存のロックファイルを、pull が現時点で行う依存関係の解決と照合して検証します。ロックファイル、プラグイン信頼記録、entity.lock はいずれも書き込みません。ずれがある場合やロックファイルがない場合は 0 以外で終了します。解決では、ロックファイルが記録するピンを pull とまったく同じように尊重します。pull 以降にレジストリが新しいバージョンを公開した参照は、pull がそのピンを保持するため、ずれにはなりません。また、レジストリがピン留めされたバージョンで異なるバイト列を提供するようになった場合は、pull を停止するのと同様に verify も停止します。コンテンツキャッシュは pull と同じように読み込まれ、埋められます。キャッシュがピンのもとで保持しているエントリはレジストリに問い合わせずにそこから読み込まれ、保持していないものは取得され、ピンと一致しなくなったものは pull とまったく同じように扱われます。さらに、Release が到達する、カタログディレクトリ内の各 Recipe および FeatureRecipe の横にある entity.lock を、ビルドが比較する対象と照合し、ビルドが拒否するピンがあれば 0 以外で終了します。対象は、記録済みのダイジェストと一致しなくなったインポートファイル、ファイルが記録済みのダイジェストと一致しなくなったローカルソース、ロックファイルと食い違うソースピンです。さらに、ロックファイルが各アーティファクトについて記録する署名と、各プラグインについてのプラグイン信頼記録を、pull が現時点で記録するものと比較し、pull がそれを記録、置換、または消去する場合は 0 以外で終了します。要件が求める署名が記録されていない場合と、別のアーティファクト用に作られた署名は、pull が応答にかかわらずそれらを書き換えるため、レジストリに問い合わせずに報告されます。pull が再度検索し、変更なしで記録する可能性のある署名(アーティファクトが取得された場合、またはキャッシュされた署名バンドルが削除または改変された場合)は、そのレジストリに問い合わせられるか、オフラインの姿勢ではその旨を示す行とともに未確認のままにされます。プラグイン信頼記録が対象とする各プラグインは、すべての pull が検証するのと同様にそのレジストリで検証されます。ただしオフラインの姿勢では、ビルドが読み込むのと同様にコンテンツキャッシュから読み込まれ、その識別情報とホスト関数は引き続き確認され、署名はその旨を示す行とともに未確認のままにされます。ただし、署名を記録していない、または別のアーティファクト用に作られた署名を記録しているためにビルドが拒否する場合は報告されます。非推奨マーカーは比較されません。さらに、ロックファイルが記録するコンパイラとコアプラグインのバージョンを報告します。これらは監査のために報告され、このバイナリと比較されることはないため、ツールチェーンの違いがずれになることはありません。—pin-sources とは、どの値が与えられても併用できません。verify は entity.lock に欠けているピンを記録することも、それで停止することもないため、このフラグは何も変えません(—upgrade とは排他的です)
--yesfalse非対話的な使用のために、引数なしの —upgrade の確認にあらかじめ応答します。作用するのはその 1 つのプロンプトだけで、それ以外には何も作用しません。その他の形式の pull はいずれも確認を求めないため、そこでこれを渡しても動作は変わりません