バージョン解決
カタログのアーティファクト(Components、Features、Recipes、FeatureRecipes、Plugins、
Aggregates)は metadata.version を持ち、カタログは同じアーティファクトの複数の
バージョンを同時に保持できます。何かがアーティファクトを参照するとき、その参照によって
使用するバージョンが選択されます。このページでは、その選択の仕組みを説明します。
バージョンの参照
参照はアーティファクトの型 URI であり、任意でバージョンに固定できます。次の 3 つの 形式を受け付けます。
| 形式 | 例 | 選択されるもの |
|---|---|---|
| 完全一致 | core/datastore/mariadb:1.2.0 | そのバージョンそのもの |
| 範囲(キャレット) | core/datastore/mariadb:^1.2.0 | >= 1.2.0 かつ < 2.0.0 の最も高いバージョン |
| バージョン指定なし | core/datastore/mariadb | 利用可能な最も高いバージョン |
キャレット形式は、npm、Cargo、Go modules でおなじみのメジャー互換の慣例に従います。 どの形式でも、解決では参照を満たす最も高いバージョンが選択され、プレリリースよりも 安定版リリースが優先されます。完全一致の参照は、自動選択を使わずに 1 つのバージョンに 固定する方法です。
決定性
選択は、依存関係がロックされるときに一度だけ行われます。ロックファイルには、参照が 選択したバージョン(範囲の参照は範囲としてではなく、解決されたバージョンとして記録されます)が、 そのバージョン自体のドキュメントから取得したコンテンツのフィンガープリントとともに記録され、 以降のビルドはすべてその記録からまったく同じアーティファクトを再現します。そのため、カタログに 新しいバージョンが追加されても、すでにロックされたビルドが暗黙のうちに変わることはありません。 再ロックは明示的な操作です。
カタログの置き場所にかかわらず、同じ規則が適用されます。ローカルのカタログのチェックアウトと レジストリは、参照を同じバージョンに解決します。また、カタログを読み取るすべてのコマンドにも 同じ規則が適用されます。ロックファイルを書き込む pull、それを読み取るビルド、validate、エディタ、 アシスタント向けツールはいずれも、ディレクトリに同じ名前のバージョンがいくつあっても、1 つの カタログから同じバージョンを選択します。また、ビルドによるロックファイルのチェックでは、ビルドが 選択したバージョンと pull が記録したバージョンが比較されます。
ライブラリの依存関係
再利用可能なスキーマライブラリとマッピングライブラリ(SchemaLibrary、MappingLibrary)は 異なる方法で解決されます。これらは最小バージョン選択(ワークスペース全体のすべての制約を 満たす最も低いバージョン)を使用し、これも Go modules と同じです。これにより、ライブラリの アップグレードは自動ではなく意図的に行われるようになります。
参照を満たすものがない場合
参照が、利用可能などのバージョンも満たさないバージョンまたは範囲を指定している場合
(たとえば 1.x のバージョンしか存在しないのに :^2.0.0 を指定した場合)、解決は別の
バージョンに暗黙的にフォールバックするのではなく、記述どおりの参照(アーティファクトと制約の両方)を
示すエラーで停止します。同じ Release に対する pull と validate は、同じ文言でこれを拒否します。
Release の依存関係の解決では、まったく存在しないアーティファクトも同じ文言で報告されます。
どちらの場合も参照が何にも一致しなかったためです。そのため、エラーが示す参照の両方の部分を
確認してください。