jvoss.nautobot

Descripción general Versiones Perspectivas

Rol de Ansible: Nautobot

Instala y configura Nautobot en servidores RHEL/CentOS o Ubuntu.

Requisitos

Este rol gestiona la instalación y configuración de Nautobot. No proporciona los servicios de PostgreSQL o Redis, que son dependencias requeridas de la aplicación. Estas tareas se dejan intencionalmente para que el usuario pueda gestionar esos servicios dentro de sus propios roles y playbooks.

Probado en plataformas soportadas por Nautobot:

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

Este rol requiere acceso root (a través de sudo) para gestionar las dependencias del sistema y las acciones en nombre de Nautobot.

Variables del rol

Variables mínimas requeridas asumiendo que los servicios de PostgreSQL y Redis están disponibles en localhost:

nautobot_db_username: nautobot
nautobot_db_password: nautobot
nautobot_secret_key: "lnvRn_5Bypl8hBV4mMwgsMuHxr6uZvGwJyDqB7fcKqo"

Consulta defaults/main.yml para una lista completa de valores por defecto y opciones configurables.

Cuentas de usuario

Las siguientes variables se pueden definir para crear usuarios solo durante la instalación inicial:

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

Cada usuario requiere un nombre de usuario, una contraseña y una dirección de correo electrónico definidas. El rol intentará crear los usuarios definidos solo una vez durante la instalación inicial. Si nautobot_superusers no está definido, no se crean usuarios y se puede utilizar el proceso de creación de usuarios manual documentado por Nautobot.

Autenticación Externa

Consulta el wiki para información sobre los métodos de autenticación externa disponibles.

Plugins

Los plugins de Nautobot que son módulos de pip se pueden instalar y configurar ajustando la variable nautobot_plugins. A continuación, un ejemplo para el plugin Nornir de Nautobot:

  nautobot_plugins:
    - name: nautobot_plugin_nornir    # Nombre del plugin
      pip: nautobot-plugin-nornir     # Nombre del módulo de Pip
      config:                         # configuración del plugin
        nornir_settings:
          credentials: "nautobot_plugin_nornir.plugins.credentials.env_vars.CredentialsEnvVars"
          runner:
            plugin: "threaded"
            options:
              num_workers: 20

Bloqueo de versión

Opcionalmente, se puede configurar una versión específica de Nautobot usando la variable:

nautobot_version: 1.0.1

Esto asegurará que se mantenga un objetivo específico. Si no se establece, en la instalación inicial pip instalará la versión más reciente. En ejecuciones posteriores, solo comprobará que el módulo esté instalado, pero no lo actualizará automáticamente.

En cualquier caso, se puede forzar una actualización configurando esta variable a la versión de lanzamiento deseada de Nautobot. No se admite la degradación.