Установка Elasticsearch с .zip на Windows

Загрузите архив .zip для Elasticsearch 8.17.3 с сайта: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.17.3-windows-x86_64.zip

Разархивируйте его с помощью вашего любимого архиватора. Это создаст папку elasticsearch-8.17.3, которую мы будем называть %ES_HOME%. В окне терминала перейдите в каталог %ES_HOME%, например:

cd C:\Program Files\elasticsearch-8.17.3

Запустите следующую команду, чтобы запустить Elasticsearch из командной строки:

.\bin\elasticsearch.bat

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

Пароль для пользователя elastic и токен регистрации для Kibana выводятся в терминал.

Рекомендуется сохранить пароль для пользователя elastic в качестве переменной окружения в вашей оболочке. Пример:

$ELASTIC_PASSWORD = "your_password"

Если вы защитили хранилище ключей Elasticsearch паролем, вам будет предложено ввести пароль хранилища ключей. Подробности см. в разделе Настройки безопасности.

По умолчанию Elasticsearch выводит свои журналы в консоль (STDOUT) и в файл <cluster name>.log в каталоге журналов Logs. Elasticsearch регистрирует некоторую информацию во время запуска, но после завершения инициализации он продолжает работать в фоновом режиме и не будет регистрировать ничего дальше, пока не произойдёт событие, достойное записи. Во время работы Elasticsearch вы можете взаимодействовать с ним через HTTP-интерфейс, который по умолчанию находится на порту 9200.

Чтобы остановить Elasticsearch, нажмите Ctrl-C.

При первом запуске Elasticsearch процесс автоматической настройки безопасности привязывает HTTP-слой к 0.0.0.0, но привязывает транспортный слой только к localhost. Это задуманное поведение обеспечивает возможность запуска кластера из одного узла с включенной по умолчанию безопасностью без дополнительной конфигурации.

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

Кроме того, без дополнительной конфигурации узлы могут присоединяться к кластеру только на одном хосте. Если вы хотите, чтобы узлы с другого хоста присоединились к вашему кластеру, необходимо установить transport.host на поддерживаемое значение (например, раскомментировать предложенное значение 0.0.0.0) или IP-адрес, привязанный к интерфейсу, к которому могут получить доступ другие хосты. Для получения дополнительной информации см. настройки транспортного слоя.

Чтобы зарегистрировать новые узлы в вашем кластере, создайте токен регистрации с помощью инструмента elasticsearch-create-enrollment-token на любом существующем узле в вашем кластере. Затем вы можете запустить новый узел с параметром --enrollment-token, чтобы он присоединился к существующему кластеру.

Elasticsearch по умолчанию загружает свою конфигурацию из файла %ES_HOME%\config\elasticsearch.yml. Формат этого файла конфигурации описан в разделе Настройка Elasticsearch.

Любые параметры, которые можно указать в файле конфигурации, также можно указать в командной строке, используя синтаксис -E следующим образом:

.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1

Вы можете проверить, что ваш узел Elasticsearch работает, отправив HTTPS-запрос на порт 9200 на localhost:

curl --cacert %ES_HOME%\config\certs\http_ca.crt -u elastic:$ELASTIC_PASSWORD https://localhost:9200 

Вызов возвращает ответ такого вида:

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "8.17.3",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_flavor" : "default",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "9.12.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

Вы можете установить Elasticsearch в качестве службы, которая работает в фоновом режиме или запускается автоматически при загрузке без взаимодействия с пользователем.

C:\Program Files\elasticsearch-8.17.3\bin>elasticsearch-service.bat

Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]

При первом запуске Elasticsearch TLS автоматически настраивается для HTTP-слоя. Сертификат CA генерируется и хранится на диске по адресу:

%ES_HOME%\config\certs\http_ca.crt

Шестнадцатеричный отпечаток SHA-256 этого сертификата также выводится в терминал. Любые клиенты, подключающиеся к Elasticsearch, такие как клиенты Elasticsearch, Beats, автономные агенты Elastic и Logstash, должны убедиться, что они доверяют сертификату, используемому Elasticsearch для HTTPS. Fleet Server и управляемые Fleet-агенты Elastic автоматически настраиваются на доверие сертификату CA. Другие клиенты могут установить доверие, используя либо отпечаток сертификата CA, либо сам сертификат CA.

Если процесс автоматической настройки уже завершился, вы всё равно можете получить отпечаток безопасности сертификата. Вы также можете скопировать сертификат CA на свой компьютер и настроить клиент на его использование.

Скопируйте значение отпечатка, выведенное в терминал при запуске Elasticsearch, и настройте клиент на использование этого отпечатка для установления доверия при подключении к Elasticsearch.

Если процесс автоматической настройки уже завершился, вы всё равно можете получить отпечаток безопасности сертификата, выполнив следующую команду. Путь к автоматически сгенерированному сертификату CA для HTTP-слоя.

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt

Команда возвращает сертификат безопасности, включая отпечаток. Значение issuer должно быть Elasticsearch security auto-configuration HTTP CA.

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>

Если ваша библиотека не поддерживает метод проверки отпечатка, автоматически сгенерированный сертификат CA создается в следующем каталоге на каждом узле Elasticsearch:

%ES_HOME%\config\certs\http_ca.crt

Скопируйте файл http_ca.crt на свой компьютер и настройте клиент на использование этого сертификата для установления доверия при подключении к Elasticsearch.

Пакет .zip полностью самодостаточен. Все файлы и каталоги по умолчанию находятся в %ES_HOME% — каталоге, созданном при распаковке архива.

Это очень удобно, так как вам не нужно создавать какие-либо каталоги, чтобы начать использовать Elasticsearch, и удаление Elasticsearch так же просто, как удаление каталога %ES_HOME%. Однако рекомендуется изменить расположение каталогов конфигурации, данных и журналов по умолчанию, чтобы не удалить важные данные в дальнейшем.