jvoss.nautobot

Ansible ロール: Nautobot

CI Ansible Galaxy Ansible Quality Score Version

NautobotをRHEL/CentOSまたはUbuntuサーバーにインストールして設定します。

要件

このロールは、Nautobotのインストールと設定を管理します。このロールは、アプリケーションに必要な依存関係であるPostgreSQLやRedisサービスを提供しません。これらのタスクは、ユーザーが自身のロールやプレイブック内でこれらのサービスを管理できるように意図的に残されています。

Nautobotがサポートするプラットフォームでテスト済み:

  • CentOS 8.2以上またはRed Hat Enterprise Linux (RHEL) 8.2以上
  • Ubuntu 20.04

このロールは、Nautobotのためにシステムの依存関係やアクションを管理するためにrootアクセス(sudo経由)を必要とします。

ロール変数

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: [email protected]

各ユーザーには、ユーザー名、パスワード、メールアドレスが必要です。このロールは、初回インストール時に定義されたユーザーを一度だけ作成しようとします。nautobot_superusersが定義されていない場合、ユーザーは作成されず、Nautobotによって文書化された手動ユーザー作成プロセスを使用できます。

外部認証

利用可能な外部認証方法については、wikiを参照してください。

プラグイン

Nautobotのプラグインでpipモジュールであるものは、nautobot_plugins変数を設定することでインストールおよび設定できます。以下は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を参照してください。

プロジェクトについて

Installs and configures Nautobot

インストール
ansible-galaxy install jvoss.nautobot
ライセンス
mit
ダウンロード
168
所有者