Docs Menu
Docs Home
/
MongoDB Ops Manager
/
API
/
Ops Manager 관리 API 튜토리얼

배포의 MongoDB 버전 업데이트

이 페이지의 내용

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

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

참고

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

고려 사항

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

경고

MongoDB 5.0 에서 6.0로 업그레이드

MongoDB 5.0 에서 6.0 으로 샤드 클러스터를 업그레이드하는 경우, MongoDB 매뉴얼의 샤드 클러스터를 6.0으로 업그레이드 페이지에 있는 절차를 사용하여 각 mongos 에 대해 캐시된 라우팅 테이블을 새로 고쳐야 합니다. .

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

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

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

전제 조건

Global Owner 역할이 있는 사용자로 Ops Manager에 액세스하려면 자격 증명이 있어야 합니다.

절차

1

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

  1. AutomationConfig 리소스를 사용하여 구성을 검색합니다. 다음 명령을 실행하여 자리 표시자를 MongoDB 버전을 업데이트하는 API 리소스에 대한 변수로 바꿉니다.

    curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
         --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
         --output currentAutomationConfig.json

  2. 다운로드한 자동화 구성 파일의 유효성을 검사합니다.

    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 값이 일치하면 자동화 구성 파일의 현재 버전으로 작업하고 있는 것입니다.

2

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

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

3

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

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

"version": "4.2.1"
4

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

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

업데이트된 구성 문서의 경로와 함께 다음 명령을 실행하고 자리 표시자를 MongoDB 버전을 업데이트하는 API 리소스에 대한 변수로 바꿉니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Content-Type: application/json"
     --request PUT "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
     --data @currentAutomationConfig.json

구성이 성공적으로 업데이트되면 API는 요청이 성공했음을 나타내는 HTTP 200 OK 상태 코드를 반환합니다.

5

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

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

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true"
6

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

AutomationStatus 리소스를 사용하여 배포서버 상태를 조회합니다. 다음 명령을 실행하여 자리 표시자를 MongoDB 버전을 업데이트하는 API 리소스에 대한 변수로 바꿉니다.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationStatus?pretty=true"

processes 배열에 있는 모든 lastGoalVersionAchieved 필드의 값이 goalVersion 필드와 일치하는지 확인합니다. 배포 상태에 대해 알아보려면 최신 플랜의 자동화 상태 가져오기를 참조하세요.

돌아가기

API로 자동화 비밀번호 순환