Описание инвентаря

Описание инвентаря#

Чтобы задать параметры развертывания платформы Astra Automation, заполните инвентарь установщика. Это обычный инвентарь Ansible в формате INI или YAML. В зависимости от используемого формата файл должен иметь одно из указанных расширений:

  • INI:

    • .ini;

    • .cfg;

  • YAML:

    • .yml;

    • .yaml.

Примечание

Если расширение не указано, файл интерпретируется как имеющий формат INI.

Утилита aa-setup по умолчанию использует файл инвентаря inventory в формате INI, расположенный в одном из следующих каталогов:

  • /opt/rbta/aa/astra-automation-setup/ – при использовании интернет-репозиториев ПАО Группа Астра;

  • в корневом каталоге распакованного архива – при использовании оффлайн-установщика.

Чтобы использовать другой файл инвентаря, при запуске утилиты aa-setup укажите путь к нему в значении аргумента --inventory (-i), например:

sudo ./aa-setup --inventory /var/aa/setup-settings.yaml

При заполнении инвентаря рекомендуется указывать полные пути к файлам и каталогам. Относительные пути рассчитываются по отношению к каталогу, в котором находится файл инвентаря.

Компоненты платформы

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

INI

YAML

Описание

[automationcontroller]

automationcontroller.hosts

Узлы плоскости управления

[execution_nodes]

execution_nodes.hosts

Узлы плоскости исполнения

[automationhub]

automationhub.hosts

Узлы Private Automation Hub

[automationedacontroller]

automationedacontroller.hosts

Узлы контроллера Event-Driven Ansible

[database]

database.hosts

Узел СУБД, развертываемой средствами платформы

[all:vars]

all.vars

Параметры, общие для всех узлов, а также различные настройки платформы

Выберите подходящую конфигурацию платформы и укажите параметры узлов в инвентаре.

Внимание

Использование одного узла для развертывания двух и более компонентов платформы не допускается.

Реквизиты доступа к узлам

С целью сокращения в примерах опущены параметры, в которых задаются реквизиты для подключения к узлам:

  • ansible_user – название учетной записи пользователя, используемой для подключения к узлу;

  • ansible_ssh_private_key_file – путь к файлу приватного ключа SSH.

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

[automationcontroller]
node1.example.com
node2.example.com

[all:vars]
ansible_user=administrator
ansible_ssh_private_key_file=./ssh-keys/ssh_key
---
automationcontroller:
  hosts:
    node1.example.com:
    node2.example.com:
  vars:
    ansible_user: administrator
    ansible_ssh_private_key_file: ./ssh-keys/ssh_key

Если реквизиты для доступа к узлам различаются, укажите их в параметрах соответствующих узлов, например:

[automationcontroller]
node1.example.com  ansible_user=alex  ansible_ssh_private_key_file=./ssh-keys/node1_key
node2.example.com  ansible_user=john  ansible_ssh_private_key_file=./ssh-keys/node2_key

[execution_nodes]
node3.example.com  ansible_user=jack  ansible_ssh_private_key_file=./ssh-keys/node3_key
---
automationcontroller:
  hosts:
    node1.example.com:
      ansible_user: alex
      ansible_ssh_private_key_file: ./ssh-keys/node1_key
    node2.example.com:
      ansible_user: john
      ansible_ssh_private_key_file: ./ssh-keys/node2_key
execution_nodes:
  hosts:
    node3.example.com:
      ansible_user: jack
      ansible_ssh_private_key_file: ./ssh-keys/node3_key

Главный узел

При развертывании платформы данные о ее узлах указываются в инвентаре установщика. При первом запуске установщика узел, указанный первым в группе automationcontroller, становится главным узлом (primary node).

К главном узлу предъявляются следующие требования:

  • При развертывании или обновлении контроллера главный узел всегда должен быть доступен.

  • Запись о главном узле в инвентаре установщика должна размещаться на первой позиции в группе automationcontroller.