CLIは、コンテナイメージ、agentengine createスターターテンプレート、および独自のリリースバイナリをパブリックロケーションから解決します。イメージはパブリックGHCRから、スターターテンプレートはパブリック例リポジトリから取得され、どちらもレジストリログインやプラットフォームセッションなしでフェッチされます。
このページでは、デフォルトのソース、オーバーライド変数、および診断について説明します。custom ソースと source.yaml 自体については、custom-artifact-source.md を参照してください。
デフォルトのソース
Publicは組み込みのデフォルトです。オーバーライドが設定されていない場合、agentengine create、agentengine dev up、およびagentengine self-updateはすべてパブリック座標に解決されます。
変数の上書き
CLIは、AGENTENGINE_IMAGE_SOURCEとAGENTENGINE_IMAGE_SOURCE_FILEという1つのオーバーライド変数ペアを読み取ります。レガシーなAP_SOURCE / AP_SOURCE_FILE名は読み取られなくなりました。いずれかを設定すると、別のソースがサイレントに解決されるのではなく、コマンドが失敗します。
使用可能な値は public と custom です。廃止された internal 値は、引き続き public のサイレントエイリアスとして受け入れられます。デフォルトのソースは public です。
移行する
AP_SOURCE と AP_SOURCE_FILE は削除されます。これらを名前変更してください。
# beforeexport AP_SOURCE=customexport AP_SOURCE_FILE=/etc/agentic/source.yaml
# afterexport AGENTENGINE_IMAGE_SOURCE=customexport AGENTENGINE_IMAGE_SOURCE_FILE=/etc/agentic/source.yamlAP_SOURCE のみを設定しているマシンは、public にサイレントにフォールバックするのではなく、AGENTENGINE_IMAGE_SOURCE を指定するエラーで失敗します。これは、移行におけるドキュメント化された破壊的変更です。
デフォルトのソースは public。変数が設定されていない場合、それが解決されます。
base: public source.yamlではパブリックデフォルトが使用されるため、registryまたはreleaseブロックを省略したカスタムソースは、そのブロックに対してそれらを継承します。source.yamlにはテンプレートフィールドがないため、agentengine createのテンプレートリポジトリは常にbase:に従います。registry.prefix を固定して影響を受けないようにします。registryブロックはイメージのみを固定します。テンプレートリポジトリとリリースをホストするものは引き続きbase:に従います。
agentengine create
agentengine create git を使用して、パブリックな 例 リポジトリのデフォルトの public ソースから、または custom source.yaml という名前のリポジトリからスターターテンプレートをフェッチします。PATH 上に git が必要であり、プラットフォームセッションは不要です。
agentengine dev up
ファーストパーティのイメージは、レジストリログインなしでパブリック GHCR (ghcr.io/mongodb/agent-engine-client-libraries) から取得されます。
診断
agentengine version --full AGENTENGINE_IMAGE_SOURCE=custom の場合にカスタムソースのリリースとレジストリを出力します。デフォルトのパブリックソースでは、ソース行は追加されません。