Ansible-Netplan 项目启动和配置教程

Ansible-Netplan 项目启动和配置教程

ansible-netplan Ansible role to manage Netplan 项目地址: https://gitcode.com/gh_mirrors/an/ansible-netplan

1. 项目目录结构及介绍

Ansible-Netplan 是一个用于管理 Netplan 的 Ansible 角色。Netplan 是 Ubuntu 18.04 及以上版本中的一种新的网络配置工具。以下是项目的目录结构及其介绍：

ansible-netplan/
├── .github/                # GitHub 相关配置文件
├── defaults/               # 默认变量文件
├── handlers/               # Ansible handlers 文件
├── molecule/               # 测试目录
├── tasks/                  # Ansible tasks 文件
├── templates/              # 模板文件，用于生成配置文件
├── tests/                  # 测试文件
├── vars/                   # 变量文件
├── .travis.yml             # Travis CI 配置文件
├── .yamllint.yml           # YAML 语法检查配置文件
├── LICENSE                 # 项目许可证文件
├── README.md               # 项目说明文件
├── poetry.lock             # Python 依赖锁定文件
├── pyproject.toml          # Python 项目配置文件
├── requirements-dev.txt    # 开发环境依赖文件
├── requirements.txt        # 生产环境依赖文件
├── setup_travis_tests.sh   # 设置 Travis CI 测试脚本
└── ...

• .github/：包含 GitHub Actions 工作流等配置。
• defaults/：包含角色的默认变量设置。
• handlers/：定义了角色中可调用的 handlers，通常用于触发通知或重启服务等操作。
• molecule/：包含了 molecule 测试框架的测试场景。
• tasks/：包含了角色执行的主要任务。
• templates/：包含了 Jinja2 模板文件，用于生成 Netplan 配置文件。
• tests/：包含了项目的单元测试和集成测试。
• vars/：包含了角色可以使用的变量定义。
• .travis.yml：配置 Travis CI 持续集成服务。
• .yamllint.yml：配置 YAML 语法检查。
• LICENSE：项目使用的 MIT 许可证。
• README.md：项目说明文件，介绍项目的用途和如何使用。
• poetry.lock 和 pyproject.toml：用于管理项目的 Python 依赖。
• requirements-dev.txt 和 requirements.txt：分别为开发环境和生产环境的依赖文件。
• setup_travis_tests.sh：用于设置 Travis CI 测试环境的脚本。

2. 项目的启动文件介绍

Ansible-Netplan 项目的启动主要是通过 Ansible 的 playbook 来实现的。以下是启动文件的基本结构：

---
- hosts: your_hosts
  any_errors_fatal: true
  roles:
    - role: mrlesmithjr.netplan
      become: yes

在 playbook 中，你需要定义目标主机 hosts，并设置 any_errors_fatal 为 true 以确保在遇到任何错误时立即停止执行。然后，通过 roles 字段引用 mrlesmithjr.netplan 角色，并指定 become: yes 以确保 Ansible 以超级用户权限执行角色。

3. 项目的配置文件介绍

项目的配置文件主要位于 defaults/main.yml 和 vars/main.yml 中。以下是一些重要的配置项：

• netplan_enabled：一个布尔值，用于启用或禁用 Netplan 配置。
• netplan_config_file：指定 Netplan 配置文件的路径，默认为 /etc/netplan/config.yaml。
• netplan_renderer：指定 Netplan 使用的渲染器，例如 networkd 或 systemd-networkd。
• netplan_configuration：定义具体的网络配置，包括网络版本、网络接口和地址等。

以下是一个配置示例：

netplan_enabled: true
netplan_config_file: /etc/netplan/my-awesome-netplan.yaml
netplan_renderer: networkd
netplan_configuration:
  network:
    version: 2
    ethernets:
      enp28s0f7:
        addresses:
          - 10.11.12.99/24

在配置文件中，你可以根据实际需求修改上述配置项，以适应你的网络环境。配置完成后，可以通过 Ansible 的 playbook 应用这些配置。

ansible-netplan Ansible role to manage Netplan 项目地址: https://gitcode.com/gh_mirrors/an/ansible-netplan