管理Anseble配置文件

最新推荐文章于 2024-06-06 08:00:00 发布

Lfei5120

最新推荐文章于 2024-06-06 08:00:00 发布

阅读量495

点赞数 3

文章标签： linux

未经允许不得私自转发

本文链接：https://blog.csdn.net/weixin_46812793/article/details/118765675

版权

管理Anseble配置文件

文章目录

1.如何配置Ansible

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

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

第一个配置文件：

	[root@centos8-1 ~]# cd /etc/ansible/
[root@centos8-1 ansible]# ls
ansible.cfg  hosts  roles  shen
[root@centos8-1 ansible]#

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

第二个配置文件：如果家目录里面没有ansible.cfg文件，则使用/etc/ansible/ansible.cfg,这里我们有这个ansible.cfg文件，所以使用这个配置文件。

[root@centos8-1 ansible]# ls -a 
.  ..  ansible.cfg  hosts  roles  shen
[root@centos8-1 ansible]#

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

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

第三个配置文件：当前目录下的配置文件

注：如果家目录没有ansible.cfg,那么默认就是用当前目录下面的ansible.cfg

[root@centos8-1 ~]# cd /opt/
[root@centos8-1 opt]# ls
ansible.cfg  shen

使用ANSIBLE_CONFIG环境变量

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

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

[root@centos8-1 ~]# 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  3 2020, 18:11:24) [GCC 8.4.1 20200928 (Red Hat 8.4.1-1)]
[root@centos8-1 ~]#

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

2.管理配置文件中的设置

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

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

remote_user = abc    //表示要去登录的默认用户


[privilege_escalation]     //这原本之里面的文件注释取消掉 ，文件不用动
become=True
become_method=sudo
become_user=root
become_ask_pass=False


root    ALL=(ALL)       ALL     //然后我们visudo进入里面添加一个用户，并且给他所有权限
shunzichishi    ALL=(ALL)       ALL
abc    ALL=(ALL)       ALL


[root@centos8-1 ansible]# ansible all -m ping   //然后我们ping对面一台主机能ping通。
192.168.100.147 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
[root@centos8-1 ansible]# 


[root@centos8-1 ansible]# ansible all -m command -a "touch shen"   //ping通之后我们给对面的主机创建一个文件。
[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.100.147 | CHANGED | rc=0 >>

[root@centos8-1 ansible]#

注：在这里如果返回的是0，表示正确，返回的是1，表示不正确

[root@localhost ~]# su abc   //然后我们sudo我们刚刚创建的用户，查看有我们刚刚创建的文件：shen
[abc@localhost root]$ cd
[abc@localhost ~]$ 
[abc@localhost ~]$ 
[abc@localhost ~]$ 
[abc@localhost ~]$ ls
shen  shenlongfei
[abc@localhost ~]$

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

Ansible配置

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

3.配置连接

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

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

remote_user = a    //对方创建的用户是a ，在这里我们设置默登录用户为a,vim直接编辑ansible.cfg


[root@localhost ~]# id a    //在第二台主机上是已经创建了这个用户的可以查看到
uid=1000(a) gid=1000(a) 组=1000(a)
[root@localhost ~]# 

[root@centos8-1 ansible]# 
[root@centos8-1 ansible]# ansible all -m ping   //然后我们ping对方主机，能ping通
192.168.100.147 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": false,
    "ping": "pong"
}
[root@centos8-1 ansible]# 


[root@centos8-1 ansible]# ansible all -m command -a "touch sss"   //然后我们给对方主机创建一个sss文件
[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.100.147 | CHANGED | rc=0 >>


[root@localhost ~]# su a    //然后我们发现这里他是以普通用户c创建的一个文件sss，并不是root用户。
[a@localhost root]$ cd
[a@localhost ~]$ ll
总用量 0
-rw-rw-r-- 1 a a 0 7月  15 04:37 sss
[a@localhost ~]$

4.清单的位置

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

[root@centos8-1 ansible]# vim ansible.cfg     //进入配置文件， 然后第一页就是清单的位置
inventory      = /etc/ansible/shen

5.连接设置

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

[root@centos8-1 ansible]# vim ansible.cfg     //进入配置文件， 然后第一页就是清单的位置
inventory      = /etc/ansible/shen

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

[root@centos8-1 ansible]# vim ansible.cfg
remote_user = a

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

[root@centos8-1 ansible]# vim ansible.cfg
inventory      = /etc/ansible/shen
#become_ask_pass=False       //在这里取消这条注释，然后改为true

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

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

6.升级特权

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

[privilege_escalation]    //如需设置需要把前面的注释取消掉
#become=True
#become_method=sudo
#become_user=root
#become_ask_pass=False

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

#become=True
#become_user=root

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

#become_method=sudo

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

#become_ask_pass=False   （true）

7.非SSH连接

默认情况下，Ansible用于连接受管主机的协议设置为smart，它会确定使用SHH的最高效方式。可以通过多种方式将其设置为其他的值。

例如，默认使用SSH的规则有一个例外。如果目录中没有localhost，Ansible将设置一个隐式localhost条目以便允许运行以localhost为目标的临时命令和playbook。这一特殊清单条目不包括在all或ungrouped主机组中。此外，Ansible不使用smart SSH连接类型，而是利用默认的特殊local连接类型来进行连接。

[root@centos8-1 ansible]# ansible localhost --list-hosts
  hosts (1):
    localhost
[root@centos8-1 ansible]# 
[root@centos8-1 ansible]# ansible localhost -m ping
localhost | SUCCESS => {
    "changed": false,
    "ping": "pong"
}
[root@centos8-1 ansible]#

local连接类型忽略remote_user设置，并且直接在本地系统上运行命令。如果使用特权升级，它会在运行sudo时使用运行Ansible命令的用户，而不是remote_user。如果这两个用户具有不同的sudo特权，这可能会导致混淆。

如果你要确保像其他受管主机一样使用SSH连接localhost，一种方法是在清单中列出它。但是，这会将它包含在all和ungrouped组中，而你可能不希望如此。

另一种方法是更改用于连接localhost的协议。执行此操作的最好方法是为localhost设置ansible_connection主机变量。为此，你需要在运行Ansible命令的目录中创建host_vars子目录。在该子目录中，创建名为localhost的文件，其应含有ansible_connection: smart这一行。这将确保对localhost使用smart（SSH)连接协议，而非local。

你也可以通过另一种变通办法来使用它。如果清单中列有127.0.0.1，则默认情况下，将会使用smart来连接它。也可以创建一个含有ansible_connection: local这一行的host_vars/127.0.0.1文件，它会改为使用local。

8.配置文件注释

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

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

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

[privilege_escalation]     //这就是有注释的字段
#become=True
#become_method=sudo
#become_user=root
#become_ask_pass=False

9.临时命令

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

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

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

常用命令;

-m 指定模块

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

-a 指定模块中的命令

-i 指定读取的清单

-o 使输出在同一行

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

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

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

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

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

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

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

[root@centos8-1 ansible]# ansible-doc -l   //列出系统所有模块，后面的模块省略了
a10_server                                                    Manage A10 Networks AX/SoftAX/Thunder/vThunder de...
a10_server_axapi3                                             Manage A10 Networks AX/SoftAX/Thunder/vThunder de...
a10_service_group                                             Manage A10 Networks AX/SoftAX/Thunder/vThunder de...
a10_virtual_server                                            Manage A10 Networks AX/SoftAX/Thunder/vThunder de...
aci_aaa_user                                                  Manage AAA users (aaa:User)                      
aci_aaa_user_certificate                                      Manage AAA user certificates (aaa:UserCert)      
aci_access_port_block_to_access_port                          Manage port blocks of Fabric interface policy lea...
aci_access_port_to_interface_policy_leaf_profile              Manage Fabric interface policy leaf profile inter...

[root@centos8-1 ansible]# ansible-doc ping
> PING    (/usr/lib/python3.6/site-packages/ansible/modules/system/ping.py)

        A trivial test module, this module always returns `pong' on successful contact. It
        does not make sense in playbooks, but it is useful from `/usr/bin/ansible' to verify
        the ability to login and that a usable Python is configured. This is NOT ICMP ping,
        this is just a trivial test module that requires Python on the remote-node. For
        Windows targets, use the [win_ping] module instead. For Network targets, use the
        [net_ping] module instead.

  * This module is maintained by The Ansible Core Team
OPTIONS (= is mandatory):

- data
        Data to return for the `ping' return value.
        If this parameter is set to `crash', the module will cause an exception.

Ansible中常用的模块

模块类别	模块
文件模块	copy：将本地文件复制到受管主机 file：设置文件的权限和其他属性 lineinfile：确保特定行是否在文件中 synchronize：使用rsync同步内容
软件包模块	package：使用操作系统本机的自动检测软件包管理器管理软件包 yum：使用yum管理软件包 apt：使用APT管理软件包 dnf：使用dnf管理软件包 gem：管理Ruby gem pip：从PyPI管理Python软件包
系统模块	firewalld：使用firewalld管理防火墙 reboot：重启计算机 service：管理服务 user：添加、删除和管理用户帐户
Net Tools模块	get_url：通过HTTP、HTTPS或FTP下载文件 nmcli：管理网络 uri：与Web服务交互

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

[root@centos8-1 ansible]# ansible all -m user -a "name=shenl uid=1234  state=present"     //这条命令是在受管主机上创建用户，指定uid
192.168.100.147 | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "comment": "",
    "create_home": true,
    "group": 1234,
    "home": "/home/shenl",
    "name": "shenl",
    "shell": "/bin/bash",
    "state": "present",
    "system": false,
    "uid": 1234
}
[root@centos8-1 ansible]# 
[root@localhost ~]# id shenl    //然后我们在受管主机上查看，已经创建了这个用户
uid=1234(shenl) gid=1234(shenl) 组=1234(shenl)
[root@localhost ~]#

[root@centos8-1 ansible]# ansible all -m user -a "name=shenl uid=1234  state=absent"     //删除受管主机上创建的用户
192.168.100.147 | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    },
    "changed": true,
    "force": false,
    "name": "shenl",
    "remove": false,
    "state": "absent"
}
[root@centos8-1 ansible]#

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

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

[root@centos8-1 ansible]# ansible webservers -m command -a 'mkdir shunzichishi'
[WARNING]: Consider using the file module with state=directory rather than running 'mkdir'.  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.100.147 | CHANGED | rc=0 >>

[root@centos8-1 ansible]#

然后对面的受管主机上查看：

[root@localhost ~]# ls
anaconda-ks.cfg  shunzichishi     //这里查看就有我们创建的shunzichishi

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

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

[root@centos8-1 ansible]# ansible webservers -m command -a 'hostname' -o
192.168.100.147 | CHANGED | rc=0 | (stdout) localhost.localdomain
[root@centos8-1 ansible]#

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

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

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

[root@centos8-1 ansible]# ansible all -m command -a 'set'
192.168.100.147 | FAILED | rc=2 >>
[Errno 2] 没有那个文件或目录: b'set': b'set'
[root@centos8-1 ansible]#

[root@centos8-1 ansible]# ansible webservers -m shell -a 'set'
192.168.100.147 | 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=()

command和shell模块都要求受管主机上安装正常工作的Python。第三个模块是raw，它可以绕过模块子系统，直接使用远程shell运行命令。在管理无法安装Python的系统（如网络路由器）时，可以利用这个模块。它也可以用于将Python安装到主机上。

在大多数情况下，建议避免使用command、shell和raw这三个“运行命令”模块。

其他模块大部分都是幂等的，可以自动进行更改跟踪。它们可以测试系统的状态，在这些系统已处于正确状态时不执行任何操作。相反，以幂等方式使用“运行命令”模块要复杂得多。依靠它们，你更难以确信再次运行临时命令或playbook不会造成意外的失败。当shell或command模块运行时，通常会基于它是否认为影响了计算机状态而报告CHANGED状态。

有时候，“运行命令”模块是有用的工具，也是解决问题的好办法。如果确实需要使用它们，可能最好先尝试用command模块，只有在需要shell或raw模块的特殊功能时才利用它们。

11.配置临时命令的连接

受管主机连接和特权升级的指令可以在Ansible配置文件中配置，也可以使用临时命令中的选项来定义。使用临时命令中的选项定义时，它们将优先于Ansible配置文件中配置的指令。下表显示了与各项配置文件指令类同的命令行选项。

Ansible命令行选项

配置文件指令	命令行选项
inventory	-i
remote_user	-u
become	—become、-b
become_method	–become-method
become_user	–become-user
become_ask_pass	–ask-become-pass、-K

在使用命令行选项配置这些指令前，可以通过查询ansible --help的输出来确定其当前定义的值。

[root@centos8-1 ansible]# ansible --help    //在这里内容很多， 后面省略

Connection Options:
  control as whom and how to connect to hosts

  --private-key PRIVATE_KEY_FILE, --key-file PRIVATE_KEY_FILE
                        use this file to authenticate the connection
  --scp-extra-args SCP_EXTRA_ARGS
                        specify extra arguments to pass to scp only (e.g. -l)
  --sftp-extra-args SFTP_EXTRA_ARGS
                        specify extra arguments to pass to sftp only (e.g. -f,
                        -l)
  --ssh-common-args SSH_COMMON_ARGS
                        specify common arguments to pass to sftp/scp/ssh (e.g.