Ansible经常使用模块命令

Ansible经常使用模块命令

1、安装ansible

yum install epel-release

yum install ansible

 

2、配置文件配置

vi /etc/ansible/ansible.cfg （主要设置一些ansible初始化的信息，好比日志存放路径、模块、插件等配置信息）

[defaults]

inventory = /etc/ansible/hosts

library = /usr/share/ansible

sudo_user = root  (默认远程执行命令的用户)

remote_port = 22

fork = 5

host_key_checking = False

log_path = /var/log/ansible.log

module_name = command

roles_path = /etc/ansible/roles

deprecation_warnings = False

 

vi /etc/ansible/hosts  （机器清单，进行分组管理）

       [tomcat]

       192.168.16.192

       192.168.16.193

 

       [nginx]

   app1 ansible_ssh_host=192.168.16.190 ansible_ssh_pass="2039"

   app2 ansible_ssh_host=192.168.16.191 sudo_user=”ald” ansible_ssh_pass="2039"

 

 (其余组命名规则查看配置文件例子)

[nginx]组使用的是明文密码认证，通常都使用密钥登录，生产环境用密钥

 

3、经常使用模块命令

l  ansible命令经常使用指令

         -m指定模块

         -a 指定模块的命令。默认是command模块，能够省略

         -B 指定ansible后台运行超时时间

         -C 测试运行效果，而不是正在运行

         -f 指定使用的并行进程的数量

       -i 指定inventory/hosts文件，默认/etc/ansiable/hosts文件

       --limit=xxx.xxx.xxx.xxx 限制对某个ip或者网段或者组执行

       --list-hosts 显示将要执行命令的主机

 

l  ansible-doc 命令经常使用指令  (显示ansiable模块的帮助文档)

           -M --module-path=/xxx/xxx  查询模块 默认是/usr/share/ansible/

-l  --list          显示已存在的全部模块

-s  command     显示playbook制定模块的用法，相似 man 命令

 

l  ansible-galaxy 下载第三方模块指令，相似yum、pip、easy_install这样的命令

ansible-galaxy install <module_name>

 

l  ansible-playbook命令经常使用指令 （和ansible相似）

--syntax-check  [yaml文件]         语法检测

-t TAGS    只容许指定的tags标签任务，多个以 , 分开

--skip-tags=SKIP_TAGS   跳过指定的标签

--start-at-task=START_AT   从哪一个任务后执行

 

l  ansible-pull 命令经常使用指令

 

l  ansible-vault 命令经常使用指令 （对playbook文件进行加密/解密）

playbook文件在执行时，须要加上 –ask-vault-pass参数，一样须要输入密码后才能正常执行。

============================================================

一、 copy——拷贝模块   (用于将本地或远程机器上的文件拷贝到远程主机上)

ansible all –m copy -a “src=/xxx/xxx dest=/yyy/yyy owner=root group=root mode=644 force=yes/no backup=yes/no”

解释：将src 文件/目录复制到远程dest上，全部者/组为root 权限为644，force为是否强制替换，backup为替换前是否须要备份远程远文件

 

二、 raw——命令模块 （和command、shell相似）

 

三、 yum——安装模块 （安装程序）

ansible all –m yum –a “name=httpd state=present”

解释：安装httpd程序，state能够是present、latest、installed表示安装程序，absent、removed表示卸载程序

 

四、 file——文件模块 （文件属性修改）

ansible all –m file –a “src=/xxx/xxx/1 dest=/yyy/1 state=link owner=alad group=alad mode=777”

ansible develop -m file -a "path=/xxx/dir recurse=yes owner=root group=alad mode=644"

解释：一、将src的文件软链接到dest目录下，并修改全部者/组和权限

      二、将path路径的目录递归形式设置全部者和权限

*、state还能够是directory：若是目录不存在，建立目录

            file：即便文件不存在，也不会被建立

hard：建立硬连接

               touch：若是文件不存在，则会建立一个新的文件，若是文件或目录已存在，则更新其最后修改时间

               absent：删除目录、文件或者取消连接文件

五、 cron——计划任务模块 （计划任务crontab）

ansible develop -m cron -a "name='show time' minute=*/1 hour=* day=* month=* weekday=* job='/bin/date'"

ansible develop -m cron -a "name='show time' state=absent"

解释：一、建立一个每分钟显示时间的计划任务

      二、删除名为show time这个计划任务

 

六、 group——组模块（用户组）

ansible all-m group -a "name=develop"

解释：在全部主机上建立一个develop的组 ，state=absent表示删除该组

 

七、 user——用户模块（用户）

ansible develop -m user -a "name=harlan groups=root password=-1vFO89dP6qyK"

ansible develop -m user -a "name=harlan state=absent remove=yes"

解释：一、在全部主机上建立harlan用户，并将其添加到root组，密码是通过hash加密后的，明文密码会被哈希，因此先填入hash后的密码便可

可用此命令hash密码  openssl passwd -salt -1 "123456"

      二、删除harlan用户。Remove表示是否删除用户的同时删除家目录

 

八、 service——服务模块（服务状态）

ansible develop -m service -a "name=nginx state=running"

ansible develop -m service -a "name=nginx state=restarted enabled=yes"

解释：一、不管服务处在什么状态，最后都是将服务状态设置为启动，当服务正在运行的时候，显示为changed为false，state显示为状态，表示为正在运行；当服务中止的时候，显示为changed为true，表示这个时候将服务进行了启动，状态为启动

      二、表示重启nginx而且将nginx设置为开机自启动，state还有staeted、reloaded、stoped值

 

九、 script——脚本模块（运行脚本）

ansible develop -m script -a "/root/a.sh"

解释：在develop主机上运行当前服务器上的a.sh脚本

 

十、get_url——下载url上指定文件（相似wget）

ansible develop -m get_url -a "url=http://file.alavening.com/alading_file/head_img/1526900421976.jpg dest=/home/ owner=alad group=alad mode=644"

解释：将url上的图片下载到dest目的目录上,而且设置相应的全部者/组和权限。

 

十一、synchronize——同步目录（默认推送，mode=pull为拉取）

       ansible develop -m synchronize -a "src=/home/test/ dest=/home/test compress=yes delete=yes"

ansible develop -m synchronize -a "src=/home/test/ dest=/home/test compress=yes mode=pull"

解释：一、将src下的文件同步到dest上，delete=yes表示以src 目录为准镜像同步。

     二、拉取远程src上的目录文件到本地dest上

 

十二、template——文档内变量的替换的模块

       ansible develop –m template –a ‘src=/mytemplates/foo.j2 dest=/etc/file.conf mode="u=rw,g=r,o=r"’

解释：将src上foo.j2的变量模版复制到dest上。Template适合用playbook编写 ，经过变量而后拷贝到远程主机。

能够参考：https://www.cnblogs.com/jsonhc/p/7895399.html

 

1三、fetch——从远程主机下载文件（不能拉取目录）

    ansible develop -m fetch -a "src=/home/test/xxx dest=/home/ flat=yes"

解释：将远程xxx文件拉取到本地home目录下，目录结构会是dest路径+远程主机名+src，假如远程主机名为develop，拉取的xxx文件在本地的/home/develop/home/test目录。若是须要指定拉取到某目录下 加个flat=yes的参数便可。

 

1四、unarchive——解压文件

ansible develop -m unarchive -a "src=/root/apache-tomcat-7.0.85.tar.gz dest=/home/test owner=alad group=alad mode=755"

ansible develop -m unarchive -a "src=/home/alad/ansible/elk/logstash-6.2.4.tar.gz dest=/home/test remote_src=yes"

ansible develop -m unarchive -a "src=http://mirrors.linuxeye.com/oneinstack-full.tar.gz dest=/home/test remote_src=yes"

解释：将本地的tomcat压缩包解压到远程主机dest目录下，并修改其权限和全部者/组，remote_src=yes 表示解压远程主机已有的压缩包，src为url表示下载此包到远程主机dest目录进行解压缩后，并删除压缩包源文件

 

1五、command和shell——linux命令模块

shell和command的区别：shell模块能够特殊字符，而command是不支持

简单说：command运行的命令中没法使用变量，管道。若是须要使用管道、变量，请使用raw模块,或者shell模块。

 

 

1六、setup——获取主机信息

       ansible develop -m setup

       ansible develop -m setup -a 'filter=ansible_*_mb'

解释：一、显示系统全部信息

      二、一般配合filter进行过滤来获取主机信息，（例子是显示内存信息）

 

1七、assemble——配置文件组装发送到远程主机

ansible test -m assemble -a "src=/root/test dest=/root/ansible/fileone mode=777 remote_src=False delimiter='========'"

解释：将src test目录下全部文件（不含test子目录内容）的内容发送到dest fileone文件中，remote_src默认为Ture表示src为远程主机上的路径，False为ansible控制端的路径，delimiter为文件之间内容分隔符。

 

4、PlayBook语法和结构

Playbook须要7个文件夹，如ansible安装nginx，则须要在/etc/ansible/roles目录下创建如下文件夹。

mkdir -pv nginx/{default,tasks,vars,meta,handlers,templates,files}

 

对于Ansible，几乎每一个YAML文件都以一个列表开始。列表中的每一个项目都是键/值对列表，一般称为“散列”或“字典”。因此，咱们须要知道如何在YAML中编写列表和字典。

YAML还有一个小小的怪癖。全部YAML文件（不管它们是否与Ansible相关联）均可以选择开始---和结束---.。这是YAML格式的一部分，并指示文档的开始和结束。

列表中的全部成员都是以相同的缩进级别开头的行（短划线和空格）："- "

例如如下例子：

 

 

第一次的话都会运行，后边若是copy的文件内容发生改变就会触发 notify ，而后会直接执行 handlers 的内容（ 这里notify后边的事件就都不会执行了 ）。

 

5、        template模块jinja2语法

A：template:使用了Jinjia2格式做为文件模版，进行文档内变量的替换的模块。至关于copy，将jinja2的文件模板理解并执行，转化为各个主机间的对应值。

如：template: src=httpd.conf.j2 dest=/etc/httpd/conf/httpd.conf

http.conf.j2必须是完整的文件内容，由于这是覆盖操做，而非只选择性远程主机替换变量，dest要指定文件名，若是是目录就至关于copy了http.conf.j2到远程目录下，不是咱们要的结果。

B：when语句：在tasks中使用，Jinja2的语法格式

- name: start nginx service

 shell: systemctl start nginx.service

 when: ansible_distribution == "CentOS" and ansible_distribution_major_version == "7"

当系统为 centos 7的时候执行sysctemctl命令，不然不执行

 

C：循环：迭代，须要重复执行的任务

       变量名为item，而with_item为要迭代的元素。若是某个任务出错，后面不执行

- name: install packages

 yum: name={{ item }} state=latest

 with_items:

    - httpd

    - php

这是基于字符串列表给出元素示例

 

- name: create users

    user: name={{ item.name }} group={{ item.group }} state=present

    with_items:

    - {name: 'userx1', group: 'groupx1'}

    - {name: 'userx2', group: 'groupx2'}

这是基于字典列表给元素示例：item.name  . 后边的表示键