Установка Elasticsearch с Docker

Вы также можете использовать защищенный образ Wolfi для дополнительной безопасности. Использование образов Wolfi требует Docker версии 20.10.10 или выше.

Для использования образа Wolfi добавьте -wolfi к тегу образа в команде Docker.

Например:

docker pull docker.elastic.co/elasticsearch/elasticsearch-wolfi:8.17.3

Для удаления контейнеров и их сети выполните:

# Remove the Elastic network
docker network rm elastic

# Remove Elasticsearch containers
docker rm es01
docker rm es02

# Remove the Kibana container
docker rm kib01

Теперь у вас настроена тестовая среда Elasticsearch. Перед началом серьезной разработки или переходом в производство с Elasticsearch, ознакомьтесь с требованиями и рекомендациями для применения при запуске Elasticsearch в Docker в производстве.

Чтобы остановить кластер, выполните команду docker-compose down. Данные в Docker-томах сохраняются и загружаются при перезапуске кластера с помощью команды docker-compose up.

docker-compose down

Чтобы удалить сеть, контейнеры и тома при остановке кластера, укажите опцию -v:

docker-compose down -v

Теперь у вас настроена тестовая среда Elasticsearch. Прежде чем начать серьезную разработку или перейти к производственной эксплуатации с Elasticsearch, ознакомьтесь с требованиями и рекомендациями, которые необходимо учитывать при работе с Elasticsearch в Docker в производственной среде.

Создайте пользовательские файлы конфигурации и привяжите их к соответствующим файлам в образе Docker. Например, для привязки custom_elasticsearch.yml к docker run укажите:

-v full_path_to/custom_elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml

Если вы привязываете пользовательский файл elasticsearch.yml, убедитесь, что он содержит параметр network.host: 0.0.0.0. Этот параметр гарантирует, что узел доступен для HTTP- и транспортного трафика, при условии, что его порты открыты. Встроенный файл elasticsearch.yml образа содержит этот параметр по умолчанию.

По умолчанию Elasticsearch автоматически создаст файл хранилища ключей для безопасных настроек. Этот файл замаскирован, но не зашифрован.

Чтобы зашифровать ваши безопасные настройки паролем и сохранить их вне контейнера, используйте команду docker run для создания хранилища ключей вручную. Команда должна:

Например:

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:8.17.3 \
bin/elasticsearch-keystore create -p

Вы также можете использовать команду docker run для добавления или обновления безопасных настроек в хранилище ключей. Вам будет предложено ввести значения параметров. Если хранилище ключей зашифровано, вам также будет предложено ввести пароль хранилища ключей.

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:8.17.3 \
bin/elasticsearch-keystore \
add my.secure.setting \
my.other.secure.setting

Если хранилище ключей уже создано и не нужно его обновлять, вы можете напрямую привязать файл elasticsearch.keystore. Переменную среды KEYSTORE_PASSWORD можно использовать для предоставления пароля хранилища ключей контейнеру при запуске. Например, команда docker run может иметь следующие опции:

-v full_path_to/config/elasticsearch.keystore:/usr/share/elasticsearch/config/elasticsearch.keystore
-e KEYSTORE_PASSWORD=mypassword

В некоторых средах может быть целесообразнее подготовить пользовательский образ, содержащий вашу конфигурацию. Способ достижения этого может быть таким же простым, как:

FROM docker.elastic.co/elasticsearch/elasticsearch:8.17.3
COPY --chown=elasticsearch:elasticsearch elasticsearch.yml /usr/share/elasticsearch/config/

Затем вы можете создать и запустить образ с помощью:

docker build --tag=elasticsearch-custom .
docker run -ti -v /usr/share/elasticsearch/data elasticsearch-custom

Некоторые плагины требуют дополнительных разрешений на безопасность. Вы должны явно принять их, либо:

Дополнительную информацию см. в Управление плагинами.

Вот как решить распространенные ошибки при запуске Elasticsearch с Docker.

Exception in thread "main" org.elasticsearch.bootstrap.BootstrapException: java.io.IOException: Is a directory: SimpleFSIndexInput(path="/usr/share/elasticsearch/config/elasticsearch.keystore") Likely root cause: java.io.IOException: Is a directory

Команда, связанная с хранилищем ключей docker run, пыталась напрямую привязать несуществующий файл elasticsearch.keystore. Если вы используете флаги -v или --volume для монтирования несуществующего файла, Docker вместо этого создаёт каталог с тем же именем.

Чтобы исправить эту ошибку:

Exception in thread "main" java.nio.file.FileSystemException: /usr/share/elasticsearch/config/elasticsearch.keystore.tmp -> /usr/share/elasticsearch/config/elasticsearch.keystore: Device or resource busy

Команда, связанная с хранилищем ключей docker run, пыталась обновить хранилище ключей при непосредственной привязке файла elasticsearch.keystore. Для обновления хранилища ключей контейнеру необходим доступ к другим файлам в каталоге config, например, к файлу keystore.tmp.

Чтобы исправить эту ошибку: