Развертывание образа qcow2#

Развертывание Angie ADC состоит из следующих этапов:

  • подготовка среды;

  • подготовка ISO-образа cloud-init с минимальной конфигурацией сети;

  • скачивание дистрибутива;

  • развертывание образа qcow2.

Ниже приведены инструкции по локальному развертыванию виртуальной машины Angie ADC с использованием ISO-образа cloud-init для тестирования решения.

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

Подготовка среды#

Для работы необходима система виртуализации, например qemu. Перед ее использованием убедитесь, что у вас установлены следующие утилиты:

  • virsh;

  • virt-install;

  • qemu;

  • libvirt;

  • libguestfs-tools;

  • virt-viewer.

Установка qemu на Fedora:

$ sudo dnf install qemu libvirt libguestfs-tools libguestfs virt-viewer virt-install

Установка qemu на Ubuntu и Debian:

$ sudo apt update
$ sudo apt install -y \
  qemu-kvm qemu-system-x86 qemu-utils \
  libvirt-daemon-system libvirt-clients virtinst virt-manager \
  ovmf cpu-checker

После установки необходимо добавить своего пользователя в соответствующие группы:

$ sudo usermod -aG libvirt USER
$ sudo usermod -aG kvm USER

Подготовка ISO-образа#

Для развертывания Angie ADC нужен ISO-образ cloud-init с минимальной конфигурацией сети. Cloud-init является стандартным агентом инициализации для виртуальных машин Linux. При запуске виртуальной машины cloud-init получает конфигурацию из ISO-образа в виде ранее заданных мета-данных и настраивает Angie ADC.

Важно

Рекомендуется всегда запускать виртуальную машину с ISO-образом cloud-init. Отсутствие ISO-образа приведет к замедлению запуска и сбросу сетевых настроек Angie ADC.

Для подготовки конфигурации необходимы следующие файлы:

  • meta-data

  • user-data

  • network-config

    Примечание

    Если необходимо задать дополнительные настройки, можно создать файл vendor-data и указать их в нем.

Шаги подготовки ISO-образа:

  1. Создайте файл meta-data и укажите в нем базовую информацию о виртуальной машине Angie ADC.

    Пример:

    instance-id: my-adc1       # уникальный идентификатор виртуальной машины
    local-hostname: my-server  # имя хоста виртуальной машины
    
  2. Создайте файл network-config и задайте в нем конфигурацию сети. Примеры для разных типов виртуализации смотрите здесь.

    Если вы используете DHCP, то файл network-config можно оставить пустым. Для всех интерфейсов будет применен автоматический способ получения адреса.

  3. Создайте файл user-data. В файле необходимо указать:

    #cloud-config
    {}
    

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

  4. Проверьте конфигурацию для каждого файла:

    cloud-init schema --config-file user-data
    
    yamllint meta-data
    
    cloud-init schema --config-file network-config --schema-type network-config
    

    Если конфигурация корректна, в выводе отобразится сообщение Valid schema <файл>.

  5. Создайте ISO-образ, который cloud-init будет использовать при запуске.

    Пример:

    genisoimage -output seed.iso -volid cidata -joliet -rock meta-data user-data network-config
    

Скачивание дистрибутива#

Скачайте образ Angie ADC из репозитория.

Развертывание#

Чтобы развернуть образ qcow2, выполните следующие действия:

  1. Проверьте состояние виртуальной сети:

    $ sudo virsh net-list --all
    
  2. Запустите виртуальную машину c ISO-образом. Диск с конфигурацией seed.iso необходимо подключить как CD-ROM при запуске.

    Пример команды для запуска виртуальной машины на KVM (QEMU) с использованием virt-install:

    virt-install \
      --virt-type kvm \
      --name adc \
      --ram 2048 \
      --vcpus 2 \
      --disk angie-adc-0.5.0-x86_64.cloud-init.qcow2,format=qcow2 \
      --disk seed.iso,device=cdrom \
      --network=bridge:virbr0 \
      --network=bridge:virbr0 \
      --graphics vnc,listen=0.0.0.0 \
      --os-variant=centos8 \
      --import
    

    После выполнения команды откроется консоль виртуального устройства в приложении virt-viewer.

  3. Посмотрите IP-адрес веб-консоли Angie ADC:

    $ sudo virsh net-dhcp-leases default
    
  4. Откройте в браузере адрес http://<адрес_консоли>:8080. Откроется страница входа в веб-консоль Angie ADC. Реквизиты для первого входа предоставляются после покупки решения. Рекомендуется сменить пароль после первого входа.

В веб-консоли Angie ADC вы можете настраивать функции Angie ADC и просматривать статистику работы балансировщика нагрузки. Также доступно управление через интерфейс командной строки (CLI).

Примечание

Сервис SSH по умолчанию не запущен. При запуске внутреннее имя виртуального устройства будет задано как angie-va. Вы можете изменить имя хоста и настройки (сеть, часовой пояс) через ISO-образ cloud-init или в программах, поддерживающих cloud-init вашей системы виртуализации.