공개 아티팩트

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이라는 하나의 재정의 변수 쌍을 읽습니다. 레거시 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.yaml

AP_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 기본값 public 소스에 대한 공개 예시 리포지토리에서 git와 함께 스타터 템플릿을 가져오거나 custom source.yaml 이름의 리포지토리에서 가져옵니다. PATH에 git가 필요하며 플랫폼 세션이 없어야 합니다.

agentengine dev up

자사 이미지는 레지스트리 로그인 없이 공용 GHCR(ghcr.io/mongodb/agent-engine-client-libraries)에서 가져옵니다.

진단

agentengine version --full AGENTENGINE_IMAGE_SOURCE=custom일 때 커스텀 소스의 릴리스와 레지스트리를 출력합니다. 기본값 공용 소스를 사용하면 소스 라인이 추가되지 않습니다.

돌아가기

환경 변수