Ansible部署

最新推荐文章于 2025-07-09 09:45:19 发布

阿业的学习之路

最新推荐文章于 2025-07-09 09:45:19 发布

阅读量218

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/m0_46516861/article/details/118828891

本文介绍了Ansible的部署过程，包括构建Ansible清单，管理配置文件，详细讲解了静态与动态清单，验证清单的方法，以及如何配置Ansible。还探讨了各种模块的使用，如command、user、copy、file和fetch，帮助理解Ansible在自动化部署中的应用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章目录

- Ansible部署

Ansible部署

1. 构建ansible清单

1.1清单定义

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

可以通过两种方式定义主机清单

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

1.2静态清单

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

默认的清单文件为/etc/Ansible下的hosts文件，而我们一般使用是不会使用这个文件，所以我们需要在修改Ansible的配置文件

[root@localhost ~]# cd /etc/ansible/    #ansible配置文件存放目录
[root@localhost ansible]# vim ansible.cfg   #ansible默认配置文件
# some basic default values...

#inventory      = /etc/ansible/hosts		#这个参数表示资源清单inventory文件的位置
inventory       =inventory					#修改清单文件存放位置
#library        = /usr/share/my_modules/	#指向存放Ansible模块的目录，支持多个目录方式，只要用冒号（：）隔开就可以
#module_utils   = /usr/share/my_module_utils/
#remote_tmp     = ~/.ansible/tmp			#临时文件远程主机存放目录
#local_tmp      = ~/.ansible/tmp			#临时文件本地存放目录
#plugin_filters_cfg = /etc/ansible/plugin_filters.yml
#forks          = 5							#并发连接数，默认为5
#poll_interval  = 15						#轮询间隔时间
#sudo_user      = root						#设置默认执行命令的用户
#ask_sudo_pass = True						
#ask_pass      = True						
#transport      = smart						#通信机制
#remote_port    = 22						#指定连接被管节点的管理端口，默认为22端口，建议修改，能够更加安全
#module_lang    = C							#模块和系统之间通信的语言
#module_set_locale = False					#模块设置区域默认为关闭

[root@localhost ansible]# touch inventory	#默认没有该文件，要自行创建
[root@localhost ansible]# ls
ansible.cfg  hosts  inventory  roles
[root@localhost ansible]# vim inventory 
127.0.0.1						#未添加进组的主机

[webservers]					#创建组，以组来管理
192.168.136.220

1.3 验证清单

列出全部清单

[root@localhost ansible]# ansible all --list-hosts
  hosts (2):
    127.0.0.1
    192.168.136.220

列出指定组的清单

[root@localhost ansible]# ansible webservers --list-hosts
  hosts (1):
    192.168.136.220

列出非组采用清单

[root@localhost ansible]# ansible ungrouped --list-hosts
  hosts (1):
    127.0.0.1

2. 管理Ansible配置文件

2.1 配置Ansible

使用/etc/ansible/ansible.cfg
这是一个全局包，由ansible默认提供，如果找不到其他配置文件，则使用此文件。

使用~/.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) > /etc/ansible/ansible.cfg

3 帮助文档

ansible-doc -l命令可以列出系统上安装的所有模块。可以使用ansible-doc来按照名称查看特定模块的帮助文档，再查找关于模块将取什么参数作为选项的信息

[root@localhost ansible]# ansible-doc -l			#获取全部模块的信息
[root@localhost ansible]# ansible-doc -s MOD_NAME		#获取指定模块的使用帮助
[root@localhost ansible]# ansible-doc 	#列出所有的用法
usage: ansible-doc [-h] [--version] [-v] [-M MODULE_PATH]
                   [--playbook-dir BASEDIR]
                   [-t {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,module,strategy,vars}]
                   [-j] [-F | -l | -s | --metadata-dump]
                   [plugin [plugin ...]]

plugin documentation tool

positional arguments:
  plugin                Plugin

optional arguments:
  --metadata-dump       **For internal testing only** Dump json metadata for
                        all plugins.
  --playbook-dir BASEDIR
                        Since this tool does not use playbooks, use this as a
                        substitute playbook directory.This sets the relative
                        path for many features including roles/ group_vars/
                        etc.
  --version             show program's version number, config file location,
                        configured module search path, module location,
                        executable location and exit
  -F, --list_files      Show plugin names and their source files without
                        summaries (implies --list)
  -M MODULE_PATH, --module-path MODULE_PATH
                        prepend colon-separated path(s) to module library (def
                        ault=~/.ansible/plugins/modules:/usr/share/ansible/plu
                        gins/modules)
  -h, --help            show this help message and exit
  -j, --json            Change output into json format.
  -l, --list            List available plugins
  -s, --snippet         Show playbook snippet for specified plugin(s)
  -t {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,module,strategy,vars}, --type {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,module,strategy,vars}
                        Choose which plugin type (defaults to "module").

4 Ansible模块

command模块

这个模块可以直接在远程主机上执行命令，并将结果返回本主机。

[root@localhost ansible]# ansible all -m command -a 'touch abc'
SSH password: 
[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.136.219 | CHANGED | rc=0 >>
[root@yy ~]# ls
公共  视频  文档  音乐  abc              initial-setup-ks.cfg
模板  图片  下载  桌面  anaconda-ks.cfg
[root@yy ~]#

命令模块接受命令名称，后面是空格分隔的列表参数。给定的命令将在所有选定的节点上执行。它不会通过shell进行处理，比如$HOME和操作如"<"，">"，"|"，";"，"&" 工作（需要使用（shell）模块实现这些功能）。注意，该命令不支持| 管道命令。

user模块

该模块主要是用来管理用户账号。
　　其主要选项如下：

comment //用户的描述信息
createhome //是否创建家目录
force //在使用state=absent时, 行为与userdel –force一致.
group //指定基本组
groups //指定附加组，如果指定为(groups=)表示删除所有组
home //指定用户家目录
move_home //如果设置为home=时, 试图将用户主目录移动到指定的目录
name //指定用户名
non_unique //该选项允许改变非唯一的用户ID值
password //指定用户密码
remove //在使用state=absent时, 行为是与userdel –remove一致
shell //指定默认shell
state //设置帐号状态，不指定为创建，指定值为absent表示删除
system //当创建一个用户，设置这个用户是系统用户。这个设置不能更改现有用户
uid //指定用户的uid

创建用户

[root@localhost ansible]# ansible localhost -m user -a"name=yy state=present comment="就这？""
SSH password: 
localhost | CHANGED => {
    "changed": true, 
    "comment": "就这？", 
    "create_home": true, 
    "group": 1002, 
    "home": "/home/yy", 
    "name": "yy", 
    "shell": "/bin/bash", 
    "state": "present", 
    "system": false, 
    "uid": 1002
}

删除用户

[root@localhost ansible]# ansible localhost -m user -a"name=yy state=absent"
SSH password: 
localhost | CHANGED => {
    "changed": true, 
    "force": false, 
    "name": "yy", 
    "remove": false, 
    "state": "absent"
}
[root@localhost ansible]# id yy
id: yy: no such user

修改用户

[root@localhost ansible]# ansible localhost -m user -a"name=yyy state=present comment="就这啊？" uid=1999"
SSH password: 
localhost | CHANGED => {
    "append": false, 
    "changed": true, 
    "comment": "就这啊？", 
    "group": 1001, 
    "home": "/home/yyy", 
    "move_home": false, 
    "name": "yyy", 
    "shell": "/bin/bash", 
    "state": "present", 
    "uid": 1999
}

copy模块

实现主控端向目标主机拷贝文件
相关选项：

src　　　　#被复制到远程主机的本地文件。可以是绝对路径，也可以是相对路径。如果路径是一个目录，则会递归复制，用法类似于"rsync"
content　　　#用于替换"src"，可以直接指定文件的值
dest　　　　#必选项，将源文件复制到的远程主机的绝对路径
backup　　　#当文件内容发生改变后，在覆盖之前把源文件备份，备份文件包含时间信息
directory_mode　　　　#递归设定目录的权限，默认为系统默认权限
force　　　　#当目标主机包含该文件，但内容不同时，设为"yes"，表示强制覆盖；设为"no"，表示目标主机的目标位置不存在该文件才复制。默认为"yes"
others　　　　#所有的 file 模块中的选项可以在这里使用

用法举例：
复制文件

[root@localhost ansible]# ansible localhost -m copy -a 'src=/root/yy dest=/root'
SSH password: 
localhost | SUCCESS => {
    "changed": false, 
    "checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709", 
    "dest": "/root/yy", 
    "gid": 0, 
    "group": "root", 
    "mode": "0644", 
    "owner": "root", 
    "path": "/root/yy", 
    "secontext": "unconfined_u:object_r:admin_home_t:s0", 
    "size": 0, 
    "state": "file", 
    "uid": 0
}

file模块

该模块主要用于设置文件的属性，比如创建文件、创建链接文件、删除文件等。
　　下面是一些常见的命令：

force　　#需要在两种情况下强制创建软链接，一种是源文件不存在，但之后会建立的情况下；另一种是目标软链接已存在，需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no
group　　#定义文件/目录的属组。后面可以加上mode：定义文件/目录的权限
owner　　#定义文件/目录的属主。后面必须跟上path：定义文件/目录的路径
recurse　　#递归设置文件的属性，只对目录有效，后面跟上src：被链接的源文件路径，只应用于state=link的情况
dest　　#被链接到的路径，只应用于state=link的情况
state　　#状态，有以下选项：
directory：如果目录不存在，就创建目录
file：即使文件不存在，也不会被创建
link：创建软链接
hard：创建硬链接
touch：如果文件不存在，则会创建一个新的文件，如果文件或目录已存在，则更新其最后修改时间
absent：删除目录、文件或者取消链接文件

[root@localhost ansible]# ansible webservers -m file -a 'path=/root/123 state=directory'
SSH password: 
192.168.136.219 | CHANGED => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/libexec/platform-python"
    }, 
    "changed": true, 
    "gid": 0, 
    "group": "root", 
    "mode": "0755", 
    "owner": "root", 
    "path": "/root/123", 
    "size": 6, 
    "state": "directory", 
    "uid": 0
}
[root@localhost ansible]# ansible webservers -m shell -a 'ls /root/123'
SSH password: 
192.168.136.219 | CHANGED | rc=0 >>

fatch模块

该模块用于从远程某主机获取（复制）文件到本地。
　　有两个选项：

dest：用来存放文件的目录
src：在远程拉取的文件，并且必须是一个file，不能是目录

[root@localhost ansible]# ansible webservers -m fetch -a 'src=/root/yy dest=/usr/'
SSH password: 
192.168.136.219 | CHANGED => {
    "changed": true, 
    "checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709", 
    "dest": "/usr/192.168.136.219/root/yy", 
    "md5sum": "d41d8cd98f00b204e9800998ecf8427e", 
    "remote_checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709", 
    "remote_md5sum": null
}
[root@localhost ansible]# cd /usr/
[root@localhost usr]# ls
192.168.136.219  etc    include  lib64    local      sbin   src
bin              games  lib      libexec  localhost  share  tmp
[root@localhost usr]#