Ansible部署

Ansible部署

1. 构建Ansible清单

1.1 定义清单

清单定义Ansible将要管理的一批主机。这些主机也可以分配到组中，以进行集中管理。组可以包含子组，主机也可以是多个组的成员。清单还可以设置应用到它所定义的主机和组的变量。

可以通过两种方式定义主机清单。静态主机清单可以通过文本文件定义。动态主机清单可以根据需要使用外部信息提供程序通过脚本或其他程序来生成。

1.2 静态清单文件

静态清单文件是指定Ansible目标受管主机的文本文件。可以使用多种不同的格式编写此文件，包括INI样式或YAML。
在最简单的形式中。INI样式的静态清单文件是受管主机的主机名或IP地址的列表，每行一个：

alpha.example.org
beta.example.org
192.168.1.100

1.3 默认静态清单的位置

/etc/ansible/hosts文件被视为系统的默认静态清单文件。不过，通常的做法是不使用该文件，而是在Ansible配置文件中为清单文件定义一个不同的位置。

1.4 验证清单文件

列出单个受管主机的清单

[root@syb ansible]# ansible 192.168.200.153 --list-hosts
  hosts (1):
    192.168.200.153

列出组的受管主机清单

[root@syb ansible]# ansible webservers --list-hosts
  hosts (2):
    192.168.200.153
    192.168.200.154

列出所有受管主机的清单

[root@syb ansible]# ansible all --list-hosts
  hosts (3):
    192.168.200.152
    192.168.200.153
    192.168.200.154

列出不属于任何组的受管主机

[root@syb ansible]# ansible ungrouped --list-hosts
  hosts (1):
    192.168.200.152

1.5 自定义清单文件

修改配置文件，更改默认请问文件

[root@syb ansible]# vim ansible.cfg
//找到这行
#inventory      = /etc/ansible/hosts
//修改，然后保持退出
inventory      = /etc/ansible/inventory

创建inventory文件，并写入受管主机

//创建清单文件
[root@syb ansible]# touch inventory
[root@syb ansible]# ls
ansible.cfg  hosts  inventory  roles

//写入受管主机
[root@syb ansible]# vim inventory 
[root@syb ansible]# cat inventory 
192.168.200.152
192.168.200.153

[webservers]
192.168.200.154
192.168.200.155

//指定清单文件位置验证清单
[root@syb ansible]# mv inventory /opt/
[root@syb ansible]# ansible all -i /opt/inventory --list-hosts
  hosts (4):
    192.168.200.152
    192.168.200.153
    192.168.200.154
    192.168.200.155

2. 管理Ansible配置文件

2.1 配置Ansible

可以通过修改 Ansible 配置文件中的设置来自定义 Ansible安装的行为。Ansible从控制节点上多个可能的位置之一选择其配置文件。

使用/etc/ansible/ansible.cfg
ansible软件包提供一个基本的配置文件，它位于**/etc/ansible/ansible.cfg**。如果找不到其他配置文件，则使用此文件。

使用~/.ansible.cfg
Ansible在用户的家目录中查找**.ansible.cfg文件。如果存在此配置文件并且当前工作目录中也没有ansible.cfg文件，则使用此配置取代/etc/ansible/ansible.cfg**。

使用./ansible.cfg
如果执行ansible命令的目录中存在ansible.cfg文件，则使用它，而不使用全局文件或用户的个人文件。这样，管理员可以创建一种目录结构，将不同的环境或项目存储在单独的目录中，并且每个目录包含为独特的一组设置而定制的配置文件。

推荐的做法是在需要运行Ansible命令的目录中创建ansible.cfg文件。此目录中也将包含任何供Ansible项目使用的文件，如清单和playbook。这是用于Ansible配置文件的最常用位置。实践中不常使用**~/.ansible.cfg或/etc/ansible/ansible.cfg**文件

使用ANSIBLE_CONFIG环境变量
我们可以通过将不同的配置文件放在不同的目录中，然后从适当的目录执行Ansible命令，以此利用配置文件。但是，随着配置文件数量的增加，这种方法存在局限性并且难以管理。有一个更加灵活的选项，即通过ANSIBLE_CONFIG环境变量定义配置文件的位置。定义了此变量时，Ansible将使用变量所指定的配置文件，而不用上面提到的任何配置文件。

2.2 配置文件优先级

ANSIBLE_CONFIG环境变量指定的任何文件将覆盖所有其他配置文件。如果没有设置该变量，则接下来检查运行ansible命令的目录中是否有ansible.cfg文件。如果不存在该文件，则检查用户的家目录是否有**.ansible.cfg文件。只有在找不到其他配置文件时，才使用全局/etc/ansible/ansible.cfg文件。如果/etc/ansible/ansible.cfg**配置文件不存在，Ansible包含它使用的默认值。

由于Ansible配置文件可以放入的位置有多种，因此Ansible当前使用哪一个配置文件可能会令人困惑。我们可以运行以下命令来清楚地确认所安装的Ansible版本以及正在使用的配置文件。
ANSIBLE_CONFIG

//查看默认使用的配置文件
[root@syb ansible]# ansible --version
ansible 2.9.23
  config file = /etc/ansible/ansible.cfg
  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3.6/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 3.6.8 (default, Dec  5 2019, 15:45:45) [GCC 8.3.1 20191121 (Red Hat 8.3.1-5)]

//设置环境变量后，查看使用的配置文件
[root@syb ~]# export ANSIBLE_CONFIG=/opt/ansible.cfg 
[root@syb ~]# ansible --version
ansible 2.9.23
  config file = /opt/ansible.cfg
  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3.6/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 3.6.8 (default, Dec  5 2019, 15:45:45) [GCC 8.3.1 20191121 (Red Hat 8.3.1-5)]

//删除/opt目录下的 .ansible.cfg 查看使用的配置文件
[root@syb ~]# cd /opt/
[root@syb opt]# rm -rf ansible.cfg 
[root@syb opt]# ansible --version
ansible 2.9.23
  config file = /etc/ansible/ansible.cfg
  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3.6/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 3.6.8 (default, Dec  5 2019, 15:45:45) [GCC 8.3.1 20191121 (Red Hat 8.3.1-5)]

//在家目录下创建一个.ansible.cfg文件，再次查看
[root@syb ~]# touch .ansible.cfg
[root@syb ~]# ansible --version
ansible 2.9.23
  config file = /root/.ansible.cfg
  configured module search path = ['/root/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3.6/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 3.6.8 (default, Dec  5 2019, 15:45:45) [GCC 8.3.1 20191121 (Red Hat 8.3.1-5)]

Ansible仅使用具有最高优先级的配置文件中的设置。即使存在优先级较低的其他配置文件，其设置也会被忽略，不会与选定配置文件中的设置结合。因此，如果你选择自行创建配置文件来取代全局/etc/ansible/ansible.cfg配置文件，就需要将该文件中所有需要的设置复制到自己的用户级配置文件中。用户组配置文件中未定义的设置将保持设为内置默认值，即使已在全局配置文件中设为某个其他值也是如此。

2.3 管理配置文件中的设置

Ansible配置文件由几个部分组成，每一部分含有以键值对形式定义的设置。部分的标题以中括号括起来。对于基本操作，请使用以下两部分：

[defaults]部分设置Ansible操作的默认值
[privilege_escalation]配置Ansible如何在受管主机上执行特权升级

[defaults]
inventory = ./inventory
remote_user = user
ask_pass = false

[privilege_escalation]
become = true
become_method = sudo
become_user = root
become_ask_pass = false

下表说明了此文件中的指令：
Ansible配置

指令	描述
inventory	指定清单文件的路径
remote_user	要在受管主机上登录的用户名。如果未指定则使用当前用户名
ask_pass	是否提示输入SSH密码。如果使用SSH公钥身份验证则可以是false
become	连接后是否自动在受管主机上切换用户（通常切换为root）
become_method	如何切换用户
become_user	要在受管主机上切换到的用户
become_ask_pass	是否需要为become_method提示输入密码。默认为false

2.4 配置连接

Ansible需要知道如何与其受管主机通信。更改配置文件的一个最常见原因是为了控制Ansible使用什么方法和用户来管理受管主机。需要的一些信息包括：

列出受管主机和主机组的清单的位置
要使用哪一种连接协议来与受管主机通信（默认为SSH），以及是否需要非标准网络端口来连接服务器
要在受管主机上使用哪一远程用户；这可以是root用户或者某一非特权用户
如果远程用户为非特权用户，Ansible需要知道它是否应尝试将特权升级为root以及如何进行升级（例如，通过sudo）
是否提示输入SSH密码或sudo密码以进行登录或获取特权

2.5 配置文件注释

Ansible配置文件允许使用两种注释字符：井号或分号。

位于行开头的#号会注释掉整行。它不能和指令位于同一行中。

分号字符可以注释掉所在行中其右侧的所有内容。它可以和指令位于同一行中，只要该指令在其左侧。

3. 运行临时命令

使用临时命令可以快速执行单个Ansible任务，不需要将它保存下来供以后再次运行。它们是简单的在线操作，无需编写playbook即可运行。

临时命令对快速测试和更改很有用。例如，可以使用临时命令确保一组服务器上的/etc/hosts文件中存在某一特定的行。可以使用另一个临时命令在许多不同的计算机上高效的重启服务，或者确保特定的软件包为最新版本。

临时命令对于通过Ansible快速执行简单的任务非常有用。它们确实也存在局限，而且总体而言，要使用Ansible Playbook来充分发挥Ansible的作用。但在许多情形中，临时命令正是快速执行简单任务所需要的工具。

3.1 运行临时命令

Ansible运行临时命令的语法如下：

ansible host-pattern -m module [-a 'module arguments'] [-i inventory]

host-pattern参数用于指定在其上运行临时命令的受管主机。它可以是清单中的特定受管主机或主机组。也可以用后面的-i选项指定特定的清单而不使用默认清单。

-m选项将Ansible应在目标主机上运行的module名称作为参数。模块是为了实施任务而执行的小程序。一些模块不需要额外的信息，但其他模块需要使用额外的参数来指定其操作详情。-a选项以带引号字符串形式取这些参数的列表。

一种最简单的临时命令使用ping模块。此模块不执行ICMP ping，而是检查能否在受管主机上运行基于Python的模块。例如，以下临时命令确定清单中的所有受管主机能否运行标准的模块：

[root@syb ansible]# ansible all -m ping
192.168.200.153 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}

3.2 帮助文档的使用

过滤user模块

[root@syb ~]# ansible-doc -l | grep user
aci_aaa_user                                                  Manage AAA
 us...
aci_aaa_user_certificate                                      Manage AAA
 us...
avi_cloudconnectoruser                                        Module for
 se...
avi_user                                                      Avi User M
odu...
avi_useraccount                                               Avi UserAc
cou...
avi_useraccountprofile                                        Module for

3.3 模块的使用

user模块

//创建用户
[root@syb ansible]# ansible all -m user -a 'name=syb uid=2001 state=present'
192.168.200.153 | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "comment": "",
    "create_home": true,
    "group": 2001,
    "home": "/home/syb",
    "name": "syb",
    "shell": "/bin/bash",
    "state": "present",
    "system": false,
    "uid": 2001
}
//查看是否有用户
[root@syb ~]# id syb
uid=2001(syb) gid=2001(syb) 组=2001(syb)

//修改uid
[root@syb ansible]# ansible all -m user -a 'name=syb uid=2002 state=present'
192.168.200.153 | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "append": false,
    "changed": true,
    "comment": "",
    "group": 2001,
    "home": "/home/syb",
    "move_home": false,
    "name": "syb",
    "shell": "/bin/bash",
    "state": "present",
    "uid": 2002
}
//查看是否更改
[root@syb ~]# id syb
uid=2002(syb) gid=2001(syb) 组=2001(syb)

//删除用户
[root@syb ansible]# ansible all -m user -a 'name=syb uid=2002 state=absent'
192.168.200.153 | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "force": false,
    "name": "syb",
    "remove": false,
    "state": "absent"
}
//查看是否删除
[root@syb ~]# id syb
id: “syb”：无此用户

command模块

//创建一个叫syb的文件
[root@syb ansible]# ansible all -m command -a 'touch syb'
[WARNING]: Consider using the file module with state=touch rather than running
'touch'.  If you need to use command because file is insufficient you can add
'warn: false' to this command task or set 'command_warnings=False' in
ansible.cfg to get rid of this message.
192.168.200.153 | CHANGED | rc=0 >>
//在受管主机上查看效果
[root@syb ~]# rm -rf syb 
[root@syb ~]# ls
anaconda-ks.cfg
[root@syb ~]# ls
anaconda-ks.cfg  syb

//查看目录内容
[root@syb ansible]# ansible all -m command -a 'ls /etc'
192.168.200.153 | CHANGED | rc=0 >>
adjtime
aliases
alternatives
anacrontab
audit
authselect
bash_completion.d
bashrc
bindresvport.blacklist
binfmt.d
chkconfig.d
cifs-utils
cron.d
cron.daily