nautobot
Ansible Роль: Nautobot
Устанавливает и настраивает Nautobot на серверах RHEL/CentOS или Ubuntu.
Требования
Эта роль управляет установкой и настройкой Nautobot. Она не предоставляет службы PostgreSQL или Redis, которые являются необходимыми зависимостями приложения. Эти задачи оставлены намеренно, чтобы пользователи могли управлять этими службами в своих собственных ролях и плейбуках.
Тестировалось на поддерживаемых платформах Nautobot:
- CentOS 8.2+ или Red Hat Enterprise Linux (RHEL) 8.2+
- Ubuntu 20.04
Для управления системными зависимостями и действиями от имени Nautobot потребуется доступ root (через sudo).
Переменные роли
Минимально необходимые переменные, если службы PostgreSQL и Redis доступны на localhost
:
nautobot_db_username: nautobot
nautobot_db_password: nautobot
nautobot_secret_key: "lnvRn_5Bypl8hBV4mMwgsMuHxr6uZvGwJyDqB7fcKqo"
Смотрите defaults/main.yml для полного списка по умолчанию и параметров, которые можно настроить.
Учетные записи пользователей
Следующие переменные могут быть определены для создания пользователей только во время первоначальной установки:
nautobot_superusers:
- username: admin
password: admin
email: [email protected]
Каждый пользователь требует указания имени пользователя, пароля и адреса электронной почты. Роль попытается создать указанных пользователей только один раз во время первоначальной установки. Если nautobot_superusers
не определена, пользователи не будут созданы, и можно использовать процесс ручного создания пользователей, документированный Nautobot.
Внешняя аутентификация
Смотрите wiki для информации о доступных методах внешней аутентификации.
Плагины
Плагины Nautobot, которые являются модулями pip, могут быть установлены и настроены, установив переменную nautobot_plugins
. Вот пример для плагина Nautobot Nornir:
nautobot_plugins:
- name: nautobot_plugin_nornir # Имя плагина
pip: nautobot-plugin-nornir # Имя модуля pip
config: # конфигурация плагина
nornir_settings:
credentials: "nautobot_plugin_nornir.plugins.credentials.env_vars.CredentialsEnvVars"
runner:
plugin: "threaded"
options:
num_workers: 20
Фиксация версии
Дополнительно можно настроить конкретную версию nautobot с помощью переменной:
nautobot_version: 1.0.1
Это обеспечит поддержку конкретной цели. Если не указано, при первоначальной установке pip установит последнюю версию. При последующих запусках будет проверяться, что модуль установлен, но он не будет обновляться автоматически.
В любом случае, обновление может быть инициировано, установив эту переменную на желаемую версию релиза Nautobot. Понижение версии не поддерживается.
Зависимости
Нет зависимостей Ansible. Приложение требует Redis и Postgres.
Пример плейбука
Смотрите EXAMPLE для полного примера плейбука.
Участие
Приветствуются вклады. Пожалуйста, смотрите CONTRIBUTING для деталей.
ansible-galaxy install jvoss/ansible-role-nautobot