部署Ansible

部署Ansible

---

构建Ansible清单

定义清单

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

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

使用静态清单指定受管主机

静态清单文件是指定Ansible目标受管主机的文本文件。可以使用多种不同的格式编写此文件，包括INI样式或YAML。

在最简单的形式中。INI样式的静态清单文件是受管主机的主机名或IP地址的列表，每行一个：

alpha.example.org
beta.example.org
192.168.1.100
1
2
3

但通常而言，可以将受管主机组织为主机组。通过主机组，可以更加有效的对一系列系统运行Ansible。这时，每一部分的开头为以中括号括起来的主机组名称。其后为该组中每一受管主机的主机名或IP地址，每行一个。

[root@hostname ~]# cat /etc/ansible/hosts
## [webservers]
## alpha.example.org
## beta.example.org
## 192.168.1.100
## 192.168.1.110

## www[001:006].example.com

## [dbservers]
##
## db01.intranet.mydomain.net
## db02.intranet.mydomain.net
## 10.25.1.56
## 10.25.1.57


## db-[99:101]-node.example.com
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

验证清单

若有疑问，可使用 ansible 命令验证计算机是否存在于清单中：

[root@hostname ~]# ansible db-99-node.example.com --list-hosts
  hosts (1):
    db-99-node.example.com

[root@hostname ~]# ansible db-99-node.example.com --list-hosts
[WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit
localhost does not match 'all'
[WARNING]: Could not match supplied host pattern, ignoring: db-99-node.example.com
  hosts (0):
1
2
3
4
5
6
7
8
9

运行以下命令来列出指定组中的所有主机：

[root@localhost ~]# ansible webservers --list-hosts
  hosts (2):
    alpha.example.org
    beta.example.org
    192.168.1.100
1
2
3
4
5

覆盖清单的位置

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

构建Ansible清单

修改默认清单文件/etc/ansible/hosts添加以下内容：

172.16.103.129

[webservers]
172.16.103.130

172.16.103.131
1
2
3
4
5
6

Ansible配置文件

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

ansible的配置文件名为ansible.cfg，默认会在四个地方（根据高/低优先级排序——从1到4）：

1.ANSIBLE_CONFIG：Ansible命令会优先检查该环境变量以及这个环境变量指向的配置文件
Export 环境变量：设置环境变量
Unset 环境变量： 取消环境变量

2…/ansible.cfg：当前工作目录，即当前执行ansible指令的目录，如果ANSIBEL_CONFIG环境变量（上一优先级配置文件）未定义，则优先使用该配置文件

3.~/.ansible.cfg：用户家目录下的隐藏文件，若当前工作目录下不存在ansible.cfg配置文件（上一优先级目录中的文件），则会查找用户家目录下的该隐藏文件

4./etc/ansible/ansible.cfg：默认配置文件，如果上面两个路径下的ansible.cfg都不存在，则使用该文件

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

[root@hostname ~]# ansible --version
ansible 2.9.27
  config file = /etc/ansible/ansible.cfg
......
1
2
3
4

管理配置文件中的设置

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

[defaults]部分设置Ansible操作的默认值
[privilege_escalation]配置Ansible如何在受管主机上执行特权升级
例如，下面是典型的ansible.cfg文件：

[defaults]
inventory = ./inventory
remote_user = user
ask_pass = true
 
[privilege_escalation]
become = true
become_method = sudo
become_user = root
become_ask_pass = false
1
2
3
4
5
6
7
8
9
10

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

配置连接

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

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

清单位置

在[defaults]部分中，inventory指令可以直接指向某一静态清单文件，或者指向含有多个静态清单文件和动态清单脚本的某一目录。

[defaults]
inventory = ./inventory
1
2

连接设置

默认情况下，Ansible使用SSH协议连接受管主机。控制Ansible如何连接受管主机的最重要参数在[defaults]部分中设置。

默认情况下，Ansible尝试连接受管主机时使用的用户名与运行ansible命令的本地用户相同。若要指定不同的远程用户，请将remote_user参数设置为该用户名。

如果为运行Ansible的本地用户配置了SSH私钥，使得它们能够在受管主机上进行远程用户的身份验证，则Ansible将自动登录。如果不是这种情况，可以通过设置指令ask_pass = true，将Ansible配置为提示本地用户输入由远程用户使用的密码。

[defaults]
inventory = ./inventory
 
remote_user = root
ask_pass = true
1
2
3
4
5

假设在使用一个Linux控制节点，并对受管主机使用OpenSSH，如果可以使用密码以远程用户身份登录，那么我们可以设置基于SSH密钥的身份验证，从而能够设置ask_pass = false。

第一步是确保在~/.ssh中为控制节点上的用户配置了SSH密钥对。并且使用ssh-copy-id命令将本地的公钥复制到受管主机中。

[root@hostname ~]# ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:872Zo1oemjmsmPfXb9FYSZjvYTjHN0O7CFzwOI8Htds root@hostname
The key's randomart image is:
+---[RSA 3072]----+
|           ...o  |
|            ++.o |
|          .+.o* o|
|           o=oo@o|
|        S  ..+*E*|
|         o ...oo.|
|       .  +..  . |
|     o. o*..o+.  |
|    o..o*+o.++.  |
+----[SHA256]-----+
[root@hostname ~]# ssh-copy-id -i ./.ssh/id_rsa.pub root@192.168.188.129
/usr/bin/ssh-copy-id: INFO: Source of key(s) to be installed: "./.ssh/id_rsa.pub"
The authenticity of host '192.168.188.129 (192.168.188.129)' can't be established.
ECDSA key fingerprint is SHA256:dmw4AHSko4CJJMsbxuSvNIRXC7lpzao5Vuy+yOGplAw.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys
root@192.168.188.129's password:

Number of key(s) added: 1

Now try logging into the machine, with:   "ssh 'root@192.168.188.129'"
and check to make sure that only the key(s) you wanted were added.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

升级特权

鉴于安全性和审计原因，Ansible可能需要先以非特权用户身份连接远程主机，然后再通过特权升级获得root用户身份的管理权限。这可以在Ansible配置文件的[privilege_escalation]部分中设置。

要默认启用特权升级，可以在配置文件中设置指令become = true。即使默认为该设置，也可以在运行临时命令或Ansible Playbook时通过各种方式覆盖它。（例如，有时候可能要运行一些不需要特权升级的任务或play。）

become_method指令指定如何升级特权。有多个选项可用，但默认为使用sudo。类似地，become_user指令指定要升级到的用户，但默认为root。

如果所选的become_method机制要求用户输入密码才能升级特权，可以在配置文件中设置become_ask_pass = true指令。

以下示例ansible.cfg文件假设你可以通过基于SSH密钥的身份验证以someuser用户身份连接受管主机，并且someuser可以使用sudo以root用户身份运行命令而不必输入密码：

[defaults]
inventory = ./inventory
remote_user = someuser
ask_pass = false
 
[privilege_escalation]
become = true
become_method = sudo
become_user = root
become_ask_pass = false
1
2
3
4
5
6
7
8
9
10

配置文件注释

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

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

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

构建清单

定义清单

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

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

使用静态清单指定受管主机

静态清单文件是指定Ansible目标受管主机的文本文件。可以使用多种不同的格式编写此文件，包括INI样式或YAML。

在最简单的形式中。INI样式的静态清单文件是受管主机的主机名或IP地址的列表，每行一个：

192.168.188.129
alpha.example.org
1
2

但通常而言，可以将受管主机组织为主机组。通过主机组，可以更加有效的对一系列系统运行Ansible。这时，每一部分的开头为以中括号括起来的主机组名称。其后为该组中每一受管主机的主机名或IP地址，每行一个。

[webservers]
alpha.example.org
192.168.1.[128:130]  //这里表示从192.168.188.128到192.168.188.130所有的ip

 [dbservers]
db01.intranet.mydomain.net
db02.intranet.mydomain.net
10.25.1.56
1
2
3
4
5
6
7
8

验证清单

若有疑问，可使用 ansible 命令验证计算机是否存在于清单中：

[root@hostname ~]# ansible alpha.example.org --list-hosts
  hosts (1):
    alpha.example.org

[root@hostname ~]# ansible alpha.eeeeexample.org --list-hosts
[WARNING]: Could not match supplied host pattern, ignoring: alpha.eeeeexample.org
[WARNING]: No hosts matched, nothing to do
  hosts (0):
1
2
3
4
5
6
7
8

运行以下命令来列出指定组中的所有主机：

[root@hostname ~]# ansible all --list-hosts
  hosts (8):
    alpha.example.org
    192.168.1.128
    192.168.1.129
    192.168.1.130
    db01.intranet.mydomain.net
    db02.intranet.mydomain.net
    10.25.1.56
1
2
3
4
5
6
7
8
9

如果清单中含有名称相同的主机和主机组，ansible 命令将显示警告并以主机作为其目标。主机组则被忽略。

应对这种情况的方法有多种，其中最简单的是确保主机组不使用与清单中主机相同的名称。

示例

当需要创建新的项目时

[root@hostname ~]# mkdir /opt/project
[root@hostname ~]# cd /opt/project/
[root@hostname project]# vim ansible.cfg
[defaults]

inventory     = ./inventory     //设置好清单文件位置

[root@hostname project]# vim inventory
192.168.188.123  //server外的是不受管主机
[webserver]
www.baidu.com
192.168.131.[1:3]

[dbserver]
192.168.188.129  ansible_user=root ansible_password=1 //当不传输ssh秘钥使，可以使用账户密码登录

#先查看一下生效的配置文件
[root@hostname project]# ansible --version
ansible 2.9.27
  config file = /opt/project/ansible.cfg
......

#使用以下命令列出默认清单文件中的所有受管主机：
[root@hostname project]# ansible all --list-hosts
  hosts (6):
    192.168.188.123
    www.baidu.com
    192.168.131.1
    192.168.131.2
    192.168.131.3
    192.168.188.129

#使用以下命令列出不属于任何组的受管主机：
[root@hostname project]# ansible ungrouped --list-hosts
  hosts (1):
    192.168.188.123

#使用以下命令列出属于某组的受管主机：
[root@hostname project]# ansible webserver --list-hosts
  hosts (4):
    www.baidu.com
    192.168.131.1
    192.168.131.2
    192.168.131.3
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

当然如果你另写了一个清单，并且想在不修改配置文件下，使用该清单，可以使用"-i"参数
如：

[root@hostname project]# echo 192.168.188.138 > hosts
[root@hostname project]# cat hosts
192.168.188.138
[root@hostname project]# ansible -i hosts all --list-hosts
  hosts (1):
    192.168.188.138
1
2
3
4
5
6

运行临时命令

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

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

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

ansible命令参数自动补全

ansible 2.9版本开始，支持命令的选项补全功能，该功能依赖于python的argcomplete插件，下面来安装python-argcomplete。

[root@hostname ~]# yum -y install python3-argcomplete #安装python-argcomplete,centos8之前是python-argcomplete
[root@hostname ~]# bash -version #要求bash版本大于或等于'4.2'
[root@hostname ~]# activate-global-python-argcomplete
[root@hostname ~]# bash
1
2
3
4

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

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

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

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

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

[root@hostname project]# ansible dbserver -m ping
192.168.188.129 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
1
2
3
4
5
6
7
8

使用临时命令通过模块来执行任务

模块是临时命令用于完成任务的工具。Ansible提供了数百个能够完成不同任务的模块。通常我们可以查找一个经过测试的专用模块，作为标准安装的一部分来完成所需的任务。

ansible-doc -l命令可以列出系统上安装的所有模块。可以使用ansible-doc来按照名称查看特定模块的帮助文档，再查找关于模块将取什么参数作为选项的信息。例如以下命令显示ping模块的帮助文档，在帮助文档里面输入q命令表示退出：

[root@hostname project]# ansible-doc ping
1

Ansible常用模块

👉更多的模块信息

大部分模块会取用参数。可在模块的文档中找到可用于该模块的参数列表。临时命令可以通过-a选项向模块传递参数。无需参数时，可从临时命令中省略-a选项。如果需要指定多个参数，请以引号括起的空格分隔列表形式提供。

例如，以下临时命令使用user模块来确保runtime用户存在于192.168.188.129上并且其UID为2000：

[root@hostname project]# ansible 192.168.188.129 -m user -a 'name=runtime uid=2000 state=present'
192.168.188.129 | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "comment": "",
    "create_home": true,
    "group": 2000,
    "home": "/home/runtime",
    "name": "runtime",
    "shell": "/bin/bash",
    "state": "present",
    "system": false,
    "uid": 2000
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

大多数模块为idempotent，这表示它们可以安全地多次运行；如果系统已处于正确的状态，它们不会进行任何操作。

在受管主机上运行任意命令

command模块允许管理员在受管主机的命令行中运行任意命令。要运行的命令通过-a选项指定为该模块的参数。例如，以下命令将对192.168.188.129受管主机运行date命令：

[root@hostname project]# ansible 192.168.188.129 -a 'date'
192.168.188.129 | CHANGED | rc=0 >>
Thu Oct 20 20:24:47 CST 2022
1
2
3

这条命令为每个受管主机返回两行输出。第一行是状态报告，显示对其运行临时操作的受管主机名称及操作的结果。第二行是使用Ansible command模块远程执行的命令的输出。

若要改善临时命令输出的可读性和解析，管理员可能会发现使对受管主机执行的每一项操作具有单行输出十分有用。使用-o选项以单行格式显示Ansible临时命令的输出。

[root@hostname project]# ansible 192.168.188.129 -a 'date' -o
192.168.188.129 | CHANGED | rc=0 | (stdout) Thu Oct 20 20:25:40 CST 2022
1
2

command模块允许管理员对受管主机快速执行远程命令。这些命令不是由受管主机上的shell加以处理。因此，它们无法访问shell环境变量，也不能执行重定向和管道等shell操作。

在命令需要shell处理的情形中，管理员可以使用shell模块。与command模块类似，可以在临时命令中将要执行的命令作为参数传递给该模块。Ansible随后对受管主机远程执行该命令。与command模块不同的是，这些命令将通过受管主机上的shell进行处理。因此，可以访问shell环境变量，也可以使用重定向和管道等操作。

以下示例演示了command与shell的区别。如果尝试使用这两个模块执行内建的Bash命令set，只有使用shell模块才会成功：

[root@hostname project]# ansible 192.168.188.129 -a 'set'
192.168.188.129 | FAILED | rc=2 >>
[Errno 2] No such file or directory: b'set': b'set'

[root@hostname project]# ansible 192.168.188.129 -m shell -a 'set'
192.168.188.129 | CHANGED | rc=0 >>
BASH=/bin/sh
BASHOPTS=cmdhist:complete_fullquote:extquote:force_fignore:hostcomplete:interactive_comments:progcomp:promptvars:sourcepath
BASH_ALIASES=()
BASH_ARGC=()
BASH_ARGV=()
BASH_CMDS=()
......
1
2
3
4
5
6
7
8
9
10
11
12
13