Настройка модуля координации

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

  1. настройка конфигурации серверов управления в файлах конфигурации;

  2. настройка конфигурации агентов в файлах конфигурации;

  3. загрузка пользовательских формул в хранилище S3.

Настройка конфигурации серверов управления

Сервер управления настраивается через главный файл конфигурации — /etc/salt/master.

В данном файле необходимо выполнить настройку, которая обеспечит трансляцию событий на главный сервер: syndic_forward_all_events: True.

Подробную информацию о настройке главного файла конфигурации сервера управления см. в официальной документации.

Чтобы логически разделить параметры конфигурации, рекомендуется использовать директорию /etc/salt/master.d/.

Например, если вы используете хранилище S3, задайте настройки подключения к хранилищу для агентов в файле s3.conf и поместите его в директорию /etc/salt/master.d/ (см. пример ниже).

Директория /etc/salt/master.d/ может содержать только файлы с расширением .conf.

Дополнительные настройки при использовании хранилища S3

При использовании хранилища S3 в качестве пространства для хранения общих файлов конфигураций и файлов состояний выполните настройки:

  1. Создайте файл /etc/salt/master/fileserver_backend.conf и укажите в нем, что в качестве бэкенда для файлов будет использоваться хранилище S3:

    fileserver_backend:
  - s3fs

  1. В файле /etc/salt/master/s3.conf пропишите настройки подключения к хранилищу S3:

    s3.service_url: <s3_hostname>:<s3_port>
s3.keyid: <ACCESS_KEY>
s3.key: <SECRET_KEY>
s3.buckets:
  - salt-bucket
s3.path_style: True
s3.location: <REGION>

    Где в параметре s3.buckets указана корзина с именем salt-bucket для хранения файлов состояния и формул.

    Подробное описание всех параметров приведено в официальной документации.

  2. Выполните настройку подключения к S3 для хранения в отдельной корзине данных хранилища Pillar — создайте файл /etc/salt/master/ext_pillar.conf, в котором будет указана корзина pillar-bucket:

    ext_pillar:
  - s3:
      service_url: <s3_hostname>:<s3_port>
      keyid: <ACCESS_KEY>
      key: <SECRET_KEY>
      bucket: pillar-bucket
      multiple_env: False
      environment: base
      prefix: ''
      verify_ssl: False
      s3_cache_expire: 30
      s3_sync_on_update: True
      path_style: True
      https_enable: False
    Подробное описание всех полей приведено в официальной документации.

Настройка конфигурации агентов

Агент настраивается через файл конфигурации — /etc/salt/minion.

Подробную информацию о настройке главного файла конфигурации агента см. в официальной документации.

Загрузка пользовательских формул в хранилище S3

Готовые формулы импортируются в хранилище S3 автоматически при установке продукта.

Чтобы загрузить пользовательские формулы и формулы-шаблоны используйте метод API importFormulas для импорта формулы в хранилище S3.