Ansible 角色：Nautobot

在 RHEL/CentOS 或 Ubuntu 服务器上安装和配置 Nautobot。

要求

此角色管理 Nautobot 的安装和配置。此角色不提供 PostgreSQL 或 Redis 服务，这些是应用程序所需的依赖项。这些任务故意留给用户在自己的角色和剧本中管理这些服务。

在支持 Nautobot 的平台上测试：

• CentOS 8.2+ 或 Red Hat 企业 Linux (RHEL) 8.2+
• Ubuntu 20.04

此角色需要 root 访问权限（通过 sudo）来管理系统依赖项和代表 Nautobot 执行操作。

角色变量

假设可用的 localhost PostgreSQL 和 Redis 服务，最低要求的变量为：

nautobot_db_username: nautobot
nautobot_db_password: nautobot
nautobot_secret_key: "lnvRn_5Bypl8hBV4mMwgsMuHxr6uZvGwJyDqB7fcKqo"

有关默认值和可配置选项的完整列表，请参阅 defaults/main.yml。

用户帐户

可以定义以下变量仅在初始安装期间创建用户：

nautobot_superusers:
  - username: admin
    password: admin
    email: changeme@example.com

每个用户需要定义用户名、密码和电子邮件地址。该角色将在初始安装期间尝试创建定义的用户一次。如果未定义 nautobot_superusers，则不会创建用户，可以使用 Nautobot 文档中记录的手动用户创建过程 documented。

外部身份验证

有关可用外部身份验证方法的信息，请参阅 wiki。

插件

可以通过设置 nautobot_plugins 变量来安装和配置可以作为 pip 模块的 Nautobot 插件。以下是 Nautobot Nornir 插件的示例：

  nautobot_plugins:
    - name: nautobot_plugin_nornir    # 插件名称
      pip: nautobot-plugin-nornir     # Pip 模块名称
      config:                         # 插件配置
        nornir_settings:
          credentials: "nautobot_plugin_nornir.plugins.credentials.env_vars.CredentialsEnvVars"
          runner:
            plugin: "threaded"
            options:
              num_workers: 20

版本锁定

可选地，可以使用以下变量配置特定版本的 Nautobot：

nautobot_version: 1.0.1

这将确保维护一个特定的目标。如果未设置，在初始安装时 pip 将安装最新版本。在后续运行中，它只会检查模块是否已安装，但不会自动升级。

在任何情况下，都可以通过将此变量设置为所需的 Nautobot 发布版本来触发升级。不支持降级。

依赖项

无 Ansible 依赖项。该应用程序需要 Redis 和 Postgres。

示例剧本

有关完整剧本示例，请参见 EXAMPLE。

贡献

鼓励贡献。有关详细信息，请参见 CONTRIBUTING。