API Guide

清单文件包含要运行命令的主机的列表。Ansible 可以同时在多个主机上运行任务。
Ansible 行动手册将 /etc/ansible/hosts 用作默认的清单文件。要指定不同的清单文件，请在运行 Ansible 行动手册时使用 -i
filepath 命令作为选项。
Ansible 行动手册文件
使用行动手册，Ansible 可以配置多个设备。行动手册是以 YAML 格式表示的人工可读脚本。Ansible 行动手册将清单和行动手册文件
作为参数进行操作，并将清单文件中的主机组映射到行动手册文件中列出的任务。
Ansible 变量
在 Ansible 中，变量定义交换机配置。许多 Dell EMC 交换机都具有通用配置。通用配置变量存储在 vars/main.yaml 文件中；例
如，dns_server 和 ntp_server。所有特定于主机的配置均存储在 host_vars/host_name.yaml 配置文件中；例如，交换机
的主机名称。变量还用作行动手册定义、命令行参数和清单定义的一部分。
Identifier GUID-5784C897-FB46-48AC-BF45-037643C69D7A
Version 2
Status Translation approved
示例：使用 Ansible 配置 OS10 交换机
OS10 支持 Ansible 集成，以自动执行交换机配置。有关如何使用 Ansible 脚本和创建 Ansible 行动手册的详细信息，请转至：
• Dell EMC Ansible 文档
• Dell EMC Networking 指南并搜索 Ansible
您可以从 Dell EMC Fabric Design Center 为您提供的网络设计下载自动生成的 Ansible 配置文件。
准备工作
在使用 Ansible 配置 OS10 交换机之前，请在您的交换机上配置基本网络设置，例如为管理接口分配 IP 地址和默认网关：
1. 使用串行线缆将终端仿真程序连接到交换机上的控制台串行端口。串行端口设置为 115200、8 数据位和无奇偶校验。
2. 配置管理接口；例如：
OS10(config)# interface mgmt 1/1/1
OS10(conf-if-ma-1/1/1)# no ip address dhcp
OS10(conf-if-ma-1/1/1)# ip address 10.1.1.10/24
OS10(conf-if-ma-1/1/1)# no shutdown
OS10(conf-if-ma-1/1/1)# exit
OS10(config)# management route 10.10.20.0/24 10.1.1.1
OS10(config)# end
Ansible 配置示例
在此示例中，配置使用 Ansible 角色从 Ansible 控制器节点配置 OS10 交换机，并使用：
• 用户名和密码
• NTP 服务器
• 系统日志服务器
1. 在控制器节点上安装 Ansible。您可以在 Ansible 安装指南页面找到最新版本的 Ansible。
您可以从安装了 Python 2 （版本 2.7）或 Python 3（版本 3.5 或更高版本）的任何设备运行 Ansible，包括 Red Hat、Debian、
Ubuntu、CentOS、OS X、任何 BSD 等。
在此示例中，Ansible 2.7.12 安装在 Ubuntu 16.04 虚拟机上。要在控制器节点上配置个人软件包归档 (PPA) 存储库并安装 Ansible，
请运行以下命令：
sudo apt-get update
sudo apt-get install software-properties-common
sudo apt-add-repository --yes --update ppa:ansible/ansible
sudo apt-get install ansible
安装 Ansible 后，通过输入以下命令验证版本：
$ ansible --version
106 OS10 调配