ansible常用模塊介紹

ansible查看模塊用法

例子 查看shell 模塊使用方法

[[email protected] opt]# ansible-doc -s shell

註： -i 指定配置文件 tomcatserver自己定義的工作組 -m 指定模塊

file模塊

file模塊包含如下選項：

force：需要在兩種情況下強制創建軟鏈接，一種是源文件不存在但之後會建立的情況下；另一種是目標軟鏈接已存在,需要先取消之前的軟鏈，然後創建新的軟鏈，有兩個選項：yes|no

group：定義文件/目錄的屬組

mode：定義文件/目錄的權限

owner：定義文件/目錄的屬主

path：必選項，定義文件/目錄的路徑

recurse：遞歸的設置文件的屬性，只對目錄有效

src：要被鏈接的源文件的路徑，只應用於state=link的情況

dest：被鏈接到的路徑，只應用於state=link的情況

state：

directory：如果目錄不存在，創建目錄

file：即使文件不存在，也不會被創建

link：創建軟鏈接

hard：創建硬鏈接

touch：如果文件不存在，則會創建一個新的文件，如果文件或目錄已存在，則更新其最後修改時間

absent：刪除目錄、文件或者取消鏈接文件

1.創建file1文件

[[email protected] opt]# ansible -i hosts tomcatserver -m file -a ‘path=/tmp/file1 state=touch‘

2.刪除file1 文件

ansible常用語句

[[email protected] opt]# ansible -i hosts tomcatserver -m file -a ‘path=/tmp/file1 state=absent‘

3.創建d1目錄

[[email protected] opt]# ansible -i hosts tomcatserver -m file -a ‘path=/tmp/d1 state=directory owner=root group=root mode=777‘

copy模塊

copy模塊包含如下選項：

backup：在覆蓋之前將原文件備份，備份文件包含時間信息。有兩個選項：yes|no

content：用於替代"src",可以直接設定指定文件的值

dest：必選項。要將源文件復制到的遠程主機的絕對路徑，如果源文件是一個目錄，那麽該路徑也必須是個目錄

directory_mode：遞歸的設定目錄的權限，默認為系統默認權限

force：如果目標主機包含該文件，但內容不同，如果設置為yes，則強制覆蓋，如果為no，則只有當目標主機的目標位置不存在該文件時，才復制。默認為yes

others：所有的file模塊裏的選項都可以在這裏使用

src：要復制到遠程主機的文件在本地的地址，可以是絕對路徑，也可以是相對路徑。如果路徑是一個目錄，它將遞歸復制。在這種情況下，如果路徑使用"/"來結尾，則只復制目錄裏的內容，如果沒有使用"/"來結尾，則包含目錄在內的整個內容全部復制，類似於rsync。

1.拷貝yum.log文件到root下的file2

[[email protected] opt]# ansible -i hosts tomcatserver -m copy -a ‘src=/tmp/yum.log dest=/root/file2 mode=755 owner=root group=root‘

2.cretes模塊執行的時候 會做一個判斷 前面的參數存在 後面的命令才不會繼續執行下去

[[email protected] opt]# ansible -i hosts tomcatserver -a ‘creates=/root/file2 ls /home‘

command模塊

command模塊包含如下選項：

creates：一個文件名，當該文件存在，則該命令不執行

free_form：要執行的Linux指令

chdir：在執行指令之前，先切換到該指定的目錄

removes：一個文件名，當該文件不存在，則該選項不執行

executable：切換shell來執行指令，該執行路徑必須是一個絕對路徑

1.查看硬盤使用情況 裏面可以使用一些命令

[[email protected] opt]# ansible -i hosts tomcatserver -m command -a ‘df -hT‘

2.查看文件內容

[[email protected] opt]# ansible -i hotst tomcatserver -m command -a ‘cat /var/www/helloword‘

chdir模塊

.chdir 進入到指定的目錄然後進行操作

進入到tmp 用戶下面將passwd 文件壓縮成 bbb.tar 文件

[[email protected] opt]# ansible -i hosts tomcatserver -a ‘chdir=/tmp/ tar zcf bbb.tar.gz passwd‘

shell 模塊

1.shell 模塊使用

與command模塊使用相似 但是shell支持管道

[[email protected] opt]# ansible -i hosts tomcatserver -m shell -a ‘ps -ef | grep httpd‘

2.raw模塊 與上面shell 相似

[[email protected] opt]# ansible -i hosts tomcatserver -m raw -a ‘ps -ef | grep httpd‘

server模塊

該模塊包含如下選項：

arguments：給命令行提供一些選項

enabled：是否開機啟動 yes|no

name：必選項，服務名稱

pattern：定義一個模式，如果通過status指令來查看服務的狀態時，沒有響應，就會通過ps指令在進程中根據該模式進行查找，如果匹配到，則認為該服務依然在運行

runlevel：運行級別

sleep：如果執行了restarted，在則stop和start之間沈睡幾秒鐘

state：對當前服務執行啟動，停止、重啟、重新加載等操作（started,stopped,restarted,reloaded）

1.啟動httpd服務 並且開機啟動

[[email protected] opt]# ansible -i hosts tomcatserver -m service -a ‘name=httpd state=started enabled=yes‘

2.關閉httpd服務

[[email protected] opt]# ansible -i hosts tomcatserver -m service -a ‘name=httpd state=stop‘

3.重啟httpd服務 並且沈睡3秒鐘

[[email protected] opt]# ansible -i hosts tomcatserver -m service -a ‘name=httpd state=restarted sleep=3‘

4.重啟network 只重啟eth0 網卡

[[email protected] opt]# ansible -i hosts tomcatserver -m service -a ‘name=network state=restarted args=eth0‘

corn模塊

包含如下選項：

backup：對遠程主機上的原任務計劃內容修改之前做備份

cron_file：如果指定該選項，則用該文件替換遠程主機上的cron.d目錄下的用戶的任務計劃

day：日（1-31，*，*/2,……）

hour：小時（0-23，*，*/2，……）

minute：分鐘（0-59，*，*/2，……）

month：月（1-12，*，*/2，……）

weekday：周（0-7，*，……）

job：要執行的任務，依賴於state=present

name：該任務的描述

special_time：指定什麽時候執行，參數：reboot,yearly,annually,monthly,weekly,daily,hourly

state：確認該任務計劃是創建還是刪除

user：以哪個用戶的身份執行

1.root用戶下 重啟系統計劃任務 每天的兩點進行重啟系統

[[email protected] opt]# ansible -i hosts tomcatserver -m cron -a ‘name="reboot system" hour=2 user=root job="/sbin/reboot"‘

2.刪除計劃任務 使用state=sbsent

[[email protected] opt]# ansible -i hosts tomcatserver -m cron -a ‘name="reboot system" hour=2 user=root job="/sbin/reboot" state=absent‘

3.每三分鐘檢查一下home下的文件

[[email protected] opt]# ansible -i hosts tomcatserver -m command -a "crontab -l"

4.special_time指定什麽時候執行

[[email protected] opt]# ansible -i hosts tomcatserver -m command -a "crontab -l"

5.刪除計劃任務（name 指定計劃任務名稱）

[[email protected] opt]# ansible -i hosts tomcatserver -m cron -a ‘name="list dir" state=absent‘

yum 模塊

選項：

config_file：yum的配置文件

disable_gpg_check：關閉gpg_check

disablerepo：不啟用某個源

enablerepo：啟用某個源

list

name：要進行操作的軟件包的名字，也可以傳遞一個url或者一個本地的rpm包的路徑

state：狀態（present，absent，latest）

1.安裝mysql服務

[[email protected] opt]# ansible -i hosts tomcatserver -m yum -a ‘name=mysql state=installed‘

2.卸載mysql服務

[[email protected] opt]# ansible -i hosts tomcatserver -m yum -a ‘name=mysql state=absent‘

user模塊

home：指定用戶的家目錄，需要與createhome配合使用

groups：指定用戶的屬組

uid：指定用的uid

password：指定用戶的密碼

name：指定用戶名

createhome：是否創建家目錄 yes|no

system：是否為系統用戶

remove：當state=absent時，remove=yes則表示連同家目錄一起刪除，等價於userdel -r

state：是創建還是刪除

shell：指定用戶的shell環境

1.創建用戶

[[email protected] opt]# ansible -i hosts tomcatserver -m command -a ‘useradd -s /sbin/nologine -M user1‘

2.使用user模塊創建模塊

createhome 是否創建家目錄 指定home 指定密碼 指定用戶 指定shell 狀態創建

[[email protected] opt]# ansible -i hosts tomcatserver -m user -a ‘createhome=yes home=/home/user2 password=123456 name=user2 shell=/bin/bash state=present‘

3.刪除用戶

[[email protected] opt]# ansible -i hosts tomcatserver -m user -a ‘remove=yes name=user2 state=absent‘

synchronize模塊（同步文件）

使用rsync同步文件

archive #鏡像rsync存檔標誌，支持遞歸、鏈接、perms、times、owner、group flags和- d,選項都為yes 默認該項為開啟。

owner、group、-D選項都為yes ，默認該項為開啟

checksum: 跳過檢測sum值，默認關閉

compress:是否開啟壓縮

copy_links：復制鏈接文件，默認為no ，註意後面還有一個links參數

delete: 刪除不存在的文件，默認no

dest：目錄路徑

dest_port：默認目錄主機上的端口 ，默認是22，走的ssh協議

dirs：傳速目錄不進行遞歸，默認為no，即進行目錄遞歸

rsync_opts：rsync參數部分

set_remote_user：主要用於/etc/ansible/hosts中定義或默認使用的用戶與rsync使用的用戶不同的情況

mode: push或pull 模塊，push模的話，一般用於從本機向遠程主機上傳文件，pull 模式用於從遠程主機上取文件

1.同步文件，將、tmp下的helloword文件復制到、var、www 的目錄裏面 src 指定原地址 dest 目標地址

[[email protected] opt]# ansible -i hosts tomcatserver -m synchronize -a ‘src=/tmp/helloword dest=/var/www/‘

2.查看文件內容

[[email protected] opt]# ansible -i hotst tomcatserver -m command -a ‘cat /var/www/helloword‘

3.同步目錄

同步/var/log/下面所有的日誌 mode 指定模式 rsync_path 指定遠程主機的sync命令 sync_opts 指定額外的rsync選項

[[email protected] opt]# ansible -i hosts tomcatserver -m synchronize -a ‘src=/var/log/ dest=/var/www/ mode=push rsync_path=/usr/bin/rsync rsync_opts="-avz,--exclude=.git"‘

filesystem模塊

設置文件的屬性

file模塊包含如下選項：

force：需要在兩種情況下強制創建軟鏈接，一種是源文件不存在但之後會建立的情況下；另一種是目標軟鏈接已存在,需要先取消之前的軟鏈，然後創建新的軟鏈，有兩個選項：yes|no

group：定義文件/目錄的屬組

mode：定義文件/目錄的權限

owner：定義文件/目錄的屬主

path：必選項，定義文件/目錄的路徑

recurse：遞歸的設置文件的屬性，只對目錄有效

src：要被鏈接的源文件的路徑，只應用於state=link的情況

dest：被鏈接到的路徑，只應用於state=link的情況

state：

directory：如果目錄不存在，創建目錄

file：即使文件不存在，也不會被創建

link：創建軟鏈接

hard：創建硬鏈接

touch：如果文件不存在，則會創建一個新的文件，如果文件或目錄已存在，則更新其最後修改時間

absent：刪除目錄、文件或者取消鏈接文件

在塊設備上創建文件系統

1.創建一個4M 的文件系統

[[email protected] opt]# ansible -i hosts tomcatserver -a ‘dd if=/dev/zero of=/disk.img bs=4k count=1024‘

2.把disk.img作為loop設備從而可以進行分區格式化

[[email protected] opt]# ansible -i hosts tomcatserver -m command -a ‘losetup /dev/loop0 /disk.img‘

3.格式化硬盤分區

-F額外的參數 對照mkfs /dev/disk.img -F 強制格式化

[[email protected] opt]# ansible -i hosts tomcatserver -m filesystem -a ‘dev=/disk.img fstype=ext4 opts=-F‘

mount掛載模塊

選項：

dump

fstype：必選項，掛載文件的類型

name：必選項，掛載點

opts：傳遞給mount命令的參數

passno

src：必選項，要掛載的文件

state：必選項

present：只處理fstab中的配置

absent：刪除掛載點

mounted：自動創建掛載點並掛載之

umounted：卸載

1.掛載設備/dev/loop0 到aaa state=mounted 掛載並且創建掛載點

[[email protected] opt]# ansible -i hosts tomcatserver -m mount -a ‘fstype=ext4 name=/aaa src=/dev/loop0 state=mounted‘

2.查看硬盤掛載情況

[[email protected]uegod100 opt]# ansible -i hosts tomcatserver -m command -a ‘df -hT‘

3.在掛載的設備上面創建文件測試

[[email protected] opt]# ansible -i hosts tomcatserver -m file -a ‘path=/aaa/test state=touch‘

本文出自 “天真無邪” 博客，謝絕轉載！

ansible常用模塊介紹