Install or Uninstall mongot in a Docker Container

Pull the mongot Docker image.

mongot Docker 이미지를 가져오려면 다음 명령을 실행 .

docker pull mongodb/mongodb-community-search:latest

이미지가 Docker Desktop에 있는지 확인하려면 다음 명령을 실행 .

docker image ls mongodb/mongodb-community-search

Docker 네트워크를 만듭니다.

데이터베이스 와 검색 컨테이너 간의 컨테이너 간 통신을 위한 Docker 네트워크를 만들려면 다음 명령을 실행 .

docker network create search-community

MongoDB Docker 이미지를 다운로드합니다.

MongoDB Docker 이미지를 다운로드 하려면 다음 명령을 실행 .

docker pull mongodb/mongodb-community-server:latest

Docker 사용하여 MongoDB 설치하는 방법에 대한 자세한 내용은 Docker 로 MongoDB Community 설치를 참조하세요.

Create a mongot sync-user password file.

mongod에 연결할 mongot의 비밀번호 파일을 만듭니다. 운영 체제를 선택하고 명령을 실행합니다.

echo -n "<mongot_password>" > passwordFile
chmod 400 passwordFile

docker volume create mongot-secrets
docker run --rm -v mongot-secrets:/secrets busybox sh -c "echo -n '<mongot_password>' > /secrets/passwordFile && chmod 400 /secrets/passwordFile"

mongod 구성 파일 만듭니다.

구성 파일 만들려면 다음 코드를 mongod.conf 또는 원하는 위치 에 저장합니다.

# MongoDB Configuration File
# Network configuration
   net:
      port: 27017
      bindIpAll: true  # Equivalent to --bind_ip_all
   # Replica set configuration
   replication:
      replSetName: rs0
   # Search configuration parameters
   setParameter:
      # Server parameters to advise mongod of mongot availability for search index management and querying
      searchIndexManagementHostAndPort: mongot-community.search-community:27028
      mongotHost: mongot-community.search-community:27028
      skipAuthenticationToSearchIndexManagementServer: false
      useGrpcForSearch: true
      searchTLSMode: disabled

Start your mongod.

mongod을(를) 시작하려면 다음을 수행합니다.

• </path/to/data/db> 를 마운트된 볼륨의 로컬 디렉토리 경로 바꾸십시오.

• </path/to/mongod.conf> 을 위에서 만든 구성 파일의 경로로 바꿉니다.

• Windows에서 각 줄 끝의 역슬래시(\)를 shell의 줄 이어지 문자로 대체합니다. 명령 프롬프트는 캐릿(^)을 사용하고 PowerShell은 역인용표를 사용합니다.

docker run --rm \
   --name mongod \
   -v </path/to/mongod.conf>:/etc/mongod.conf:ro \
   -v </path/to/data/db>:/data/db \
   -p 27017:27017 \
   --network search-community \
   mongodb/mongodb-community-server:latest \
   --config /etc/mongod.conf \
   --replSetMember=mongod.search-community:27017

In a new shell, start mongosh.

다음 명령을 실행하여 포트 27017에서 시작한 mongod 인스턴스에 연결합니다.

docker exec -it mongod mongosh --port 27017

Create a user for the mongot process on your MongoDB deployment.

mongot searchCoordinator 역할이 있는 사용자를 통해 MongoDB deployment 에 연결할 수 있어야 합니다.

다음 명령을 실행하여 admin 데이터베이스 에 연결합니다.

use admin

searchCoordinator 역할 가진 사용자를 만들려면 다음을 수행합니다.

• <mongot_username> 을 mongot 사용자의 사용자 이름으로 바꾸십니다.

• <mongot_password> 를 4단계의 passwordFile 에 지정한 비밀번호로 바꿉니다.

• 다음 명령을 실행합니다:

db.createUser(
   {
      user: "<mongot_username>",
      pwd: "<mongot_password>",
      roles: [ "searchCoordinator" ]
   }
)

사용자 생성에 대한 자세한 내용은 자체 관리 배포서버에서 사용자 생성을 참조하세요.

검색 구성 옵션을 지정합니다.

YAML 구성 파일 사용하여 mongot 를 구성할 수 있습니다. 이전 단계에서 지정한 사용자 이름 syncSource.replicaSet.scramAuth.username(으)로 지정해야 합니다. 또한 이전 단계에서 생성한 passwordFile 를 syncSource.replicaSet.scramAuth.passwordFile로 지정해야 합니다.

mongot 구성 옵션에 대한 자세한 내용은 mongot 옵션을 참조하세요.

예시 들어 아래와 같이 로컬 구성에 맞게 설정을 조정할 수 있습니다.

# mongot.conf
syncSource:
   replicaSet:
      hostAndPort: "mongod.search-community:27017"
      scramAuth:
         username: "mongotUser"
         passwordFile: "/passwordFile"
         authSource: "admin"
         tls:
            enabled: false
   replicationReader:
      readPreference: "secondaryPreferred"
storage:
   dataPath: "/data/mongot"
server:
   grpc:
      address: "mongot-community.search-community:27028"
      tls:
         mode: "disabled"
metrics:
   enabled: true
   address: "mongot-community.search-community:9946"
healthCheck:
   address: "mongot-community.search-community:8080"
logging:
   verbosity: INFO

파일 mongot.config 또는 원하는 파일 위치 에 저장합니다.

두 컨테이너 모두 동일한 search-community Docker 네트워크에서 실행 .

mongot 프로세스 시작합니다.

Community 바이너리(mongot)에서 검색을 시작하려면 운영 체제를 선택하고 명령을 실행합니다.

docker run --rm \
   --name mongot-community \
   -v </path/to/data/mongot>:/data/mongot \
   -v </path/to/mongot.conf>:/mongot-community/config.default.yml \
   -v </path/to/passwordFile>:/passwordFile:ro \
   --network search-community \
   -p 8080:8080 \
   -p 9946:9946 \
   mongodb/mongodb-community-search:latest

docker run --rm ^
   --name mongot-community ^
   -v </path/to/data/mongot>:/data/mongot ^
   -v </path/to/mongot.conf>:/mongot-community/config.default.yml ^
   -v mongot-secrets:/secrets:ro ^
   --network search-community ^
   -p 8080:8080 ^
   -p 9946:9946 ^
   mongodb/mongodb-community-search:latest

이 명령은 다음을 수행합니다.

• 볼륨을 마운트합니다.

• 로컬 볼륨에서 구성 파일 마운트합니다.

• 포트 범위 지정합니다.

• 지표 포트를 노출합니다.

• 이름이 mongot-community인 컨테이너 사용하여 search-community Docker 네트워크에서 컨테이너 시작합니다.

Verify the health of the mongot process.

To verify, send a request by using a HTTP client or curl to the /health endpoint. For example, send a curl request similar to the following sample request:

curl localhost:8080/health

엔드포인트는 응답에서 다음 중 하나를 반환합니다.

• SERVINGmongot 프로세스가 실행 중인 경우

  mongot 인덱스의 상태를 확인하지 않으므로 쿼리를 제공하지 않을 수 있으며, 쿼리를 제공하려면 인덱스는 Ready 상태여야 합니다.

• NOT_SERVINGmongot 프로세스가 실행 중이 아닌 경우

자세한 내용은 mongot 연결 확인을 참조하세요.