02. inventory

Ansible 可同时操作属于一个组的多台主机，组和主机之间的关系通过 inventory文件配置。默认的文件路径为 /etc/ansible/hosts。

除默认文件外，你还可以同时使用多个 inventory 文件(后面会讲到)，也可以从动态源，或云上拉取 inventory 配置信息。详见动态 Inventory。

1. 主机与组⚓

mail.example.com

[webservers]
foo.example.com
bar.example.com

[dbservers]
one.example.com
two.example.com
three.example.com

方括号[] 中是组名。一个系统可以属于不同的组，比如一台服务器可以同时属于 webserver组和 dbserver组。这时属于两个组的变量都可以为这台主机所用。

如果有主机的SSH端口不是标准的22端口，可在主机名之后加上端口号，用冒号分隔。

假设你有一些静态IP地址，希望设置一些别名，但不是在系统的 host 文件中设置，又或者你是通过隧道在连接，那么可以设置如下:

jumper ansible_ssh_port=5555 ansible_ssh_host=192.168.1.50

jumper 即主机别名。

简写格式，类似于 linux 中的{1..50}：

[databases]
db-[a:f].example.com

对于每一个 host，你还可以选择连接类型和连接用户名:

[targets]
localhost              ansible_connection=local
other1.example.com     ansible_connection=ssh        ansible_ssh_user=mpdehaan
other2.example.com     ansible_connection=ssh        ansible_ssh_user=mdehaan

2. 主机变量⚓

前面已经提到过，分配变量给主机很容易做到，这些变量定义后可在 playbooks 中使用:

[atlanta]
host1 http_port=80 maxRequestsPerChild=808
host2 http_port=303 maxRequestsPerChild=909

3. 组的变量⚓

也可以定义属于整个组的变量:

[atlanta]
host1
host2

[atlanta:vars]
ntp_server=ntp.atlanta.example.com
proxy=proxy.atlanta.example.com

4. 把一个组作为另一个组的子成员⚓

可以把一个组作为另一个组的子成员，以及分配变量给整个组使用. 这些变量可以给 /usr/bin/ansible-playbook 使用，但不能给 /usr/bin/ansible 使用:

[atlanta]
host1
host2

[raleigh]
host2
host3

[southeast:children]
atlanta
raleigh

[southeast:vars]
some_server=foo.southeast.example.com
halon_system_timeout=30
self_destruct_countdown=60
escape_pods=2

[usa:children]
southeast
northeast

5. 分文件定义 Host 和 Group 变量⚓

不同于 inventory 文件(INI 格式)，这些独立文件的格式为 YAML。详见 YAML 语法。

假设 inventory 文件的路径为：

/etc/ansible/hosts

假设有一个主机名为 foosball，主机同时属于两个组，一个是 raleigh，另一个是 webservers. 那么以下配置文件(YAML 格式)中的变量可以为 foosball 主机所用。依次为 raleigh 的组变量，webservers 的组变量，foosball 的主机变量：

/etc/ansible/group_vars/raleigh
/etc/ansible/group_vars/webservers
/etc/ansible/host_vars/foosball

文件内容类似于这样：

---
ntp_server: acme.example.org
database_server: storage.example.org

还有更进一步的运用，你可以为一个主机，或一个组，创建一个目录，目录名就是主机名或组名。目录中的可以创建多个文件，文件中的变量都会被读取为主机或组的变量。

/etc/ansible/group_vars/raleigh/db_settings
/etc/ansible/group_vars/raleigh/cluster_settings

Ansible 1.2 及以上的版本中，group_vars/ 和 host_vars/ 目录可放在 inventory 目录下，或是 playbook 目录下。如果两个目录下都存在，那么 playbook 目录下的配置会覆盖 inventory 目录的配置。

6. 连接到主机的 Inventory 参数说明⚓

详见：

inventory-parameters：https://docs.ansible.com/ansible/latest/user_guide/intro_inventory.html#connecting-to-hosts-behavioral-inventory-parameters
Vaults：
- https://docs.ansible.com/ansible/latest/user_guide/playbooks_best_practices.html#best-practices-for-variables-and-vaults
- https://docs.ansible.com/ansible/latest/user_guide/vault.html
权限升级：https://docs.ansible.com/ansible/latest/user_guide/become.html#become

ansible_connection
      与主机的连接类型。比如:local，ssh 或者 paramiko。 Ansible 1.2 以前默认使用 paramiko.1.2 以后默认使用 'smart'，'smart' 方式会根据是否支持 ControlPersist， 来判断 'ssh' 方式是否可行。

对所有类型的连接通用的参数：
ansible_host
      将要连接的远程主机名。与你想要设定的主机的别名不同的话，可通过此变量设置。

ansible_port
      ssh端口号。如果不是默认的端口号，通过此变量设置。

ansible_user
      默认的 ssh 用户名

ansible_password
      ssh 密码(这种方式并不安全，强烈建议使用 Vaults 进行加密)

针对 SSH 连接的参数：
ansible_ssh_private_key_file
      ssh 使用的私钥文件。适用于有多个密钥，而你不想使用 SSH 代理的情况。

权限升级参数：
ansible_sudo_password
      sudo 密码(这种方式并不安全，强烈建议使用 Vaults 进行加密)

ansible_sudo_exe (new in version 1.8)
      sudo 命令路径(适用于1.8及以上版本)

远程主机环境变量参数：
ansible_shell_type
      目标系统的shell类型。默认情况下，命令的执行使用 'sh' 语法，可设置为 'csh' 或 'fish'。

ansible_python_interpreter
      目标主机的 python 路径。适用于的情况: 系统中有多个 Python， 或者命令路径不是"/usr/bin/python"，比如  \*BSD， 或者 /usr/bin/python 指向的
      不是 2.X 版本的 Python。我们不使用 "/usr/bin/env" 机制，因为这要求远程用户的路径设置正确，且要求 "python" 可执行程序名不可为 python以外的名字(实际有可能名为python26)。

ansible_*_interpreter
      与 ansible_python_interpreter 的工作方式相同，可设定如 ruby 或 perl 的路径....