ansible安装

Posted 2020-12-04

ansible安装方式

ansible安装常用两种方式，yum安装和pip程序安装

这里提供二种安装方式,任选一种即可：

1、使用yum安装

yum install epel-release -y
yum install ansible –y

2、 使用pip（python的包管理模块）安装

pip install ansible

#如果没pip,需先安装pip.yum可直接安装：
yum install python-pip
pip install ansible

ansible程序结构
安装目录

通过使用rpm -ql ansible指令可以查看ansible安装的所有文件位置！

配置文件目录：/etc/ansible/
执行文件目录：/usr/bin/
Lib库依赖目录：/usr/lib/pythonX.X/site-packages/ansible/
Help文档目录：/usr/share/doc/ansible-X.X.X/
Man文档目录：/usr/share/man/man1

ansible配置文件的查找顺序

(1)、检查环境变量ANSIBLE_CONFIG指向的路径文件（export ANSIBLE_CONFIG=/etc/ansible.cfg ）
(2)、~/.ansible.cfg，检查当前目录（/etc/ansible）下的ansible.cfg配置文件
(3)、/etc/ansible.cfg 检查etc目录的配置文件

ansible配置文件

设置/etc/ansible/ansible.cfg配置参数，ansible有许多参数，下面列出常用的参数：

inventory：#这个参数表示资源清单inventory文件的位置，资源清单就是一些ansible需要连接管理的主 机列表。这个参数的配置实例如下：

inventory = /etc/ansible/hosts

library： ansible的操作动作，无论是本地或远程，都使用一小段代码来执行，这小段代码称为模块，这个library参数就是指向存放ansible模块的目录。配置实例如下：

library = /usr/share/ansible

ansible支持多个目录方式，只要用冒号“ : ”隔开就可以，同时也会检查当前执行playbook位置下的./library目录。

forks：设置默认情况下ansible最多能有多少个进程同时工作， 从ansible 1.3开始,fork数量默认自动设置为主机数量或者潜在的主机数量,默认设置最多5个进程并行处理。具体需要设置多少个，可以根据控制主机的性能和被管节点的数量来确定，可能是 50或100。默认值5是非常保守的值，配置实例如下：

forks = 5

sudo_user：这是设置默认执行命令的用户，也可以在playbook中重新设置这个参数。配置实例如下：

sudo_user = root
remote_port：这是指定连接被管节点的管理端口，默认是22。除非设置了特殊的SSH端口，不然这个参数一般是不需要修改的。
配置实例如下：

remote_port = 22
host_key_checking：这是设置是否检查SSH主机的密钥。可以设置为True或False，关闭后第一次连接没有提示配置实例

host_key_checking = False
timeout：这是设置SSH连接的超时间隔，单位是秒。配置实例如下：

timeout = 60

log_path：ansible系统默认是不记录日志的，如果想把ansible系统的输出记录到日志文件中，需要设置log_path来指定一个存储ansible日志的文件。配置实例如下：

log_path = /var/log/ansible.log

1

另外需要注意，执行ansible的用户需要有写入日志的权限，模块将会调用被管节点的syslog来记录。
ansible主机清单

ansible主机清单设置
编辑/etc/ansible/hosts:

[[email protected] ~]# vim /etc/ansible/hosts #定义方式：

###1、直接指明主机地址或主机名：
green.example.com
blue.example.com
172.17.250.230
172.17.254.180
172.17.254.165

###2、定义一个主机组[组名]把地址或主机名加进去
[webservers]
172.17.254.180
172.17.254.165
#组成员可以使用通配符来匹配，如下 172.17.254.[1:6] #表示匹配从172.17.254.1——172.17.254.6的主机

ansible配置公私钥
配置ansible使用公钥验证

配置这个的原因是为了方便ansible可以实现无秘访问控制其他机器，是实现自动化的前提。这一步可以再配置好ansible.cfg文件以及hosts主机清单后执行。

虽然ansible支持其他主机认证方式，但是我们最常用的的还是基于秘钥的认证：
1、首先生成秘钥

##执行下条指令后一路回车即可！
[[email protected] ~]# ssh-keygen -t rsa

2、然后向主机分发秘钥：

##所有添加到主机清单中的IP地址或者主机名，全部都要用下条指令执行一遍。
[[email protected] ~]# ssh-copy-id [email protected]主机名或IP地址

3、如果出现以下情况：

ssh-copy-id -i ~/.ssh/id_rsa.pub [email protected]
-bash: ssh-copy-id: command not found

#请尝试：
yum -y install openssh-clientsansible

ansible常用命令
ansible命令集

/usr/bin/ansible # Ansibe AD-Hoc 临时命令执行工具，常用于临时命令的执行

/usr/bin/ansible-doc # ansible 模块功能查看工具

/usr/bin/ansible-galaxy # 下载/上传优秀代码或Roles模块 的官网平台，基于网络的

/usr/bin/ansible-playbook # ansible 定制自动化的任务集编排工具

/usr/bin/ansible-pull # ansible远程执行命令的工具，拉取配置而非推送配置（使用较少，海量机器时使用，对运维的架构能力要求较高）

/usr/bin/ansible-vault # ansible 文件加密工具

/usr/bin/ansible-console # ansible基于Linux Consoble界面可与用户交互的命令执行工具

ansible命令详解

###命令格式：
ansible <host-pattern> [-f forks] [-m module_name] [-a args]

###我们可以通过 ansible -h查看帮助
###本段中所有以“**”开头的参数，均表示是重要的
[[email protected] ~]# ansible -h
Usage: ansible <host-pattern> [options] Options:

** -a MODULE_ARGS, --args=MODULE_ARGS
模块的参数,如果执行默认COMMAND的模块，即是命令参数,如：“date”,“pwd”等等 module arguments 模块参数

-k, --ask-pass
ask for SSH password 登录密码，提示输入SSH密码而不是假设基于密钥的验证

--ask-su-pass
ask for su password su切换密码

-K, --ask-sudo-pass
ask for sudo password 提示密码使用sudo,sudo表示提权操作

--ask-vault-pass
ask for vault password

-B SECONDS, --background=SECONDS
run asynchronously, failing after X seconds (default=N/A)后台运行超时时间

** -C, --check
don‘t make any changes; instead, try to predict some of the changes that may occur #只是测试一下会改变什么内容，不会真正去执行;相反,试图预测一些可能发生的变化

-c CONNECTION, --connection=CONNECTION
connection type to use (default=smart) #连接类型使用

** -f FORKS, --forks=FORKS
specify number of parallel processes to use (default=5) #并行任务数。NUM被指定为一个整数,默认是5

-h, --help
show this help message and exit 打开帮助文档API

** -i INVENTORY, --inventory-file=INVENTORY
specify inventory host file (default=/etc/ansible/hosts) #指定库存主机文件的路径,默认为/etc/ansible/hosts

** --list-hosts
outputs a list of matching hosts; does not execute anything else

** -m MODULE_NAME, --module-name=MODULE_NAME
module name to execute (default=command) #执行模块的名字，默认使用 command 模块，所以如果是只执行单一命令可以不用 -m参数

-M MODULE_PATH, --module-path=MODULE_PATH
specify path(s) to module library (default=/usr/share/ansible/) #要执行的模块的路径，默认为/usr/share/ansible/

-o, --one-line
condense output #压缩输出，摘要输出.尝试一切都在一行上输出。

-P POLL_INTERVAL, --poll=POLL_INTERVAL
set the poll interval if using -B (default=15) #调查背景工作每隔数秒。需要- b

--private-key=PRIVATE_KEY_FILE
use this file to authenticate the connection #私钥路径，使用这个文件来验证连接

** -S, --su
run operations with su #用 su 命令

** -R SU_USER, --su-user=SU_USER
run operations with su as this user (default=root) #指定SU的用户，默认是root用户

** -s, --sudo
run operations with sudo (nopasswd)

** -U SUDO_USER, --sudo-user=SUDO_USER
desired sudo user (default=root)(deprecated, use become) #sudo到哪个用户，默认为 root

** -T TIMEOUT, --timeout=TIMEOUT
override the SSH timeout in seconds (default=10) #指定SSH默认超时时间， 默认是10S

-t TREE, --tree=TREE
log output to this directory #将日志内容保存在该输出目录,结果保存在一个文件中在每台主机上。

** -u REMOTE_USER, --user=REMOTE_USER
connect as this user (default=root) #远程用户， 默认是root用户

--vault-password-file=VAULT_PASSWORD_FILE
vault password file

** -v, --verbose
verbose mode (-vvv for more, -vvvv to enable 详细信息connection debugging)

--version
show program‘s version number and exit #输出ansible的版本

ansible-doc命令

ansible-doc指令是用来查看ansible所支持的模块的文件信息的，并且支持shell！

查看 ansible-doc 的使用说明：

###一般用法：（也是常用的用法）
ansible-doc -l 获取模块信息
ansible-doc -s MOD_NAME 获取指定模块的使用帮助

###ansible-doc
[[email protected] ~]# ansible-doc -h
Usage: ansible-doc [options][module...]

Options:
-h, --help show this help message and exit # 显示命令参数API文档

-l, --list List available modules #列出可用的模块

-M MODULE_PATH, --module-path=MODULE_PATH #指定模块的路径specify path(s) to module library (default=None)

-s, --snippet Show playbook snippet for specified module(s) #显示playbook制定模块的用法

--version show program‘s version number and exit # 显示ansible-doc的版本号查看模块

实例：

[[email protected] ~]# ansible-doc -l|grep mysql
mysql_db Add or remove MySQL databases from a remote host.
mysql_replication Manage MySQL replication
mysql_user Adds or removes a user from a MySQL database.
mysql_variables Manage MySQL global variables
[[email protected] ~]#
[[email protected] ~]# ansible-doc -l mysql_replication
a10_server Manage A10 Networks AX/SoftAX/Thunder/vThunder devic...
a10_service_group Manage A10 Networks devices‘ service groups
......
......
......
quantum_router_interface Attach/Detach a subnet‘s interface to a router
quantum_subnet Add/remove subnet from a network
(END)