Бэкэнды

Бэкенд базы данных (по умолчанию)

wagtail.search.backends.database

Бэкенд поиска базы данных ищет контент в базе данных, используя функции полнотекстового поиска используемого бэкэнда базы данных (например, PostgreSQL FTS, SQLite FTS5). Этот бэкенд предназначен для разработки и, вероятно, будет достаточно эффективен для использования в продакшене на сайтах, которые не требуют специфических возможностей Elasticsearch.

Бэкенд Elasticsearch

Поддерживаются версии Elasticsearch 5, 6 и 7. Используйте соответствующий бэкенд для вашей версии:

• wagtail.search.backends.elasticsearch5 (Elasticsearch 5.x)
• wagtail.search.backends.elasticsearch6 (Elasticsearch 6.x)
• wagtail.search.backends.elasticsearch7 (Elasticsearch 7.x)

Необходимые компоненты — сама служба Elasticsearch и, через pip, пакет elasticsearch-py. Основная версия пакета должна соответствовать установленной версии Elasticsearch:

pip install "elasticsearch>=5.0.0,<6.0.0"  # for Elasticsearch 5.x

pip install "elasticsearch>=6.4.0,<7.0.0"  # for Elasticsearch 6.x

pip install "elasticsearch>=7.0.0,<8.0.0"  # for Elasticsearch 7.x

Бэкенд настраивается в настройках:

WAGTAILSEARCH_BACKENDS = {
    'default': {
        'BACKEND': 'wagtail.search.backends.elasticsearch5',
        'URLS': ['http://localhost:9200'],
        'INDEX': 'wagtail',
        'TIMEOUT': 5,
        'OPTIONS': {},
        'INDEX_SETTINGS': {},
    }
}

За исключением BACKEND, ключи являются необязательными и по умолчанию принимают указанные значения. Любой определенный ключ в OPTIONS передается напрямую конструктору Elasticsearch в качестве чувствительного к регистру именованного аргумента (например, 'max_retries': 1).

Имя пользователя и пароль могут быть необязательно указаны в поле URL, чтобы предоставить учетные данные для проверки подлинности службы Elasticsearch:

WAGTAILSEARCH_BACKENDS = {
    'default': {
        ...
        'URLS': ['http://username:password@localhost:9200'],
        ...
    }
}

INDEX_SETTINGS — это словарь, используемый для переопределения значений по умолчанию при создании индекса. Значения по умолчанию определены в классе ElasticsearchSearchBackend в модуле wagtail/wagtail/search/backends/elasticsearch7.py. Любой новый ключ добавляется, а любой существующий ключ, если он не является словарем, заменяется новым значением. Вот пример того, как настроить количество фрагментов и установить итальянский LanguageAnalyzer в качестве анализатора по умолчанию:

WAGTAILSEARCH_BACKENDS = {
    'default': {
        ...,
        'INDEX_SETTINGS': {
            'settings': {
                'index': {
                    'number_of_shards': 1,
                },
                'analysis': {
                    'analyzer': {
                        'default': {
                            'type': 'italian'
                        }
                    }
                }
            }
        }
    }

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

• Зарегистрируйтесь на сайте Bonsai
• Используйте панель управления Bonsai для создания кластера.
• Настройте URLS в записи Elasticsearch в WAGTAILSEARCH_BACKENDS с помощью URL-адреса кластера из вашей панели управления Bonsai
• Запустите ./manage.py update_index

Amazon AWS Elasticsearch

Бэкенд Elasticsearch совместим с Amazon Elasticsearch Service, но требует дополнительной настройки для обработки аутентификации на основе IAM. Это можно сделать с помощью пакета requests-aws4auth вместе со следующей конфигурацией:

from elasticsearch import RequestsHttpConnection
from requests_aws4auth import AWS4Auth

WAGTAILSEARCH_BACKENDS = {
    'default': {
        'BACKEND': 'wagtail.search.backends.elasticsearch5',
        'INDEX': 'wagtail',
        'TIMEOUT': 5,
        'HOSTS': [{
            'host': 'YOURCLUSTER.REGION.es.amazonaws.com',
            'port': 443,
            'use_ssl': True,
            'verify_certs': True,
            'http_auth': AWS4Auth('ACCESS_KEY', 'SECRET_KEY', 'REGION', 'es'),
        }],
        'OPTIONS': {
            'connection_class': RequestsHttpConnection,
        },
    }
}