자동화 구성 업데이트
이 페이지의 내용
- Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.
- 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.
프로젝트의 자동화 구성 에 따라 MongoDB 프로세스 및 에이전트의 목표 상태가 결정됩니다. MongoDB Agent는 지정된 목표에 따라 배포서버를 구축합니다.
구성을 업데이트하려면 다음을 수행합니다.
현재 구성을 조회합니다.
수정하려는 항목만 변경하고 필요에 따라 변경합니다.
PUT을(를) 사용하여 전체 구성을 바꿉니다. 반드시PUT를 사용해야 합니다.PATCH을(를) 사용 하지 마세요 .
참고
일부 매개변수는 automationConfig 엔드포인트를 통해 업데이트할 수 없습니다. 자세한 내용은 다음을 참조하세요.
전제 조건
API 에 대한 액세스 권한이 있어야 합니다. 자세한 내용은 API 액세스 구성을 참조하세요.
자동화 구성 API 리소스용 변수
API 리소스는 이러한 변수 중 하나 이상을 사용합니다. 이러한 API 리소스를 호출하기 전에 이러한 변수를 원하는 값으로 바꿉니다.
이름 | 유형 | 설명 |
|---|---|---|
PUBLIC-KEY | 문자열 | API 자격 증명에 대한 공개 API 키입니다. |
PRIVATE-KEY | 문자열 | API 자격 증명에 대한 비공개 API 키 입니다. |
cloud.mongodb.com | 문자열 | Cloud Manager 인스턴스의 URL 입니다. |
GROUP-ID | 문자열 | 프로젝트 설정에 있는 프로젝트의 고유 식별자입니다. |
CLUSTER-ID | 문자열 | cluster의 고유 식별자입니다. |
절차
Cloud Manager에서 자동화 구성을 조회하고 유효성을 검사합니다.
AutomationConfig 리소스를 사용하여 구성을 검색합니다. 다음 명령을 실행하여 자리 표시자를 자동화 구성 API 리소스용 변수로 바꿉니다.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \ --output currentAutomationConfig.json 다운로드한 자동화 구성 파일의 유효성을 검사합니다.
currentAutomationConfig.json의version필드와 자동화 구성 백업 파일mms-cluster-config-backup.json의 필드를 비교합니다.version값은 두 JSON 문서 모두에서 마지막 요소입니다. 다음의 MongoDB Agent를 실행하는 모든 호스트에서 이 파일을 찾을 수 있습니다.Linux 및 macOS:
/var/lib/mongodb-mms-automation/mms-cluster-config-backup.jsonWindows:
%SystemDrive%\MMSAutomation\versions\mms-cluster-config-backup.json
version값이 일치하면 자동화 구성 파일의 현재 버전으로 작업하고 있는 것입니다.
다운로드한 자동화 구성 파일을 편집합니다.
원하는 텍스트 편집기에서 currentAutomationConfig.json 을(를) 엽니다.
자동화 구성 옵션에 대해 자세히 알아보려면 자동화 구성을 참조하세요.
MongoDB Agent를 업데이트하는 경우 이 절차를 계속하기 전에 에이전트 버전 업데이트 를 참조하세요.
업데이트된 자동화 구성을 보냅니다.
AutomationConfig 리소스를 사용하여 업데이트된 자동화 구성을 보냅니다.
업데이트된 구성 문서의 경로와 함께 다음 명령을 실행하고 자리 표시자를 자동화 구성 API 리소스에 대한 변수로 바꿉니다.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Content-Type: application/json" --request PUT "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \ --data @currentAutomationConfig.json
구성이 성공적으로 업데이트되면 API는 요청이 성공했음을 나타내는 HTTP 200 OK 상태 코드를 반환합니다.
배포 상태를 확인하여 목표 상태에 도달했는지 확인합니다.
AutomationStatus 리소스를 사용하여 배포서버 상태를 조회합니다. 다음 명령을 실행하여 자리 표시자를 자동화 구성 API 리소스용 변수로 바꿉니다.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationStatus?pretty=true"
processes 배열에 있는 모든 lastGoalVersionAchieved 필드의 값이 goalVersion 필드와 일치하는지 확인합니다. 배포 상태에 대해 알아보려면 최신 플랜의 자동화 상태 가져오기를 참조하세요.