ansible模块介绍

命令模块:

1:command模块在远程节点上执行命令:

command模块后面紧跟要执行的命令,命令的参数以空格隔开。指定的命令会在所选的节点上执行。命令并不是通过shell执行的,所以并不能使用$HOME等环境变量和一些操作符(<,>,|,&).shell模块可以使用。

1》chdir 在运行命令之前,先切换到指定的目录。

[[email protected] ansible]# ansible testhosts -m command -a "ls -l chdir=/tmp"
127.0.0.1 | success | rc=0 >>
total 4
drwx------ 2 root root 4096 Apr  5 21:27 pymp-eBJbzL

192.168.1.112 | success | rc=0 >>
total 4
drwxr-xr-x 2 root root 4096 Apr  2 02:04 rsync
/先切换到/tmp目录下,然后再执行命令!

2》creates 后边可以直接指定一个文件名(目录名),或者是以正则模式匹配一系列文件名。如果所指定的文件存在的话,则不执行指定的命令。

[[email protected] ansible]# ansible 192.168.1.112 -m command -a "ls -l /tmp creates=/tmp/test"
192.168.1.112 | success | rc=0 >>
total 4
drwxr-xr-x 2 root root 4096 Apr  2 02:04 rsync

/tmp/test不存在,所以执行命令

[[email protected] ansible]# ansible 192.168.1.112 -m command -a "ls -l /tmp creates=/tmp/rsync"
192.168.1.112 | success | rc=0 >>
skipped, since /tmp/rsync exists

/tmp/rsync文件存在,所以不执行命令

3》removes 后边可以直接指定一个文件名(或目录名),或者是以正则模式匹配一系列文件名。如果所指定的文件不存在的话,则不运行命令。(注意与creates的对比)

[[email protected] ~]# ansible 192.168.1.112 -m command -a "ls -l /tmp removes=/tmp/test"
192.168.1.112 | success | rc=0 >>
skipped, since /tmp/test does not exist

[[email protected] ~]# ansible 192.168.1.112 -m command -a "ls -l /tmp removes=/tmp/rsync"
192.168.1.112 | success | rc=0 >>
total 4
drwxr-xr-x 2 root root 4096 Apr  2 02:04 rsync

[[email protected] ~]# 

/注意与creates的对比

2.script模块在远程机器上运行本地脚本。

script模块的-a选项直接跟一个本地脚本的绝对路径,脚本的参数以空格隔开。该模块首先将指定的脚本传到远程节点上,然后在远程节点的shell环境下执行该脚本。

[[email protected] ~]# ansible 192.168.1.112 -m script -a "/root/test.sh"
192.168.1.112 | success >> {
    "changed": true, 
    "rc": 0, 
    "stderr": "", 
    "stdout": "ok\n"
}

/注意的是,这是本地的脚本在远程执行,这样执行的时候,脚本文件必须得有可执行权限/

3.shell模块,在远程节点执行命令

shell模块的参数为命令名称,命令本身的参数以空格隔开。像command模块那样在远程节点执行命令,但shell模块再远程节点是通过shell环境(/bin/bash)执行命令的,该模块也可以执行一个shell脚本,但该脚本必须在远程节点上存在。

chdir、creates、removes参数与command模块的参数一样。

[[email protected] ~]# ansible 192.168.1.112 -m shell -a " echo $HOME"
192.168.1.112 | success | rc=0 >>
/root

shell执行脚本文件
[[email protected] ~]# ansible 192.168.1.112 -m command  -a " echo $HOME"
192.168.1.112 | success | rc=0 >>
/root

[[email protected] ~]# ansible 192.168.1.112 -m shell -a "/bin/bash /root/test1.sh"
192.168.1.112 | FAILED | rc=127 >>
/bin/bash: /root/test1.sh: No such file or directory

[[email protected] ~]# vim test1.sh   /在远程节点上创建脚本文件
[[email protected] ~]# cat test1.sh 
#!/bin/bash
echo oK
[[email protected] ~]# 

[[email protected] ~]# ansible 192.168.1.112 -m shell -a "/bin/bash /root/test1.sh"
192.168.1.112 | success | rc=0 >>
oK

/sehll执行脚本文件,脚本文件必须在远程节点上存在

看一个简单的playbook文件:

[[email protected] ansible]# vim test.yml 

---
- hosts: 192.168.1.112
  remote_user: root

  tasks:
   - name: lianxi module 1
#file on the remote
     shell: /bin/bash /root/test1.sh
     
/playbook脚本是以.yml为后缀的!下面为执行结果
[[email protected] ~]# cd /etc/ansible
[[email protected] ansible]# ansible-playbook test.yml 

PLAY [192.168.1.112] ********************************************************** 

GATHERING FACTS *************************************************************** 
ok: [192.168.1.112]

TASK: [lianxi module 1] ******************************************************* 
changed: [192.168.1.112]

PLAY RECAP ******************************************************************** 
192.168.1.112              : ok=2    changed=1    unreachable=0    failed=0

4.文件相关模块:

copy 复制本地文件到远程路径下

copy模块将本地文件复制到远程路径下。fetch模块将远程文件复制到本地。

copy的选项:

dest 必选参数,为目标文件指定远程节点上的一个绝对路径。如果src是一个目录,那么该参数也必须是个目录。

src 本地文件的绝对路径,或者相对路径。如果是个路径则会递归复制,路径是以/结尾的话,只复制目录里面的内容,如果不以/几位的话会复制目

录本身和里面的内容。类似Rsync那样。

backup 可选参数,为源文件创建一个备份文件,被给备份文件添加一个时间戳信息。值为:yes/no,默认为no。

[[email protected] ~]# ansible 192.168.1.112 -m copy -a "src=/root/test  dest=/root/ backup=yes"
192.168.1.112 | success >> {
    "changed": true, 
    "checksum": "4e1243bd22c66e76c2ba9eddc1f91394e57f9f83", 
    "dest": "/root/test", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "d8e8fca2dc0f896fd7cb4cb0031ba249", 
    "mode": "0644", 
    "owner": "root", 
    "size": 5, 
    "src": "/root/.ansible/tmp/ansible-tmp-1459869115.84-179543827108657/source", 
    "state": "file", 
    "uid": 0
}

content 可选参数,当使用该参数来代替src的时候,会将内容直接写入到目标文件中。

[[email protected] ~]# ansible 192.168.1.112 -m copy -a "content=‘test test‘ dest=/root/test"
192.168.1.112 | success >> {
    "changed": true, 
    "checksum": "abedc47a5ede3fab13390898c5160ec9afbb6ec3", 
    "dest": "/root/test", 
    "gid": 0, 
    "group": "root", 
    "md5sum": "4f4acc5d8c71f5fbf04dace00b5360c8", 
    "mode": "0644", 
    "owner": "root", 
    "size": 9, 
    "src": "/root/.ansible/tmp/ansible-tmp-1459869735.21-149102614709149/source", 
    "state": "file", 
    "uid": 0
}

查看一下:
[[email protected] ~]# cat test
test test[[email protected] ~]#

directory_mode 可选参数,当递归复制的时候,为所创建的目录设置权限,如果没有指定则使用系统的默认权限。该参数只影响新创建的目录,不会影响已经存在的目录。

[[email protected] ~]# ansible webservers -m copy -a "src=/root/test/ dest=/root/ directory_mode=0777"

force ,该参数默认值为yes,当远程文件与本地文件内容不一致的时候会替换远程文件。只有当远程目标文件不存在的时候才会传输文件。

group 文件或目录的所属组.

[[email protected] ~]# ansible webservers -m copy -a "src=/root/test/testgroup dest=/root/test1/testgroup group=liuzhenwei"

mode 文件或目录的权限,如0644。

[[email protected] ~]# ansible webservers -m copy -a "src=/root/test/testgroup dest=/root/test1/testgroup mode=0755"

看一下copy模块的返回值,各代表的意思:

src 要复制到远程节点的源文件路径

backup_file 远程节点上的备份文件路径,backup=yes的时候才有

uid 文件的所有者ID

dest 目标文件在远程节点上的绝对路径,/root/file.txt

checksum 校验值

md5sum md5校验值

state 状态,如 file

gid 文件的所属组ID

mode 文件的权限

owner 文件所有者

group 文件所属组

size 文件大小

时间: 2024-10-09 23:12:45

ansible模块介绍的相关文章

ansible模块介绍之ios_facts

一.模块简介 收集运行IOS系统的(此处指思科的ios)的远端设备信息 二.模块参数 auth_pass #特权密码,如果参数authorize=no,则不会检索此密码,如果任务task不指定,则默认使用环境变量ANSIBLE_NET_AUTH_PASS代替 authorize #是否进入特权模式,yes是;no不是.如果任务task不指定,则默认使用环境变量ANSIBLE_NET_AUTHORIZE 代替 gather_subset #限定取的子集范围,可跟范围:all(所有设备信息),con

Ansible 常用模块介绍

ansible提供了众多模块,我们可以在ansible主机上运行ansible-doc -l命令查看ansible所有支持的模块.通过ansible-doc -s MODULE_NAME  命令可以查看指定模块的所有参数 查看所有模块 [email protected]:/etc/ansible/roles/tomcat8_install/tasks# ansible-doc  -l less 436 Copyright (C) 1984-2009 Mark Nudelman less come

Ansible 自动化运维工具之inventory和常用模块介绍

一.inventory介绍 前面我们介绍过ansible的hosts文件是存放被管理主机的,被管理主机比较少的情况下,直接在hosts中定义即可,但是以后很定会管理多台主机,而ansible可管理的主机集合就叫做inventory.在ansible中,描述你主机的默认方法是将它们列在一个文本文件中,这个文件叫inventory文件. 一个简单的inventory文件可能只包含一组主机名的列表,如下: ftp.testansible.com samba.testansible.com mail.t

Ansible 之 概念和常用模块介绍

1  概述 ansible是新出现的自动化运维工具,基于Python开发,集合了众多运维工具(puppet.cfengine.chef.func.fabric)的优点,实现了批量系统配置.批量程序部署.批量运行命令等功能. ansible是基于模块工作的,本身没有批量部署的能力.真正具有批量部署的是ansible所运行的模块,ansible只是提供一种框架.主要包括如下的特性: (1).连接插件connection plugins:负责和被监控端实现通信: (2).host inventory:

Ansible的安装、配置及常用模块介绍

Ansible的安装.配置及常用模块介绍 ansible安装方式 1. 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 inst

自动化运维工具ansible详细介绍

在学习批量管理软件时,首先要明确的知道自己需要什么,网上大神很多,他们都研究到源码上了,写了很多介绍绚丽功能的文档,但其实那些功能基本上我们都用不到,经常被各种文档弄得头脑发晕,此文就是为了简单直白的告诉大家ansible的功能,满足大家的基本需求. 首先确认批量管理我们需要什么:无外乎主机分组管理.实时批量执行命令或脚本.实时批量分发文件或目录.定时同步文件等. 目录 1.      ansible与saltstack对比... 2.      ansible安装... 3.      ans

Ansible基础介绍

Ansible是一种基于python编写的自动化批量部署工具.主要应用于批量部署应用和结合Git.Jenkins进行自动化配置管理. Ansible结构: Ansible(核心程序) 就是ansible的心脏大脑,进行各部分的协调调用. Host Invertory(主机群组) 定义了被管理的Client,例如Client的IP.域名或ssh端口等信息. Playbooks(剧本) 用于给Client执行的任务配置文件 Modules(模块) ansible的内置功能模块,例如yum模块,she

自动化运维工具ansible简单介绍

一.Ansible介绍Ansible 简单的说是一个配置管理系统(configuration management system).你只需要可以使用 ssh 访问你的服务器或设备就行.它也不同于其他工具,因为它使用推送的方式,而不是像 puppet 等 那样使用拉取安装agent的方式.ansible可以帮助我们完成一些批量任务,或者完成一些需要经常重复的工作.? 模块化:调用特定的模块,完成特定任务? 有Paramiko,PyYAML,Jinja2(模板语言)三个关键模块? 支持自定义模块?

Ansible基本介绍

一.基础知识: 1. 简介 ansible基于python开发,集合了众多运维工具的优点,实现了批量系统配置.批量程序部署.批量运行命令等功能.ansible是基于模块工作的,本身没有批量部署的能力.        真正具有批量部署的是ansible运行的模块,ansible只是一个框架 (1) 连接插件connection plugins: 负责和被监控端实现通信:        (2) host inventory: 指定操作的主机,是一个配置文件里面定义监控的主机        (3) 各