ansible的12個常用模塊介紹

一、ansible 常用命令

1、ansible 命令集

/usr/bin/ansible　 //Ansibe AD-Hoc 臨時命令執行工具，常用于臨時命令的執行
/usr/bin/ansible-doc   //Ansible 模塊功能查看工具
/usr/bin/ansible-galaxy　　//下載/上傳優秀代碼或Roles模塊的官網平臺，基于網路的
/usr/bin/ansible-playbook  //Ansible 定制自動化的任務集編排工具
/usr/bin/ansible-pull　　 //Ansible遠程執行命令的工具，拉取配置而非推送配置（使用較少，海量機器時使用，對運維的架構能力要求較高）
/usr/bin/ansible-vault　　 //Ansible 檔案加密工具
/usr/bin/ansible-console　 //Ansible基于Linux Consoble界面可與用戶互動的命令執行工具

其中，我們比較常用的是/usr/bin/ansible和/usr/bin/ansible-playbook，而這里主要講/usr/bin/ansible的使用，

2、ansible-doc 命令

1）使用ansible-doc命令查看模塊用法

注：如果列出的資訊較多，可使用空格翻頁，或向下的鍵依次查看，最后輸入“q”退出，

ansible-doc yum

2）ansible-doc命令常用于獲取模塊資訊及其使用幫助

//列出所有已安裝的模塊;注:按q退出
ansible-doc -l
//-s列出yum模塊描述資訊和操作動作
ansible-doc -s yum  
ansible-doc -s command

注：如果列出的資訊較多，可使用空格翻頁，或向下的鍵依次查看，最后輸入“q”退出，

二、ansible命令模塊

1、command模塊

command 模塊可以幫助我們在遠程主機上執行命令，
注意：使用 command 模塊在遠程主機中執行命令時，不會經過遠程主機的 shell 處理，在使用 command 模塊時，如果需要執行的命令中含有重定向、管道符等操作時，這些符號也會失效，比如”<”, “>”, “|”, “;” 和 “&” 這些符號，如果你需要這些功能，可以參考后面介紹的 shell 模塊，還有一點需要注意，如果遠程節點是 windows 作業系統，則需要使用 win_command 模塊，
執行 ansible 時，不加 -m 默認使用 command ，可以在 /etc/ansible/ansible.cfg 中修改，

1）常用引數

可用 ansible-doc command 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

free_form引數 ：必須引數，指定需要遠程執行的命令，需要說明一點，free_form 引數與其他引數（如果想要使用一個引數，那么則需要為這個引數賦值，也就是name=value模式）并不相同，比如，當我們想要在遠程主機上執行 ls 命令時，我們并不需要寫成”free_form=ls” ，這樣寫反而是錯誤的，因為并沒有任何引數的名字是 free_form，當我們想要在遠程主機中執行 ls 命令時，直接寫成 ls 即可，因為 command 模塊的作用是執行命令，所以，任何一個可以在遠程主機上執行的命令都可以被稱為 free_form，

chdir引數 : 此引數的作用就是指定一個目錄，在執行對應的命令之前，會先進入到 chdir 引數指定的目錄中，

creates引數 ：看到 creates，你可能會從字面上理解這個引數，但是使用這個引數并不會幫助我們創建檔案，它的作用是當指定的檔案存在時，就不執行對應命令，比如，如果 /testdir/test檔案存在，就不執行我們指定的命令，

removes引數 ：與 creates 引數的作用正好相反，它的作用是當指定的檔案不存在時，就不執行對應命令，比如，如果 /testdir/tests 檔案不存在，就不執行我們指定的命令，此引數并不會幫助我們洗掉檔案，

2）舉例

命令格式：ansible [主機] [-m 模塊] [-a args]
//所有主機執行data命令，其中all可以換成IP或者分類名稱，例：192.168.2.4 / webserver
ansible all -m command -a 'date'
//指定ip執行date
ansible 192.168.2.4 -m command -a 'date'
//指定分組執行date
ansible webserver -m command -a 'date'

#不加-m模塊，則默認使用command模塊
ansible all -a 'date'
ansible all -a 'ls /root'

2、ping模塊

檢查指定節點機器是否還能連通，用法很簡單，不涉及引數，主機如果在線，則回復pong

可用 ansible-doc ping 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

ansible all -m ping

3、cron模塊

cron 模塊可以幫助我們管理遠程主機中的計劃任務，功能相當于 crontab 命令，
在了解cron模塊的引數之前，先寫出一些計劃任務的示例：
// 示例1，每天的1點5分輸出 test 字符
5 1 * * * echo test

// 示例2，每3天執行一次計劃任務，于當天的1點1分執行，具體任務為輸出 test 字符
1 1 */3 * * echo test

// 示例3，每次系統啟動后需要執行一次計劃任務，具體任務為輸出 test 字符
@reboot echo test

// 示例4，每小時執行一次計劃任務，具體任務為輸出 test 字符
@hourly echo test

1）cron模塊常用引數

可用 ansible-doc cron 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

`minute`引數：此引數用于設定計劃任務中分鐘設定位的值，比如，上述示例1中分鐘設定位的值為5，即 minute=5，當不使用此引數時，分鐘設定位的值默認為”*”，

`hour`引數：此引數用于設定計劃任務中小時設定位的值，比如，上述示例1中小時設定位的值為1，即 hour=1，當不使用此引數時，小時設定位的值默認為”*”，

`day`引數：此引數用于設定計劃任務中日設定位的值，當不使用此引數時，日設定位的值默認為”*”，

`month`引數：此引數用于設定計劃任務中月設定位的值，當不使用此引數時，月設定位的值默認為”*”，

`weekday`引數：此引數用于設定計劃任務中周幾設定位的值，當不使用此引數時，周幾設定位的值默認為”*”，

`special_time`引數：在上述示例3與示例4中，計劃任務的時間設定格式為 @reboot 或者@hourly，@reboot 表示重啟時執行，@hourly 表示每小時執行一次，相當于設定成”0 0 * * *” ，這種@開頭的時間設定格式則需要使用 special_time 引數進行設定，special_time 引數的可用值有 reboot(重啟后)、yearly(每年)、annually(每年，與yearly相同)、monthly(每月)、weekly(每周)、daily(每天)、hourly(每時)，

注意：當上述時間單位設定引數都未指定時，計劃任務的時間設定默認會被設定為”* * * * *”，這樣表示每秒都會執行一次計劃任務，所以，在使用cron模塊時，我們應該確定對應的時間引數設定正確，

`user`引數：此引數用于設定當前計劃任務屬于哪個用戶，當不使用此引數時，默認為管理員用戶，

`job`引數：此引數用于指定計劃的任務中需要實際執行的命令或者腳本，比如上例中的 “echo test” 命令，

`name`引數：此引數用于設定計劃任務的名稱，計劃任務的名稱會在注釋中顯示，當不指定計劃任務的名稱時，ansible 會默認為計劃任務加入注釋，注釋的內容為 //Ansible: None，假設指定計劃任務的名稱為 test，那么注釋的內容為 //Ansible: test，在一臺機器中，計劃任務的名稱應該具有唯一性，方便我們以后根據名稱修改或洗掉計劃任務，

`state`引數：當計劃任務有名稱時，我們可以根據名稱修改或洗掉對應的任務，當洗掉計劃任務時，需要將 state 的值設定為 absent，

`disabled`引數：當計劃任務有名稱時，我們可以根據名稱使對應的任務”失效”（注釋掉對應的任務），注意，使用此引數時，除了需要指定任務的名稱，還需要同時指定任務的job 以及任務的時間設定，而且任務的時間設定必須和對應任務完全相同，否則在注釋任務的同時，任務的時間設定會被修改，除非你確定這樣做，

`backup`引數：如果此引數的值設定為 yes，那么當修改或者洗掉對應的計劃任務時，會先對計劃任務進行備份，然后再對計劃任務進行修改或者洗掉，cron 模塊會在遠程主機的 /tmp 目錄下創建備份檔案，以 crontab 開頭并且隨機加入一些字符，具體的備份檔案名稱會在回傳資訊的 backup_file 欄位中看到，推薦將此此引數設定為 yes，

2）示例

//在 webserver 主機上創建計劃任務，任務名稱為”crontab test”，任務于每天1點5分執行，任務內容為輸出test字符，
ansible webserver -m cron -a " name='crontab test' minute=5 hour=1 job='echo test' "
//查看webserver主機上的計劃任務
ansible webserver -a 'crontab -l'
//移除webserver主機上的計劃任務
ansible webserver -m cron -a 'name="crontab test" state=absent'

//在 webserver 主機上創建計劃任務，任務名稱為”special time test”，任務將在重啟時執行，任務內容為輸出 test 字符，
ansible webserver -m cron -a " name='special time test' special_time=reboot job='echo test' "
//查看webserver主機上的計劃任務
ansible webserver -a 'crontab -l'
//移除webserver主機上的計劃任務
ansible webserver -m cron -a 'name="special time test" state=absent'

//由于”special time test”已經存在，所以，當我們再次操作同名的任務時，ansible 將會認為是修改原來的任務，執行如下命令，原計劃任務會被修改，因為啟用了 backup，所以任務在修改前會被備份，
ansible webserver -m cron -a " name='special time test' special_time=hourly job='echo test' backup=yes "
//查看webserver主機上的計劃任務
ansible webserver -a 'crontab -l'
//移除webserver主機上的計劃任務
ansible webserver -m cron -a 'name="special time test" state=absent'

//我們想要將special time  test 這個任務注釋掉，則需要使用如下命令，注意，最好與 backup 引數同時使用，
ansible webserver -m cron -a " name='special time test' minute=55 job='echo test' disabled=yes backup=yes"
//查看webserver主機上的計劃任務
ansible webserver -a 'crontab -l'
//移除webserver主機上的計劃任務
ansible webserver -m cron -a 'name="special time test" state=absent'

4、user模塊

user 模塊可以幫助我們管理遠程主機上的用戶，比如創建用戶、修改用戶、洗掉用戶、為用戶創建密鑰對等操作，

1）常用引數

可用 ansible-doc user 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

`name`引數：必須引數，用于指定要操作的用戶名稱，可以使用別名 user，

`group`引數：此引數用于指定用戶所在的基本組，

`gourps`引數：此引數用于指定用戶所在的附加組，注意，如果說用戶已經存在并且已經擁有多個附加組，那么如果想要繼續添加新的附加組，需要結合 append 引數使用，否則在默認情況下，當再次使用 groups 引數設定附加組時，用戶原來的附加組會被覆寫，

`append`引數：如果用戶原本就存在多個附加組，那么當使用 groups 引數設定附加組時，當前設定會覆寫原來的附加組設定，如果不想覆寫原來的附加組設定，需要結合 append 引數，將 append 設定為 yes，表示追加附加組到現有的附加組設定，append 默認值為 no，

`shell`引數：此引數用于指定用戶的默認 shell，

`uid`引數：此引數用于指定用戶的 uid 號，

`expires`引數：此引數用于指定用戶的過期時間

`comment`引數：此引數用于指定用戶的注釋資訊，

`state`引數：此引數用于指定用戶是否存在于遠程主機中，可選值有 present、absent，默認值為 present，表示用戶需要存在，當設定為 absent 時表示洗掉用戶，

`remove`引數：當 state 的值設定為 absent 時，表示要洗掉遠程主機中的用戶，但是在洗掉用戶時，不會洗掉用戶的家目錄等資訊，這是因為 remove 引數的默認值為 no，如果設定為yes，在洗掉用戶的同時，會洗掉用戶的家目錄，當 state=absent 并且 remove=yes 時，相當于執行 “userdel --remove” 命令，

`password`引數：此引數用于指定用戶的密碼，但是這個密碼不能是明文的密碼，而是一個對明文密碼”加密后”的字串

2）示例

user該模塊主要是用來管理用戶賬號
user模塊是請求的是useradd，userdel，usermod三個指令
//在 mysql 主機上創建名為 test01 的用戶，如果用戶已經存在，則不進行任何操作，
ansible mysql -m user -a 'name="test01"'
//查看在 mysql 主機上創建的用戶資訊
ansible mysql -a 'tail -3 /etc/passwd'
//在 mysql 主機上洗掉名為 test01 的用戶，但是不會洗掉 test01 用戶的家目錄，
ansible mysql -m user -a 'name="test01" state=absent'
//查看mysql主機上的除root用戶外的所有用戶的家目錄
ansible mysql -a 'ls /home'
//在 mysql 主機上洗掉名為 test01 的用戶，同時會洗掉 test01 用戶的家目錄，如果已經不存在 test01 的用戶，則不做任何操作，
ansible mysql -m user -a 'name="test01" state=absent remove=yes'

指定 mysql 主機上的 test01 用戶的過期時間為2021年12月31日，使用”date -d 2021-12-31 +%s“命令可以獲取到對應日期的 unix 時間戳，
//獲取到對應日期的 unix 時間戳，
date -d 2021-12-31 +%s
//遠程部署在 mysql 主機上創建名為 test01 的用戶，指定 mysql 主機上的 test01 用戶的過期時間為2021年12月31日
ansible mysql -m user -a 'name=test01 expires=1640880000'
//查看在 mysql 主機上創建的用戶資訊
ansible mysql -a 'tail -3 /etc/passwd'
//查看 mysql 主機上保存用戶的密碼、賬號有效期等資訊
ansible mysql -a 'tail -3 /etc/shadow'

圖片上寫錯了，18991天除以365，相當于52年

5、group模塊

group 模塊可以幫助我們管理遠程主機上的組，
group模塊請求的是groupadd，groupdel，groupmod三個指令，

//查看group模塊資訊
ansible-doc -s group
ansible-doc group

1）常用引數

`name`引數：必須引數，用于指定要操作的組名稱，
`state`引數：用于指定組的狀態，兩個值可選，present，absent，默認為 present，設定為absent 表示洗掉組，
`gid`引數：用于指定組的gid，
`system`引數：設定值為yes，表示創建為系統組

2）示例

//遠程部署在 mysql 主機上創建名為 test01 的用戶
ansible mysql -m user -a 'name="test01"'
//創建組在 mysql 主機上
ansible mysql -m group -a 'name=mysql gid=1234 system=yes'
//查看在 mysql 主機組資訊
ansible mysql -a 'tail /etc/group'
//使用user模塊向 mysql 主機組里添加成員
ansible mysql -m user -a 'name=test01 uid=306 system=yes group=mysql'
//使用id查看在 mysql 主機上用戶test01用戶的資訊
ansible mysql -a 'id test01'

6、shell模塊

shell 模塊可以幫助我們在遠程主機上執行命令，與 command 模塊不同的是，shell 模塊在遠程主機中執行命令時，會經過遠程主機上的 /bin/sh 程式處理，支持shell的各種功能，例如管道和重定向符號等，

1）常用引數

可用 ansible-doc shell 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

`free_form`引數 ：必須引數，指定需要遠程執行的命令，但是并沒有具體的一個引數名叫free_form，具體解釋參考 command 模塊，

`chdir`引數 : 此引數的作用就是指定一個目錄，在執行對應的命令之前，會先進入到 chdir 引數指定的目錄中，

`creates`引數 ：使用此引數指定一個檔案，當指定的檔案存在時，就不執行對應命令，可參考command 模塊中的解釋，

`removes`引數 ：使用此引數指定一個檔案，當指定的檔案不存在時，就不執行對應命令，可參考 command 模塊中的解釋，

`executable`引數：默認情況下，shell 模塊會呼叫遠程主機中的 /bin/sh 去執行對應的命令，通常情況下，遠程主機中的默認 shell 都是 bash，如果你想要使用其他型別的 shell 執行命令，則可以使用此引數指定某種型別的 shell 去執行對應的命令，指定 shell 檔案時，需要使用絕對路徑，

2）舉例

//先創建一個目錄
ansible mysql -a 'mkdir /testdir'
//使用 shell 模塊可以在遠程服務器上執行命令，它支持管道與重定向等符號，下面命令列印出mytest并寫入test檔案，
ansible mysql -m shell -a "chdir=/testdir echo mytest > test"
//下面命令列出了 /testdir 下面的檔案，多了個 test 檔案，
ansible mysql -m shell -a "chdir=/testdir ls"
//下面命令列出了 test 檔案的內容，
ansible mysql -m shell -a "chdir=/testdir cat test"

注：ansible mysql -a 'mkdir /testdir1 warn=false'可關閉警告訊息

//創建用戶使用無互動模式給用戶設定密碼
ansible mysql -m shell -a 'echo abc123 | passwd --stdin test01'

7、copy模塊

copy 模塊的作用就是拷貝檔案，它與之前介紹過的 fetch 模塊類似，不過，fetch 模塊是從遠程主機中拉取檔案到 ansible 管理主機，而 copy 模塊是將 ansible 管理主機上的檔案拷貝到遠程主機中，

1）常用引數

可用 ansible-doc copy 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

`src`引數 ：用于指定需要copy的檔案或目錄，

`dest`引數 ：用于指定檔案將被拷貝到遠程主機的哪個目錄中，dest為必須引數，

`content`引數 ：當不使用src指定拷貝的檔案時，可以使用content直接指定檔案內容，src與content兩個引數必有其一，否則會報錯，

`force`引數 : 當遠程主機的目標路徑中已經存在同名檔案，并且與ansible主機中的檔案內容不同時，是否強制覆寫，可選值有yes和no，默認值為yes，表示覆寫，如果設定為no，則不會執行覆寫拷貝操作，遠程主機中的檔案保持不變，

`backup`引數 : 當遠程主機的目標路徑中已經存在同名檔案，并且與ansible主機中的檔案內容不同時，是否對遠程主機的檔案進行備份，可選值有yes和no，當設定為yes時，會先備份遠程主機中的檔案，然后再將ansible主機中的檔案拷貝到遠程主機，

`owner`引數 : 指定檔案拷貝到遠程主機后的屬主，但是遠程主機上必須有對應的用戶，否則會報錯，

`group`引數 : 指定檔案拷貝到遠程主機后的屬組，但是遠程主機上必須有對應的組，否則會報錯，

`mode`引數 : 指定檔案拷貝到遠程主機后的權限，如果你想將權限設定為”rw-r--r--“，則可以使用mode=0644表示，如果你想要在user對應的權限位上添加執行權限，則可以使用mode=u+x表示，

2）舉例

ansible管理主機上

mkdir /testdir
echo -e "123\n456\n" > /testdir/copytest
cat /testdir/copytest
123
456

//將 ansible 主機中 /testdir/copytest 檔案復制到遠程主機的 /testdir 目錄下，
ansible mysql -m copy -a "src=/testdir/copytest dest=/testdir/"
//查看目錄下檔案
ansible mysql -a "ls -al  /testdir" 
//查看copytest的內容
ansible mysql -a "cat /testdir/copytest"

//在遠程主機的 /testdir 目錄下生成檔案 testfile1，testfile1 檔案中有兩行文本，第一行文本為 aaa，第二行為 bbb
ansible mysql -m copy -a 'content="aaa\nbbb\n" dest=/testdir/testfile1'
//查看目錄下檔案
ansible mysql -a "ls -al  /testdir"
//查看testfile1的內容
ansible mysql -a "cat /testdir/testfile1"

注：當使用 content 指定檔案內容時，dest 引數對應的值必須是一個檔案，而不能是一個路徑，

//復制本地檔案/etc/fstab到mysql串列中的主機/opt目錄下并改名為fstab.back，屬主為root，權限為640
ansible mysql -m copy -a 'src=/etc/fstab dest=/opt/fstab.back owner=root mode=640'
//查看opt目錄下檔案
ansible mysql -a 'ls -l /opt'
//查看/etc/fstab詳情
ll /etc/fstab

8、file模塊

file 模塊可以幫助我們完成一些對檔案的基本操作，比如，創建檔案或目錄、洗掉檔案或目錄、修改檔案權限等，

1）常用引數

可用 ansible-doc file 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

`path`引數 ：必須引數，用于指定要操作的檔案或目錄，在之前版本的ansible中，使用dest引數或者name引數指定要操作的檔案或目錄，為了兼容之前的版本，使用dest或name也可以，

`state`引數 ：此引數非常靈活，其對應的值需要根據情況設定，比如，我們想要在遠程主機上創建/testdir/a/b目錄，那么則需要設定path=/testdir/a/b，但是，我們無法從”/testdir/a/b“這個路徑看出b是一個檔案還是一個目錄，ansible也同樣無法單單從一個字串就知道你要創建檔案還是目錄，所以，我們需要通過state引數進行說明，當我們想要創建的/testdir/a/b是一個目錄時，需要將state的值設定為directory，”directory”為目錄之意，當它與path結合，ansible就能知道我們要操作的目標是一個目錄，同理，當我們想要操作的/testdir/a/b是一個檔案時，則需要將state的值設定為touch，當我們想要創建軟鏈接檔案時，需將state設定為link，想要創建硬鏈接檔案時，需要將state設定為hard，當我們想要洗掉一個檔案時（洗掉時不用區分目標是檔案、目錄、還是鏈接），則需要將state的值設定為absent，”absent”為缺席之意，當我們想讓操作的目標”缺席”時，就表示我們想要洗掉目標，
state（狀態），細分下來還有以下幾個選項：
 directory：如果目錄不存在，就創建目錄；如果目錄已經存在，則不進行任何操作，
 file：即使檔案不存在，也不會被創建
 link：創建軟鏈接
 hard：創建硬鏈接
 touch：如果檔案不存在，則會創建一個新的檔案，如果檔案或目錄已存在，則更新其最后修改時間
 absent：洗掉目錄、檔案或者取消鏈接檔案

`src`引數 ：當state設定為link或者hard時，表示我們想要創建一個軟鏈或者硬鏈，所以，我們必須指明軟鏈或硬鏈鏈接的哪個檔案，通過src引數即可指定鏈接源，

`force`引數 : 當state=link的時候，可配合此引數強制創建鏈接檔案，當force=yes時，表示強制創建鏈接檔案，不過強制創建鏈接檔案分為三種情況，情況一：當要創建的鏈接檔案指向的源檔案并不存在時，使用此引數，可以先強制創建出鏈接檔案，情況二：當要創建鏈接檔案的目錄中已經存在與鏈接檔案同名的檔案時，將force設定為yes，會將同名檔案覆寫為鏈接檔案，相當于洗掉同名檔案，創建鏈接檔案，情況三：當要創建鏈接檔案的目錄中已經存在與鏈接檔案同名的檔案，并且鏈接檔案指向的源檔案也不存在，這時會強制替換同名檔案為鏈接檔案，

`owner`引數 ：用于指定被操作檔案的屬主，屬主對應的用戶必須在遠程主機中存在，否則會報錯，

`group`引數 ：用于指定被操作檔案的屬組，屬組對應的組必須在遠程主機中存在，否則會報錯，

`mode`引數：用于指定被操作檔案的權限，比如，如果想要將檔案權限設定為”rw-r-x---“，則可以使用mode=650進行設定，或者使用mode=0650，效果也是相同的，如果想要設定特殊權限，比如為二進制檔案設定suid，則可以使用mode=4700，

`recurse`引數：當要操作的檔案為目錄，將recurse設定為yes，可以遞回的修改目錄中檔案的屬性，

2）舉例

//在 mysql 主機上創建一個名為 testfile1 的檔案，如果 testfile1 檔案已經存在，則會更新檔案的時間戳，與 touch 命令的作用相同，
ansible mysql -m file -a "path=/testdir/testfile1 state=touch"
//查看/testdir/testfile1詳細資訊
ansible mysql -a 'ls -l /testdir/testfile1'

//在 mysql 主機上創建一個名為 /testdir/testdir 的目錄，如果 /testdir/testdir 目錄已經存在，則不進行任何操作，
ansible mysql -m file -a "path=/testdir/testdir state=directory"
//查看 /testdir 目錄下檔案
ansible mysql -a 'ls -l /testdir'

//在 mysql 上為 testfile1 檔案創建軟鏈接檔案，軟鏈接名為 linkfile1，執行下面命令的時候，testfile1 已經存在，
ansible mysql -m file -a "path=/testdir/linkfile1 state=link src=/testdir/testfile1"
//查看 /testdir 目錄下兩個檔案
ansible mysql -a 'ls -l /testdir/testfile1'
ansible mysql -a 'ls -l /testdir/linkfile1'

//在 mysql 上為 testfile2 檔案創建硬鏈接檔案，硬鏈接名為 hardfile2，執行下面命令的時候，testfile2 已經存在，
ansible mysql -m file -a "path=/testdir/hardfile2 state=hard src=/testdir/testfile2"
//查看 /testdir 目錄下檔案，顯示其inode號
ansible mysql -a 'ls -li /testdir'

//在創建鏈接檔案時，如果源檔案不存在，或者鏈接檔案與其他檔案同名時，強制覆寫同名檔案或者創建鏈接檔案，參考上述 force 引數的解釋，
ansible mysql -m file -a "path=/testdir/linkfile3 state=link src=/testdir/sourcefile force=yes"
//查看 /testdir 目錄下檔案，顯示其inode號
ansible mysql -a 'ls -li /testdir'

//洗掉遠程機器上的指定檔案或目錄，
ansible mysql -m file -a "path=/testdir/testdir state=absent"
//查看 /testdir 目錄下檔案
ansible mysql -a 'ls -l /testdir'

//先創建好 mysql 組和 mysql 主
ansible mysql -m user -a 'name=mysql system=yes'
ansible mysql -m group -a 'name=mysql system=yes'

//修改 /testdir/test 檔案引數（屬主、屬組、權限）
ansible mysql -m file -a 'owner=mysql group=mysql mode=644 path=/testdir/test'
//查看 /testdir 目錄下的 test 檔案
ansible mysql -a 'ls -l /testdir/test'

//當操作遠程主機中的目錄時，同時遞回的將目錄中的檔案的屬主屬組都設定為mysql，
ansible mysql -m file -a "path=/testdir/abb/abc state=directory owner=mysql group=mysql recurse=yes"
//查看 /testdir 目錄下的檔案資訊
ansible mysql -a 'ls -l /testdir'
ansible mysql -a 'ls -l /testdir/abb'

9、yum模塊

yum 模塊可以幫助我們在遠程主機上通過 yum 源管理軟體包，

查看yum模塊資訊
ansible-doc yum

1）常用引數

`name`引數：必須引數，用于指定需要管理的軟體包，比如 nginx，

`state`引數：用于指定軟體包的狀態 ，默認值為，present，表示確保軟體包已經安裝，除了，present，其他可用值有 installed、latest、absent、removed，其中 installed 與present 等效，latest 表示安裝 yum 中最新的版本，absent 和 removed 等效，表示洗掉對應的軟體包，

`disable_gpg_check`引數：用于禁用對 rpm 包的公鑰 gpg 驗證，默認值為 no，表示不禁用驗證，設定為 yes 表示禁用驗證，即不驗證包，直接安裝，在對應的 yum 源沒有開啟 gpg 驗證的情況下，需要將此引數的值設定為 yes，否則會報錯而無法進行安裝，

`enablerepo`引數：用于指定安裝軟體包時臨時啟用的 yum 源，假如你想要從A源中安裝軟體，但是你不確定A源是否啟用了，你可以在安裝軟體包時將此引數的值設定為 yes，即使A源的設定是未啟用，也可以在安裝軟體包時臨時啟用A源，

`disablerepo`引數：用于指定安裝軟體包時臨時禁用的 yum 源，某些場景下需要此引數，比如，當多個 yum 源中同時存在要安裝的軟體包時，你可以使用此引數臨時禁用某個源，這樣設定后，在安裝軟體包時則不會從對應的源中選擇安裝包，enablerepo 引數和 disablerepo 引數可以同時使用，

`update_cache`引數：強制更新yum的快取

`conf_file`引數：指定遠程yum安裝時所依賴的組態檔（安裝本地已有的包），

2）舉例

//確保 mysql 主機上通過 yum 源安裝了 httpd (對應 yum 源如果未開啟 gpg 驗證，需要設定 disable_gpg_check=yes)，如下三條命令的效果相同，
ansible mysql -m yum -a 'name=httpd disable_gpg_check=yes'
ansible mysql -m yum -a 'name=httpd state=present disable_gpg_check=yes'
ansible mysql -m yum -a 'name=httpd state=installed disable_gpg_check=yes'

//查看是否安裝
ansible mysql -a 'rpm -q httpd'

//卸載httpd，以下兩條命令效果相同
ansible mysql -m yum -a 'name=httpd state=absent'
ansible mysql -m yum -a 'name=nginx state=removed'

//查看是否安裝
ansible mysql -a 'rpm -q httpd'

//查看是否安裝
ansible mysql -a 'rpm -q tree'
//在 mysql 主機上安裝 tree 時不確定 local 源是否啟用，使用 enablerepo=local確保臨時啟用 local 源，
ansible mysql -m yum -a 'name=telnet disable_gpg_check=yes enablerepo=local'
//查看是否安裝
ansible mysql -a 'rpm -q tree'

注意：這里要確保 mysql 主機上存在 local.repo 本地源，否則會報錯
以下是建立yum本地源倉庫的步驟，不再貼圖

mount /dev/cdrom /mnt/		    	# 把光碟掛載到/mnt目錄下

cd /etc/yum.repos.d/
mkdir repos.bak
mv *.repo repos.bak                 #備份好后，以上步驟配置好yum源倉庫環境

vim local.repo
[local]						    	# 倉庫類別
name=local						    # 倉庫名稱
baseurl=file:///mnt			    	# 指定URL 訪問路徑為光碟掛載目錄
enabled=1					     	# 開啟此yum源，此為默認項，可省略
gpgcheck=0						    # 不驗證軟體包的簽名


yum clean all && yum makecache		# 洗掉yum快取并更新

然后我們再把 tree 卸載，使用ansible mysql -m yum -a 'name=tree state=absent'命令，進行下面的實驗

//查看是否安裝
ansible mysql -a 'rpm -q tree'
//在 mysql 主機上安裝 tree 時，確定多個源中都有 tree，但是不想從 local 源中安裝，所以在安裝時臨時禁用 local 源，
ansible mysql -m yum -a 'name=tree disable_gpg_check=yes disablerepo=local'
//查看是否安裝
ansible mysql -a 'rpm -q tree'

10、service模塊

service 模塊可以幫助我們管理遠程主機上的服務，比如，啟動或停止遠程主機中的 httpd 或 nginx 服務，

1）常用引數

可用 ansible-doc service 命令查看模塊資訊
向下翻到最后查看 EXAMPLES ，輸入“q”退出

`arguments`引數：命令列提供額外的引數
`name`引數：此引數用于指定需要操作的服務名稱，比如 nginx，
`state`引數：此引數用于指定服務的狀態，比如，我們想要啟動遠程主機中的 nginx，則可以將 state 的值設定為 started；如果想要停止遠程主機中的服務，則可以將 state 的值設定為 stopped，此引數的可用值有 started、stopped、restarted、reloaded，
`enabled`引數：此引數用于指定是否將服務設定為開機 啟動項，設定為 yes 表示將對應服務設定為開機啟動，設定為 no 表示不會開機啟動，
`runlevel`引數：開機啟動的級別，一般不用指定，
`sleep`引數：在重啟服務的程序中，是否等待，如在服務關閉以后等待2秒再啟動，(定義在劇本中，)

2）舉例

//查看webserver上是否已安裝httpd
ansible webserver -a 'rpm -q httpd'
//查看web服務器httpd運行狀態
ansible webserver -a 'systemctl status httpd'

//啟動httpd服務，并設為開機自啟
ansible webserver -m service -a 'name=httpd enabled=yes state=started'
//關閉防火墻
ansible all -m service -a 'name=firewalld state=stopped'
//查看是否開啟
ansible webserver -a 'systemctl status httpd'

11、script模塊

注意：學習此模塊前最好先去了解command模塊，
script 模塊可以幫助我們在遠程主機上執行 ansible 管理主機上的腳本，也就是說，腳本一直存在于 ansible 管理主機本地，不需要手動拷貝到遠程主機后再執行，

1）常用引數

可用 ansible-doc script 命令查看模塊資訊

`free_form`引數 ：必須引數，指定需要執行的腳本，腳本位于 ansible 管理主機本地，并沒有具體的一個引數名叫 free_form，具體解釋請參考 command 模塊，

`chdir`引數 : 此引數的作用就是指定一個遠程主機中的目錄，在執行對應的腳本之前，會先進入到 chdir 引數指定的目錄中，

`creates`引數 ：使用此引數指定一個遠程主機中的檔案，當指定的檔案存在時，就不執行對應腳本，可參考 command 模塊中的解釋，

`removes`引數 ：使用此引數指定一個遠程主機中的檔案，當指定的檔案不存在時，就不執行對應腳本，可參考 command 模塊中的解釋，

2）舉例

//先寫個腳本
vim test.sh
#!/bin/bash
echo "This is a testscript" > /opt/script.txt

chmod +x test.sh


//使用script執行腳本
ansible mysql -m script -a 'test.sh'
//查看腳本寫入到 /opt/script.txt 檔案的內容
ansible mysql -a 'cat /opt/script.txt'

12、setup模塊

setup 模塊用于收集遠程主機的一些基本資訊，是通過呼叫facts組件來實作的，
facts就是變數，內建變數 ，每個主機的各種資訊，cpu核數、記憶體大小等會存在facts中的某個變數中，

1）常用引數

可用 ansible-doc setup 命令查看模塊資訊

`filter`引數：用于進行條件過濾，如果設定，僅回傳匹配過濾條件的資訊，

2）舉例

//獲取 mysql 組主機的facts資訊
ansible mysql -m setup

注意：回傳的資訊非常多，很多情況我們并不需要全部的資訊，可以通過過濾獲得指定的資訊，

//獲取 mysql 主機的 IPV4 地址，
ansible mysql -m setup -a "filter=ansible_all_ipv4_addresses"

//查看記憶體
ansible mysql -m setup  -a 'filter="*mem*"'
ansible mysql -m shell -a 'free -m'

//顯示cpu個數(只顯示總的個數)
ansible mysql -m setup  -a 'filter=ansible_processor_vcpus'

其他可查看常用資訊：

ansible_all_ipv4_addresses：僅顯示ipv4的資訊，
ansible_devices：僅顯示磁盤設備資訊，
ansible_distribution：顯示是什么系統，例：centos,suse等，
ansible_distribution_major_version：顯示是系統主版本，
ansible_distribution_version：僅顯示系統版本，
ansible_machine：顯示系統型別，例：32位，還是64位，
ansible_eth0：僅顯示eth0的資訊，
ansible_hostname：僅顯示主機名，
ansible_kernel：僅顯示內核版本，
ansible_lvm：顯示lvm相關資訊，
ansible_memtotal_mb：顯示系統總記憶體，
ansible_memfree_mb：顯示可用系統記憶體，
ansible_memory_mb：詳細顯示記憶體情況，
ansible_swaptotal_mb：顯示總的swap記憶體，
ansible_swapfree_mb：顯示swap記憶體的可用記憶體，
ansible_mounts：顯示系統磁盤掛載情況，
ansible_processor：顯示cpu個數(具體顯示每個cpu的型號)，
ansible_processor_vcpus：顯示cpu個數(只顯示總的個數)，