目录
Ansible介绍
-
Ansible是一个基于 Python开发 的配置管理和应用部署工具,现在也在自动化管理领域大放异彩。它融合了众多老牌运维工具的优点,Pubbet和Saltstack能实现的功能,Ansible基本上都可以实现。
-
Ansible能批量配置、部署、管理上千台主机。比如以前需要切换到每个主机上执行的一或多个操作,使用Ansible只需在固定的一台Ansible控制节点上去完成所有主机的操作。
-
Ansible是 基于模块工作 的,它只是提供了一种运行框架,它本身没有完成任务的能力,真正执行操作的是Ansible的模块 ,比如copy模块用于拷贝文件到远程主机上,service模块用于管理服务的启动、停止、重启等。
Ansible的特性和原理
-
Ansible其中一个比较鲜明的特性是Agentless ,即无Agent的存在,它就像普通命令一样,并非C/S软件,也只需在某个作为控制节点的主机上安装一次Ansible即可, 通常它基于ssh连接 来控制远程主机,远程主机上不需要安装Ansible或其它额外的服务。
-
使用者在使用时,在服务器终端输入命令或者playbooks,会通过预定好的规则将playbook拆解为play,再组织成ansible可以识别的任务调用模块和插件,根据主机清单通过SSH将临时文件发给远程的客户端执行并返回结果,执行结束后自动删除。
-
Ansible的另一个比较鲜明的特性是它的绝大多数模块都具备幂等性(idempotence)。所谓幂等性,指的是多次操作或多次执行对系统资源的影响是一致的。 比如执行systemctl stop xxx 命令来停止服务,当发现要停止的目标服务已经处于停止状态,它什么也不会做,所以多次停止的结果仍然是停止,不会改变结果,它是幂等的,而systemctl restart xxx是非幂等的。
-
Ansible的很多模块在执行时都会先判断目标节点是否要执行任务,所以,可以放心大胆地让Ansible去执行任务,重复执行某个任务绝大多数时候不会产生任何副作用。
ansible 环境安装部署
管理端: 192.168.6.88 ansible
被管理端:192.168.6.87
被管理端:192.168.6.86
管理端安装 ansible
先安装 epel 源
再安装ansible工具
ansible的目录结构
配置主机清单
cd /etc/ansible
vim hosts
[webservers]: 是一个组名,用于标识一组被管理的主机。
192.168.6.87: 是一个被管理的主机的IP地址或主机名
如果你使用主机名而不是IP地址,你需要先在/etc/hosts文件中进行相应的配置。
[dbservers]: 另一个组名,用于标识另一组被管理的主机。
192.168.41.33: 另一个被管理的主机的IP地址或主机名
配置密钥对验证
ssh-keygen -t rsa #一路回车,使用免密登录
完成上述步骤后,可以进行以下测试:
在管理端执行Ansible命令,例如:
ansible webservers -m ping
这将向名为webservers的组中的所有主机发送ping模块命令,以检查与这些主机的连接是否正常。
如果连接正常,可以尝试执行其他Ansible命令
ansible webservers -m command -a "uptime"
这将在webservers组中的所有主机上执行uptime命令,并返回结果。
通过执行这些测试,可以验证Ansible的配置是否成功,并且可以与被管理的主机进行通信和执行命令。
ansible 命令行模块
命令格式:ansible <组名> -m <模块> -a <参数列表>
ansible-doc -l 列出所有已安装的模块,按q退出
command 模块
在远程主机执行命令,不支持管道,重定向等shell的特性。
ansible-doc -s command -s 列出指定模块的描述信息和操作动作
ansible 192.168.6.87 -m command -a 'date' 指定 ip 执行 date
ansible webservers -m command -a 'date' 指定组执行 date
ansible all -m command -a 'date' all 代表所有 hosts 主机
ansible all -a 'ls /' 如省略 -m 模块,则默认运行 command 模块
command模块常用参数
- free_form:要在远程主机上执行的命令。可以是一个字符串或一个列表。
- chdir:在执行命令之前切换到的目录。
- creates:如果指定的文件或目录已经存在,则命令不会执行。
- removes:如果指定的文件或目录不存在,则命令不会执行。
- executable:指定要使用的可执行程序。
- warn:是否在命令执行失败时发出警告,默认为yes。
- stdin:将标准输入传递给命令的内容。
- stdin_add_newline:在传递标准输入时是否添加换行符,默认为yes。
- strip_empty_ends:是否去除输出结果中的空行,默认为yes。
- cmd_timeout:命令执行的超时时间,以秒为单位。
- argv:要传递给命令的参数列表。
ansible all -m command -a "chdir=/home ls ./"
shell 模块
相当于调用远程主机的shell进程,然后在该shell下打开一个子shell运行命令(支持管道符号等功能)
-
可以使用
ansible-doc -s shell
命令查看shell
模块的描述信息和操作动作。
ansible-doc -s shell
shell模块常用参数
- cmd:要在远程主机上执行的Shell命令或脚本。
- stdin:将标准输入传递给Shell命令或脚本。
- executable:指定要使用的Shell解释器,默认为/bin/sh。
- chdir:在执行命令或脚本之前切换到指定的工作目录。
- creates:如果指定的文件或目录已存在,则不执行命令。
- removes:如果指定的文件或目录不存在,则不执行命令。
- warn:控制是否在命令执行失败时发出警告,默认为true。
- timeout:指定命令执行的超时时间,单位为秒。
- stdinaddnewline:在传递标准输入时,是否自动添加换行符,默认为true。
- warn:控制是否在命令执行失败时发出警告,默认为true。
在远程主机上设置密码:
ansible dbservers -m shell -a 'echo 123456 | passwd --stdin test'
将密码 123456 通过管道传递给 passwd 命令的 --stdin 选项,并将密码设置给用户名为 test 的用户。
获取网络接口的 IP 地址:
ansible dbservers -m shell -a 'echo $(ifconfig ens33 | awk "NR==2 {print $2}") | cut -d " " -f2'
通过 ifconfig 命令获取网络接口 ens33 的信息,然后使用 awk 命令提取第二行的第二个字段(IP 地址),再通过管道传递给 cut 命令,使用空格作为分隔符提取第二个字段(即 IP 地址)。
获取网络接口的 IP 地址(使用转义符号):
ansible dbservers -m shell -a 'echo $(ifconfig ens33 | awk "NR==2 {print \$2}")'
这个命令与前一个命令类似,只是在 awk 命令中使用了转义符号 \ 来转义 $2,以防止在 Ansible 命令中被解析为变量。
上述示例, 通过 -m shell 参数指定要使用的模块为 shell。使用 -a 参数后面跟随要执行的命令。
注意:使用 shell 模块时,要谨慎考虑安全性和潜在的风险。
cron 模块
在远程主机定义任务计划。其中有两种状态(state):
present表示添加(可以省略),absent表示移除。
ansible-doc -s cron 按 q 退出
常用的参数:
- minute/hour/day/month/weekday:分/时/日/月/周
- job:任务计划要执行的命令
- name:任务计划的名称
例:
ansible webservers -m cron -a 'minute="*/1" job="/bin/echo helloworld" name="test crontab"'
使用Ansible的cron模块在名为webservers的主机上创建一个计划任务。计划任务的执行时间是每分钟一次,执行的命令是/bin/echo helloworld,并且给这个计划任务取名为test crontab。
ansible webservers -m cron -a 'name="test crontab" state=absent'
使用Ansible的cron
模块在名为webservers
的主机上移除一个名为test crontab
的计划任务。state=absent
参数表示移除该计划任务。
假如该计划任务没有取名字,name=None即可
user 模块
查看 user
模块的摘要信息
ansible-doc -s user
常用的参数:
- name:用户名,必选参数
- state=present|absent:创建账号或者删除账号,present表示创建,absent表示删除
- system=yes|no:是否为系统账号
- uid:用户uid
- group:用户基本组
- shell:默认使用的shell
- move_home=yse|no:如果设置的家目录已经存在,是否将已经存在的家目录进行移动
- password:用户的密码,建议使用加密后的字符串
- comment:用户的注释信息
- remove=yes|no:当state=absent时,是否删除用户的家目录
ansible dbservers -m user -a 'name="test01"' 创建用户test01
ansible dbservers -m command -a 'tail /etc/passwd'
ansible dbservers -m user -a 'name="test01" state=absent' 删除用户test01
group 模块
用户组管理的模块
ansible-doc -s group
常用参数
- name(必需):指定要操作的组名称。
- state:指定组的状态,可选值为 present(存在)和 absent(不存在),默认为 present。如果设置为 absent,表示删除该组。
- gid:指定组的 GID(组标识符)。
- system:指定创建的组是否为系统组,默认为 false。如果设置为 true,表示创建的组为系统组。
- append:在用户已经存在于其他组的情况下,将用户添加到指定组中,默认为 false。如果设置为 true,表示将用户添加到指定组中。
- local:在本地主机上执行操作,而不是远程主机,默认为 false。如果设置为 true,表示在本地主机上执行操作。
- non_unique:允许创建具有非唯一 GID 的组,默认为 false。如果设置为 true,表示允许创建非唯一 GID 的组。
- state 和 gid 参数不能同时使用。
例
ansible dbservers -m group -a 'name=mysql gid=306 system=yes'
创建了一个名为 "mysql" 的用户组。name
参数指定了组名为 "mysql",gid
参数指定了组标识符为 360,system
参数指定了该组为系统组
查看了验证 "mysql" 组是否成功创建
ansible dbservers -m user -a 'name=test01 uid=306 system=yes group=mysql'
将test01用户添加到mysql组中
ansible dbservers -a 'tail /etc/passwd' 查看
ansible dbservers -a 'id test01'
copy 模块
用于复制指定主机文件到远程主机的
ansible-doc -s copy
常用的参数:
- dest:指出复制文件的目标及位置,使用绝对路径,如果是源目录,指目标也要是目录,如果目标文件已经存在会覆盖原有的内容
- src:指出源文件的路径,可以使用相对路径或绝对路径,支持直接指定目录,如果源是目录则目标也要是目录
- mode:指出复制时,目标文件的权限
- owner:指出复制时,目标文件的属主
- group:指出复制时,目标文件的属组
- content:指出复制到目标主机上的内容,不能与src一起使用
例
ansible dbservers -m copy -a 'src=/etc/fstab dest=/opt/fstab.bak owner=root mode=640'
使用 copy 模块将 "/etc/fstab" 文件复制到 "dbservers" 主机组中的 "/opt/fstab.bak" 文件中
src 参数指定了源文件路径为 "/etc/fstab" dest 参数指定了目标文件路径为 "/opt/fstab.bak"
owner 参数指定了目标文件的所有者为 "root" mode 参数指定了目标文件的权限模式为 640
ansible dbservers -a 'ls -l /opt'
使用 ls -l
命令查看了 "dbservers" 主机组中 "/opt" 目录的内容,以验证 "/opt/fstab.bak" 文件是否成功创建。
ansible dbservers -a 'cat /opt/fstab.bak'
使用 cat
命令显示了 "dbservers" 主机组中 "/opt/fstab.bak" 文件的内容
ansible dbservers -m copy -a 'content="helloworld" dest=/opt/hello.txt'
使用 copy 模块将字符串 "helloworld" 写入到 "dbservers" 主机组中的 "/opt/hello.txt" 文件中。content 参数指定了要写入的内容 dest 参数指定了目标文件路径为 "/opt/hello.txt"。
ansible dbservers -a 'cat /opt/hello.txt'
使用 cat 命令显示了 "dbservers" 主机组中 "/opt/hello.txt" 文件的内容
file 模块
设置文件属性,用来创建、删除、修改文件和目录的权限、所有权和时间戳等
查看file模块 ansible-doc -s file
常用参数
- path: 指定文件或目录的路径。
- state: 指定文件或目录的状态,可以是absent(不存在)、directory(目录)、file(文件)、hard(硬链接)、link(符号链接)、touch(创建文件)等。
- owner: 指定文件或目录的所有者。
- group: 指定文件或目录的所属组。
- mode: 指定文件或目录的权限,可以使用八进制或符号表示法,例如0644或u+rwx,g+rw,o+r。
- src: 用于创建链接文件时指定源文件的路径。
- follow: 指定是否跟随符号链接,默认为yes,即跟随链接。
- recurse: 指定是否递归处理目录,默认为no,即不递归处理。
- recurse_attributes: 指定是否递归处理目录的属性,默认为no。
- recurse_file_type: 指定递归处理目录时的文件类型,默认为file,可以是file、directory或link。
- recurse_mode: 指定递归处理目录时的权限,默认为preserve,即保持原有权限。
- recurse_user: 指定递归处理目录时的所有者。
- recurse_group: 指定递归处理目录时的所属组
file模块示例
修改文件的属主、属组和权限:
ansible dbservers -m file -a 'owner=test01 group=mysql mode=644 path=/opt/fstab.bak'
这个命令将目标主机上的/opt/fstab.bak文件的属主设置为test01,属组设置为mysql,权限设置为644
创建一个链接文件:
ansible dbservers -m file -a 'path=/opt/fstab.link src=/opt/fstab.bak state=link'
这个命令将在目标主机上创建一个名为/opt/fstab.link的链接文件,它将链接到/opt/fstab.bak文件。
创建一个空文件:
ansible dbservers -m file -a "path=/opt/abc.txt state=touch"
这个命令将在目标主机上创建一个名为/opt/abc.txt的空文件。
删除一个文件:
ansible dbservers -m file -a "path=/opt/abc.txt state=absent"
这个命令将删除目标主机上的/opt/abc.txt文件。
hostname 模块
用于管理远程主机上的主机名
模块参数
- name: 指定要设置的主机名。
- temporary: 设置为yes时,临时修改主机名,重启后会恢复为原来的主机名。
- state: 指定操作的状态。可选值为present(默认值,设置主机名)、absent(删除主机名)和query(查询主机名)。
例
ansible dbservers -m hostname -a "name=mysql01"
执行该命令后,Ansible将连接到dbservers主机组中的主机,并使用hostname模块将它们的主机名设置为mysql01。
ping 模块
用于测试与远程主机的连接。它发送一个简单的ping请求到远程主机,并等待响应。
常用参数
- data: 指定要发送的ping数据包的内容。
- count: 指定要发送的ping数据包的数量。
- timeout: 指定等待ping响应的超时时间。
- dest: 指定要ping的目标主机。
- source: 指定发送ping请求的源IP地址。
- pattern: 指定要发送的ping数据包的模式。
- size: 指定要发送的ping数据包的大小。
- validate_certs: 指定是否验证远程主机的SSL证书。
例
检测远程主机的连通性:
ansible all -m ping
yum 模块
在远程主机上安装与卸载软件包
ansible-doc -s yum
常用参数
- name:必需参数,用于指定需要管理的软件包的名称。例如:name: nginx。
- state:用于指定软件包的状态。默认值为present,表示确保软件包已经安装。除了present,其他可用值有installed、latest、absent、removed。其中,installed与present等效,latest表示安装yum源中最新的版本,absent和removed等效,表示删除对应的软件包。例如:state: present。
- disablegpgcheck:用于指定是否禁用GPG检查,默认值为no。如果设置为yes,则会禁用GPG检查。例如:disable_gpg_check: yes。
- enablerepo:用于指定启用的yum仓库。可以指定多个仓库,以逗号分隔。例如:enablerepo: epel,extras。
- disablerepo:用于指定禁用的yum仓库。可以指定多个仓库,以逗号分隔。例如:disablerepo: base,updates。
- update_cache:用于指定是否更新yum缓存,默认值为yes。如果设置为no,则不会更新yum缓存。例如:update_cache: no。
- installroot:用于指定安装软件包的根目录。例如:installroot: /mnt/root。
- exclude:用于指定需要排除的软件包。可以指定多个软件包,以逗号分隔。例如:exclude: kernel*,httpd。
例
ansible webservers -m yum -a 'name=httpd' #安装服务
ansible webservers -m yum -a 'name=httpd state=absent' #卸载服务
service/systemd 模块
用于管理远程主机上的管理服务的运行状态
ansible-doc -s service
常用的参数:
- name:被管理的服务名称
- state=started|stopped|restarted:动作包含启动关闭或者重启
- enabled=yes|no:表示是否设置该服务开机自启
- runlevel:如果设定了enabled开机自启去,则要定义在哪些运行目标下自启动
ansible webservers -a 'systemctl status httpd' 查看服务器httpd运行状态
ansible webservers -m service -a 'enabled=true name=httpd state=started' 启动httpd服务
script 模块
实现远程批量运行本地的 shell 脚本
ansible-doc -s script
常用参数
- free_form:必需参数,指定需要执行的脚本的路径。可以是绝对路径或相对路径。例如:script: /path/to/script.sh。
- chdir:可选参数,指定在执行脚本之前要进入的远程主机上的目录。这可以用于确保脚本在正确的工作目录中执行。例如:chdir: /path/to/directory。
- creates:可选参数,指定一个文件路径。如果该文件存在,则不执行脚本。这可以用于避免重复执行脚本。例如:creates: /path/to/file。
- executable:可选参数,指定要用于执行脚本的可执行程序。如果未指定,Ansible将使用默认的可执行程序。例如:executable: /bin/bash。
- removes:可选参数,指定一个文件路径。如果该文件存在,则在执行脚本之后删除它。这可以用于清理脚本执行过程中生成的临时文件。例如:removes: /path/to/file。
- warn:可选参数,指定是否在脚本执行失败时发出警告。默认情况下,如果脚本执行失败,Ansible会中止任务。如果将warn设置为true,则即使脚本执行失败,Ansible也会继续执行后续任务。例如:warn: true。
例
- 创建了一个名为
test.sh
的Shell脚本文件,并将一条消息写入/opt/script.txt
文件中。
-
chmod +x test.sh 为脚本添加可执行权限
-
ansible webservers -m script -a 'test.sh' 执行脚本
-
ansible webservers -a 'cat /opt/script.txt' 查看文件内容
执行上述步骤后,能够在远程主机上看到/opt/script.txt
文件,并且文件中包含了hello ansible from script
的消息。
setup 模块
facts 组件是用来收集被管理节点信息的,使用 setup 模块可以获取这些信息
ansible-doc -s setup
常用参数
- gather_subset:指定要收集的子集信息。默认情况下,它会收集所有可用的信息。可以使用逗号分隔的值,如all,hardware,network,或者使用通配符*来匹配特定的子集。
- gather_timeout:指定信息收集的超时时间。默认情况下,它是10秒。可以使用整数或浮点数来指定超时时间,单位是秒。
- filter:指定一个过滤器,用于仅返回满足条件的信息。可以使用Jinja2模板语法来定义过滤器条件。
- fact_path:指定一个目录路径,用于存储收集到的主机信息。默认情况下,信息存储在ansible_facts变量中,但可以将其保存到指定的目录中,以便后续使用。
- fact_caching:指定是否启用事实缓存。可以设置为yes或no。启用缓存可以提高性能,避免每次都重新收集信息。
- fact_caching_connection:指定缓存连接的详细信息,如缓存服务器的主机和端口。具体的配置取决于所使用的缓存插件。
例
ansible webservers -m setup 获取mysql组主机的facts信息
ansible dbservers -m setup -a 'filter=*ipv4' 使用filter可以筛选指定的facts信息