jvoss.nautobot

Ansible Rolle: Nautobot

Installiert und konfiguriert Nautobot auf RHEL/CentOS oder Ubuntu-Servern.

Anforderungen

Diese Rolle verwaltet die Installation und Konfiguration von Nautobot. Sie bietet keine PostgreSQL- oder Redis-Dienste, die für die Anwendung erforderlich sind. Diese Aufgaben werden absichtlich nicht übernommen, um dem Benutzer die Verwaltung dieser Dienste innerhalb seiner eigenen Rollen und Playbooks zu ermöglichen.

Getestet auf von Nautobot unterstützten Plattformen:

CentOS 8.2+ oder Red Hat Enterprise Linux (RHEL) 8.2+
Ubuntu 20.04

Diese Rolle benötigt Root-Zugriff (über sudo), um Systemabhängigkeiten und Aktionen im Namen von Nautobot zu verwalten.

Rollvariablen

Mindestanforderungen an Variablen, vorausgesetzt, die PostgreSQL- und Redis-Dienste sind lokal verfügbar:

nautobot_db_username: nautobot
nautobot_db_password: nautobot
nautobot_secret_key: "lnvRn_5Bypl8hBV4mMwgsMuHxr6uZvGwJyDqB7fcKqo"

Siehe defaults/main.yml für eine vollständige Liste der Standardwerte und konfigurierbaren Optionen.

Benutzerkonten

Die folgenden Variablen können definiert werden, um Benutzer nur während der initialen Installation zu erstellen:

nautobot_superusers:
  - username: admin
    password: admin
    email: [email protected]

Jeder Benutzer benötigt einen definierten Benutzernamen, ein Passwort und eine E-Mail-Adresse. Die Rolle versucht, die definierten Benutzer nur einmal während der initialen Installation zu erstellen. Wenn nautobot_superusers nicht definiert ist, werden keine Benutzer erstellt und der manuelle Benutzererstellungsprozess dokumentiert von Nautobot kann stattdessen verwendet werden.

Externe Authentifizierung

Siehe das Wiki für Informationen über verfügbare externe Authentifizierungsmethoden.

Plugins

Nautobot-Plugins, die Pip-Module sind, können installiert und konfiguriert werden, indem die Variable nautobot_plugins gesetzt wird. Unten ist ein Beispiel für das Nautobot Nornir-Plugin:

  nautobot_plugins:
    - name: nautobot_plugin_nornir    # Plugin-Name
      pip: nautobot-plugin-nornir     # Pip-Modulname
      config:                         # Plugin-Konfiguration
        nornir_settings:
          credentials: "nautobot_plugin_nornir.plugins.credentials.env_vars.CredentialsEnvVars"
          runner:
            plugin: "threaded"
            options:
              num_workers: 20

Versionssperre

Optional kann eine bestimmte Version von Nautobot mit der Variable konfiguriert werden:

nautobot_version: 1.0.1

Dies stellt sicher, dass ein bestimmtes Ziel aufrechterhalten wird. Wenn nicht eingestellt, installiert Pip bei der ersten Installation die neueste Version. Bei nachfolgenden Ausführungen wird nur überprüft, ob das Modul installiert ist, ohne es automatisch zu aktualisieren.

In beiden Fällen kann ein Upgrade durch Setzen dieser Variablen auf die gewünschte Nautobot-Version ausgelöst werden. Ein Downgrade wird nicht unterstützt.