문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

rs.initiate()

이 페이지의 내용

  • 설명
  • IP 바인딩
  • 복제본 세트 구성
  • 예제

설명

rs.initiate(configuration)

복제본 세트를 설정합니다. 선택적으로 메서드는 복제본 세트의 구성을 담고 있는 문서 형식의 인수를 사용할 수 있습니다.

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드를 설명합니다. 이는 데이터베이스 명령이나 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다 .

데이터베이스 명령에 대해서는 replSetInitiate 명령을 참조하십시오.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

레거시 mongo 셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.

Mongo 셸 V4.4

rs.initiate() 메서드에는 다음과 같은 매개 변수가 있습니다.

매개변수
유형
설명
configuration
문서
선택 사항입니다. 새 복제본 세트에 대한 구성을 지정하는 문서입니다. 구성을 지정하지 않으면 MongoDB는 기본 복제본 세트 구성을 사용합니다.

IP 바인딩

경고

공개적으로 액세스할 수 있는 IP 주소에 인스턴스를 바인딩하기 전에 무단 액세스로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 보안 검사 목록을 참조하세요. 최소한으로 인증을 활성화하고 네트워크 인프라를 강화하는 것을 고려하세요.

2} 및mongod 몽고DB mongos 바이너리는 기본적으로 로컬 호스트에 바인딩됩니다. 바이너리에 대해 net.ipv6 구성 파일 설정 또는 --ipv6 명령줄 옵션이 설정되어 있으면 바이너리가 로컬 호스트 IPv6 주소에 추가적으로 바인딩됩니다.

기본적으로 로컬 호스트에 바인딩된 mongod 및 mongos 는 동일한 컴퓨터에서 실행 중인 클라이언트의 연결만 허용합니다. 이 바인딩 동작에는 mongosh 및 복제본 세트 또는 샤드 클러스터의 다른 멤버가 포함됩니다. 원격 클라이언트는 로컬 호스트에만 바인딩된 바이너리에는 연결할 수 없습니다.

기본 바인딩을 재정의하고 다른 IP 주소에 바인딩하려면 net.bindIp 구성 파일 설정 또는 --bind_ip 명령줄 옵션을 사용하여 호스트 이름 또는 IP 주소 목록을 지정합니다.

경고

MongDB 부터 5 시작됩니다.0, 분할 수평 DNS IP 주소로만 구성된 노드는 시작 유효성 검사에 실패하고 오류를 보고합니다. 를 참조하세요.disableSplitHorizonIPCheck

예를 들어 다음 mongod 인스턴스는 로컬 호스트와 IP 주소 198.51.100.1 와 연결된 호스트명 My-Example-Associated-Hostname에 모두 바인딩됩니다.

mongod --bind_ip localhost,My-Example-Associated-Hostname

이 인스턴스에 연결하려면 원격 클라이언트가 호스트 이름 또는 관련 IP 주소 198.51.100.1를 지정해야 합니다.

mongosh --host My-Example-Associated-Hostname
mongosh --host 198.51.100.1

복제본 세트 구성

복제본 세트 구성 문서에 대한 자세한 내용은 복제본 세트 구성 문서 예제를 참조하세요.

중요

변경된 IP 주소로 인해 구성이 업데이트되는 것을 방지하려면 IP 주소 대신 DNS 호스트 이름을 사용하세요. 특히 복제본 세트 구성원 또는 샤드 클러스터 구성원을 구성할 때 IP 주소 대신 DNS 호스트 이름을 사용하는 것이 중요합니다.

IP 주소 대신 호스트 이름을 사용하여 분할된 네트워크 범위에 걸쳐 클러스터를 구성합니다. MongoDB 5 부터 시작.0, IP 주소로만 구성된 노드는 시작 유효성 검사에 실패하여 시작되지 않습니다.

예제

다음 예제에서는 멤버가 3개인 새 복제본 집합을 시작합니다.

mongod 인스턴스 3개는 --replSet 명령줄 옵션(또는 구성 파일을 사용하는 경우 replication.replSetName)이 myReplSet로 설정된 상태에서 시작되어야 하며 --bind_ip(또는 구성 파일을 사용하는 경우 net.bindIp)를 적절하게 설정하여 복제본 세트의 다른 멤버와 클라이언트가 연결할 수 있도록 해야 합니다.

경고

공개적으로 액세스할 수 있는 IP 주소에 인스턴스를 바인딩하기 전에 무단 액세스로부터 클러스터를 보호해야 합니다. 보안 권장 사항의 전체 목록은 보안 검사 목록을 참조하세요. 최소한으로 인증을 활성화하고 네트워크 인프라를 강화하는 것을 고려하세요.

mongosh 를 mongod 인스턴스 중 하나에 연결하고 rs.initiate() 를 실행합니다.

참고

복제본 세트의 단 하나 mongod rs.initiate() 의 인스턴스에서만 를 실행합니다.

중요

변경된 IP 주소로 인해 구성이 업데이트되는 것을 방지하려면 IP 주소 대신 DNS 호스트 이름을 사용하세요. 특히 복제본 세트 구성원 또는 샤드 클러스터 구성원을 구성할 때 IP 주소 대신 DNS 호스트 이름을 사용하는 것이 중요합니다.

IP 주소 대신 호스트 이름을 사용하여 분할된 네트워크 범위에 걸쳐 클러스터를 구성합니다. MongoDB 5 부터 시작.0, IP 주소로만 구성된 노드는 시작 유효성 검사에 실패하여 시작되지 않습니다.

rs.initiate(
   {
      _id: "myReplSet",
      version: 1,
      members: [
         { _id: 0, host : "mongodb0.example.net:27017" },
         { _id: 1, host : "mongodb1.example.net:27017" },
         { _id: 2, host : "mongodb2.example.net:27017" }
      ]
   }
)

복제본 세트 구성에 대한 자세한 내용은 복제본 세트 구성 필드를 참조하세요.

복제본 세트 배포에 관한 자세한 내용은 복제본 세트 배포를 참조하세요.

팁

다음도 참조하세요.

멤버 구성 튜토리얼

← rs.help()
rs.printReplicationInfo() →

이 페이지의 내용