Перейти к основному содержимому

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

Сведения

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

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

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

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

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

  1. Распакуйте дистрибутив новой версии СУБД Pangolin. Убедитесь в наличии лицензии.
  2. Подготовка виртуального окружения.
  3. Выбор сценария установки: с помощью Pangolin Installer (целевой), при помощи Ansible плейбука (альтернативный).
  4. Подготовка к выбранному сценарию автоматизированной установки.
  5. Запуск сценария автоматизированной установки.
  6. Проверка результата процесса установки.
Подсказка

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

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

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

  • Операционная система и ее версия на узле, с которого выполняется установка, совпадает с ОС и версией на узле/узлах (в зависимости от конфигурации) экземпляра СУБД Pangolin.
  • На всех узлах, в том числе и на том, с которого планируется запуск автоматизированной установки, установлены требуемые пакеты, указанные в разделе «Список пакетных зависимостей, требуемых для корректной работы Ansible-скриптов».
  • Установлена версия пакета ansible-core не ниже 2.11.0 и не выше 2.12.0. Данный пакет устанавливается в рамках поставляемого пакета ansible-venv-controller, который устанавливается в рамках подготовки виртуального окружения.

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

Рекомендуется запускать развертывание 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 dnf -y install pangolin-ansible-venv-controller-6.5.0-sberlinux8.x86_64.rpm

  3. Активируйте виртуальное окружение для начала последующей установки:

    source /opt/pangolin-ansible-venv-controller/bin/activate

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

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

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

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

Способ установкиПреимуществаНедостатки
Pangolin Installer- Простота и удобство использования;
- Автоматизация процесса установки/обновления;
- Минимальные требования к настройке;
- Визуализация статуса выполнения процесса установки/обновления;
- Одна точка конфигурирования		- Меньшая гибкость по сравнению с плейбуком:
- Отсутствие возможности интеграции инструмента в собственную автоматизацию;
- Неосуществимость развертывания дополнительных настроек ролевой модели
Ansible плейбук- Высокая степень контроля над процессом развертывания;
- Гибкая настройка параметров системы;
- Возможность использование плейбука в собственной автоматизации		- Требуются знания YAML и навыки работы с автоматизированными скриптами;
- Ручная настройка различных параметров в различных конфигурационных файлах;
- Дополнительные шаги по установке необходимых пакетов

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

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

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

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

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

  1. Очистите КТС. Для этого выполните удаление продукта СУБД Pangolin по инструкции.
  2. Очистите файл ansible.log перед повторным запуском установки.
  3. Очистите файл ./installer/cache.json, а также добавьте ключ --flush-cache при повторном запуске установки.