ansible安装配置及一些常用模块，ansible安装配置
ansible安装配置及一些常用模块，ansible安装配置
摘要
ansible是目前非常火的运维自动化批量管理工具之一
- saltstack
- ansible
- puppet
- chef
ansible和saltstack都是使用python语言写的，而在选择以及使用的过程中，ansible相对saltstack具有以下几个优势
- 使用ssh-key控制agent，无需安装agent
- 配置起来相对简单，学习门槛低
- 并发以及性能方面还是saltstack占优的，不过在小集群（300以下）的表现上ansible也非常给力；
- 二次开发扩展：由于两个都是python语言写的，这方面都还不错，不过在日常使用中吗，saltstack的api调用要比ansible的好用很多，state和playbook孰强孰若还真不好说
- 操作界面，没用过ui
- 第三方插件的丰富程度这点ansible完胜
- 支持windows
- 开源社区的活跃程度这点ansible完胜
- 安全性：saltstack相对要更好一些
- 自动注册：这点ansible貌似没有
安装
| pip install ansible |
配置
| # cat /etc/ansible/ansible.cfg[defaults]inventory = /etc/ansible/hostsremote_tmp = $HOME/.ansible/tmproles_path = /data/ansible/roles:/etc/ansible/rolestransport = smartgathering = smartfact_caching_timeout = 30require_sudo = Falsemodule_name = shellprivate_key_file = /root/.ssh/id_rsaansible_managed = Ansible managed: {file} modified on %Y-%m-%d %H:%M:%S by {uid} on {host}#action_plugins = /data/ansible/ansible_plugins/action_plugins#connection_plugins = /data/ansible/ansible_plugins/connection_plugins#lookup_plugins = /data/ansible/ansible_plugins/lookup_plugins#vars_plugins = /data/ansible/ansible_plugins/vars_plugins#filter_plugins = /data/ansible/ansible_plugins/filter_pluginsnocolor = 0fact_caching = memoryhost_key_checking = Falsetimeout = 10pattern = *forks = 20poll_interval = 15remote_user = devopsremote_port = 9555log_path = /data/logs/ansible/ansible.log[inventory][privilege_escalation]become=Truebecome_exe=sudobecome_method=sudobecome_user=rootbecome_ask_pass=False[paramiko_connection]record_host_keys=False[ssh_connection]pipelining = True[persistent_connection][accelerate]accelerate_port = 5099accelerate_timeout = 30accelerate_connect_timeout = 5.0accelerate_daemon_timeout = 30#accelerate_multi_key = yes[selinux][colors][diff] |
| cat /etc/ansible/hosts[all: children]managerother[manager]ansible ansible_ssh_host=172.16.1.1jenkins ansible_ssh_host=172.16.1.2[other]other ansible_ssh_host=172.16.1.3 |
运行
| ansible all -m pingansible all -m shell -a "uptime" |
playbook
- shell –> 命令
- playbook –> ansible命令
tower
| wget http://releases.ansible.com/ansible-tower/setup/ansible-tower-setup-latest.tar.gz |
模块
ansible本身是没有部署能力的，它只是个框架，它的模块才有真正的部署能力。
| ansible -i hosts all -m ping |
它就是用的ansible命令行，-i 表示使用当前目录下的hosts文件，all表示Host文件内声明的所有服务器，-m ping 表示使用module名为ping的module，这个module没有参数，所以就这样调用就行了。
Command
command 模块用于运行系统命令，比如echo hello, 你安装在系统里的python，或者make 一类。大家能领悟就行了。
常用参数：
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| chdir | no | 运行command命令前先cd到这个目录 | ||
| creates | no | 如果这个参数对应的文件存在，就不运行command | ||
| executable | no | 将shell切换为command执行，这里的所有命令需要使用绝对路径 | ||
| removes | no | 如果这个参数对应的文件不存在，就不运行command |
案例
| #ansible 命令调用command:ansible -i hosts all -m command -a "uptime" |
ansible命令行调用-m command模块 -a表示使用参数 “”内的为执行的command命令。
那么对应的节点都会执行关机。
| # Run the command if the specified file does not exist.ansible -i hosts all -m command -a "/usr/bin/make_database.sh arg1 arg2 creates=/path/to/database" |
利用creates参数，判断/path/to/database这个文件是否存在，存在就跳过command命令，不存在就执行command命令。
shell
这个是一个很神奇的模块，它也是ansible的核心模块之一。它跟command模块一样负责在被ansible控制的节点（服务器）执行命令行。它与command模块有着相似的地方，也有不同的地方，看完这篇文章将告诉你答案。
常用参数
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| chdir | no | 跟command一样的，运行shell之前cd到某个目录 | ||
| creates | no | 跟command一样的，如果某个文件存在则不运行shell | ||
| removes | no | 跟command一样的，如果某个文件不存在则不运行shell |
案例
让所有节点运行somescript.sh并把log输出到somelog.txt。
| $ ansible -i hosts all -m shell -a "sh somescript.sh >> somelog.txt" |
先进入somedir/ ，再在somedir/目录下让所有节点运行somescript.sh并把log输出到somelog.txt。
| $ ansible -i hosts all -m shell -a "somescript.sh >> somelog.txt" chdir=somedir/ |
体验shell和command的区别,先cd到某个需要编译的目录，执行condifgure然后,编译，然后安装。
| $ ansible -i hosts all -m shell -a "./configure && make && make insatll" chdir=/xxx/yyy/ |
yum
用于包管理
常用参数
| 参数名 | 是否必须 | 默认值 | 选项值 | 参数说明 |
|---|---|---|---|---|
| conf_file | 不 | 设定远程yum执行时所依赖的yum配置文件 | ||
| disable_gpg_check | 不 | No | Yes/No | 在安装包前检查包，只会影响state参数为present或者latest的时候 |
| list | No | 只能由ansible调用，不支持playbook，这个干啥的大家都懂 | ||
| name | Yes | 你需要安装的包的名字，也能如此使用name=python=2.7安装python2.7 | ||
| state | no | present | present/latest/absent | 用于描述安装包最终状态，present/latest用于安装包，absent用于remove安装包 |
| update_cache | no | no | yes/no | 用于安装包前执行更新list,只会影响state参数为present/latest的时候 |
案例
| - name: 安装最新版本的apache yum: name=httpd state=latest- name: 移除apache yum: name=httpd state=absent- name: 安装一个特殊版本的apache yum: name=httpd-2.2.29-1.4.amzn1 state=present- name: 升级所有的软件包 yum: name=* state=latest- name: 从一个远程yum仓库安装nginx yum: name=http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm state=present- name: 从本地仓库安装nginx yum: name=/usr/local/src/nginx-release-centos-6-0.el6.ngx.noarch.rpm state=present- name: 安装整个Development tools相关的软件包 yum: name="@Development tools" state=present |
| - name: Install Base Require Software yum: name: "{{ item }}" state: present with_items: - gcc - fping ignore_errors: yes |
apt
这个模块是ubuntu作为远端节点的OS的时候，用的最多的。Apt是啥就不多说了，ubuntu/debian的包管理工具。
常用参数
| 参数名 | 是否必须 | 默认值 | 选项值 | 参数说明 |
|---|---|---|---|---|
| cache_valid_time | no | 如果update_cache参数起作用的时候，这个参数才会起作用。其用来控制update_cache的整体有效时间 | ||
| deb | no | 这个用于安装远程机器上的.deb后缀的软件包 | ||
| default_release | no | 等同于apt命令的-t选项，这里就不多说了 | ||
| force | no | no | yes/no | 强制执行apt install/remove |
| install_recommends | no | Ture | yes/no | 这个参数可以控制远程电脑上是否只是下载软件包，还是下载后安装，默认参数为true,设置为false的时候光下载软件包，不安装 |
| name | no | apt要下载的软件包名字，支持name=git=1.6 这种制定版本的模式 | ||
| purge | no | yes/no | 如果state参数值为absent,这个参数为yes的时候，将会强行干净的卸载 | |
| state | no | present | latest/absent/present | 定义软件包的最终状态，latest时为安装最新软件 |
| update_cache | no | yes/no | 当这个参数为yes的时候等于apt-get update | |
| upgrade | no | yes | yes/safe/full/dist | 如果参数为yes或者safe，等同于apt-get upgrade.如果是full就是完整更新。如果是dist等于apt-get dist-upgrade。 |
案例
| # 在安装foo软件包前更新然后安装foo- apt: name=foo update_cache=yes# 移除foo软件包- apt: name=foo state=absent# 安装foo软件包- apt: name=foo state=present# 安装foo 1.0软件包- apt: name=foo=1.00 state=present# 安装nginx最新的名字为squeeze-backport发布包，并且安装前执行更新- apt: name=nginx state=latest default_release=squeeze-backports update_cache=yes# 只下载openjdk-6-jdk最新的软件包，不安装- apt: name=openjdk-6-jdk state=latest install_recommends=no# 安装所有软件包到最新版本- apt: upgrade=dist# 更新apt-get的list- apt: update_cache=yes# 3600秒后停止update_cache- apt: update_cache=yes cache_valid_time=3600# 安装远程节点上的/tmp/mypackage.deb软件包- apt: deb=/tmp/mypackage.deb |
fetch
copy
copy模块在ansible里的角色就是把ansible执行机器上的文件拷贝到远程节点上。
与fetch模块相反的操作。
常用参数
| 参数名 | 是否必须 | 默认值 | 选项值 | 参数说明 |
|---|---|---|---|---|
| src | no | 用于定位ansible执行的机器上的文件，需要绝对路径。如果拷贝的是文件夹，那么文件夹会整体拷贝，如果结尾是”/”,那么只有文件夹内的东西被考过去。一切的感觉很像rsync | ||
| content | no | 用来替代src，用于将指定文件的内容，拷贝到远程文件内 | ||
| dest | yes | 用于定位远程节点上的文件，需要绝对路径。如果src指向的是文件夹，这个参数也必须是指向文件夹 | ||
| backup | no | no | yes/no | 备份远程节点上的原始文件，在拷贝之前。如果发生什么意外，原始文件还能使用。 |
| directory_mode | no | 这个参数只能用于拷贝文件夹时候，这个设定后，文件夹内新建的文件会被拷贝。而老旧的不会被拷贝 | ||
| follow | no | no | yes/no | 当拷贝的文件夹内有link存在的时候，那么拷贝过去的也会有link |
| force | no | yes | yes/no | 默认为yes,会覆盖远程的内容不一样的文件（可能文件名一样）。如果是no，就不会拷贝文件，如果远程有这个文件 |
| group | no | 设定一个群组拥有拷贝到远程节点的文件权限 | ||
| mode | no | 等同于chmod，参数可以为“u+rwx or u=rw,g=r,o=r” | ||
| owner | no | 设定一个用户拥有拷贝到远程节点的文件权限 |
案例
| # 把/srv/myfiles/foo.conf文件拷贝到远程节点/etc/foo.conf，并且它的拥有者是foo，拥有它的群组是foo，权限是0644- copy: src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644# 跟上面的案例一样，不一样的只是权限的写法- copy: src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode="u=rw,g=r,o=r"# 另外一个权限的写法- copy: src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode="u+rw,g-wx,o-rwx"# 拷贝/mine/ntp.conf到远程节点/etc/ntp.conf，并且备份远程节点的/etc/ntp.conf。- copy: src=/mine/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes |
常用参数返回值
| 参数名 | 参数说明 | 返回值 | 返回值类型 | 样例 |
|---|---|---|---|---|
| src | 位于ansible执行机上的位置 | changed | string | /home/httpd/.ansible/tmp/ansible-tmp-1423796390.97-147729857856000/source |
| backup_file | 将原文件备份 | changed and if backup=yes | string | /path/to/file.txt.2015-02-12@22:09~ |
| uid | 在执行后，拥有者的ID | success | int | 100 |
| dest | 远程节点的目标目录或文件 | success | string | /path/to/file.txt |
| checksum | 拷贝文件后的checksum值 | success | string | 6e642bb8dd5c2e027bf21dd923337cbb4214f827 |
| md5sum | 拷贝文件后的md5 checksum值 | when supported | string | 2a5aeecc61dc98c4d780b14b330e3282 |
| state | 执行后的状态 | success | string | file |
| gid | 执行后拥有文件夹、文件的群组ID | success | int | 100 |
| mode | 执行后文件的权限 | success | string | 0644 |
| owner | 执行后文件所有者的名字 | success | string | httpd |
| group | 执行后文件所有群组的名字 | success | string | httpd |
| size | 执行后文件大小 | success | int | 1220 |
file
在之前ansible命令行的时候有copy模块，在playbook的时代自然也有一个模块专门负责文件的拷贝，当然这个时代它不仅仅是文件拷贝那么简单。
来自官方的解释：
file模块它包含了文件、文件夹、超级链接类的创立、拷贝、移动、删除操作。
常用参数
| 参数名 | 是否必须 | 默认值 | 选项 | 说明 |
|---|---|---|---|---|
| follow | no | no | yes/no | 如果原来的文件是link，拷贝后依旧是link |
| force | no | no | yes/no | 强制执行，没说的 |
| group | no | 设定一个群组拥有拷贝到远程节点的文件权限 | ||
| mode | no | 等同于chmod，参数可以为“u+rwx or u=rw,g=r,o=r” | ||
| owner | no | 设定一个用户拥有拷贝到远程节点的文件权限 | ||
| path | yes | 目标路径，也可以用dest,name代替 | ||
| src | yes | 待拷贝文件/文件夹的原始位置。 | ||
| state | no | file | file/link/directory/ hard/touch/absent | file代表拷贝后是文件； link代表最终是个软链接； directory代表文件夹； hard代表硬链接； touch代表生成一个空文件； absent代表删除 |
例子
| # 修改文件的所有组、人、权限。- file: path=/etc/foo.conf owner=foo group=foo mode=0644# 操作链接的案例- file: src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link#参数化案例- file: src=/tmp/{{ item.path }} dest={{ item.dest }} state=link with_items: - { path: 'x', dest: 'y' } - { path: 'z', dest: 'k' }# 使用touch来创建一个空文件并定义权限- file: path=/etc/foo.conf state=touch mode="u=rw,g=r,o=r"# touch一个空文件，并且修改权限- file: path=/etc/foo.conf state=touch mode="u+rw,g-wx,o-rwx" - name: link Zabbix Agent Link #shell: ln -s {{ install_dir }}/zabbix-{{ zabbix_version }} {{ zabbix_dir }} file: src: "{{ install_dir }}/zabbix-{{ zabbix_version }}" dest: "{{ zabbix_dir }}" owner: root group: root state: link |
template
template使用了Jinjia2格式作为文件模版，进行文档内变量的替换的模块。它的每次使用都会被ansible标记为”changed”状态。
常用参数
| 参数名 | 是否必须 | 默认值 | 选项值 | 参数说明 |
|---|---|---|---|---|
backup no no yes/no 建立个包括timestamp在内的文件备份，以备不时之需.
dest yes 远程节点上的绝对路径，用于放置template文件。
group no 设置远程节点上的的template文件的所属用户组
mode no 设置远程节点上的template文件权限。类似Linux中chmod的用法
owner no 设置远程节点上的template文件所属用户
src yes 本地Jinjia2模版的template文件位置。
案例
| # 把/mytemplates/foo.j2文件经过填写参数后，复制到远程节点的/etc/file.conf，文件权限相关略过- template: src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644# 跟上面一样的效果，不一样的文件权限设置方式- template: src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode="u=rw,g=r,o=r" |
service
service模块说白了，就是Linux下的service命令。但是它更简单。这个是playbook中用的非常多的模块。
常用参数
| 参数名 | 是否必须 | 默认值 | 选项值 | 参数说明 |
|---|---|---|---|---|
| enabled | no | yes/no | 启动os后启动对应service的选项。使用service模块的时候，enabled和state至少要有一个被定义 | |
| name | yes | 需要进行操作的service名字 | ||
| state | no | stared/stoped/restarted/reloaded | service最终操作后的状态。 |
案例
| # 不管当前什么情况，启动apache- service: name=httpd state=started# 不管当前什么情况，停止apache- service: name=httpd state=stopped# 不管当前什么情况，重启apache- service: name=httpd state=restarted# 系统重启后，启动apache- service: name=httpd enabled=yes |
wait_for
当你利用service 启动tomcat，或数据库后，他们真的启来了么？这个你是否想确认下？
wait_for模块就是干这个的。等待一个事情发生，然后继续。它可以等待某个端口被占用，然后再做下面的事情，也可以在一定时间超时后做另外的事。
常用参数
| 参数名 | 是否必须 | 默认值 | 选项值 | 参数说明 |
|---|---|---|---|---|
| connect_timeout | no | 5 | 在下一个事情发生前等待链接的时间，单位是秒 | |
| delay | no | 延时，大家都懂，在做下一个事情前延时多少秒 | ||
| host | no | 127.0.0.1 | 执行这个模块的host | |
| path | no | 当一个文件存在于文件系统中，下一步才继续。 | ||
| port | no | 端口号，如8080 | ||
| state | no | started | present/started/ stopped/absent | 对象是端口的时候start状态会确保端口是打开的， stoped状态会确认端口是关闭的; 对象是文件的时候，present或者started会确认文件是存在的， 而absent会确认文件是不存在的。 |
评论暂时关闭