根據(jù)zs官方的分類,將模塊按功能分類為:云模塊、命令模塊、數(shù)據(jù)庫模塊、文件模塊、資產(chǎn)模塊、消息模塊、監(jiān)控模塊、網(wǎng)絡(luò)模塊、通知模塊、包管理模塊、源碼控制模塊、系統(tǒng)模塊、單元模塊、web設(shè)施模塊、windows模塊 ,具體可以參看官方頁面。
創(chuàng)新互聯(lián)建站網(wǎng)站建設(shè)由有經(jīng)驗(yàn)的網(wǎng)站設(shè)計(jì)師、開發(fā)人員和項(xiàng)目經(jīng)理組成的專業(yè)建站團(tuán)隊(duì),負(fù)責(zé)網(wǎng)站視覺設(shè)計(jì)、用戶體驗(yàn)優(yōu)化、交互設(shè)計(jì)和前端開發(fā)等方面的工作,以確保網(wǎng)站外觀精美、成都網(wǎng)站設(shè)計(jì)、網(wǎng)站建設(shè)易于使用并且具有良好的響應(yīng)性。
這里從官方分類的模塊里選擇最常用的一些模塊進(jìn)行介紹。
測試主機(jī)是否是通的,用法很簡單,不涉及參數(shù):
ansible test -m ping
setup模塊,主要用于獲取主機(jī)信息,在playbooks里經(jīng)常會用到的一個(gè)參數(shù)gather_facts就與該模塊相關(guān)。setup模塊下經(jīng)常使用的一個(gè)參數(shù)是filter參數(shù),具體使用示例如下:
ansible 10.212.52.252 -m setup -a 'filter=ansible_*_mb' //查看主機(jī)內(nèi)存信息
ansible 10.212.52.252 -m setup -a 'filter=ansible_eth[0-2]' //查看地接口為eth0-2的網(wǎng)卡信息
ansible all -m setup --tree /tmp/facts //將所有主機(jī)的信息輸入到/tmp/facts目錄下,每臺主機(jī)的信息輸入到主機(jī)名文件中(/etc/ansible/hosts里的主機(jī)名)
file模塊主要用于遠(yuǎn)程主機(jī)上的文件操作,file模塊包含如下選項(xiàng):
force:需要在兩種情況下強(qiáng)制創(chuàng)建軟鏈接,一種是源文件不存在但之后會建立的情況下;另一種是目標(biāo)軟鏈接已存在,需要先取消之前的軟鏈,然后創(chuàng)建新的軟鏈,有兩個(gè)選項(xiàng):yes|no
group:定義文件/目錄的屬組
mode:定義文件/目錄的權(quán)限
owner:定義文件/目錄的屬主
path:必選項(xiàng),定義文件/目錄的路徑
recurse:遞歸的設(shè)置文件的屬性,只對目錄有效
src:要被鏈接的源文件的路徑,只應(yīng)用于state=link的情況
dest:被鏈接到的路徑,只應(yīng)用于state=link的情況
state:
directory:如果目錄不存在,創(chuàng)建目錄
file:即使文件不存在,也不會被創(chuàng)建
link:創(chuàng)建軟鏈接
hard:創(chuàng)建硬鏈接
touch:如果文件不存在,則會創(chuàng)建一個(gè)新的文件,如果文件或目錄已存在,則更新其最后修改時(shí)間
absent:刪除目錄、文件或者取消鏈接文件
使用示例:
ansible test -m file -a "src=/etc/fstab dest=/tmp/fstab state=link"
ansible test -m file -a "path=/tmp/fstab state=absent"
ansible test -m file -a "path=/tmp/test state=touch"
復(fù)制文件到遠(yuǎn)程主機(jī),copy模塊包含如下選項(xiàng):
backup:在覆蓋之前將原文件備份,備份文件包含時(shí)間信息。有兩個(gè)選項(xiàng):yes|no
content:用于替代"src",可以直接設(shè)定指定文件的值
dest:必選項(xiàng)。要將源文件復(fù)制到的遠(yuǎn)程主機(jī)的絕對路徑,如果源文件是一個(gè)目錄,那么該路徑也必須是個(gè)目錄
directory_mode:遞歸的設(shè)定目錄的權(quán)限,默認(rèn)為系統(tǒng)默認(rèn)權(quán)限
force:如果目標(biāo)主機(jī)包含該文件,但內(nèi)容不同,如果設(shè)置為yes,則強(qiáng)制覆蓋,如果為no,則只有當(dāng)目標(biāo)主機(jī)的目標(biāo)位置不存在該文件時(shí),才復(fù)制。默認(rèn)為yes
others:所有的file模塊里的選項(xiàng)都可以在這里使用
src:要復(fù)制到遠(yuǎn)程主機(jī)的文件在本地的地址,可以是絕對路徑,也可以是相對路徑。如果路徑是一個(gè)目錄,它將遞歸復(fù)制。在這種情況下,如果路徑使用"/"來結(jié)尾,則只復(fù)制目錄里的內(nèi)容,如果沒有使用"/"來結(jié)尾,則包含目錄在內(nèi)的整個(gè)內(nèi)容全部復(fù)制,類似于rsync。
validate :The validation command to run before copying into place. The path to the file to validate is passed in via '%s' which must be present as in the visudo example below.
示例如下:
ansible test-m copy -a "src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644"
ansible test -m copy -a "src=/mine/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes"
ansible test -m copy -a "src=/mine/sudoers dest=/etc/sudoers validate='visudo -cf %s'"
用于管理服務(wù)
該模塊包含如下選項(xiàng):
arguments:給命令行提供一些選項(xiàng)
enabled:是否開機(jī)啟動 yes|no
name:必選項(xiàng),服務(wù)名稱
pattern:定義一個(gè)模式,如果通過status指令來查看服務(wù)的狀態(tài)時(shí),沒有響應(yīng),就會通過ps指令在進(jìn)程中根據(jù)該模式進(jìn)行查找,如果匹配到,則認(rèn)為該服務(wù)依然在運(yùn)行
runlevel:運(yùn)行級別
sleep:如果執(zhí)行了restarted,在則stop和start之間沉睡幾秒鐘
state:對當(dāng)前服務(wù)執(zhí)行啟動,停止、重啟、重新加載等操作(started,stopped,restarted,reloaded)
使用示例:
ansible test -m service -a "name=httpd state=started enabled=yes"
asnible test -m service -a "name=foo pattern=/usr/bin/foo state=started"
ansible test -m service -a "name=network state=restarted args=eth0"
用于管理計(jì)劃任務(wù)包含如下選項(xiàng):
backup:對遠(yuǎn)程主機(jī)上的原任務(wù)計(jì)劃內(nèi)容修改之前做備份
cron_file:如果指定該選項(xiàng),則用該文件替換遠(yuǎn)程主機(jī)上的cron.d目錄下的用戶的任務(wù)計(jì)劃
day:日(1-31,*,*/2,……)
hour:小時(shí)(0-23,*,*/2,……)
minute:分鐘(0-59,*,*/2,……)
month:月(1-12,*,*/2,……)
weekday:周(0-7,*,……)
job:要執(zhí)行的任務(wù),依賴于state=present
name:該任務(wù)的描述
special_time:指定什么時(shí)候執(zhí)行,參數(shù):reboot,yearly,annually,monthly,weekly,daily,hourly
state:確認(rèn)該任務(wù)計(jì)劃是創(chuàng)建還是刪除
user:以哪個(gè)用戶的身份執(zhí)行
示例:
ansible test -m cron -a 'name="a job for reboot" special_time=reboot job="/some/job.sh"'
ansible test -m cron -a 'name="yum autoupdate" weekday="2" minute=0 hour=12 user="root
ansible test -m cron -a 'backup="True" name="test" minute="0" hour="5,2" job="ls -alh > /dev/null"'
ansilbe test -m cron -a 'cron_file=ansible_yum-autoupdate state=absent'
使用yum包管理器來管理軟件包,其選項(xiàng)有:
config_file:yum的配置文件
disable_gpg_check:關(guān)閉gpg_check
disablerepo:不啟用某個(gè)源
enablerepo:啟用某個(gè)源
name:要進(jìn)行操作的軟件包的名字,也可以傳遞一個(gè)url或者一個(gè)本地的rpm包的路徑
state:狀態(tài)(present,absent,latest)
示例如下:
ansible test-m yum -a 'name=httpd state=latest'
ansible test -m yum -a 'name="@Development tools" state=present'
ansible test -m yum -a 'name=http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm state=present'
user模塊是請求的是useradd, userdel, usermod三個(gè)指令,goup模塊請求的是groupadd, groupdel, groupmod 三個(gè)指令。
home:指定用戶的家目錄,需要與createhome配合使用
groups:指定用戶的屬組
uid:指定用的uid
password:指定用戶的密碼
name:指定用戶名
createhome:是否創(chuàng)建家目錄 yes|no
system:是否為系統(tǒng)用戶
remove:當(dāng)state=absent時(shí),remove=yes則表示連同家目錄一起刪除,等價(jià)于userdel -r
state:是創(chuàng)建還是刪除
shell:指定用戶的shell環(huán)境
使用示例:
user: name=johnd comment="John Doe" uid=1040 group=admin
user: name=james shell=/bin/bash groups=admins,developers append=yes user: name=johnd state=absent remove=yes
user: name=james18 shell=/bin/zsh groups=developers expires=1422403387
user: name=test generate_ssh_key=yes ssh_key_bits=2048 ssh_key_file=.ssh/id_rsa #生成密鑰時(shí),只會生成公鑰文件和私鑰文件,和直接使用ssh-keygen指令效果相同,不會生成authorized_keys文件。
注:指定password參數(shù)時(shí),不能使用明文密碼,因?yàn)楹竺孢@一串密碼會被直接傳送到被管理主機(jī)的/etc/shadow文件中,所以需要先將密碼字符串進(jìn)行加密處理。然后將得到的字符串放到password中即可。
echo "123456" | openssl passwd -1 -salt $(< /dev/urandom tr -dc '[:alnum:]' | head -c 32) -stdin
$1$4P4PlFuE$ur9ObJiT5iHNrb9QnjaIB0
#使用上面的密碼創(chuàng)建用戶
ansible all -m user -a 'name=foo password="$1$4P4PlFuE$ur9ObJiT5iHNrb9QnjaIB0"'
不同的發(fā)行版默認(rèn)使用的加密方式可能會有區(qū)別,具體可以查看/etc/login.defs文件確認(rèn),centos 6.5版本使用的是SHA512加密算法。
ansible all -m group -a 'name=somegroup state=present'
使用rsync同步文件,其參數(shù)如下:
archive: 歸檔,相當(dāng)于同時(shí)開啟recursive(遞歸)、links、perms、times、owner、group、-D選項(xiàng)都為yes ,默認(rèn)該項(xiàng)為開啟
checksum: 跳過檢測sum值,默認(rèn)關(guān)閉
compress:是否開啟壓縮
copy_links:復(fù)制鏈接文件,默認(rèn)為no ,注意后面還有一個(gè)links參數(shù)
delete: 刪除不存在的文件,默認(rèn)no
dest:目錄路徑
dest_port:默認(rèn)目錄主機(jī)上的端口 ,默認(rèn)是22,走的ssh協(xié)議
dirs:傳速目錄不進(jìn)行遞歸,默認(rèn)為no,即進(jìn)行目錄遞歸
rsync_opts:rsync參數(shù)部分
set_remote_user:主要用于/etc/ansible/hosts中定義或默認(rèn)使用的用戶與rsync使用的用戶不同的情況
mode: push或pull 模塊,push模的話,一般用于從本機(jī)向遠(yuǎn)程主機(jī)上傳文件,pull 模式用于從遠(yuǎn)程主機(jī)上取文件
使用示例:
src=some/relative/path dest=/some/absolute/path rsync_path="sudo rsync"
src=some/relative/path dest=/some/absolute/path archive=no links=yes
src=some/relative/path dest=/some/absolute/path checksum=yes times=no
src=/tmp/helloworld dest=/var/www/helloword rsync_opts=--no-motd,--exclude=.git mode=pull
dev:目標(biāo)塊設(shè)備
force:在一個(gè)已有文件系統(tǒng) 的設(shè)備上強(qiáng)制創(chuàng)建
fstype:文件系統(tǒng)的類型
opts:傳遞給mkfs命令的選項(xiàng)
ansible test -m filesystem -a 'fstype=ext2 dev=/dev/sdb1 force=yes'
ansible test -m filesystem -a 'fstype=ext4 dev=/dev/sdb1 opts="-cc"'
配置掛載點(diǎn)
選項(xiàng):
dump
fstype:必選項(xiàng),掛載文件的類型
name:必選項(xiàng),掛載點(diǎn)
opts:傳遞給mount命令的參數(shù)
src:必選項(xiàng),要掛載的文件
state:必選項(xiàng)
present:只處理fstab中的配置
absent:刪除掛載點(diǎn)
mounted:自動創(chuàng)建掛載點(diǎn)并掛載之
umounted:卸載
示例:
name=/mnt/dvd src=/dev/sr0 fstype=iso9660 opts=ro state=present
name=/srv/disk src='LABEL=SOME_LABEL' state=present
name=/home src='UUID=b3e48f45-f933-4c8e-a700-22a159ec9077' opts=noatime state=present
ansible test -a 'dd if=/dev/zero of=/disk.img bs=4k count=1024'
ansible test -a 'losetup /dev/loop0 /disk.img'
ansible test -m filesystem 'fstype=ext4 force=yes opts=-F dev=/dev/loop0'
ansible test -m mount 'name=/mnt src=/dev/loop0 fstype=ext4 state=mounted opts=rw'
該模塊主要用于從http、ftp、https服務(wù)器上下載文件(類似于wget),主要有如下選項(xiàng):
sha256sum:下載完成后進(jìn)行sha256 check;
timeout:下載超時(shí)時(shí)間,默認(rèn)10s
url:下載的URL
url_password、url_username:主要用于需要用戶名密碼進(jìn)行驗(yàn)證的情況
use_proxy:是事使用代理,代理需事先在環(huán)境變更中定義
示例:
get_url: url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440
get_url: url=http://example.com/path/file.conf dest=/etc/foo.conf sha256sum=b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c
用于解壓文件,模塊包含如下選項(xiàng):
copy:在解壓文件之前,是否先將文件復(fù)制到遠(yuǎn)程主機(jī),默認(rèn)為yes。若為no,則要求目標(biāo)主機(jī)上壓縮包必須存在。
creates:指定一個(gè)文件名,當(dāng)該文件存在時(shí),則解壓指令不執(zhí)行
dest:遠(yuǎn)程主機(jī)上的一個(gè)路徑,即文件解壓的路徑
grop:解壓后的目錄或文件的屬組
list_files:如果為yes,則會列出壓縮包里的文件,默認(rèn)為no,2.0版本新增的選項(xiàng)
mode:解決后文件的權(quán)限
src:如果copy為yes,則需要指定壓縮文件的源路徑
owner:解壓后文件或目錄的屬主
示例如下:
- unarchive: src=foo.tgz dest=/var/lib/foo
- unarchive: src=/tmp/foo.zip dest=/usr/local/bin copy=no
- unarchive: src=https://example.com/example.zip dest=/usr/local/bin copy=no