La CLI resuelve imágenes de contenedor, agentengine create plantillas de inicio y su propio binario de lanzamiento desde ubicaciones públicas: imágenes desde GHCR público y plantillas de inicio desde un repositorio de ejemplo público, ambos obtenidos sin inicio de sesión en el registro y sin sesión de plataforma.
Esta página cubre la fuente por defecto, las variables de anulación y los diagnósticos. Para la fuente custom y source.yaml en sí, consulte custom-artifact-source.md.
La fuente por defecto
Public es la funcionalidad incorporada por defecto. Sin una anulación establecida, agentengine create, agentengine dev up y agentengine self-update resuelven todas las coordenadas públicas.
Sobrescribir variables
La CLI lee un par de variables de anulación: AGENTENGINE_IMAGE_SOURCE y AGENTENGINE_IMAGE_SOURCE_FILE. Los nombres heredados AP_SOURCE / AP_SOURCE_FILE ya no se leen; establecer cualquiera de ellos hace que el comando falle en lugar de resolver silenciosamente una fuente diferente.
Los valores aceptados son public y custom. El valor retirado internal todavía se acepta como un alias silencioso para public. La fuente por defecto es public.
migrar
AP_SOURCE y AP_SOURCE_FILE se eliminan; cámbieles el nombre.
# beforeexport AP_SOURCE=customexport AP_SOURCE_FILE=/etc/agentic/source.yaml
# afterexport AGENTENGINE_IMAGE_SOURCE=customexport AGENTENGINE_IMAGE_SOURCE_FILE=/etc/agentic/source.yamlUna máquina que todavía solo establece AP_SOURCE falla con un error que nombra AGENTENGINE_IMAGE_SOURCE, en lugar de volver silenciosamente a public. Esta es la ruptura documentada de la migración.
La fuente por defecto es public. Sin ninguna variable establecida, eso es lo que se resuelve.
base: public en un source.yaml utiliza los valores por defecto públicos, por lo que una fuente personalizada que omite un bloque registry o release los hereda para ese bloque. El repositorio de plantillas de agentengine create siempre sigue base:, ya que source.yaml no tiene campo de plantillas. Fije registry.prefix para que no se vea afectado. Un bloque registry fija solo las imágenes; el repositorio de plantillas y el host de lanzamiento siguen base:.
agentengine crear
agentengine create obtiene la plantilla de inicio con git, del repositorio de ejemplo público para la fuente public por defecto, o del repositorio que custom source.yaml nombres. Necesita git en la PATH y ninguna sesión de plataforma.
agentengine dev levantar
Las imágenes de origen propio provienen de GHCR público (ghcr.io/mongodb/agent-engine-client-libraries) sin inicio de sesión en el registro.
Diagnósticos
agentengine version --full imprime la versión y el registro de la fuente personalizada cuando AGENTENGINE_IMAGE_SOURCE=custom. Con la fuente pública por defecto, no añade líneas de origen.