Ansible之路——第五章:Ansible的几个命令
安装完ansible后,发现ansible一共为我们提供了七个指令:ansible、 ansible-doc、ansible-galaxy、ansible-console、ansible-playbook、ansible-pull、ansible-vault。
下面简单介绍一下这几个命令的用法。相应命令的详细用法可以通过man来查询。
5.1 ansible
Ansible是指令核心部分,其主要用于执行ad-hoc命令。 Ad-Hoc 是指ansible下临时执行的一条命令,并且不需要保存的命令。
一个ad-hoc命令的执行,需要按以下格式进行执行:
ansible 主机或组 -m 模块名 -a "模块参数" ansible参数
其中:
- 主机和组,是在/etc/ansible/hosts 里进行指定的部分,当然动态Inventory 使用的是脚本从外部应用里获取的主机;
- 模块名,可以通过ansible-doc -l 查看目前安装的模块,默认不指定时,使用的是command模块,具体可以查看/etc/ansible/ansible.cfg 的“#module_name = command ” 部分,默认模块可以在该配置文件中进行修改;
- 模块参数,可以通过 “ansible-doc 模块名” 查看具体的用法及后面的参数;
- ansible参数,可以通过ansible命令的帮忙信息里查看到,这里有很多参数可以供选择,如是否需要输入密码、是否sudo等。
5.2 ansible-doc
该指令用于查看模块信息,常用参数有-l ,具体如下:
//列出所有已安装的模块
ansible-doc -l
//查看某个模块的具体用法
ansible-doc <module>
5.3 ansible-galaxy
ansible-galaxy 指令用于方便的从https://galaxy.ansible.com/ 站点下载第三方扩展模块,我们可以形象的理解其类似于centos下的yum、python下的pip或easy_install 。
5.4 ansible-console
ansible-console是ansible为我们提供的一款交互式工具,类似于Windows中的cmd及Linux中的shell。可以在ansible-console虚拟出来的终端上像shell一样使用ansible内置的各种命令,这为习惯于shell交互方式的用户提供了良好的使用体验,所有的操作与shell类似,而且支持tab键补全。
如:
5.5 ansible-playbook
该指令是使用最多的指令,其通过读取playbook 文件后,执行相应的动作。
5.6 ansible-pull
该指令使用需要谈到Ansible的另一种工作模式:pull模式(Ansible默认使用push模式)。
前面的学习使用都是基于Ansible 的push 模式来工作,即不要在远程主机做任何操作只需要在控制机编排playbook,push 到远程主机即可完成任务,另外一个工作模式就是pull这和通常使用的push模式工作机理刚好相反,其适用于以下场景:
1) 被控节点在配置时不可用,比如自动伸缩的服务池
2) 被控节点较多,控制机资源有限无法满足高线程和低时间的运行效率
Ansible 基于pull 模式的工作流程:
1) 每台被控端需要安装Ansible 和git(svn)
2) 所有的配置及playbooks 都存放在git 仓库
3) 被控端的ansible-pull 计划任务会定期检查给定的git 的tag 或者分支
4) ansible-pull 执行特定的playbooks 即local.yml 或者hostname.yml
5) 每次更改playbooks 只需要提交到git 即可
将Ansible设置为从节点pull而不是push,是有一些缺点,例如要求在节点上安装软件,但是也存在一些优点:
- 不需要中央管理服务器(取决于repository的类型)
- 分散存储库是可能的。(再次:取决于repository的类型。)
- 连接可以由节点启动(如果不允许您更改防火墙策略,则可能很重要)
- 增加并行度
- 节点可用时可以pull。(在基于push的模型中,如果节点不可用,则无法对其进行配置。)
- 非常快,因为避免了每个任务的SSH连接开销。
5.6.1测试:
在GitHub上创建一个新的库:pull-test
本地将这个库下载下来,并提交ansible脚本:
# git clone git@10.152.35.204:root/pull-test.git # cd pull-test/ # vim main.yml # git add main.yml # git commit -m "show route info" # git push -u origin master
这里的main.yml只是打印了本地的路由信息,实际上可以执行任何操作:
编辑host inventory:
127.0.0.1 ansible_ssh_pass=root123
开始测试:
注意,ansible-pull的本地主机清单里面的ip地址必须是127.0.0.1,否则会报错:
ERROR! Specified hosts and/or --limit does not match any hosts
如果不提供任何主机清单(/etc/ansible/hosts里面也为空),那么仓库中的ansible脚本里面需要使用127.0.0.1或者localhost作为hosts。
5.6.2 周期执行
在实际应用中,ansible-pull一般与linux下的crontab协作,用于定期检查仓库中的配置或者脚本是否更新:
# -C 分支 -d 目的地 -i 主机路径 -e 添加参数 -o 只有git仓库发生改变才执行playbook
如:
*/5 * * * * ansible-pull -C master -d /root/test -i /opt/ansible-pull-test/hosts -U <github仓库> -e "role=db" shenchan.yml -o
5.7 ansible-vault
ansible-vault主要应用于配置文件中含有敏感信息,又不希望他能被人看到,vault可以帮你加密/解密这个配置文件,属高级用法。
主要对于playbooks里比如涉及到配置密码或其他变量时,可以通过该指令加密,这样我们通过cat看到的会是一个密码串类的文件,编辑的时候需要输入事先设定的密码才能打开。这种playbook文件在执行时,需要加上 --ask-vault-pass参数,同样需要输入密码后才能正常执行。
5.7.1 用法:
5.7.2 加密:
5.7.3 解密:
5.7.4 加密时编辑(输入密码后可以看到加密前的实际内容):
5.7.5 加密时运行:
5.7.6 还可以将加密的密码存在文件中,这样在运行的时候就不需要输入密码了:
注:从ansible2.4开始,官方就不再推荐使用--vault-password-file选项了,开始推荐使用--vault-id来代替--vault-password-file指定密码文件。
5.7.7 创建加密文件,编辑退出后自动对文件进行加密:
5.7.8 查看加密文件原内容:
5.7.9 修改加密文件的密码:
同样的,在更新密码的时候,推荐使用--new-vault-id来代替--new-vault-password-file指定新的密码文件。
5.7.10 加密字符串:encrtpt_string
前面的命令都是对整个文件进行加密,但是通常我们并不需要加密整个文件,因为这样反而会对我们的阅读造成困扰,有时我们只是想把“密码”等敏感信息隐藏起来而已。
从ansible2.3开始,使用encrypt_string命令,可以加密字符串,通过加密字符串的功能,能够有效的隐藏敏感信息的值。
比如,有如下的playbook:
我们觉得password这个密码变量以明文的方式存储在playbook中不太安全,因为所有有权限查看该playbook的人都能看到密码,我们需要对密码字符串的值进行加密,以保证它不会明文出现在这里。操作如下:
先对字符串进行加密,加密时,会提示输入密码:
这一长串文本就是1234加密后的文本。现在,复制这串文本,用这串文本替换playbook中的密码,如:
这里的密码已经被替换为了加密后的字符串了,下面来运行这个playbook:
5.8 ansible-lint
除了上述几个命令之外,还有ansible-lint这个命令,不过需要安装ansible-lint的软件包
ansible-lint 是一个对playbook的语法进行检查的工具。
如果没有安装ansible-lint,也可以使用 ansible-playbook --syntax-check对剧本进行语法的检查。
ansible-playbook --syntax-check + 剧本名
(对剧本语法进行检查但不执行)