Dell-Networking.dellos-ntp
NTPロール
このロールはネットワーク時間プロトコル(NTP)の設定を簡単に行えるようにします。このロールはdellos6、dellos9、およびdellos10のために抽象化されています。特に、すべてのdellosに対するNTPサーバーの設定およびdellos10におけるNTPソース、認証、ブロードキャストサービスの設定を可能にします。
NTPロールには、Dell EMCネットワーキングデバイスへの接続にSSH接続が必要です。組み込みのOS接続変数を使用できます。
インストール
ansible-galaxy install Dell-Networking.dellos-ntp
ロール変数
- ロールは、ansible_network_os変数を使用して抽象化されており、dellos9、dellos6、dellos10の値を取ります。
- dellos_cfg_generateがtrueに設定されている場合、この変数はロール設定コマンドをファイルに生成します。
- それに対応する状態変数がabsentに設定されているロール変数は、その変数の設定を無効にします。
- 変数に空の値を設定すると、対応する設定が無効になります。
- 変数と値は大文字と小文字を区別します。
dellos_ntpキー
キー | 型 | 説明 | 対応 |
---|---|---|---|
server |
list | NTPサーバーを設定します(server.* を参照) |
dellos6, dellos9, dellos10 |
server.ip |
string (必須) | NTPサーバーのIPv4アドレスを設定します(A.B.C.D形式) | dellos6, dellos9, dellos10 |
server.key |
integer | NTPサーバーのピア認証キーを設定します | dellos10 |
server.prefer |
boolean | ピアの優先度を設定します | dellos10 |
server.vrf |
list | VRFインスタンスのNTPサーバーを設定します; リスト項目にはVRFインスタンスの名前が含まれます | dellos9 |
server.state |
string: absent,present* | absentに設定するとNTPサーバーを削除します | dellos6, dellos9, dellos10 |
source |
string | ソースアドレスのインターフェースを設定します | dellos10 |
master |
integer | ローカルクロックをサーバーとして設定します | dellos10 |
authenticate |
boolean | 時間ソースの認証を設定します | dellos10 |
authentication_key |
list | 信頼された時間ソース用の認証キーを設定します(authentication_key.* を参照) |
dellos10 |
authentication_key.key_num |
integer | 認証キー番号を設定します | dellos10 |
authentication_key.key_string_type |
integer: 0,7 | 値が7の場合は隠れた認証キー文字列を設定し、値が0の場合は暗号化されていない認証キー文字列を設定します | dellos10 |
authentication_key.key_string |
string | 認証キー文字列を設定します | dellos10 |
authentication_key.state |
string: absent,present* | absentに設定すると認証キーを削除します | dellos10 |
trusted_key |
list | 信頼された時間ソース用のキー番号を設定します(trusted_key.* を参照) |
dellos10 |
trusted_key.key_num |
integer | キー番号を設定します | dellos10 |
trusted_key.state |
string: absent,present* | absentに設定すると信頼されたキーを削除します | dellos10 |
intf |
dictionary | インターフェースのNTPを設定します(intf.* を参照) |
dellos10 |
intf.<インターフェース名> |
dictionary | インターフェースのNTPを設定します(<インターフェース名>.* を参照) |
dellos10 |
<インターフェース名>.disable |
boolean | インターフェースでのNTPを無効にします | dellos10 |
<インターフェース名>.broadcast |
boolean | インターフェースでのNTPブロードキャストクライアントサービスを設定します | dellos10 |
注: アスタリスク(*)は指定されていない場合のデフォルト値を示します。
接続変数
Ansible Dell EMCネットワーキングロールは、インベントリ内のノードと通信を確立するための接続情報を必要とします。この情報はAnsibleのgroup_varsやhost_varsディレクトリ、またはインベントリやプレイブック内に存在します。
キー | 必須 | 選択肢 | 説明 |
---|---|---|---|
ansible_host |
はい | 指定されたトランスポートを介してリモートデバイスに接続するためのホスト名またはアドレスを指定します | |
ansible_port |
いいえ | リモートデバイスとの接続を構築するために使用されるポートを指定します; 値が指定されていない場合、ANSIBLE_REMOTE_PORTオプションが使用され、デフォルトは22です | |
ansible_ssh_user |
いいえ | リモートデバイスへの接続のCLIログインを認証するためのユーザー名を指定します; 値が指定されていない場合、ANSIBLE_REMOTE_USER環境変数の値が使用されます | |
ansible_ssh_pass |
いいえ | リモートデバイスへの接続を認証するためのパスワードを指定します | |
ansible_become |
いいえ | はい、いいえ* | モジュールがリモートデバイスでコマンドを送信する前に特権モードに入るよう指示します; 値が指定されていない場合、ANSIBLE_BECOME環境変数の値が使用され、デバイスがすべてのコマンドを非特権モードで実行しようとします |
ansible_become_method |
いいえ | enable, sudo* | 特権昇格を処理するためのbecomeメソッドを指定できるように指示します; 値が指定されていない場合、ANSIBLE_BECOME_METHOD環境変数の値が使用されます |
ansible_become_pass |
いいえ | リモートデバイスで特権モードに入る必要がある場合に使用するパスワードを指定します; ansible_become がnoに設定されている場合、このキーは適用されません |
|
ansible_network_os |
はい | dellos6/dellos9/dellos10, null* | リモートデバイスと通信するために正しいターミナルおよびcliconfプラグインをロードします |
注: アスタリスク(*)は指定されていない場合のデフォルト値を示します。
依存関係
dellos-ntpロールは、コアAnsibleコードに含まれるモジュールに基づいて構築されています。これらのモジュールは、Ansibleバージョン2.2.0で追加されました。
例示プレイブック
この例では、dellos-ntpロールを使用してNTPサーバー、ソースIP、認証、およびブロードキャストサービスを設定します。スイッチの詳細と対応する変数を含むhostsファイルを作成します。ホストファイルは、ansible_network_os変数を対応するDell EMCネットワーキングOS名で定義する必要があります。dellos_cfg_generate変数がtrueに設定されている場合、設定コマンドを*.partファイルとしてbuild_dirパスに生成します。デフォルトではfalseに設定されています。例では、dellos-ntpロールだけを参照するシンプルなプレイブックを書きます。
ロールを含めることで、NTP属性を設定するためのすべてのタスクに自動的にアクセスできます。サンプルのhost_varsはdellos10用です。
サンプルホストファイル
leaf1 ansible_host=<ip_address>
サンプルhost_vars/leaf1
host: leaf1
ansible_ssh_user: xxxxx
ansible_ssh_pass: xxxxx
ansible_network_os: dellos10
build_dir: ../temp/dellos10
dellos_ntp:
source: ethernet 1/1/2
master: 5
authenticate: true
authentication_key:
- key_num: 123
key_string_type: 7
key_string: test
state: present
trusted_key:
- key_num: 1323
state: present
server:
- ip: 2.2.2.2
key: 345
prefer: true
state: present
intf:
ethernet 1/1/2:
disable: true
broadcast: true
NTPを設定するシンプルなプレイブック - leaf.yaml
- hosts: leaf1
roles:
- Dell-Networking.dellos-ntp
実行
ansible-playbook -i hosts leaf.yaml
(c) 2017 Dell Inc.またはその子会社。全著作権所有。
The dellos-ntp role facilitates the configuration of NTP attributes in devices running Dell EMC Networking Operating Systems.
ansible-galaxy install Dell-Networking.dellos-ntp