개요
작업 공간의 연결된 Atlas cluster 는 플랫폼 기본 송신 정책의 일부입니다. 클러스터 연결한 후에는 에이전트 가 deny_all 및 allow_list 모드 모두에서 클러스터에 연결할 수 있으며, 클러스터 를 이그레스 대상으로 추가할 필요가 없습니다.
이 가이드 에서는 agentengine CLI 사용하여 Atlas cluster 작업 공간에 연결하고, 링크를 확인하고, 나중에 연결된 클러스터 변경하는 방법을 학습 수 있습니다.
클러스터 를 연결하면 Atlas Agent Engine 연결 IP 주소도 클러스터의 IP 액세스 목록 에 추가됩니다. 이러한 IP 주소를 수동으로 추가할 필요는 없습니다.
LLM 제공자 API 및 기타 타사 서비스와 같이 기본 정책이 적용되지 않는 대상을 허용하는 방법을 학습 네트워크 이그레스 정책 관리 가이드 참조하세요.
전제 조건
시작하기 전에 다음 전제 조건을 충족하는지 확인하세요.
agentengineCLI 버전 0.1.54-alpha 이상이 설치되어 있고PATH환경 변수에서 사용할 수 있습니다. 자세한 학습 은 설치 및 인증 가이드 참조하세요.agentengine auth login명령을 사용하여 플랫폼에 인증할 수 있습니다.연결하려는 클러스터 포함된 Atlas 프로젝트 있거나 해당 프로젝트 에 클러스터 생성할 수 있는 권한이 있습니다.
Atlas 서비스 계정 만들기
agentengine CLI 서비스 계정을 사용하여 Atlas 에 인증합니다. Atlas 프로젝트 에서 클러스터 보유하는 서비스 계정을 만든 후 다음 역할 구성 중 하나를 부여합니다.
Project Owner역할Cluster Creator,Cluster Manager,Database Access Admin및Network Access Manager역할
CLI 서비스 계정 자격 증명 저장하고 확인하는 방법을 학습 Atlas 리소스 설정 가이드 참조하세요.
클러스터 연결
클러스터 선택하거나 생성합니다.
CLI 에 메시지가 표시되면 연결하려는 클러스터 를 선택합니다. 대신 클러스터 생성하려면 클러스터 생성 옵션을 선택합니다. 새 클러스터는 기본값 으로 Flex 계층 입니다.
참고
M0 또는 공유 계층을 사용하지 마세요. 클러스터 계층 요구 사항에 대해 자세히 학습 Atlas 리소스 설정 가이드 참조하세요.
링크 확인
CLI Atlas 구성에 대한 두 가지 보기, 즉 로컬 CLI 상태 와 플랫폼 상태 보고합니다. 이러한 상태는 다를 수 있으므로 연결 문제를 해결할 때 두 상태를 모두 확인하세요.
로컬 CLI 상태
컴퓨터에 기록된 Atlas 설정 검토 하려면 다음 명령을 실행 .
agentengine atlas setup
이 명령은 CLI .agentengine/state.json 파일 에 저장하는 로컬 상태 읽습니다. 새 체크아웃이나 다른 컴퓨터에서는 작업 공간이 이미 연결된 경우에도 전체 설정 다시 실행 하라는 메시지가 표시될 수 있습니다. 이 동작은 예상된 동작이며 클러스터 연결을 해제하지 않습니다.
플랫폼 상태
Atlas Agent 엔진이 기록한 링크를 검토 하려면 다음 명령을 실행 .
agentengine atlas status
이 명령은 연결된 Atlas 환경 및 프로젝트 ID, 송신 동기화 상태, 마지막으로 성공적인 동기화 시간을 보고합니다. 다음 표에서는 동기화 상태 값에 대해 설명합니다.
상태 | 설명 |
|---|---|
| Atlas Agent Engine에는 현재 클러스터 정책이 있습니다. |
| Atlas Agent 엔진이 정책 변경 사항을 적용하고 있습니다. |
| Atlas Agent 엔진이 클러스터 정책을 조회 할 수 없습니다. |
연결된 클러스터 변경
다른 클러스터 연결하려면 agentengine atlas setup 명령을 다시 실행 하고 새 클러스터 선택합니다. 이 명령은 송신 링크를 다시 가리키고 새 클러스터의 Atlas IP 액세스 목록 구성합니다.
참고
새 클러스터 다른 Atlas 프로젝트 에 속하는 경우, 서비스 계정에도 해당 프로젝트 에서 Project Owner 역할 있어야 합니다.
문제 해결
이 섹션에서는 Atlas cluster 연결할 때 발생할 수 있는 문제에 대해 설명합니다.
권한 오류로 인해 설치가 실패합니다.
Atlas 서비스 계정에 클러스터 를 보유하는 Atlas 프로젝트 에서 Project Owner 역할 있는지 확인합니다.
Atlas 프로젝트를 연결할 수 없는 경우
agentic atlas setup 명령은 Atlas 프로젝트 를 작업 공간에 자동으로 연결합니다. 링크가 실패하면 명령이 메모를 인쇄하고 완료됩니다. 링크를 다시 시도하려면 agentic atlas link을 실행 다음 agentic atlas status를 실행 링크가 성공했는지 확인합니다.
연결하지 않은 클러스터에 에이전트가 연결할 수 없음
기본 정책은 연결된 클러스터 에만 적용됩니다. 다른 MongoDB cluster 에 연결하려면 이를 포트 27017의 송신 대상으로 추가합니다. 자세한 학습 은 네트워크 이그레스 정책 관리 가이드 참조하세요.
에이전트가 메모리를 사용하지 않지만 여전히 Atlas 에 연결할 수 없음
메모리를 비활성화해도 Atlas 요구 사항은 제거 되지 않습니다. 작업 공간이 Atlas 에 연결되는 경우 이 가이드 에 설명된 대로 클러스터 를 연결합니다.
다음 단계
클러스터 를 연결한 후 에이전트 호출하는 다른 대상(예: LLM 제공자 API)을 허용합니다. 방법을 학습 네트워크 이그레스 시작하기 튜토리얼을 참조하세요.