jvoss.nautobot

Rôle Ansible : Nautobot

Installe et configure Nautobot sur des serveurs RHEL/CentOS ou Ubuntu.

Exigences

Ce rôle gère l'installation et la configuration de Nautobot. Ce rôle ne fournit pas les services PostgreSQL ou Redis, qui sont des dépendances requises de l'application. Ces tâches sont laissées intentionnellement à l'utilisateur pour qu'il puisse gérer ces services dans ses propres rôles et playbooks.

Testé sur les plateformes supportées par Nautobot :

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

Ce rôle nécessite un accès root (via sudo) pour gérer les dépendances système et les actions au nom de Nautobot.

Variables de rôle

Variables minimales requises en supposant que les services PostgreSQL et Redis sont disponibles sur localhost :

nautobot_db_username: nautobot
nautobot_db_password: nautobot
nautobot_secret_key: "lnvRn_5Bypl8hBV4mMwgsMuHxr6uZvGwJyDqB7fcKqo"

Voir defaults/main.yml pour une liste complète des valeurs par défaut et des options configurables.

Comptes utilisateurs

Les variables suivantes peuvent être définies pour créer des utilisateurs lors de l'installation initiale uniquement :

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

Chaque utilisateur nécessite un nom d'utilisateur, un mot de passe et une adresse e-mail définis. Le rôle tentera de créer les utilisateurs définis uniquement une fois lors de l'installation initiale. Si nautobot_superusers n'est pas défini, aucun utilisateur n'est créé et le processus de création d'utilisateur manuel documénté par Nautobot pourra être utilisé à la place.

Authentification externe

Voir le wiki pour des informations sur les méthodes d'authentification externe disponibles.

Plugins

Les plugins Nautobot qui sont des modules pip peuvent être installés et configurés en définissant la variable nautobot_plugins. Voici un exemple pour le plugin Nautobot Nornir :

nautobot_plugins:
  - name: nautobot_plugin_nornir    # Nom du plugin
    pip: nautobot-plugin-nornir     # Nom du module pip
    config:                         # configuration du plugin
      nornir_settings:
        credentials: "nautobot_plugin_nornir.plugins.credentials.env_vars.CredentialsEnvVars"
        runner:
          plugin: "threaded"
          options:
            num_workers: 20

Verrouillage de version

Optionnellement, une version spécifique de Nautobot peut être configurée en utilisant la variable :

nautobot_version: 1.0.1

Cela garantira qu'une cible spécifique est maintenue. Si ce n'est pas défini, lors de l'installation initiale, pip installera la dernière version. Lors des exécutions suivantes, il vérifiera uniquement que le module est installé, mais ne le mettra pas à jour automatiquement.

Dans tous les cas, une mise à niveau peut être déclenchée en définissant cette variable sur la version de publication souhaitée de Nautobot. Le retour à une version précédente n'est pas pris en charge.