MeiliSearch 설치 및 실행 방법

설치 및 실행 

도커 이미지를 사용해서 설치할 것이고, 컨테이너를 실행할 때 보안을 위해서 MASTER_KEY를 옵션으로 줘야한다.

MASTER KEY는 최소 16바이트 길이의 UTF-8 문자로 구성되어야하며, 아래 툴들을 사용해서 생성할 수 있다.

• uuidgen
• openssl rand
• shasum
• randomkeygen

docker pull getmeili/meilisearch
docker run -d --name meilisearch -p 7700:7700 -e MEILI_MASTER_KEY=MASTER_KEY getmeili/meilisearch

 

KEY 확인

서버가 실행되고 나면 서버에 생성된 키를 확인하기 위해 아래와 같은 요청으로 API 키를 확인한다.

이때 처음 우리가 직접 생성했던 MASTER_KEY는 키 확인 용으로만 사용해야하고, 일반 API 요청에 사용해서는 안된다. 

curl -X GET 'http://localhost:7700/keys' \
-H 'Authorization: Bearer MASTER_KEY'

{
  "results": [
    {
      "name": "Default Search API Key",
      "description": "Use it to search from the frontend",
      "key": "0beec7b5ea3f0fdbc95d0dd47f3c5bc275da8a33",
      "uid": "123-345-456-987-abc",
      "actions": [
        "search"
      ],
      "indexes": [
        "*"
      ],
      "expiresAt": null,
      "createdAt": "2024-01-25T16:19:53.949636Z",
      "updatedAt": "2024-01-25T16:19:53.949636Z"
    },
    {
      "name": "Default Admin API Key",
      "description": "Use it for anything that is not a search operation. Caution! Do not expose it on a public frontend",
      "key": "62cdb7020ff920e5aa642c3d4066950dd1f01f4d",
      "uid": "123-345-456-987-abc",
      "actions": [
        "*"
      ],
      "indexes": [
        "*"
      ],
      "expiresAt": null,
      "createdAt": "2024-01-25T16:19:53.94816Z",
      "updatedAt": "2024-01-25T16:19:53.94816Z"
    }
  ],
  …
}

 

응답을 확인해보면 admin key와 search key 2개의 키가 기본으로 생성된다.

admin key는 인덱스 생성과 같은 중요한 작업을 수행할 때 사용하며, search key는 검색할 때 사용한다.

curl \
  -X POST 'http://localhost:7700/indexes' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer DEFAULT_ADMIN_API_KEY' \
  --data-binary '{
    "uid": "medical_records",
    "primaryKey": "id"
  }'

curl \
  -X POST 'http://localhost:7700/indexes/medical_records/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer DEFAULT_SEARCH_API_KEY' \
  --data-binary '{ "q": "appointments" }'

 

 

추가적인 설정이 필요하다면 링크에서 확인할 수 있다. 

 

 

 

Reference

https://www.meilisearch.com/docs/learn/self_hosted/getting_started_with_self_hosted_meilisearch

Getting started with self-hosted Meilisearch — Meilisearch documentation

 

https://www.meilisearch.com/docs/learn/security/basic_security

Securing your project — Meilisearch documentation