jvoss.nautobot

Rola Ansible: Nautobot

Instaluje i konfiguruje Nautobot na serwerach RHEL/CentOS lub Ubuntu.

Wymagania

Ta rola zarządza instalacją i konfiguracją Nautobot. Nie dostarcza usług PostgreSQL ani Redis, które są wymagane przez aplikację. Te zadania pozostają do zarządzania przez użytkownika w jego własnych rolach i playbookach.

Testowane na platformach wspieranych przez Nautobot:

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

Rola wymaga dostępu root (przez sudo) do zarządzania zależnościami systemowymi i działaniami w imieniu Nautobot.

Zmienne roli

Minimalnie wymagane zmienne zakładając, że usługi PostgreSQL i Redis na localhost są dostępne:

nautobot_db_username: nautobot
nautobot_db_password: nautobot
nautobot_secret_key: "lnvRn_5Bypl8hBV4mMwgsMuHxr6uZvGwJyDqB7fcKqo"

Pełną listę domyślnych wartości i opcji konfigurowalnych można znaleźć w defaults/main.yml.

Konta użytkowników

Poniższe zmienne można zdefiniować, aby utworzyć użytkowników tylko podczas początkowej instalacji:

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

Każdy użytkownik wymaga zdefiniowania nazwy użytkownika, hasła i adresu e-mail. Rola spróbuje utworzyć zdefiniowanych użytkowników tylko raz podczas początkowej instalacji. Jeśli nautobot_superusers nie jest zdefiniowane, użytkownicy nie są tworzeni, a ręczny proces tworzenia użytkowników udokumentowany przez Nautobot można użyć w zamian.

Zewnętrzna autoryzacja

Zobacz wiki po więcej informacji o dostępnych metodach autoryzacji zewnętrznej.

Wtyczki

Wtyczki Nautobot, które są modułami pip, mogą być instalowane i konfigurowane przez ustawienie zmiennej nautobot_plugins. Poniżej znajduje się przykład dla wtyczki Nautobot Nornir:

  nautobot_plugins:
    - name: nautobot_plugin_nornir    # Nazwa wtyczki
      pip: nautobot-plugin-nornir     # Nazwa modułu pip
      config:                         # konfiguracja wtyczki
        nornir_settings:
          credentials: "nautobot_plugin_nornir.plugins.credentials.env_vars.CredentialsEnvVars"
          runner:
            plugin: "threaded"
            options:
              num_workers: 20

Blokowanie wersji

Opcjonalnie, można skonfigurować konkretną wersję nautobotu używając zmiennej:

nautobot_version: 1.0.1

To zapewni, że określona wersja będzie utrzymywana. Jeśli nie jest ustawiona, podczas początkowej instalacji pip zainstaluje najnowszą wersję. Przy kolejnych uruchomieniach sprawdzi tylko, czy moduł jest zainstalowany, ale nie zaktualizuje go automatycznie.

W każdym przypadku, aktualizację można wymusić przez ustawienie tej zmiennej na pożądaną wersję wydania Nautobot. Wersji w dół nie wspiera się.