Ansible Rolle: NetBox

Eine Ansible Rolle, die auf Debian/Ubuntu installiert wird.

Diese Rolle installiert alle Abhängigkeiten, die für NetBox benötigt werden, einschließlich der PostgreSQL-Datenbank. Damit kann eine NetBox-Anwendung eingerichtet werden, die alles auf derselben Maschine beinhaltet.

Die Einrichtung des Web-Backends und Frontends kann deaktiviert werden, wenn Sie bereits einen eigenen Weg haben, dies zu handhaben.

Abhängigkeiten

Keine.

Rollenvariablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit den Standardwerten:

Einrichtung für die PostgreSQL-Datenbank:

netbox_database: netbox
netbox_database_user: netbox
netbox_database_password: netbox
netbox_database_host: localhost # Dies zwingt zur Einrichtung von PostgreSQL

Wo NetBox heruntergeladen werden soll und welche Version:

netbox_version: latest
netbox_git_url: https://github.com/netbox-community/netbox.git

Standardmäßig wird immer die neueste stabile Version heruntergeladen. Eine spezielle Version kann durch Verwendung von v3.5.1, zum Beispiel, erzwungen werden.

Wo NetBox installiert werden soll:

netbox_install_directory: /opt/netbox

Der Benutzername, das Passwort und die E-Mail für den Superbenutzer:

netbox_superuser_username: admin
netbox_superuser_password: admin
netbox_superuser_email: admin@example.com

LDAP kann als Authentifizierungsmechanismus verwendet werden. Es muss aktiviert werden, und die gesamte LDAP-Konfiguration muss in den folgenden Variablen angegeben werden (siehe NetBox Dokumentation):

netbox_setup_ldap_auth: false
netbox_ldap_config: ""

Andere Python-Pakete können mit local_requirements.txt installiert werden; dies ist nützlich, um Pakete wie NAPALM oder Plugins zu installieren:

netbox_local_requirements:
  - napalm
  …

Die Konfiguration für NetBox muss als key: value Paare angegeben werden, wie im Folgenden. Bitte beachten Sie, dass der geheime Schlüssel nicht angegeben werden muss, da er automatisch generiert wird:

netbox_config:
  ALLOWED_HOSTS:
    - localhost
    - 127.0.0.1
  TIME_ZONE: "Europe/Paris"
  …

Der Befehl zur Wartung wird täglich um 4:30 Uhr UTC mit einem systemd-Timer ausgeführt. Sie können on_unit_active_sec: 12h anstelle von on_calendar verwenden, um den Wartungsbefehl alle 12 Stunden auszuführen (zum Beispiel).

netbox_systemd_timers:
  netbox-housekeeping:
    enabled: true
    command: "{{ netbox_virtualenv_path }}/bin/python {{ netbox_install_directory }}/netbox/manage.py housekeeping"
    on_calendar: "*-*-* 4:30:00 UTC"

Konfiguration für den Backend-Webserver und systemd:

netbox_setup_systemd: false
netbox_gunicorn_address: 127.0.0.1
netbox_gunicorn_port: 8001
netbox_gunicorn_workers_number: 5

Ob der Frontend-Webserver konfiguriert werden soll oder nicht:

netbox_setup_web_frontend: false

SSL/TLS-Konfiguration für den Frontend-Webserver:

netbox_web_tls: false
netbox_web_tls_port: 443
# netbox_web_tls_crt: /etc/pki/server.crt
# netbox_web_tls_key: /etc/pki/server.key
# netbox_web_tls_chain:
netbox_web_tls_redirect: false

Beispiel-Playbook

- hosts: netboxes
  roles:
    - { role: gmazoyer.netbox }

Lizenz

Diese Ansible Rolle wird unter den Bedingungen der GNU GPLv3 veröffentlicht. Bitte lesen Sie die LICENSE-Datei für weitere Informationen.

Teile dieser Rolle enthalten MIT-lizenzierte Codes (siehe 7c400dd) und sind im Header gekennzeichnet. Siehe LICENSE-MIT für weitere Informationen.

Autoreninformation

Diese Rolle wurde 2017 von Guillaume Mazoyer erstellt.