Запуск Milvus в Docker (Linux)
На этой странице описано, как запустить экземпляр Milvus в Docker.
Необходимые условия
Установка Milvus в Docker
Milvus предоставляет скрипт для установки в виде контейнера Docker. Скрипт доступен в репозитории Milvus. Перед началом нового развертывания загрузите и ознакомьтесь со скриптом:
# Download the installation script
$ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh
# Inspect the Docker image selected by the script
$ grep -n "milvusdb/milvus:" standalone_embed.sh
# Start the Docker container
$ bash standalone_embed.sh start
Скрипт загружается из ветки Milvus « master ». Тег образа Docker указан в скрипте и может отличаться от v3.0.5. Чтобы установить именно этот выпуск, воспользуйтесь конфигурацией с указанием версии, описанной в разделе «Запуск Milvus с помощью Docker Compose».
При этом развертывании с помощью Docker Woodpecker работает с локальной файловой системой в качестве бэкэнда WAL, поэтому внешний сервис очереди сообщений не требуется. См. раздел «Woodpecker».
Если вы хотите использовать Backup в автономном режиме развертывания, рекомендуется использовать метод развертывания с помощью Docker Compose.
Если у вас возникнут проблемы с загрузкой образа, свяжитесь с нами по адресу community@zilliz.com, указав подробности проблемы, и мы предоставим вам необходимую поддержку.
После запуска скрипта установки:
- Контейнер Docker с именем milvus-standalone запущен на порту 19530.
- Вместе с Milvus в том же контейнере установлен встроенный etcd, работающий на порту 2379. Его файл конфигурации сопоставлен файлу embedEtcd.yaml в текущей папке.
- Чтобы изменить конфигурацию Milvus по умолчанию, добавьте свои настройки в файл user.yaml в текущей папке, а затем перезапустите службу.
- Том данных Milvus сопоставлен папке volumes/milvus в текущей папке.
Проверьте актуальный образ и состояние работоспособности:
docker inspect --format '{{.Config.Image}}' milvus-standalone
docker inspect --format '{{.State.Health.Status}}' milvus-standalone
Дождитесь появления сообщения « healthy », прежде чем приступать к выполнению инструкций из раздела «Быстрый старт». При использовании этого сервера подключите SDK к http://localhost:19530; локальный URI .db запускает Milvus Lite.
Вы можете перейти в веб-интерфейс Milvus по адресу http://127.0.0.1:9091/webui/, чтобы узнать больше о вашем экземпляре Milvus. Подробности см. в разделе «Веб-интерфейс Milvus».
(Необязательно) Обновление настроек Milvus
Вы можете изменить настройки Milvus в файле user.yaml, расположенном в текущей папке. Например, чтобы изменить адрес proxy.healthCheckTimeout на 1000 ms, можно отредактировать файл следующим образом:
cat << EOF > user.yaml
# Extra config to override default milvus.yaml
proxy:
healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
EOF
Затем перезапустите службу следующим образом:
$ bash standalone_embed.sh restart
Информацию о соответствующих элементах конфигурации см. в разделе «Конфигурация системы».
Обновление Milvus
Команда upgrade скрипта загружает скрипт с сайта master и заново создает контейнер, используя образ, выбранный этим скриптом. Она не проверяет, поддерживается ли путь от исходной версии к целевой, и может заново создать сгенерированные файлы конфигурации. Не следует рассматривать это как гарантию того, что любое старое развертывание можно безопасно обновить до версии v3.0.5.
Перед обновлением создайте резервные копии метаданных, постоянных данных, файла embedEtcd.yaml и файла user.yaml. Проверьте совместимость целевой версии, очереди сообщений и хранилища, а также проверьте восстановление в тестовой среде. Для развертываний, управляемых с помощью Docker Compose, следуйте инструкциям в разделе «Обновление автономной версии Milvus с помощью Docker Compose»; не применяйте эту процедуру напрямую к контейнеру, управляемому скриптом.
Остановка и удаление Milvus
Вы можете остановить и удалить этот контейнер следующим образом
# Stop Milvus
$ bash standalone_embed.sh stop
# Delete Milvus data
$ bash standalone_embed.sh delete
Дополнительные зависимости
По умолчанию в этом развертывании в качестве очереди сообщений используется Woodpecker (WAL в локальной файловой системе), а для метаданных — встроенный etcd — ничего больше устанавливать не требуется. Чтобы использовать другую очередь сообщений или подключить внешнее объектное хранилище / метаданные, см.:
- Очередь сообщений: Woodpecker (по умолчанию) · Pulsar · Kafka · RocksMQ
- Объектное хранилище: MinIO (по умолчанию) · AWS S3 · Azure Blob · GCP Cloud Storage · Aliyun OSS · Tencent COS · Huawei OBS · S3-совместимое
- Метаданные: etcd
Storage V3 по умолчанию отключен. Включите его перед использованием функций, которые от него зависят. Требования и соображения по совместимости см. в разделе Storage V3.
Что дальше
Установив Milvus в Docker, вы можете:
Ознакомьтесь с разделом «Быстрый старт», чтобы узнать, на что способен Milvus.
Ознакомиться с основными операциями Milvus:
Перед сменой версии Milvus ознакомьтесь с рекомендациями по обновлению на этой странице.
Разверните кластер Milvus в облаке:
Ознакомьтесь с Milvus WebUI — интуитивно понятным веб-интерфейсом для мониторинга и управления Milvus.
Ознакомьтесь с Milvus Backup — инструментом с открытым исходным кодом для резервного копирования данных Milvus.
Ознакомьтесь с Birdwatcher — инструментом с открытым исходным кодом для отладки Milvus и динамического обновления конфигурации.
Познакомьтесь с Attu — инструментом с графическим интерфейсом с открытым исходным кодом для интуитивного управления Milvus.
