Автоматизированная установка при помощи Ansible-скриптов#

При переходе к данному разделу предполагается, что процесс подготовки к установке уже пройден.

Данный раздел рассматривает процесс автоматизированной установки СУБД Pangolin при помощи Ansible-скриптов.

Конфигурационные файлы и сценарии, приведенные в данном руководстве, являются примерами. Значение приведенных параметров и переменных зависит от конкретного случая установки.

Порядок установки#

Для осуществления автоматизированной установки Pangolin выполните последовательно шаги, описанные в подразделах ниже.

  1. Распакуйте дистрибутив новой версии СУБД Pangolin.

  2. Подготовка виртуального окружения.

  3. Выбор сценария установки: с помощью Pangolin Installer (целевой), при помощи Ansible плейбука (альтернативный).

  4. Подготовка к выбранному сценарию автоматизированной установки.

  5. Запуск сценария автоматизированной установки.

  6. Проверка результата процесса установки.

Подсказка

Все блоки подготовки и самого процесса установки являются обязательными, кроме блоков с указанием признака в заголовке: опционально.

Ограничения и требования#

Убедитесь, что:

  • операционная система и ее версия на узле, с которого выполняется установка, совпадает с ОС и версией на узле/узлах (в зависимости от конфигурации) экземпляра СУБД Pangolin.

  • на всех узлах, в том числе и на том, с которого планируется запуск автоматизированной установки, установлен пакет python версии 3 и выше.

Подготовка виртуального окружения#

Рекомендуется запускать развертывание Pangolin в виртуальной среде Python. Для этого необходимо выполнить установку пакета pangolin-ansible-venv-controller на управляющем хосте, который поставляется в составе дистрибутива:

  1. Разархивируйте rpm-пакет venv из 3rdparty части:

    tar -xz -f 3rdparty/3rdparty.tar.gz ./pangolin-ansible-venv-controller*

  2. Выполните установку пакета:

    sudo dnf install pangolin-ansible-venv-controller-{product_version}-{OS}.x86_64.rpm

    sudo yum install pangolin-ansible-venv-controller-rhel{version_OS}.x86_64.rpm

    sudo apt install pangolin-ansible-venv-controller-{product_version}_amd64.deb

    sudo apt-get install pangolin-ansible-venv-controller-altlinux{version_OS}.x86_64.rpm

    Пример готовой команды:

    sudo dnf -y install pangolin-ansible-venv-controller-6.5.0-sberlinux8.x86_64.rpm

Выбор сценария установки#

Для автоматизированного развертывания СУБД доступны два варианта:

  • Pangolin Installer предлагает интуитивно понятный интерфейс и автоматизацию процесса установки/обновления. Подходит для DBA специалистов, в связи с низкими требования к настройке и навыкам администратора, но сохраняя надежность и контроль над процессом установки/обновления. При этом во внутренней реализации утилиты используются Ansible скрипты входящие в состав плейбука.

  • Ansible плейбук напрямую предназначен для DevOps инженеров, так как требует навыков работы с YAML и заполнения конфигурационных файлов. Обеспечивает гибкую настройку параметров системы и расширенный контроля над процессом установки. Может быть использован, например, при интеграции в работу собственных сценариев автоматизации.

Способ установки

Преимущества

Недостатки

Pangolin Installer

- Простота и удобство использования;
- Автоматизация процесса установки/обновления;
- Минимальные требования к настройке;
- Визуализация статуса выполнения процесса установки/обновления;
- Одна точка конфигурирования

- Меньшая гибкость по сравнению с плейбуком:
- Отсутствие возможности интеграции инструмента в собственную автоматизацию;
- Неосуществимость развертывания дополнительных настроек ролевой модели

Ansible плейбук

- Высокая степень контроля над процессом развертывания;
- Гибкая настройка параметров системы;
- Возможность использование плейбука в собственной автоматизации

- Требуются знания YAML и навыки работы с автоматизированными скриптами;
- Ручная настройка различных параметров в различных конфигурационных файлах;
- Дополнительные шаги по установке необходимых пакетов

Воспользуйтесь одной из предложенных инструкций, в зависимости от выбора сценария:

Проверка результата#

Для проверки успешности установки рекомендуется использовать чек-лист проверки корректности работы СУБД Pangolin.

Действия, в случае неудачной установки#

В случае, если установка прошла неудачно, выполните следующие пункты перед началом новой установки:

  1. Очистите КТС. Для этого выполните удаление продукта СУБД Pangolin по инструкции.

  2. Очистите файл ansible.log перед повторным запуском установки.

  3. Очистите файл ./installer/cache.json, а также добавьте ключ --flush-cache при повторном запуске установки.