NETBOX как dynamic inventory для Ansible

Для начала подготовим виртуалочку для управления инфрой через ansible. Использовать будем Debian 12

Ставим python3.11 (т.к. он будет в зависимостях в нашем Pipfile) и pip

apt install python3.11-full
apt install pip

Устанавливаем pipenv

pip install pipenv --break-system-packages

Подготавливаем ansible.cfg и Pipfile с зависимостями
ansible.cfg
Spoiler

[defaults]

roles_path = ../../roles:roles
callback_plugins = /root/ansible/ansible_collection/ansible_collections
interpreter_python = /usr/bin/python3
force_valid_group_names = ignore
host_key_checking = False
stdout_callback = yaml

timeout = 20

config_context = True
fact_caching = jsonfile
fact_caching_connection = inventory/.cache
fact_caching_timeout = 86400

module_defaults:

 ansible.builtin.setup:

   gather_timeout: 10

 ansible.builtin.gather_facts:

   gather_timeout: 10

[ssh_connection]
scp_if_ssh = True
delay=10
retries=2
pipelining=True
ssh_args = -o ControlMaster=auto -o ControlPersist=5m -o ConnectionAttempts=3 -o UserKnownHostsFile=/dev/null

Pipfile
Spoiler

[ [source] ]

url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]

requests = "==2.26.0"
proxmoxer = "==2.0.1"
ansible = "==9.7.0"
ansible-lint = "==6.14.4"
hvac = "==0.11.2"
dnspython = "==2.3.0"
pyvcloud = "==23.0.4"
lxml = "==4.9.2"
pynetbox = "==6.6.2"
zabbix-api = "==0.5.5"
pure-sasl = "==0.5.1"
netaddr = "==0.8.0"
pytz = "==2023.3"
"molecule[ansible]" = "==4.0.1"
molecule-proxmox = "==0.7.0"
ansible-compat = "==25.1.4"
"requests[socks]"="==2.26.0"
pywinrm = "==0.5.0"

[dev-packages]

[requires]

python_version = "3.11"

Создадим директории и положим конфиги и прочее

/inventories
	/iwad
		/group_vars
			all.yaml
		netbox-inventory.yaml
/playbooks
	/base
		ansible.cfg
		base.yaml
		Pipfile
/roles
	/base

Клонируем репу с базовой ролью

Создаём виртуальное окружение(поставим пару пакетов которые пригодятся)

cd /root/ansible/playbooks/base
pipenv install
pipenv shell
pip install dotenv loguru

Приводим /inventories/iwad/netbox-inventory.yaml примерно к такому виду

---
plugin: netbox.netbox.nb_inventory
api_endpoint: https://netbox.iwad.ru
token: fc58b84c25grbc5506627a8c32r32a397213ee
validate_certs: false
config_context: false
group_names_raw: True

group_by:
  - device_roles
compose:
  nbx_role: role.name
  primary_ip_address: primary_ip.address
query_filters:
  - status: 'active'
  - cf_device_class: server
  - tenant: org_iwad
device_query_filters:
  - has_primary_ip: 'true'
vm_query_filters:
  - has_primary_ip: 'true'

проверяем что инвентарь парсится(конечно же в netbox уже должны быть внесены устройства)

ansible-inventory -i ../../inventories/iwad --graph
@all:
  |--@ungrouped:
  |--@proxmox:
  |  |--pve36.iwad.ru
  |  |--pve37.iwad.ru
  |  |--pve38.iwad.ru
  |  |--pve42.iwad.ru

или

ansible-inventory -i ../../inventories/iwad --list

кладём id_rsa поьзователю ansible(не умно, признаю) и пробуем катать базовую роль

РАБОТАЕМ!!!

https://netboxlabs.com/docs/integrations/tool-integrations/netbox-ansible-collection/#use-case-1---netbox-as-a-dynamic-inventory-source-for-ansible

https://docs.ansible.com/projects/ansible/latest/collections/netbox/netbox/nb_inventory_inventory.html

https://habr.com/ru/companies/ruvds/articles/962710/

https://demo.netbox.dev/api/schema/swagger-ui/#/