빌드 배포

개요

이 가이드 에서는 CLI 에서 에이전트 빌드 프로덕션에 배포 방법을 학습 수 있습니다. 배포하기 전에 에이전트 이미지를 빌드 해야 합니다.

명령 구문 및 옵션

다음 명령을 사용하여 배포서버 관리 .

Agentengine 배포
Agentengine 배포 목록
Agentengine 배포 가져오기 <deployment_id>
Agentengine 배포 로그 <deployment_id>
Agentengine 배포 취소 <deployment_id>

배포 시작

다음 구문을 사용하여 에이전트 빌드 배포 .

agentengine deploy [--auto] [--build-id <id>] [--version <version>] [--workspace-id <id>] [--project-id <id>] [--org-id <id>] [--base-url <url>] [--context <name>] [--no-wait] [--timeout <duration>] [--workspace <name>] [--all] [--json] [--yes]

이 명령은 마지막으로 성공적인 빌드 또는 빌드 ID 제공한 경우 특정 빌드 의 배포서버 시작합니다. 이 명령은 배포서버 상태가 succeeded, failed 또는 rolled_back 상태가 되거나 시간 초과 값에 도달할 때까지 5초마다 배포서버 상태를 폴링합니다.

중요

파일 시스템 액세스

에이전트 를 배포한 후에는 /tmp 또는 /scratch 디렉토리 아래에만 로컬 파일을 쓰기 (write) 해야 합니다. /var 또는 홈 디렉토리와 같은 다른 경로는 런타임 환경에서 쓰기가 불가능할 수 있으므로 사용하지 마세요.

명령 플래그

빌드 배포할 때 다음과 같은 선택적 플래그를 사용할 수 있습니다.

플래그	설명
`--auto`	에이전트 를 빌드하고 빌드 트리거하는 배포서버 를 모니터링합니다. 이 플래그는 단일 에이전트 프로젝트에만 적용됩니다. 두 명령을 별도로 실행 대신 이 플래그를 사용하여 한 번에 빌드 하고 배포 .
`--build-id`	배포 할 빌드 ID . 기본값 으로 이 명령은 작업 공간의 마지막 성공적인 빌드 배포합니다. 이 플래그는 `--version`와 상호 배타적입니다.
`--version`	선언된 이 `agent.yaml` 버전의 출시하다 빌드 배포합니다. 이 플래그는 `--build-id`와 상호 배타적입니다.
`--workspace-id`	플랫폼 작업 공간 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--project-id`	플랫폼 프로젝트 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--org-id`	조직 ID. 기본값 으로 CLI 로컬에 저장된 인증 상태 에서 이 값을 읽습니다.
`--base-url`	플랫폼 API 기본 URL.
`--context`	`.agentengine/state.json` 파일 의 명명된 로컬 컨텍스트입니다.
`--no-wait`	배포서버 시작한 후 상태를 폴링하지 않고 즉시 반환하도록 CLI 에 지시합니다.
`--timeout`	배포서버 완료될 때까지 대기하는 최대 시간입니다. 기본값 으로 배포서버 30분 후에 시간 초과됩니다.
`--workspace`	(Monorepo에만 해당) 루트 `agent.yaml`에 정의된 대로 특정 작업 공간을 이름별로 배포합니다. 이 플래그는 `--all`와 상호 배타적입니다.
`--all`	(Monorepo에만 해당) 모든 작업 공간을 순차적으로 배포합니다. 이 플래그는 `--workspace`와 상호 배타적입니다.
`--json`	배포서버 결과를 JSON 으로 출력합니다.
`--yes`	배포 명령이 Atlas 설정 실행할 때 청구된 Flex 기본값 및 Atlas IP 액세스 목록 변경 사항을 수락합니다.

배포 나열

작업 공간의 배포서버 기록을 보려면 다음 명령을 실행 .

agentengine deploy list [--workspace <name>] [--workspace-id <id>] [--project-id <id>] [--org-id <id>] [--base-url <url>] [--context <name>] [--status <status>] [--limit <n>] [--offset <n>] [--json]

이 명령은 배포서버 ID, 상태, 실행기, 빌드 ID, 이미지, 생성 시간, 버전 및 오류 메시지를 포함하여 현재 작업 공간에 대한 모든 배포를 표시합니다.

명령 플래그

플래그	설명
`--workspace`	(Monorepo에만 해당) 루트 `agent.yaml`에 정의된 대로 특정 작업 공간을 이름으로 선택합니다.
`--workspace-id`	플랫폼 작업 공간 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--project-id`	플랫폼 프로젝트 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--org-id`	조직 ID. 기본값 으로 CLI 로컬에 저장된 인증 상태 에서 이 값을 읽습니다.
`--base-url`	플랫폼 API 기본 URL.
`--context`	`.agentengine/state.json` 파일 의 명명된 로컬 컨텍스트입니다.
`--status`	배포서버 상태( 예시 : `succeeded`, `failed` 또는 `in_progress`)를 기준으로 결과를 필터링합니다.
`--limit`	반환할 최대 배포 수입니다.
`--offset`	건너뛸 배포서버 수입니다.
`--json`	배포서버 목록을 JSON 으로 출력합니다.

배포 상태 확인

배포서버 의 자세한 상태를 보려면 다음 명령을 실행 .

agentengine deploy get [<deployment_id>] [-f] [--workspace <name>] [--workspace-id <id>] [--project-id <id>] [--org-id <id>] [--base-url <url>] [--context <name>] [--json]

기본값 으로 이 명령은 가장 최근 배포서버 의 특정 시점 스냅샷 반환합니다. 특정 배포서버 확인하려면 배포서버 ID 입력합니다. 출력에는 배포서버 상태, 빌드 ID, 버전, 이미지, 조건, 구성 요소 준비 상태 및 실시간 상태 정보가 포함됩니다.

명령 플래그

플래그	설명
`-f`, `--follow`	배포서버 터미널 상태 에 도달할 때까지 서버 전송 이벤트(SSE)를 사용하여 배포서버 이벤트를 실시간 스트리밍합니다. 배포서버 이미 터미널 상태 인 경우 명령은 스트림 할 항목이 없다고 보고합니다.
`--workspace`	(Monorepo에만 해당) 특정 작업 공간을 이름으로 선택합니다.
`--workspace-id`	플랫폼 작업 공간 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--project-id`	플랫폼 프로젝트 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--org-id`	조직 ID. 기본값 으로 CLI 로컬에 저장된 인증 상태 에서 이 값을 읽습니다.
`--base-url`	플랫폼 API 기본 URL.
`--context`	`.agentengine/state.json` 파일 의 명명된 로컬 컨텍스트입니다.
`--json`	배포서버 상태를 JSON 으로 출력합니다.

배포 이벤트 로그 보기

배포서버 대한 구조화된 이벤트 로그 보려면 다음 명령을 실행 .

agentengine deploy logs [<deployment_id>] [-f] [--severity <level>] [--category <category>] [--limit <n>] [--workspace <name>] [--workspace-id <id>] [--project-id <id>] [--org-id <id>] [--base-url <url>] [--context <name>] [--json]

이 명령은 지정된 배포서버 대한 이벤트 로그 검색하여 생성에서 완료까지의 각 상태 전환을 표시합니다. 배포서버 ID 제공하지 않으면 명령은 가장 최근 배포서버 대한 이벤트 로그 표시합니다. 이벤트 로그 사용하여 배포서버 동작을 추적하고, 실패를 조사하고, 예상되는 수명 주기 전환이 발생했는지 확인할 수 있습니다.

배포서버 실패하면 실패한 구성 요소에 대한 이벤트 에 종료 코드와 간단한 실패 이유가 모두 포함됩니다.

참고

--json 플래그는 --follow, --severity 또는 --category 플래그와 결합할 수 없습니다.

명령 플래그

플래그	설명
`-f`, `--follow`	배포서버 종료 상태 에 도달할 때까지 새 이벤트를 폴링합니다.
`--severity`	심각도 수준(`info`, `success`, `warn` 또는 `error`)별로 이벤트를 필터링합니다.
`--category`	카테고리별로 이벤트를 필터링합니다( 예시 : `agent_rollout` 또는 `tool_rollout`).
`--limit`	페이지당 반환할 최대 이벤트 수입니다. 기본값은 100입니다.
`--workspace`	(Monorepo에만 해당) 특정 작업 공간을 이름으로 선택합니다.
`--workspace-id`	플랫폼 작업 공간 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--project-id`	플랫폼 프로젝트 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--org-id`	조직 ID. 기본값 으로 CLI 로컬에 저장된 인증 상태 에서 이 값을 읽습니다.
`--base-url`	플랫폼 API 기본 URL.
`--context`	`.agentengine/state.json` 파일 의 명명된 로컬 컨텍스트입니다.
`--json`	이벤트 로그 JSON 으로 출력합니다.

배포 취소

진행 중인 배포서버 취소하려면 다음 명령을 사용합니다.

agentengine deploy cancel <deployment_id> [--workspace <name>] [--workspace-id <id>] [--project-id <id>] [--org-id <id>] [--base-url <url>] [--context <name>]

이 명령은 배포서버 이미 succeeded, failed 또는 rolled_back 상태 인 경우 오류를 반환합니다.

명령 플래그

플래그	설명
`--workspace`	(Monorepo에만 해당) 루트 `agent.yaml` 파일 에 정의된 대로 특정 작업 공간을 이름으로 선택합니다.
`--workspace-id`	플랫폼 작업 공간 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--project-id`	플랫폼 프로젝트 ID. 기본값 으로 CLI `.agentengine/state.json` 파일 에서 이 값을 읽습니다.
`--org-id`	조직 ID. 기본값 으로 CLI 로컬에 저장된 인증 상태 에서 이 값을 읽습니다.
`--base-url`	플랫폼 API 기본 URL.
`--context`	`.agentengine/state.json` 파일 의 명명된 로컬 컨텍스트입니다.

빌드 제한

이 플랫폼은 각 프로젝트 에 대해 다음과 같은 빌드 제한을 적용합니다.

Limit	값
동시 활성 빌드	10
연속 24시간 동안의 일일 빌드	100

빌드 제한을 초과하는 경우 요청 RESOURCE_LIMIT_EXCEEDED 메시지와 함께 400 Bad Request 오류를 반환합니다.

공개 미리 보기 중에 적용 모든 제한 사항을 검토 하려면 MongoDB Atlas Agent 엔진 제한 사항을 참조하세요.

예시

다음 예시 마지막으로 성공적인 빌드 배포 해당 배포서버 의 상태를 확인한 다음 취소하는 방법을 보여 줍니다.

배포를 시작합니다.

다음 명령을 실행하여 마지막으로 성공적인 빌드 배포 하고 상태 폴링 없이 즉시 반환합니다.

agentengine deploy --no-wait

배포서버 성공적으로 시작되면 출력은 다음과 유사합니다.

Deploying last successful build...
✓ Deployment started (deployment_id: deploy-9fb9e685)

배포서버 상태를 확인합니다.

다음 명령을 실행하여 이전 단계의 배포서버 ID 사용하여 배포서버 상태를 확인합니다.

agentengine deploy get deploy-9fb9e685

출력은 다음과 유사합니다.

Deployment: deploy-9fb9e685
Status:     in_progress (started 45s ago)
Trigger:    build
Build:      bld_01...
Version:    v0.1.0 (r1)
Conditions:
  Available      False  NotAvailable — One or more components are not available.
Components:
  Orchestration Engine   0/1 not ready
  Agent Sandbox          1/1 ready
  Tool Sandbox           1/1 ready
Health: unavailable

배포서버 취소합니다.

마지막으로 다음 명령을 실행 배포서버 취소합니다.

agentengine deploy cancel deploy-9fb9e685

다음 단계

에이전트 배포한 후 에이전트의 성능과 활동을 모니터 할 수 있습니다. 에이전트 모니터 하는 방법을 학습 모니터 가이드 참조하세요.

Atlas Agent Engine에서 에이전트 실행 위한 최소 요구 사항에 대해 학습 MongoDB Atlas Agent Engine 문서의 Agent 계약 섹션을 참조하세요.

돌아가기

에이전트 이미지 빌드

자체 CI/CD 파이프라인에서 구축