jvoss.nautobot
Ansible ロール: Nautobot
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を参照してください。