샤드 클러스터를 키 파일 인증으로 업데이트(다운타임 없음)

관리자 사용자를 생성합니다.

db.createUser() 메서드를 사용하여 관리자 사용자를 만들고 다음 역할을 할당합니다.

• clusterAdmin 데이터베이스의 admin {

• { admin 데이터베이스의 userAdmin 역할

샤드 cluster에서 유지 관리 작업 또는 사용자 관리 작업을 수행하는 클라이언트는 이 튜토리얼 완료 시 이 사용자로 인증해야 합니다. 인증을 시행한 후 cluster에 액세스할 수 있도록 하려면 지금 이 사용자를 생성하십시오.

admin = db.getSiblingDB("admin");
admin.createUser(
  {
    user: "admin",
    pwd: "<password>",
    roles: [
      { role: "clusterAdmin", db: "admin" },
      { role: "userAdmin", db: "admin" }
    ]
  }
);

선택 사항: 클라이언트 애플리케이션에 대한 추가 사용자를 생성합니다.

관리자 사용자 외에도 인증을 시행하기 전에 추가 사용자를 생성할 수 있습니다. 이렇게 하면 인증을 완전히 시행한 후에도 샤드 cluster에 대한 액세스가 보장됩니다.

db.getSiblingDB("marketing").createUser(
  {
    "user": "joe",
    "pwd": "<password>",
    "roles": [ { "role" : "readWrite", "db" : "marketing" } ]
  }
)

MongoDB에서 제공하는 역할은 데이터베이스 사용자 역할 을 참조하세요.

사용자 추가에 대한 자세한 내용은 사용자 추가 튜토리얼을 참조하세요. 새 사용자를 추가할 때는 보안 권장 사항을 고려하세요.

선택 사항: 클라이언트 애플리케이션을 업데이트하여 인증 자격 증명을 지정합니다.

현재 샤드 cluster는 인증을 시행하지 않지만, 샤드 cluster에 연결할 때 인증 자격 증명을 지정하도록 클라이언트 애플리케이션을 업데이트할 수 있습니다. 이렇게 하면 이 튜토리얼을 완료할 때 연결 끊김을 방지할 수 있습니다.

mongosh  --username "joe" --password "<password>" \
  --authenticationDatabase "marketing" --host mongos1.example.net:27017

새 mongos 구성 파일을 만듭니다.

각 mongos 대해 다음을 수행합니다.

1. 기존 mongos 구성 파일을 복사하여 <filename>-secure.conf (또는 Windows를 사용하는 경우 .cfg )와 같은 고유 이름을 지정합니다. 이 새 구성 파일을 사용하여 shard cluster에서 인증을 적용하기 위해 mongos 을(를) 전환합니다. 백업을 위해 원본 구성 파일을 유지합니다.

2. 새 구성 파일에 다음 설정을 추가합니다.

   • security.transitionToAuth 다음으로 설정 true

   • security.keyFile 키 파일 경로로 설정합니다.

     다른 내부 인증 메커니즘을 사용하는 경우 메커니즘에 적합한 설정을 지정합니다.

   security:
      transitionToAuth: true
      keyFile: <path-to-keyfile>

   새 구성 파일에는 이전에 mongos 에서 사용한 모든 구성 설정과 새 보안 설정이 포함되어 있어야 합니다.

새 구성 파일로 mongos 를 한 번에 하나씩 다시 시작합니다.

한 번에 하나씩 mongos mongos 인스턴스를 다시 시작하려면 다음 절차를 따르세요.

1. 종료하려면 mongos 에 연결합니다.

2. admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 mongos 을 안전하게 종료합니다.

   db.getSiblingDB("admin").shutdownServer()

3. 새 구성 파일로 mongos 를 다시 시작하고 --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 새 구성 파일의 이름이 mongos-secure.conf 인 경우입니다.

   mongos --config <path>/mongos-secure.conf

   여기서 <path> 은 새 구성 파일이 포함된 폴더의 시스템 경로를 나타냅니다.

샤드 cluster의 mongos 모든 mongos 인스턴스가 다시 시작될 때까지 다음 인스턴스에 대해 다시 시작 프로세스를 반복합니다.

새 mongod 구성 파일을 만듭니다.

config 서버 복제본 세트의 각 mongod 에 대해

1. 기존 mongod 구성 파일을 복사하여 <filename>-secure.conf (또는 Windows를 사용하는 경우 .cfg )와 같은 고유 이름을 지정합니다. 이 새 구성 파일을 사용하여 shard cluster에서 인증을 적용하기 위해 mongod 을(를) 전환합니다. 백업을 위해 원본 구성 파일을 유지합니다.

2. 새 구성 파일에 다음 설정을 추가합니다.

   • security.transitionToAuth 다음으로 설정 true

   • security.keyFile 키 파일 경로로 설정합니다.

     다른 내부 인증 메커니즘을 사용하는 경우 메커니즘에 적합한 설정을 지정합니다.

   security:
      transitionToAuth: true
      keyFile: <path-to-keyfile>

새 구성 파일로 mongod 를 한 번에 하나씩 다시 시작합니다.

세컨더리 멤버부터 시작하여 한 번에 한 멤버씩 복제본 세트를 다시 시작합니다.

1. 세컨더리 멤버를 한 번에 하나씩 다시 시작하려면 다음을 수행합니다.

   1. mongod 에 연결하고 admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 mongod 을 안전하게 종료합니다.

      db.getSiblingDB("admin").shutdownServer()

   2. 새 구성 파일로 mongod 를 다시 시작하고 { --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 새 구성 파일의 이름이 mongod-secure.conf 인 경우입니다.

      mongod --config <path>/mongod-secure.conf

      여기서 <path> 은 새 구성 파일이 포함된 폴더의 시스템 경로를 나타냅니다.

   이 멤버가 활성화되면 다음 세컨더리 멤버에 대해 이 과정을 반복합니다.

2. 모든 세컨더리 멤버가 다시 시작되고 작동되면 프라이머리 멤버를 다시 시작합니다.

   1. mongod 에 연결합니다.

   2. rs.stepDown() 메서드를 사용하여 프라이머리를 물러나고 trigger 투표를 트리거합니다.

      rs.stepDown()

      rs.status() 메서드를 사용하여 복제본 세트가 새 프라이머리를 선택했는지 확인할 수 있습니다.

   3. 프라이머리를 물러나고 새 프라이머리가 선출되면 admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 이전 프라이머리를 종료합니다.

      db.getSiblingDB("admin").shutdownServer()

   4. 새 구성 파일로 mongod 를 다시 시작하고 { --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 새 구성 파일의 이름이 mongod-secure.conf 인 경우입니다.

      mongod --config <path>/mongod-secure.conf

      여기서 <path> 은 새 구성 파일이 포함된 폴더의 시스템 경로를 나타냅니다.

mongos 구성 파일에서 transitionToAuth 을(를) 제거합니다.

이 튜토리얼 중에 생성된 mongos 구성 파일에서 security.transitionToAuth 키와 해당 값을 제거합니다. 튜토리얼에 추가된 security.keyFile 설정을 그대로 둡니다.

security:
   keyFile: <path-to-keyfile>

업데이트된 구성 파일로 mongos 를 다시 시작합니다.

한 번에 하나씩 mongos 인스턴스를 다시 시작하려면 절차를 따르세요. mongos

1. 종료하려면 mongos 에 연결합니다.

2. admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 mongos 을 안전하게 종료합니다.

   db.getSiblingDB("admin").shutdownServer()

3. 업데이트된 구성 파일로 mongos 를 다시 시작하고 --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 업데이트된 구성 파일의 이름이 mongos-secure.conf 인 경우:

   mongos --config <path>/mongos-secure.conf

mongod 구성 파일에서 transitionToAuth 을(를) 제거합니다.

이 튜토리얼 중에 생성된 config 서버 구성 파일에서 security.transitionToAuth 키와 해당 값을 제거합니다. 튜토리얼에 추가된 security.keyFile 설정을 그대로 둡니다.

security:
   keyFile: <path-to-keyfile>

업데이트된 구성 파일로 mongod 를 한 번에 하나씩 다시 시작합니다.

세컨더리 멤버부터 시작하여 한 번에 한 멤버씩 복제본 세트를 다시 시작합니다.

1. 세컨더리 멤버를 한 번에 하나씩 다시 시작하려면 다음을 수행합니다.

   1. mongod 에 연결하고 admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 mongod 을 안전하게 종료합니다.

      db.getSiblingDB("admin").shutdownServer()

   2. 업데이트된 구성 파일로 mongod 를 다시 시작하고 { --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 새 구성 파일의 이름이 mongod-secure.conf 인 경우입니다.

      mongod --config <path>/mongod-secure.conf

      여기서 <path> 은 업데이트된 구성 파일이 포함된 폴더의 시스템 경로를 나타냅니다.

   이 멤버가 활성화되면 다음 세컨더리 멤버에 대해 이 과정을 반복합니다.

2. 모든 세컨더리 멤버가 다시 시작되고 작동되면 프라이머리 멤버를 다시 시작합니다.

   1. mongod 에 연결합니다.

   2. rs.stepDown() 메서드를 사용하여 프라이머리를 물러나고 trigger 투표를 트리거합니다.

      rs.stepDown()

      rs.status() 메서드를 사용하여 복제본 세트가 새 프라이머리를 선택했는지 확인할 수 있습니다.

   3. 프라이머리를 물러나고 새 프라이머리가 선출되면 admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 이전 프라이머리를 종료합니다.

      db.getSiblingDB("admin").shutdownServer()

   4. 업데이트된 구성 파일로 mongod 를 다시 시작하고 { --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 새 구성 파일의 이름이 mongod-secure.conf 인 경우입니다.

      mongod --config <path>/mongod-secure.conf

      여기서 <path> 은 업데이트된 구성 파일이 포함된 폴더의 시스템 경로를 나타냅니다.

mongod 구성 파일에서 transitionToAuth 을(를) 제거합니다.

이 튜토리얼 중에 생성된 config 서버 구성 파일에서 security.transitionToAuth 키와 해당 값을 제거합니다. 튜토리얼에 추가된 security.keyFile 설정을 그대로 둡니다.

security:
   keyFile: <path-to-keyfile>

업데이트된 구성 파일로 mongod 를 한 번에 하나씩 다시 시작합니다.

세컨더리 멤버부터 시작하여 한 번에 한 멤버씩 복제본 세트를 다시 시작합니다.

1. 세컨더리 멤버를 한 번에 하나씩 다시 시작하려면 다음을 수행합니다.

   1. mongod 에 연결하고 admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 mongod 을 안전하게 종료합니다.

      db.getSiblingDB("admin").shutdownServer()

   2. 업데이트된 구성 파일로 mongod 를 다시 시작하고 { --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 새 구성 파일의 이름이 mongod-secure.conf 인 경우입니다.

      mongod --config <path>/mongod-secure.conf

      여기서 <path> 은 업데이트된 구성 파일이 포함된 폴더의 시스템 경로를 나타냅니다.

   이 멤버가 활성화되면 다음 세컨더리 멤버에 대해 이 과정을 반복합니다.

2. 모든 세컨더리 멤버가 다시 시작되고 작동되면 프라이머리 멤버를 다시 시작합니다.

   1. mongod 에 연결합니다.

   2. rs.stepDown() 메서드를 사용하여 프라이머리를 물러나고 trigger 투표를 트리거합니다.

      rs.stepDown()

      rs.status() 메서드를 사용하여 복제본 세트가 새 프라이머리를 선택했는지 확인할 수 있습니다.

   3. 프라이머리를 물러나고 새 프라이머리가 선출되면 admin 데이터베이스에 대해 db.shutdownServer() 메서드를 사용하여 이전 프라이머리를 종료합니다.

      db.getSiblingDB("admin").shutdownServer()

   4. 업데이트된 구성 파일로 mongod 를 다시 시작하고 { --config 를 사용하여 구성 파일의 경로를 지정합니다. 예를 들어 새 구성 파일의 이름이 mongod-secure.conf 인 경우입니다.

      mongod --config <path>/mongod-secure.conf

      여기서 <path> 은 업데이트된 구성 파일이 포함된 폴더의 시스템 경로를 나타냅니다.