배포서버의 구성 편집
- Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.
- 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.
MongoDB 버전, 스토리지 엔진, 호스트 또는 샤드 수를 포함한 배포의 구성 및 토폴로지를 수정할 수 있습니다. 배포 토폴로지의 모든 수준에서 최상위 샤드 클러스터 또는 복제본 세트 에서 샤드 클러스터 내의 복제본 세트 또는 복제본 세트 내의 개별 프로세스와 같은 하위 수준으로 수정할 수 있습니다. 독립형 프로세스를 수정할 수도 있습니다.
고려 사항
cluster 또는 멤버에 변경 사항 적용
개별 MongoDB 프로세스에 대한 구성을 변경하는 경우, cluster에 대한 향후 변경 사항은 더 이상 하위 프로세스에 적용되지 않습니다.
예시
복제본 세트 멤버에 대한 저널링을 해제한 다음 나중에 복제본 세트의 저널 커밋 간격을 변경하면 변경 사항이 해당 멤버에 적용되지 않습니다.
MongoDB 버전
Cloud Manager에서 사용할 수 있는 MongoDB 버전을 선택하려면 사용자 지정 MongoDB 빌드 추가를 참조하세요.
배포서버의 MongoDB 버전을 변경하기 전에 다음 문서에서 고려 사항 또는 호환성 문제를 확인합니다.
드라이버에 대한 문서입니다.
사전 정의된 유지 관리 기간 동안 버전 변경을 계획합니다.
프로덕션 환경을 변경하기 전에 스테이징 환경에서 MongoDB 버전을 변경합니다. 스테이징 환경은 프로덕션 환경을 미러링해야 합니다. 이렇게 하면 프로덕션 배포서버의 다운타임을 초래할 수 있는 호환성 문제를 방지하는 데 도움이 될 수 있습니다.
복제본 세트 및 샤드 클러스터 의 수동 업그레이드를 수행할 때는 MongoDB 릴리스 노트 를 따르세요.
참고
다운그레이드 제한 사항
MongoDB deployment는 다운그레이드할 수 없습니다.
버전 5.0부터 4.4.0 이전 버전까지
4.4 버전부터 4.2.6 이전 버전까지
MongoDB 버전에 대한 백업 고려 사항
백업 고려 사항에 대해 자세히 알아보려면 백업 고려 사항을 참조하세요.
"featureCompatibilityVersion" : 4.2
을(를) 통해 MongoDB 4.2로 업그레이드하기로 선택하면 Cloud Manager에 MongoDB, Inc.가 백업에 MongoDB Enterprise를 사용하기 위해 부여하는 특별 라이선스 에 동의하는 모달이 표시됩니다.
스토리지 엔진
중요
MongoDB는 MongoDB 4.2 에서 MMAPv1 스토리지 엔진에 대한 지원을 제거했습니다. 배포 구성을 편집하여 스토리지 엔진을 WiredTiger 스토리지 엔진으로 변경하면 Cloud Manager가 MongoDB 프로세스를 다시 시작합니다.
MongoDB 3.0 이상 을 실행 하거나 업그레이드 하고 MongoDB 스토리지 엔진 을 수정 하면 Cloud Manager 가 MongoDB 프로세스 를 종료 하고 다시 시작 합니다 . 다중 멤버 복제본 세트 의 경우 Cloud Manager 는 각 멤버의 롤링 초기 동기화 를 수행합니다.
Cloud Manager 는 호스트에 충분한 디스크 공간이 있는 경우 한 storage engine 에서 다른 스토리지 엔진으로 마이그레이션하는 동안 백업 디렉토리를 생성합니다. 디스크 공간이 부족하면 백업이 수행되지 않습니다. 마이그레이션이 완료되면 Cloud Manager가 백업 디렉토리를 삭제 하지 않습니다 . 이전 백업 디렉토리를 유지하거나 삭제할 수 있습니다. 백업 디렉토리는 mongod 의 데이터 디렉토리에 있습니다.
예시
데이터 디렉토리가 /data/process
이면 백업은 /data/process.bak.UNIQUENAME
이 됩니다. UNIQUENAME
는 Cloud Manager가 생성하는 임의의 문자열입니다.
독립형 인스턴스 또는 복제본 세트 의 스토리지 엔진 을 변경하려면 먼저 MongoDB 데이터 디렉토리 의 상위 디렉토리 에 대한 쓰기 (write) 액세스 을 자동화에 부여해야 합니다. 에이전트 는 스토리지 엔진 을 업데이트할 때 상위 디렉토리 에 데이터의 임시 백업 을 생성합니다. 독립형 인스턴스의 스토리지 엔진 변경도 전체 /mongodump 및 /mongorestore 를 수행하기 위해 충분한 디스크 공간이 필요합니다. 그런 다음 스토리지 엔진 구성이 변경된 후 이 디스크 공간이 인스턴스 로 복원됩니다. Cloud Manager 는 백업 디렉토리를 삭제 하지 않습니다 .
config 서버 에서는 을 변경할 수 storage engine 없습니다. 스토리지 엔진 및 사용 가능한 옵션에 대한 자세한 내용은 MongoDB 매뉴얼의 스토리지 를 참조하세요.
고정 속성
배포가 생성된 후에는 다음 설정을 수정할 수 없습니다.
다음 배포 설정을 수정할 수 있습니다 .
배포 토폴로지
하위 프로세스를 포함하여 배포 토폴로지의 모든 수준에서 수정할 수 있습니다.
토폴로지 또는 프로세스를 수정하려면 이 튜토리얼 또는 보다 구체적인 튜토리얼 중 하나를 사용하세요.
프로젝트 수준 수정
배포에 영향을 주는 일부 수정 사항은 프로젝트 수준에서 발생합니다. 다음 변경 사항은 프로젝트의 모든 MongoDB 프로세스에 영향을 줍니다. 이러한 변경 사항의 경우 지정된 튜토리얼을 사용합니다.
배포에 TLS 를 사용하도록 설정하려면 배포에 TLS 사용을 참조하세요.
배포에 대한 인증을 활성화하려면 Cloud Manager 프로젝트에 인증 활성화를 참조하세요.
배포서버를 위한 MongoDB 사용자 및 역할을 추가하거나 수정하려면 MongoDB 사용자 관리를 참조하세요.
다중 수정
여러 수정 사항을 하나의 배포로 결합할 수 있습니다.
예시
Review Changes 버튼을 클릭하기 전에 다음과 같은 사항을 모두 수정할 수 있습니다.
배포의 MongoDB 프로세스에 TLS 를 활성화합니다.
위에서 안정적인 최신 버전의 MongoDB를 실행하는 새 샤드 클러스터를 추가합니다.
Review Changes 을(를) 클릭하면 배포하기 전에 확인할 수 있도록 검토에서 모든 변경 사항이 한 화면에 표시됩니다.
강제 재구성
복제본 세트 및 샤딩된 클러스터 전용
MongoDB Agent는 Force Reconfigure 복제본 세트 설정을 Yes
로 설정한 경우 복제본 세트가 새 구성을 수락하도록 강제할 수 있습니다. 소수의 멤버를 사용할 수 있는 상태에서 복제본 세트를 복구하는 경우에만 재구성을 강제로 수행합니다.
경고: 복제본 세트 를 강제로 재구성하면 과반수가 커밋된 쓰기가 롤백 될 수 있습니다.
진행 시 유의하세요. 이 작업의 잠재적 영향에 대한 질문이 있는 경우 MongoDB 지원에 문의하세요.
샤드 제거
샤딩된 클러스터 전용
샤드를 제거하면 해당 샤드의 모든 샤딩되지 않은 데이터베이스가 movePrimary 명령을 사용하여 나머지 샤드로 이동합니다.
샤드 제거 프로세스 중에도 모든 샤딩된 컬렉션은 온라인 상태로 유지되며 사용할 수 있습니다. 그러나 movePrimary
작업 중에 샤딩되지 않은 컬렉션에 대한 읽기 또는 쓰기 작업을 수행하면 마이그레이션 실패 또는 데이터 손실과 같은 예기치 않은 동작이 발생할 수 있습니다.
샤드를 제거하기 전에 샤드되지 않은 컬렉션이 포함된 데이터베이스의 프라이머리 샤드를 이동하는 것이 좋습니다.
샤드 제거에 학습 보려면 기존 샤드 클러스터에서 샤드 제거를 참조하세요.
여러 복제본 세트 멤버 제거
한 번에 여러 개의 복제본 세트 멤버를 제거하거나 마이그레이션할 수 있지만 투표권이 있는 멤버의 과반수는 그대로 유지해야 합니다. 투표 멤버를 더 제거해야 하는 경우 한 번에 하나씩 제거합니다.
예시
예시 1
4노드 복제본 세트가 있습니다. 모든 노드는 투표권이 있는 멤버입니다. 하나의 노드만 제거할 수 있으며, 이 경우 투표 노드 4개 중 3개의 대다수가 유지됩니다. 나중에 나머지 3노드 복제본 세트에서 다른 노드를 제거할 수 있습니다. 이렇게 하면 나머지 투표 노드의 대부분이 보존됩니다.
예시
예시 2
4노드 복제본 세트가 있습니다. 3개의 노드는 투표권이 있는 노드이고 1개의 노드는 투표권이 없는 노드입니다. 투표 멤버 한 명과 투표권이 없는 멤버 한 명을 동시에 제거할 수 있습니다. 이렇게 하면 투표 노드 3개 중 2개의 대다수가 보존됩니다.
투표에 대해 자세히 알아보려면 복제본 세트 고가용성 및 복제본 세트 투표를 참조하세요.
전제 조건
배포에서는 Cloud Manager와 호환되는 자동화 버전을 실행 중이어야 합니다. 배포에서 호환되는 버전의 에이전트가 실행되고 있지 않은 경우 Cloud Manager는 에이전트를 업데이트하라는 배너를 표시합니다.
절차
편집하려는 배포 유형을 선택합니다.
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
독립형 설정을 수정합니다.
Standalone Settings 섹션에는 다음과 같은 구성 설정이 포함되어 있습니다.
설정 | 설명 |
---|---|
Hostname | Cloud Manager 가 |
Port | |
Version | |
Auth Schema Version | 배포를 위한 사용자 데이터를 저장하기 위해 사용자를 저장하기 위한 스키마를 선택합니다. 3.0 이전 MongoDB 버전에서 업그레이드하는 경우, MongoDB 3.0+는 사용자 데이터에 대해 이전 버전과 다른 스키마를 사용합니다. 호환성 정보는 MongoDB 3.0 릴리스 노트의 보안 변경 사항 을 참조하세요. |
Feature Compatibility Version | 배포의 기능 호환성 버전 을 선택합니다. Cloud Manager는 배포에서 MongoDB 버전 3.4 이상을 실행하는 경우 이 필드를 표시합니다. |
Log File |
예를 예시
|
고급 구성 옵션을 수정합니다.
Advanced Configuration Options 섹션에서는 배포의 각 MongoDB 프로세스에 대한 MongoDB 런타임 옵션을 설정할 수 있습니다.
옵션을 추가하려면 다음을 수행합니다.
Add Option를 클릭합니다.
Select a Startup Option을 클릭하고 구성 옵션을 선택합니다.
Cloud Manager는 선택한 옵션에 대해 허용 가능한 값을 구성하기 위해 상황에 맞는 입력을 표시합니다.
선택한 옵션과 해당 값을 프로세스에 추가하려면 Add 을 클릭합니다.
사용 가능한 Advanced Configuration Options에 대한 설명은 MongoDB deployment를 위한 고급 옵션을 참조하세요.
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
클러스터 전체 설정 수정.
Replica Set Configuration 션에는 다음과 같은 클러스터 전체 구성 설정이 포함되어 있습니다.
설정 | 설명 |
---|---|
Auth Schema Version | 배포를 위한 사용자 데이터를 저장하기 위해 사용자를 저장하기 위한 스키마를 선택합니다. 3.0 이전 MongoDB 버전에서 업그레이드하는 경우, MongoDB 3.0+는 사용자 데이터에 대해 이전 버전과 다른 스키마를 사용합니다. 호환성 정보는 MongoDB 3.0 릴리스 노트의 보안 변경 사항 을 참조하세요. |
Feature Compatibility Version | 배포의 기능 호환성 버전 을 선택합니다. Cloud Manager는 배포에서 MongoDB 버전 3.4 이상을 실행하는 경우 이 필드를 표시합니다. |
Replica Set Settings | 복제본 세트와 연결된 각 프로세스의 테이블을 표시합니다. 각 프로세스의 MongoDB 서버 버전, 데이터 디렉토리, 로그 경로를 구성할 수 있습니다. |
Process Name | |
Version | |
Log File |
예를 예시
|
각 복제본 세트 노드를 구성합니다.
Cloud Manager 는 Member Configuration 섹션의 MongoD Settings 제목 아래에 각 복제본 세트 멤버를 나열합니다. 각 복제본 세트 멤버에는 다음과 같은 구성 가능한 옵션이 있습니다.
설정 | 설명 |
---|---|
Member | 메뉴에서 다음 복제본 세트 노드 역할 중 하나를 선택합니다.
|
Hostname | 메뉴에서 Cloud Manager 자동화가 복제본 세트 노드를 배포할 호스트를 선택합니다. 메뉴에는 Cloud Manager 자동화 아래에 있는 호스트만 나열됩니다. Cloud Manager 자동화에 서버를 추가하는 방법에 대한 전체 문서는 자동화를 위한 서버 프로비저닝을 참조하세요. 이 호스트 이름은 호스트 이름, FQDN, IPv4 주소 또는 IPv6 주소가 될 수 있습니다. |
Port | |
Votes | |
Priority | |
Delay | 프라이머리 노드보다 '뒤처지는' 시간을 초 단위로 지정합니다. 이 노드는 '지연'이어야 합니다. 이 설정은 |
Build Indexes |
|
Tags | |
Add a Mongod |
복제 설정을 구성합니다.
Replication Settings 섹션에는 복제본 세트에 대한 다음 설정 옵션이 포함되어 있습니다.
설정 | 설명 |
---|---|
Protocol Version | 복제본 세트에서 사용하는 복제 프로토콜 버전을 선택합니다. 이 설정은 자세한 내용은 복제본 세트 프로토콜 버전을 참조하세요. |
Chaining Allowed | 세컨더리 노드가 다른 세컨더리 노드로부터 복제할 수 있도록 하려면 |
Write Concern Majority Journal Default | 쓰기 고려가 저널 옵션 |
Heartbeat Timeout (secs) | 복제본 세트 노드가 서로에게 성공적인 하트비트를 기다리는 시간(초)을 지정합니다. 이 설정은 |
Election Timeout (ms) | 복제본 세트의 프라이머리 설정에 연결할 수 없는 경우를 감지하기 위한 시간 제한을 밀리초 단위로 지정합니다. 이 설정은 |
CatchUp Timeout (ms) | 새로 선출된 프라이머리 가 더 최근 쓰기가 있을 수 있는 다른 복제본 세트 노드와 동기화하거나 따라잡는 데 걸리는 시간 제한을 밀리초 단위로 지정합니다. 이 설정은 |
CatchUp Takeover Delay (ms) | 노드가 현재 프라이머리보다 앞서 있다고 판단한 후 캐치업 인계를 시작하기 위해 노드가 기다리는 시간(밀리초)을 지정합니다. 이 설정은 |
Last Error Defaults | 복제본 세트에 대한 기본 쓰기 고려를 지정합니다. 복제본 세트는 쓰기 작업이나 getLastError가 다른 쓰기 고려를 지정하지 않는 경우에만 이 쓰기 고려를 사용합니다. 이 옵션을 설정하지 않으면 복제본 세트에 대한 기본 쓰기 고려는 프라이머리의 확인만 필요합니다. 이 옵션을 문서 형식(예: |
Force Reconfigure | 복제본 세트의 재구성을 강제로 수행하도록 지정합니다. 경고: 복제본 세트 를 강제로 재구성하면 과반수가 커밋된 쓰기가 롤백 될 수 있습니다. 진행 시 유의하세요. 이 작업의 잠재적 영향에 대한 질문이 있는 경우 MongoDB 지원에 문의하세요. 학습 내용은 MongoDB Server 매뉴얼의 사용할 수 없는 멤버가 있는 복제본 세트 재구성 을 참조하세요. |
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
클러스터 전체 설정을 구성합니다.
Cluster Configuration 션에는 다음과 같은 클러스터 전체 구성 설정이 포함되어 있습니다.
설정 | 설명 |
---|---|
Shard Name Prefix | 클러스터에 있는 각 샤드 의 접두사를 지정합니다. Cloud Manager는 |
Auth Schema Version | 배포를 위한 사용자 데이터를 저장하기 위해 사용자를 저장하기 위한 스키마를 선택합니다. 3.0 이전 MongoDB 버전에서 업그레이드하는 경우, MongoDB 3.0+는 사용자 데이터에 대해 이전 버전과 다른 스키마를 사용합니다. 호환성 정보는 MongoDB 3.0 릴리스 노트의 보안 변경 사항 을 참조하세요. |
Feature Compatibility Version | 배포의 기능 호환성 버전 을 선택합니다. Cloud Manager는 배포에서 MongoDB 버전 3.4 이상을 실행하는 경우 이 필드를 표시합니다. |
Process Name | 샤드 클러스터에 연결된 Cloud Manager는 MongoDB 3.0 이하 버전을 실행하는 클러스터의 경우 Cloud Manager는 config 서버 |
Version | |
Log File | 로그 파일 이름과 확장자를 포함하여 예를 예시
|
클러스터의 각 샤드를 구성합니다.
Member Configuration 섹션에서 Shard Settings 을 클릭하여 샤드 구성 옵션을 엽니다. Cloud Manager 는 클러스터 의 각 샤드 와 해당 샤드 와 연결된 mongod
프로세스를 나열합니다. 각 샤드 프로세스 에는 다음과 같은 옵션이 있습니다. 회색으로 표시된 옵션은 수정할 수 없습니다.
설정 | 설명 |
---|---|
Member | 메뉴에서 다음 복제본 세트 노드 역할 중 하나를 선택합니다.
|
Hostname | 메뉴에서 Cloud Manager 자동화가 복제본 세트 노드를 배포할 호스트를 선택합니다. 메뉴에는 Cloud Manager 자동화 아래에 있는 호스트만 나열됩니다. Cloud Manager 자동화에 서버를 추가하는 방법에 대한 전체 문서는 자동화를 위한 서버 프로비저닝을 참조하세요. 이 호스트 이름은 호스트 이름, FQDN, IPv4 주소 또는 IPv6 주소가 될 수 있습니다. |
Port | |
Votes | |
Priority | |
Delay | 프라이머리 노드보다 '뒤처지는' 시간을 초 단위로 지정합니다. 이 노드는 '지연'이어야 합니다. 이 설정은 |
Build Indexes |
|
Tags | |
Add a Mongod |
클러스터에 샤드를 추가하려면 다음을 수행합니다.
Add a Shard를 클릭합니다.
Cluster Configuration 섹션에서 샤드의 각
mongod
에 다음 매개 변수를 설정합니다.Version
Data Directory
Log File
클러스터에서 각 를 구성합니다.mongos
Member Configuration 섹션에서 Mongos Settings 을 클릭하여 mongos
구성 옵션을 엽니다. 각 mongos
프로세스 에는 다음과 같은 옵션이 있습니다. 회색으로 표시된 옵션은 수정할 수 없습니다.
설정 | 설명 |
---|---|
Hostname | 메뉴에서 Cloud Manager 자동화가 이 호스트 이름은 호스트 이름, FQDN, IPv4 주소 또는 IPv6 주소가 될 수 있습니다. |
Port | |
Add a Mongos | 추가 |