배포의 MongoDB 버전 업데이트

이 페이지의 내용

고려 사항

MongoDB 버전을 업데이트하기 위한 API 리소스용 변수
전제 조건
절차

Cloud Manager는 2024년 8월 30일부터 더 이상 MongoDB 3.6 및 4.0에 대한 자동화, 백업 및 모니터링을 지원하지 않습니다. MongoDB 배포를 업그레이드하거나 Atlas로 마이그레이션하세요.

Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.: 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.

이 튜토리얼에서는 API 를 사용하여 MongoDB 배포서버를 새 버전의 MongoDB로 마이그레이션하는 방법을 설명합니다. 이 단계에서는 튜토리얼을 사용 하여 API를 통해 cluster를 배포한경우처럼 MongoDB의 4.0.6 버전을 사용하는 기존 배포가 있다고 가정합니다.

참고

그룹과 프로젝트는 동의어입니다. {PROJECT-ID}는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID가 동일하게 유지됩니다. 이 페이지에서는 설명에 대해 얘기할 때 더욱 친숙한 용어 그룹을 사용합니다. 엔드포인트는 문서에 명시된 대로 유지됩니다.

고려 사항

API 는 MongoDB 버전 2.6 이상에 대한 대부분의 MongoDB 설정 및 매개 변수를 지원합니다. 자세한 내용은 MongoDB 설정 및 자동화 지원을 참조하세요.

MongoDB 버전을 업데이트하기 위한 API 리소스용 변수

API 리소스는 이러한 변수 중 하나 이상을 사용합니다. 이러한 API 리소스를 호출하기 전에 이러한 변수를 원하는 값으로 바꿉니다.

이름	유형	설명
`PUBLIC-KEY`	문자열	API 자격 증명에 대한 공개 API 키입니다.
`PRIVATE-KEY`	문자열	API 자격 증명에 대한 비공개 API 키 입니다.
`cloud.mongodb.com`	문자열	Cloud Manager 인스턴스의 URL 입니다.
`GROUP-ID`	문자열	프로젝트 설정에 있는 프로젝트의 고유 식별자입니다.
`CLUSTER-ID`	문자열	cluster의 고유 식별자입니다.

전제 조건

배포가 존재하는 Cloud Manager 프로젝트에 대해 Project Owner 역할이 있는 사용자로 Cloud Manager에 액세스하려면 자격 증명이 있어야 합니다.

절차

Cloud Manager에서 자동화 구성을 조회합니다.

AutomationConfig 리소스를 사용하여 구성을 검색합니다. 다음 명령을 실행하여 자리 표시자를 MongoDB 버전을 업데이트하는 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.json
- Windows: %SystemDrive%\MMSAutomation\versions\mms-cluster-config-backup.json
version 값이 일치하면 자동화 구성 파일의 현재 버전으로 작업하고 있는 것입니다.

편집을 위해 구성 문서를 엽니다.

다음 단계에서 구성 문서를 편집할 때 설정에 대한 자세한 설명은 자동화 구성 설명을 참조하세요.

배열 에서 MongoDB `processes` 버전을 업데이트합니다.

모든 processes.version 필드를 업데이트하여 4.2.1 을 지정합니다.

"version": "4.2.1"

업데이트된 자동화 구성을 보냅니다.

AutomationConfig 리소스를 사용하여 업데이트된 자동화 구성을 보냅니다.

업데이트된 구성 문서의 경로와 함께 다음 명령을 실행하고 자리 표시자를 MongoDB 버전을 업데이트하는 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 상태 코드를 반환합니다.

자동화 구성이 성공적으로 업데이트되었는지 확인합니다.

Cloud Manager에서 자동화 구성을 조회하고 변경 사항이 포함되어 있는지 확인합니다. 구성을 검색하려면 다음 명령을 실행하여 자리 표시자를 MongoDB 버전을 업데이트하는 API 리소스에 대한 변수로 바꿉니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true"

배포 상태를 확인하여 목표 상태에 도달했는지 확인합니다.

AutomationStatus 리소스를 사용하여 배포서버 상태를 조회합니다. 다음 명령을 실행하여 자리 표시자를 MongoDB 버전을 업데이트하는 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 필드와 일치하는지 확인합니다. 배포 상태에 대해 알아보려면 최신 플랜의 자동화 상태 가져오기를 참조하세요.

돌아가기

자동화 비밀번호 회전

백업 복원 자동화

참고