Netplanロール

:warning: このプロジェクトはアーカイブされました！ :warning:

このロールは、私たちの hifis.toolkit コレクションに移行されました：

• https://github.com/hifis-net/ansible-collection-toolkit
• https://galaxy.ansible.com/ui/repo/published/hifis/toolkit/

Netplanをインストールおよび構成するためのAnsibleロールです。

要件

なし。

ロール変数

デフォルトで設定されていない必須変数

サンプルネットワーク構成

Netplanを使ったネットワーキングの設定サンプル：

netplan_ethernets:
  - interface_name: 'eth0'
    dhcp4: 'no'
    routes:
      - to: 'default'
        via: '10.123.0.1'
    addresses:
      - '10.123.0.10/24'
    nameservers:
      addresses:
        - '8.8.8.8'
        - '9.9.9.9'
      search:
        - 'domain.local'
        - 'domain.name'

デフォルトで設定される変数

既存のNetplan構成ファイルを削除するフラグ

既存のNetplan構成ファイルを削除するかどうかを決定するフラグ：

netplan_remove_existing_configs: true

Netplan構成ファイルテンプレートの名前

Netplan構成ファイルを提供するテンプレートの名前：

netplan_configuration_file_template: 'config.yaml.j2'

Netplan構成ファイルのディレクトリ

Netplan構成ファイルのディレクトリ：

netplan_configuration_dir: '/etc/netplan'

Netplan構成ファイルの名前

Netplan構成ファイルの名前：

netplan_configuration_file: 'config.yaml'

Netplan構成ファイルのパス

Netplan構成ファイルのパス：

netplan_configuration_file_path: "{{ (netplan_configuration_dir, netplan_configuration_file) | path_join }}"

インストールするパッケージ

インストールする必要があるパッケージのリスト：

netplan_packages:
  - 'netplan.io'

ifupdownネットワーク構成ファイル

パッケージifupdownによってネットワークが管理されている場合に存在するネットワーク構成ファイル：

ifupdown_ifstate_file: '/run/network/ifstate'

トラブルシューティング

クリーンアップ：パッケージifupdownを手動でアンインストールしてください

パッケージ ifupdown を安全に削除する前に、Netplanネットワークを適切に構成する必要があります。 パッケージを早すぎる段階で削除すると、ロールがハングします。

そのため、このロールは ifupdown パッケージの削除を処理しません。

制限事項

ネットワーク構成のブートストラップはサポートされていません

ロールの実行中にネットワーク構成をブートストラップできないことに注意してください。 管理されたノードは、事前にネットワーキングを構成しておく必要があります。

Ansibleが接続するIPの変更はサポートされていません

このロールは、Ansibleが接続するIPアドレスを変更することをサポートしていないことに注意してください。 接続中のIPアドレスを変更すると、 netplan apply を実行した際にロールがハングします。 この場合、AnsibleはSSH接続を失います。

依存関係

なし。

ライセンス

Apache-2.0

著者情報

HIFISソフトウェアチーム