碼上快樂

相關內容    簡體    繁體

Ansible配置及常用模塊總結 - 運維筆記

本文轉載自   查看原文   2017-09-19 18:02   7869    Ansible

 

一.  Ansible 介紹
Ansible是一個配置管理系統configuration management system, python 語言是運維人員必須會的語言, ansible 是一個基於python 開發的自動化運維工具, 其功能實現基於ssh遠程連接服務, ansible 可以實現批量系統配置，批量軟件部署，批量文件拷貝，批量運行命令等功能, 除了ansible之外，還有saltstack 等批量管理軟件.

Ansible能做什么? 
ansible可以幫助運維人員完成一些批量任務，或者完成一些需要經常重復的工作。
比如：同時在100台服務器上安裝nginx服務，並在安裝后啟動服務。
比如：將某個文件一次性拷貝到100台服務器上。
比如：每當有新服務器加入工作環境時，運維人員都要為新服務器部署某個服務，也就是說運維人員需要經常重復的完成相同的工作。
這些場景中運維人員都可以使用到ansible。

Ansible軟件特點?
ansible不需要單獨安裝客戶端，SSH相當於ansible客戶端。
ansible不需要啟動任何服務，僅需安裝對應工具即可。
ansible依賴大量的python模塊來實現批量管理。
ansible配置文件/etc/ansible/ansible.cfg。

Ansible是一種agentless(基於ssh)，可實現批量配置、命令執行和控制，基於Python實現的自動化運維工具。Ansible的兩個特性：
- 模塊化：通過調用相關模塊，完成指定任務，且支持任何語言編寫的自定義模塊;
- playbook：劇本，可根據需要一次執行完劇本中的所有任務或某些任務;

Ansible 架構

- 連接插件(connectior plugins) 用於連接主機 用來連接被管理端。
- 核心模塊(core modules) 連接主機實現操作， 它依賴於具體的模塊來做具體的事情。
- 自定義模塊(custom modules) 根據自己的需求編寫具體的模塊。
- 插件(plugins) 完成模塊功能的補充。
- 劇本(playbooks)ansible的配置文件,將多個任務定義在劇本中，由ansible自動執行。
- 主機清單(host inventory)定義ansible需要操作主機的范圍。

最重要的一點: ansible是模塊化的, 它所有的操作都依賴於模塊, 不需要單獨安裝客戶端（no agents），基於系統自帶的sshd服務，sshd就相當於ansible的客戶端, 不需要服務端（no sever）,需要依靠大量的模塊實現批量管理, 配置文件 /etc/ansible/ansible.cfg (前期不用配置)。

二.  Ansible語法及配置參數
語法格式：
ansible <pattern_goes_here> -m <module_name> -a <arguments>
也就是:
ansible  匹配模式   -m  模塊  -a  '需要執行的內容'

解釋說明:
匹配模式：即哪些機器生效 (可以是某一台, 或某一組, 或all) , 默認模塊為command , 執行常規的shell命令.

-m name, --module-name=name:  指定執行使用的模塊。
-u username, --user=username:  指定遠程主機以username運行命令。
-s, --sudo:  相當於linux系統下的sudo命令。
-u sudo_username, --sudo-user=sudo_username:  使用sudo, 相當於linux系統下的sudo命令。
-C, --check:  只檢查不實際執行。
-e, 即extra_vars:  引用外部參數。
-i, 即inventory:  指定倉庫列表, 默認/etc/ansible/hosts。
--list-host:  列出執行主機列。 

######  ansible配置文件常用參數  ########

host_key_checking	
host_key_checking=False 禁用驗證host_key_checking

inventory  
定義庫文件位置，腳本，或者存放可通信主機的目錄
inventory = /etc/ansible/hosts

library	
ansible默認搜尋模塊的位置
library = /usr/share/ansible
Ansible知道如何搜尋多個用冒號隔開的路徑，同時也會搜索在playbook中的"./library"。

log_path 
日志存放位置
默認不開啟，ansible將會吧模塊加載紀錄在系統日志系統中.不包含用密碼.
log_path=/var/log/ansible.log

module_name
這個是/usr/bin/ansible的默認模塊名（-m）. 默認是'command'模塊。command模塊不支持shell變量，管道，配額。所以最好把這個參數改為'shell'。
module_name = command

nocolor	
默認ansible會為輸出結果加上顏色，用來更好的區分狀態信息和失敗信息。如果你想關閉這一功能,可以把'nocolor'設置為'1'。
nocolor=0

nocows	
默認ansible可以調用一些cowsay的特性，使得/usr/bin/ansible-playbook運行起來更加愉快。
如果不喜歡cows，可以通通過將'nocows'設置為'1'來禁用這一選項:
nocows=0

poll_interval
對於Ansible中的異步任務，這個是設置定義，當具體的poll interval 沒有定義時，多少時間回查一下這些任務的狀態, 默認值是一個折中選擇15秒鍾.這個時間是個回查頻率和任務完成叫回頻率和當任務完成時的回轉頻率的這種:
poll_interval=15

private_key_file
如果你是用pem密鑰文件而不是SSH客戶端或秘密啊認證的話, 你可以設置這里的默認值, 來避免每一次提醒設置密鑰文件位置"--ansible-private-keyfile":
private_key_file=/path/to/file.pem

remote_port
這個設置是你系統默認的遠程SSH端口, 如果不指定,默認為22號端口:（建議修改成別的端口）
remote_port = 22

remote_user
這是個ansible使用/usr/bin/ansible-playbook連接的默認用戶名。注意如果不指定, /usr/bin/ansible默認使用當前用戶名稱:
remote_user = root

timeout
這個事默認SSH鏈接嘗試超市時間:
timeout = 10

transport
如果"-c <transport_name>" 選項沒有在使用/usr/bin/ansible 或者 /usr/bin/ansible-playbook 特指的話, 這個參數提供了默認通信機制。默認值為'smart'。 
如果本地系統支持ControlPersist技術的話, 將會使用(基於OpenSSH)'ssh', 如果不支持該技術，將使用'paramiko'庫，其他傳輸選項包括'local', 'chroot','jail'等等。
用戶通常可以這個設置為'smart',讓playbook在需要的條件自己選擇'connectin:'參數.

record_host_keys
默認設置會記錄並驗證通過在用戶hostfile中新發現的的主機（如果host key checking 被激活的話）。這個選項在有很多主機的時候將會性能很差！！
在這種情況下，建議使用SSH傳輸代替。當設置為False時, 性能將會提升,在hostkey checking 被禁用時候, 建議使用！！！
record_host_keys=True

scp_if_ssh
又是用戶操控一個一個沒有開啟SFTP協議的遠程系統.如果這個設置為True, scp將代替用來為遠程主機傳輸文件:
scp_if_ssh=False	
如果沒有遇到這樣的問題沒有必要來修改這個設置。當然修改這個設置也沒有什么明顯的弊端。大部分的系統環境都默認支持SFTP, 通常情況下不需要修改。

pipelining
在不通過實際文件傳輸的情況下執行ansible模塊來使用管道特性, 從而減少執行遠程模塊SSH操作次數。如果開啟這個設置,將顯著提高性能！！
然而當使用"sudo:"操作的時候, 你必須在所有管理的主機的/etc/sudoers中禁用'requiretty'。
默認這個選項為了保證與sudoers requiretty的設置（在很多發行版中時默認的設置）的兼容性是禁用的。但是為了提高性能強烈建議開啟這個設置。
pipelining=False

accelerate_port	
在急速模式下使用的端口。
accelerate_port = 5099

accelerate_timeout
這個設置時用來控制從客戶機獲取數據的超時時間.如果在這段時間內沒有數據傳輸,套接字連接會被關閉. 一個保持連接（keepalive）數據包通常每15秒回發回給控制台,所以這個超時時間不應該低於15秒（默認值為30秒）:
accelerate_timeout = 30

accelerate_connect_timeout
這個設置空着套接字調用的超時時間。這個應該設置相對比較短。
這個和'accelerate_port'連接在回滾到ssh或者paramiko（受限於你默認的連接設置）連接方式之前會嘗試三次開始遠程加速daemon守護進程。默認設置為1.0秒！
accelerate_connect_timeout = 1.0
需要注意: 這個選項值可以設置為小於1秒鍾,但是除非你擁有一個速度很快而且很可靠的網絡,否則也許這樣並不是一個很好的選擇。
如果你使用英特網訪問你的系統，最好提高這個值！！！

accelerate_daemon_timeout
這個控制加速daemon守護進程的超時時間,用分鍾來衡量.默認為30分鍾！
accelerate_daemon_timeout = 30
注意, 在1.6版本之前,daemon發起的超時時間是硬編碼的.對於1.6以后的版本,超時時間是根據daemon上一次活動信息和這個可設置的選項。

accelerate_multi_key
如果這個選項開啟,這個設置將允許多個私鑰被加載到daemon。任何客戶端要想連接daemon都需要開啟這個選項！！！
accelerate_multi_key = yes
通過本地套接字文件連接的通過SSH上傳密鑰文件到目標節點的新客戶端, 必須在登陸daemon時使用原始的登陸密鑰登陸。

三.  Ansible常用模塊
ping 模塊: 檢查指定節點機器是否還能連通，用法很簡單，不涉及參數，主機如果在線，則回復pong 。
raw 模塊: 執行原始的命令，而不是通過模塊子系統。
yum 模塊: RedHat和CentOS的軟件包安裝和管理工具。
apt 模塊: Ubuntu/Debian的軟件包安裝和管理工具。
pip 模塊 : 用於管理Python庫依賴項，為了使用pip模塊，必須提供參數name或者requirements。
synchronize 模塊: 使用rsync同步文件，將主控方目錄推送到指定節點的目錄下。
template 模塊: 基於模板方式生成一個文件復制到遠程主機（template使用Jinjia2格式作為文件模版，進行文檔內變量的替換的模塊。
copy 模塊: 在遠程主機執行復制操作文件。
user 模塊 與 group 模塊: user模塊是請求的是useradd, userdel, usermod三個指令，goup模塊請求的是groupadd, groupdel, groupmod 三個指令。
service 或 systemd 模塊: 用於管理遠程主機的服務。
get_url 模塊: 該模塊主要用於從http、ftp、https服務器上下載文件（類似於wget）。
fetch 模塊: 它用於從遠程機器獲取文件，並將其本地存儲在由主機名組織的文件樹中。
file 模塊: 主要用於遠程主機上的文件操作。
lineinfile 模塊: 遠程主機上的文件編輯模塊
unarchive模塊: 用於解壓文件。
command模塊 和 shell模塊: 用於在各被管理節點運行指定的命令. shell和command的區別：shell模塊可以特殊字符，而command是不支持
hostname模塊: 修改遠程主機名的模塊。
script模塊: 在遠程主機上執行主控端的腳本，相當於scp+shell組合。
stat模塊: 獲取遠程文件的狀態信息，包括atime,ctime,mtime,md5,uid,gid等信息。
cron模塊: 遠程主機crontab配置。
mount模塊: 掛載文件系統。
find模塊: 幫助在被管理主機中查找符合條件的文件，就像 find 命令一樣。
selinux模塊：遠程管理受控節點的selinux的模塊

四.  Ansible配置說明

1) 實驗環境准備

ip地址               主機名                 角色           系統版本 
172.16.60.211       ansible-server        主控節點        centos7.5
172.16.60.212       ansible-node01        受控節點1       centos7.5
172.16.60.213       ansible-node02        受控節點2       centos7.5
172.16.60.214       ansible-node03        受控節點3       centos7.5

四個節點各自設置主機名
[root@ansible-server ~]# hostnamectl set-hostname ansible-server
[root@ansible-node01 ~]# hostnamectl set-hostname ansible-node01
[root@ansible-node02 ~]# hostnamectl set-hostname ansible-node02
[root@ansible-node03 ~]# hostnamectl set-hostname ansible-node03

設置主控節點到受控節點的ssh無密碼信任關系 (ansible應用環境下, 主控節點必須要設置ssh無密碼跳轉到受控節點的信任關系)

添加主控節點到受控節點的認證! 首先主控節點必須要生成公私密鑰對, 否則不能進行免密信任關系設置!!   
[root@ansible-server ~]# ssh-keygen -t rsa                                 #一直回車即可
[root@ansible-server ~]# ssh-copy-id -i /root/.ssh/id_rsa.pub -p22 root@172.16.60.212      #回車, 輸入遠程登錄的密碼即可
[root@ansible-server ~]# ssh-copy-id -i /root/.ssh/id_rsa.pub -p22 root@172.16.60.213
[root@ansible-server ~]# ssh-copy-id -i /root/.ssh/id_rsa.pub -p22 root@172.16.60.214

如果受控節點數量比較多的話, 可以使用expect進行遠程ssh連接的免密信任關系, 具體可參考: https://www.cnblogs.com/kevingrace/p/5900303.html

2) Ansible安裝部署

Ansible有兩種安裝方式: yum 和 pip 安裝方式
 
Ansible在epel的yum中有提供，所以配置好epel源，直接使用yum命令安裝即可.
CentOS系統, 可以使用默認的yum源直接安裝ansible
 
[root@ansible-server ~]# yum install -y ansible
 
配置文件目錄：/etc/ansible/
執行文件目錄：/usr/bin/
Lib庫依賴目錄：/usr/lib/pythonX.X/site-packages/ansible/
Help文檔目錄：/usr/share/doc/ansible-X.X.X/
Man文檔目錄：/usr/share/man/man1/
 
================================================
pip安裝方式
# yum -y install python-pip python-devel
# pip install ansible
================================================
 
ansible程序文件
/usr/bin/ansible:  命令行工具
ansible命令通用格式: ansible <host-pattern> [options] [-m module_name] [-a args]
/usr/bin/ansible-doc: 幫助文檔
/usr/bin/ansible-playbook: 劇本執行工具
/etc/ansible/ansible.cfg: 主配置文件
/etc/ansible/hosts: 管理的主機清單
/etc/ansible/roles: 角色存放處
 
查看ansible命令幫助
[root@ansible-server ~]# ansible -h
 
查看支持的模塊
[root@ansible-server ~]# ansible-doc -l
[root@ansible-server ~]# ansible-doc -l|grep copy    #查看copy模塊
 
查看ansible的支持的模塊個數
[root@ansible-server ~]# ansible-doc -l |wc -l
2080
 
查看ansible版本
[root@ansible-server ~]# ansible --version
ansible 2.7.8
  config file = /etc/ansible/ansible.cfg
  configured module search path = [u'/root/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python2.7/site-packages/ansible
  executable location = /usr/bin/ansible
  python version = 2.7.5 (default, Apr 11 2018, 07:36:10) [GCC 4.8.5 20150623 (Red Hat 4.8.5-28)]

3) Ansible清單管理
inventory文件通常用於定義要管理主機的認證信息， 例如ssh登錄用戶名、密碼以及key相關信息。默認inventory文件為/etc/hostsweb-nodes, ansible模塊操作命令中可以省去默認inventory (即可以省去"-i /etc/hostsweb-nodes"), 如果inventory文件定義了其他路徑,則在ansible模塊操作命令中不能省去, 要加上"-i inventory路徑".

如何配置Inventory文件?
主控節點:
-  支持主機名通配以及正則表達式，例如web[1:3].oldboy.com;
-  支持基於非標准的ssh端口，例如web1.oldboy.com:6666;
-  支持指定變量，可對個別主機的特殊配置，如登陸用戶，密碼等;

受控節點
-  支持嵌套組，例如[game:children],那么在game模塊下面的組都會被game所包含;
-  支持指定變量，例如[game:vars]在下面指定變量;

ansible的inventory清單文件(/etc/ansible/hosts)中配置說明:
[ ] 中的名字代表組名
主機(hosts)部分可以使用域名、主機名、IP地址表示, 一般此類配置中多使用IP地址；
組名下的主機地址就是ansible可以管理的地址;

下面是/etc/ansible/hosts 文件中清單的配置示例:

[root@ansible-server ~]# cd /etc/ansible/
[root@ansible-server ansible]# cp hosts hosts.bak
[root@ansible-server ansible]# vim hosts                      #如下, 這里設置了兩組管理清單
...........
#可以使用受控節點的ip, 下面表示test-hosts組包括172.16.60.212, 172,16,60,213, 172.16.60.214 (如果ssh端口不是22, 比如是22222, 可以配置為"172.16.60.212:22222")
[test-hosts]
172.16.60.2[12:14]
  
#也可以使用受控節點的主機名, 前提是主控節點要能跟受控節點的主機名正常通信
[web-nodes]
172.16.60.21[2:3]
#ansible-node03                #前提是要能ping通這個主機名, 即做好/etc/hosts主機名映射
  
簡單測試，可設置是否生效
查看ansible清單里所有節點的uptime情況
[root@ansible-server ansible]# ansible all -m command -a "uptime"
172.16.60.213 | CHANGED | rc=0 >>
 01:43:15 up 13 days, 22:19,  3 users,  load average: 0.00, 0.01, 0.05
  
172.16.60.214 | CHANGED | rc=0 >>
 01:43:15 up 13 days, 22:19,  3 users,  load average: 0.01, 0.03, 0.05
  
172.16.60.212 | CHANGED | rc=0 >>
 01:43:15 up 13 days, 23:30,  3 users,  load average: 0.00, 0.01, 0.05
  
查看ansible清單里test-hosts組的節點的主機名
[root@ansible-server ansible]# ansible test-hosts -m command -a "hostname"  
172.16.60.213 | CHANGED | rc=0 >>
ansible-node02
  
172.16.60.214 | CHANGED | rc=0 >>
ansible-node03
  
172.16.60.212 | CHANGED | rc=0 >>
ansible-node01
  
查看ansible清單里web-nodes組的節點的系統時間
[root@ansible-server ansible]# ansible web-nodes -m command -a "date"        
172.16.60.213 | CHANGED | rc=0 >>
Sun Mar 17 01:51:02 CST 2019
  
172.16.60.212 | CHANGED | rc=0 >>
Sun Mar 17 01:51:02 CST 2019
 
[root@ansible-server ansible]# ansible test-hosts --list-hosts
  hosts (3):
    172.16.60.212
    172.16.60.213
    172.16.60.214
[root@ansible-server ansible]# ansible web-nodes --list-hosts
  hosts (2):
    172.16.60.212
    172.16.60.213
 
[root@ansible-server ansible]# ansible -i /etc/ansible/hosts web-nodes -m command -a "cat /etc/redhat-release"
172.16.60.213 | CHANGED | rc=0 >>
CentOS Linux release 7.5.1804 (Core)
 
172.16.60.212 | CHANGED | rc=0 >>
CentOS Linux release 7.5.1804 (Core)

########  inventory內置參數  ########
ansible內置了一些固定的主機變量名，在inventory中定義其值

但是請注意：從ansible2.0開始，ansible_ssh_user，ansible_ssh_host，ansible_ssh_port 這三個inventory內置參數已經改變為ansible_user，ansible_host，ansible_port了，這兩種參數方式都可以使用！但是只有這三個內置參數變量，其他的都不變。

驗證ansible, ansible是通過ssh端口探測通信

[root@ansible-server ~]# cd /etc/ansible/
[root@ansible-server ansible]# cp hosts hosts.bak
[root@ansible-server ansible]# vim hosts                      #如下, 這里設置了兩組管理清單
...........
#可以使用受控節點的ip
[test-hosts]
172.16.60.212
172.16.60.213
172.16.60.214
 
#也可以使用受控節點的主機名, 前提是主控節點要能跟受控節點的主機名正常通信
[web-nodes]
172.16.60.212
172.16.60.213
#ansible-node03                #前提是要能ping通這個主機名, 即做好/etc/hosts主機名映射
 
簡單測試，可設置是否生效
查看ansible清單里所有節點的uptime情況
[root@ansible-server ansible]# ansible all -m command -a "uptime"
172.16.60.213 | CHANGED | rc=0 >>
 01:43:15 up 13 days, 22:19,  3 users,  load average: 0.00, 0.01, 0.05
 
172.16.60.214 | CHANGED | rc=0 >>
 01:43:15 up 13 days, 22:19,  3 users,  load average: 0.01, 0.03, 0.05
 
172.16.60.212 | CHANGED | rc=0 >>
 01:43:15 up 13 days, 23:30,  3 users,  load average: 0.00, 0.01, 0.05
 
查看ansible清單里test-hosts組的節點的主機名
[root@ansible-server ansible]# ansible test-hosts -m command -a "hostname"   
172.16.60.213 | CHANGED | rc=0 >>
ansible-node02
 
172.16.60.214 | CHANGED | rc=0 >>
ansible-node03
 
172.16.60.212 | CHANGED | rc=0 >>
ansible-node01
 
查看ansible清單里web-nodes組的節點的系統時間
[root@ansible-server ansible]# ansible web-nodes -m command -a "date"         
172.16.60.213 | CHANGED | rc=0 >>
Sun Mar 17 01:51:02 CST 2019
 
172.16.60.212 | CHANGED | rc=0 >>
Sun Mar 17 01:51:02 CST 2019

[root@ansible-server ansible]# ansible test-hosts --list-hosts
  hosts (3):
    172.16.60.212
    172.16.60.213
    172.16.60.214
[root@ansible-server ansible]# ansible web-nodes --list-hosts 
  hosts (2):
    172.16.60.212
    172.16.60.213

[root@ansible-server ansible]# ansible -i /etc/ansible/hosts web-nodes -m command -a "cat /etc/redhat-release" 
172.16.60.213 | CHANGED | rc=0 >>
CentOS Linux release 7.5.1804 (Core) 

172.16.60.212 | CHANGED | rc=0 >>
CentOS Linux release 7.5.1804 (Core)

4) Ansible 常用模塊

1.  ping模塊
檢查指定節點機器是否還能連通，用法很簡單，不涉及參數.  主機如果在線，則回復pong. 測試連通性的模塊.

[root@ansible-server ~]# ansible web-nodes -m ping
172.16.60.213 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
172.16.60.212 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

[root@ansible-server ~]# ansible -i /etc/ansible/hosts all -m ping
172.16.60.214 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
172.16.60.213 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}
172.16.60.212 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

可以獲得該模塊的說明
[root@ansible-server ~]# ansible-doc -v ping

2.  raw模塊
執行原始的命令，而不是通過模塊子系統。在任何情況下，使用shell或command命令模塊也是合適的。給定原始的參數直接通過配置的遠程shell運行。可返回標准輸出、錯誤輸出和返回代碼。此模塊沒有變更處理程序支持。 這個模塊不需要遠程系統上的Python，就像腳本模塊一樣。此模塊也支持Windows目標。raw, shell, command三個模塊都能調用對象機器上的某條指令或者某個可執行文件。raw和shell模塊很像, 都支持管道; command模塊不支持管道.

注意下三者之間的微妙區別, 如下會發現raw模塊執行的是系統原始命令, 執行后會主動關閉到被控制節點的連接!
[root@ansible-server ~]# ansible -i /etc/ansible/hosts all -m raw -a "hostname"
172.16.60.212 | CHANGED | rc=0 >>
ansible-node01
Shared connection to 172.16.60.212 closed.

172.16.60.213 | CHANGED | rc=0 >>
ansible-node02
Shared connection to 172.16.60.213 closed.

172.16.60.214 | CHANGED | rc=0 >>
ansible-node03
Shared connection to 172.16.60.214 closed.

[root@ansible-server ~]# ansible -i /etc/ansible/hosts all -m shell -a "hostname"   
172.16.60.214 | CHANGED | rc=0 >>
ansible-node03

172.16.60.213 | CHANGED | rc=0 >>
ansible-node02

172.16.60.212 | CHANGED | rc=0 >>
ansible-node01

[root@ansible-server ~]# ansible -i /etc/ansible/hosts all -m command -a "hostname"               
172.16.60.214 | CHANGED | rc=0 >>
ansible-node03

172.16.60.213 | CHANGED | rc=0 >>
ansible-node02

172.16.60.212 | CHANGED | rc=0 >>
ansible-node01

raw和shell模塊支持管道, command模塊不支持管道
[root@ansible-server ~]# ansible -i /etc/ansible/hosts all -m raw -a "cat /etc/passwd|grep kevin"
172.16.60.213 | CHANGED | rc=0 >>
kevin:x:1001:1001::/home/kevin:/bin/bash
Shared connection to 172.16.60.213 closed.

172.16.60.212 | CHANGED | rc=0 >>
kevin:x:1003:1003::/home/kevin:/bin/bash
Shared connection to 172.16.60.212 closed.

172.16.60.214 | CHANGED | rc=0 >>
kevin:x:1000:1000::/home/kevin:/bin/bash
Shared connection to 172.16.60.214 closed.

[root@ansible-server ~]# ansible -i /etc/ansible/hosts all -m shell -a "cat /etc/passwd|grep kevin"   
172.16.60.213 | CHANGED | rc=0 >>
kevin:x:1001:1001::/home/kevin:/bin/bash

172.16.60.214 | CHANGED | rc=0 >>
kevin:x:1000:1000::/home/kevin:/bin/bash

172.16.60.212 | CHANGED | rc=0 >>
kevin:x:1003:1003::/home/kevin:/bin/bash

[root@ansible-server ~]# ansible -i /etc/ansible/hosts all -m command -a "cat /etc/passwd|grep kevin"     
172.16.60.213 | FAILED | rc=1 >>
cat: /etc/passwd|grep: No such file or directory
cat: kevin: No such file or directorynon-zero return code

172.16.60.212 | FAILED | rc=1 >>
cat: /etc/passwd|grep: No such file or directory
cat: kevin: No such file or directorynon-zero return code

172.16.60.214 | FAILED | rc=1 >>
cat: /etc/passwd|grep: No such file or directory
cat: kevin: No such file or directorynon-zero return code

3.  yum模塊
這個模塊是RedHat 和 CentOS作為遠端受控節點OS的時候，用的最多的模塊, 是RedHat / CentOS包管理工具的模塊, 使用`yum’軟件包管理器管理軟件包，其選項有:
config_file：yum的配置文件 （optional）
disable_gpg_check：關閉gpg_check （optional）
disablerepo：不啟用某個源 （optional）
enablerepo：啟用某個源（optional）
name：要進行操作的軟件包的名字，默認最新的程序包，指明要安裝的程序包，可以帶上版本號，也可以傳遞一個url或者一個本地的rpm包的路徑
state：表示是安裝還是卸載的狀態, 其中present、installed、latest 表示安裝,  absent 、removed表示卸載刪除;  present默認狀態, laster表示安裝最新版本.

溫馨提示:
要確保受控節點的python版本對應正確, 否則執行下面命令會報錯 (下面報錯說明受控節點需要python2版本, 而當前是python3):
"msg": "The Python 2 bindings for rpm are needed for this module. If you require Python 3 support use the `dnf` Ansible module instead.. 
The Python 2 yum module is needed for this module. If you require Python 3 support use the `dnf` Ansible module instead."

安裝httpd
[root@ansible-server ~]# ansible web-nodes -m yum -a 'name=httpd state=latest' 
[root@ansible-server ~]# ansible web-nodes -m yum -a 'name=httpd state=present'
[root@ansible-server ~]# ansible web-nodes -m yum -a 'name=httpd state=installed'

[root@ansible-server ~]# ansible web-nodes -m yum -a 'name=http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm state=present'
[root@ansible-server ~]# ansible web-nodes -m yum -a 'name="@Development tools" state=present'

卸載httpd
[root@ansible-server ~]# ansible web-nodes -m yum -a 'name=httpd state=absent' 
[root@ansible-server ~]# ansible web-nodes -m yum -a 'name=httpd state=removed'

4.  apt模塊
這個模塊是ubuntu作為遠端受控節點OS的時候，用的最多的模塊。Apt是Ubuntu/Debian的包管理工具。
deb: 用於安裝遠程機器上的.deb后綴的軟件包（optional）
install_recommends: 這個參數可以控制遠程電腦上是否只是下載軟件包，還是下載后安裝，默認參數為true,設置為false的時候只下載軟件包，不安裝
update_cache: 當這個參數為yes的時候等於apt-get update（optional）
name: apt要下載的軟件包名字，支持name=git=1.6 這種制定版本的模式
state: 狀態（present，absent，latest）,表示是安裝還是卸載. 其中present、installed、latest 表示安裝, absent 、removed表示卸載刪除; present默認狀態, laster表示安裝最新版本.

在安裝foo軟件包前更新然后安裝foo
# ansible web-nodes -m apt -a 'name=foo update_cache=yes'

移除foo軟件包
# ansible web-nodes -m apt -a 'name=foo state=absent'

安裝foo軟件包
# ansible web-nodes -m apt -a 'name=foo state=present'

安裝foo 1.0軟件包
# ansible web-nodes -m apt -a 'name=foo=1.00 state=present'

安裝nginx最新的名字為squeeze-backport發布包，並且安裝前執行更新
# ansible web-nodes -m apt -a 'name=nginx state=latest default_release=squeeze-backports update_cache=yes'

只下載openjdk-6-jdk最新的軟件包，不安裝
# ansible web-nodes -m apt -a 'name=openjdk-6-jdk state=latest install_recommends=no'

安裝所有軟件包到最新版本
# ansible web-nodes -m apt -a 'upgrade=dist'

更新apt-get的list
# ansible web-nodes -m apt -a 'update_cache=yes'

3600秒后停止update_cache
# ansible web-nodes -m apt -a 'update_cache=yes cache_valid_time=3600'

安裝遠程節點上的/tmp/mypackage.deb軟件包
# ansible web-nodes -m apt -a 'deb=/tmp/mypackage.deb'

5.  pip 模塊
用於管理Python庫依賴項，為了使用pip模塊，必須提供參數name或者requirements
chdir： 執行pip命令前cd進入的目錄
name：要安裝的Python庫的名稱或遠程包的URL。
requirements：一個pip requirements.txt文件的路徑，它應該是遠程系統的本地文件，如果使用chdir選項，則可以將文件指定為相對路徑。
version：指定的Python庫的安裝版本。
extra_args：額外的參數傳遞給pip (后面使用雙引號)。
executable：顯式可執行文件或可執行文件的路徑名，用於為系統中安裝的特定版本的Python運行pip。 例如pip-3.3，如果系統中安裝了Python 2.7和3.3，並且想要為Python 3.3安裝運行pip。 它不能與“virtualenv”參數一起指定（在2.1中添加）。 默認情況下，它將采用適用於python解釋器的版本。 pip3在python 3上，pip2或pip在python 2上。
virtualenv：要安裝到的virtualenv目錄的可選路徑。 它不能與’executable’參數一起指定（在2.1中添加）。 如果virtualenv不存在，則將在安裝軟件包之前創建它。 可選的virtualenv_site_packages，virtualenv_command和virtualenv_python選項會影響virtualenv的創建。
virtualenv_command：用於創建虛擬環境的命令或路徑名。 例如pyvenv，virtualenv，virtualenv2，~/bin /virtualenv，/usr/local/bin/virtualenv。
virtualenv_python：用於創建虛擬環境的Python可執行文件。 例如python3.5，python2.7。 未指定時，將使用用於運行ansible模塊的Python版本。 當virtualenv_command使用pyvenv或-m venv模塊時，不應使用此參數。
state：狀態（present，absent，latest， forcereinstall），表示是安裝還是卸載的狀態. 其中present表示默認安裝; lastest表示最新版本安裝; absent表示卸載和刪除; forcereinstall表示強制重新安裝, "forcereinstall"選項僅適用於可ansible 2.1及更高版本.

安裝bottle python包
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle' 
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle state=present'          #默認的present狀態可以省略不寫

卸載bottle python包
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle state=absent'

在0.4.6版安裝bottle python包
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle version=0.4.6 state=present'

使用遠程協議（bzr +，hg +，git +，svn +）安裝MyApp。 不必在extra_args中提供'-e'選項。
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=svn+http://myrepo/svn/MyApp#egg=MyApp'

使用遠程協議（bzr +，hg +，git +）安裝MyApp。
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=git+http://myrepo/app/MyApp'

從本地壓縮包安裝MyApp
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=file:///path/to/MyApp.tar.gz'

將bottle安裝到指定的virtualenv中，繼承全局安裝的模塊
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle virtualenv=/my_app/venv virtualenv_site_packages=yes'

使用Python 2.7將bottle安裝到指定的virtualenv中
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle virtualenv=/my_app/venv virtualenv_command=virtualenv-2.7'

在用戶主目錄中安裝bottle (extra_args后面使用雙引號)
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle extra_args="--user"'  

安裝指定的python requirements
[root@ansible-server ~]# ansible web-nodes -m pip -a 'requirements=/my_app/requirements.txt'

在指定的virtualenv中安裝指定的python requirements
[root@ansible-server ~]# ansible web-nodes -m pip -a 'requirements=/my_app/requirements.txt virtualenv=/my_app/venv'

安裝指定的python requirements和自定義pip源URL
[root@ansible-server ~]# ansible web-nodes -m pip -a 'requirements=/my_app/requirements.txt extra_args="-i https://example.com/pypi/simple"'

專門為Python 3.3安裝bottle，使用'pip-3.3'可執行文件
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle executable=pip-3.3' 

安裝 bottle，如果已安裝，強制重新安裝
[root@ansible-server ~]# ansible web-nodes -m pip -a 'name=bottle state=forcereinstall'

6.  synchronize 模塊
這個模塊是使用rsync同步文件，將主控方目錄推送到指定受控節點的目錄下。其參數如下:
delete: 刪除不存在的文件，delete=yes 使兩邊的內容一樣（即以推送方為主），默認no
src: 要同步到目的地的源主機上的路徑; 路徑可以是絕對的或相對的。如果路徑使用”/”來結尾，則只復制目錄里的內容，如果沒有使用”/”來結尾，則包含目錄在內的整個內容全部復制
dest:目的地主機上將與源同步的路徑; 路徑可以是絕對的或相對的。
dest_port:默認目錄主機上的端口 ，默認是22，走的ssh協議。
mode: push或pull，默認push，一般用於從本機向遠程主機上傳文件，pull 模式用於從遠程主機上取文件。
rsync_opts:通過傳遞數組來指定其他rsync選項。

將主控節點上/data/kevin目錄同步到受控節點的/home目錄下
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/data/kevin dest=/home'

將主控節點上/data/kevin/test.file文件同步到受控節點的/opt目錄下
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/data/kevin/test.file dest=/opt'

將主控節點上/data/kevin/test.file文件同步到受控節點的/root/bobo.file文件
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/data/kevin/test.file dest=/root/bobo.file'

將主控節點上/opt/同步到受控節點的/opt/目錄, 使受控節點保持和主控節點的opt目錄一致, 不一樣的就刪除! 默認delete=no
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/opt/ dest=/opt/ delete=yes'

注意命令中要加"/", 如果不加"/", 則主控節點的opt目錄就同步到受控節點的/opt目錄下即, 即/opt/opt
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/opt dest=/opt delete=yes'  

將主控節點上/data/kevin目錄同步到受控節點的/mnt/www目錄下. 但是bobo目錄排除在外!  rsync_opts可以進行多次傳遞.
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/data/kevin/ dest=/mnt/www/ rsync_opts="--no-motd" rsync_opts="--exclude=bobo"'

強制兩邊同步保持一致! 跟主控節點源目錄保持一致!
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/data/kevin/ dest=/mnt/www/ rsync_opts="--no-motd" rsync_opts="--exclude=bobo" delete=yes'

從遠程受控節點上將/usr/local/src/grace.file文件拉取到主控節點的/root目錄下
[root@ansible-server ~]# ansible web-nodes -m synchronize -a 'src=/usr/local/src/grace.file dest=/root/ rsync_opts="-avpgolr" mode=pull '

synchronize 模塊相比copy模塊來說, 同步速度增加很多.

7.  template 模塊
基於模板方式生成一個文件復制到遠程主機（template使用Jinjia2格式作為文件模版，進行文檔內變量的替換的模塊。它的每次使用都會被ansible標記為”changed”狀態。）
backup: 如果原目標文件存在，則先備份目標文件
src: 在ansible控制器上的Jinja2格式化模板的路徑。 這可以是相對或絕對的路徑。
dest: 將模板渲染到遠程機器上的位置。
force: 是否強制覆蓋，默認為yes
owner: 目標文件屬主
group: 目標文件屬組
mode: 目標文件的權限模式，模式可以被指定為符號模式（例如，u + rwx或u = rw，g = r，o = r）

[root@ansible-server ~]# ansible web-nodes -m template -a "src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel  mode=0644" 

同樣的例子，但使用等效於0644的符號模式
[root@ansible-server ~]# ansible web-nodes -m template -a "src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode="u=rw,g=r,o=r""

具體用法, 可參考playbook劇本寫法.

8.  copy 模塊
把主控節點本地的文件上傳同步到遠程受控節點上, 該模塊不支持從遠程受控節點拉取文件到主控節點上。 參數選項如下:
src:指定源文件路徑，可以是相對路徑，也可以是絕對路徑，可以是目錄(並非是必須的，可以使用content，直接生成文件內容). src即是要復制到遠程主機的文件在本地的地址，可以是絕對路徑，也可以是相對路徑。如果路徑是一個目錄，它將遞歸復制。在這種情況下，如果路徑使用”/”來結尾，則只復制目錄里的內容，如果沒有使用”/”來結尾，則包含目錄在內的整個內容全部復制，類似於rsync。
dest:指定目標文件路徑，只能是絕對路徑，如果src是目錄，此項必須是目錄. 這個是必選項!
owner:指定屬主;
group:指定屬組;
mode:指定權限,可以以數字指定比如0644;
content:代替src，直接往dest文件中寫內容，可以引用變量，也可以直接使用inventory中的主機變量. 寫后會覆蓋原文件內容!
backup:在覆蓋之前將原文件備份，備份文件包含時間信息。有兩個選項：yes|no
force: 如果目標主機包含該文件，但內容不同，如果設置為yes，則強制覆蓋，如果為no，則只有當目標主機的目標位置不存在該文件時，才復制。默認為yes ;
directory_mode：遞歸的設定目錄的權限，默認為系統默認權限;
others：所有的file模塊里的選項都可以在這里使用;

特別注意:  src和content不能同時使用!!!!

[root@ansible-server ~]# ansible web-nodes -m copy -a 'src=/data/kevin/ dest=/mnt/www/ backup=yes'

[root@ansible-server ~]# ansible web-nodes -m copy -a 'src=/etc/hosts dest=/mnt/www/ owner=root group=root mode=0644'

[root@ansible-server ~]# ansible web-nodes -m copy -a 'src=/etc/hosts dest=/mnt/www/ owner=root group=root mode="u=rw,g=r,o=r"'

向遠程受控節點的/mnt/www/test.file文件寫入內容, 把原內容覆蓋掉
[root@ansible-server ~]# ansible web-nodes -m copy -a 'content="\nMy age is 26" dest=/mnt/www/test.file'

9.  user 模塊 與 group 模塊
user模塊是請求的是useradd, userdel, usermod三個指令，goup模塊請求的是groupadd, groupdel, groupmod 三個指令。

user模塊
home: 指定用戶的家目錄, 需要與createhome配合使用。
groups: 指定用戶的屬組。
uid: 指定用的uid。
password: 設定用戶密碼, password參數需要接受md5加密后的值. 特別注意: 指定password參數時, 不能使用明文密碼, 因為后面這一串密碼會被直接傳送到被管理主機的/etc/shadow文件中, 所以需要先將密碼字符串進行加密處理, 然后將得到的字符串放到password中即可。
name: 指定用戶名。
system: 是否為系統用戶。 表示默認創建為普通用戶, 而非系統用戶, 指定是用yes. 也就是說yes是默認創建為普通用戶, 而非系統用戶;
update_password: 修改用戶密碼, 其中always: 新密碼和舊密碼不同時進行修改; on_create: 為新創建的用戶指定密碼.
createhome: 創建家目錄, 其中yes表示默認項, 即創建用戶默認是有家目錄的; no表示創建用戶時不創建家目錄.
remove: 其中yes是刪除用戶家目錄, 需要指定此參數; no是默認項, 刪除用戶時默認不刪除用戶的家目錄. 當state=absent時, remove=yes則表示連同家目錄一起刪除, 等價於userdel -r。
state: 用戶狀態是創建還是刪除. (present, absent) ;默認為present; 其中present表示添加用戶; absent表示刪除用戶
shell: 指定用戶的shell環境。
generate_ssh_key: 是否為相關用戶生成SSH密鑰。 這不會覆蓋現有的SSH密鑰。
ssh_key_bits: 可選擇指定要創建的SSH密鑰中的位數。
ssh_key_passphrase: 設置SSH密鑰的密碼。 如果沒有提供密碼, SSH密鑰將默認沒有密碼。
ssh_key_file: 指定SSH密鑰文件名(可選). 如果這是一個相對的文件名, 那么它將是相對於用戶的主目錄。
ssh_key_type: 指定要生成的SSH密鑰的類型(可選). 可用的SSH密鑰類型將取決於目標主機上的實現。

使用bash shell添加用戶haha，將組"管理員"和"開發人員"附加到用戶組
[root@ansible-server ~]# ansible web-nodes -m user -a "name=haha shell=/bin/bash groups=admins,developers append=yes"
 
增加用戶anhui (先對密碼做明文到密文的處理)
[root@ansible-server ~]# echo "anhui@123" | openssl passwd -1 -stdin
$1$rj74jCVy$NDW80bgY0DUTuHUlSunVv1
[root@ansible-server ~]# ansible web-nodes -m user -a 'name=anhui system=yes password=$1$rj74jCVy$NDW80bgY0DUTuHUlSunVv1 state=present'
 
刪除用戶anhui
[root@ansible-server ~]# ansible web-nodes -m user -a 'name=anhui remove=yes state=absent'  
 
更新用戶kevin的密碼 (先對新密碼kevin@bj123做明文到密文的處理)
[root@ansible-server ~]# echo "kevin@bj123"| openssl passwd -1 -stdin  
$1$5X5bH5.J$RwE6o6g6bX953W7vAaizv/
[root@ansible-server ~]# ansible web-nodes -m user -a 'name=kevin update_password=always password=$1$5X5bH5.J$RwE6o6g6bX953W7vAaizv/'
 
在~/.ssh/id_rsa中為用戶bobo創建一個2048位的SSH密鑰
[root@ansible-server ~]# ansible web-nodes -m user -a 'name=bobo generate_ssh_key=yes ssh_key_bits=2048 ssh_key_file=.ssh/id_rsa'

[root@ansible-server ~]# ansible web-nodes -m group -a "name=yang gid=888"
[root@ansible-server ~]# ansible web-nodes -m user -a "name=yang uid=888 group=888 shell=/sbin/nologin create_home=no"

group模塊
gid: 指定用的gid。
name: 指定用戶名。
state: 是創建還是刪除, (present，absent);
system: 如果是，則表示創建的組是系統組;

[root@ansible-server ~]# ansible web-nodes -m group -a "name=huoqiu state=present"

[root@ansible-server ~]# ansible web-nodes -m group -a "name=chenzun gid=897 state=present" 

[root@ansible-server ~]# ansible web-nodes -m group -a "name=huoqiu state=absent"

10.  service 模塊 或 systemd模塊
管理服務的模塊, service管理的服務必須是yum安裝的服務, 即默認的系統服務腳本。編譯安裝的服務不好使用service模塊管理. 
name: 服務名稱;
state:  started/stopped/restarted/reloaded;
enabled: true/false;
runlevel: 運行級別;
sleep: 如果執行了restarted,在stop和start之間沉睡幾秒;
arguments: 給命令行提供一些選項;

[root@ansible-server ~]# ansible web-nodes -m service -a "name=sshd state=restarted"

[root@ansible-server ~]# ansible web-nodes -m service -a "enabled=on name=httpd state=started"
[root@ansible-server ~]# ansible web-nodes -m service -a "enabled=yes name=httpd state=started" 

[root@ansible-server ~]# ansible web-nodes -m service -a "name=httpd state=reloaded"    

[root@ansible-server ~]# ansible web-nodes -m service -a "name=httpd state=stopped"

service模塊適用於service管理程序的情況，如果是centos7系統，使用systemctl管理程序的話，可以使用systemd模塊。systemctl可以控制程序啟/停，reload，開機啟動，觀察程序狀態（status）等。systemd模塊的主要參數如下：
name:  服務名稱，例如crond.service，最好帶上后綴 .service
state:  需要的操作，started/stopped/restarted/reloaded
enabled：是否需要開機啟動
daemon_reload：systemd 讀取配置文件，每次修改了文件，最好都運行一次，確保應用了

需要注意：使用systemd前，如果是自己生成的配置文件，需要先放到/etc/systemd/system/ 目錄中，然后使用daemon_reload 中就可以了，注意不要和系統之前自帶的配置沖突，例如之前已經用yum安裝過redis或haproxy 之類的，已經存在相應的服務了，需要自行判斷要使用哪個文件。也可以使用.include 引用其他文件，具體參考systemd文檔 (查看命令"ansible-doc systemd")。systemd模塊在ansible的yml文件中配置示例如下:

- name: Make sure a service is running
  systemd: state=started name=httpd

- name: stop service cron on debian, if running
  systemd: name=cron state=stopped

- name: restart service cron on centos, in all cases, also issue daemon-reload to pick up config changes
  systemd:
    state: restarted
    daemon_reload: yes
    name: crond

- name: reload service httpd, in all cases
  systemd:
    name: httpd
    state: reloaded

- name: enable service httpd and ensure it is not masked
  systemd:
    name: httpd
    enabled: yes
    masked: no

- name: enable a timer for dnf-automatic
  systemd:
    name: dnf-automatic.timer
    state: started
    enabled: True

- name: just force systemd to reread configs (2.4 and above)
  systemd: daemon_reload=yes

11.  get_url 模塊
該模塊主要用於從http、ftp、https服務器上下載文件(類似於wget), 主要有如下選項:
sha256sum: 下載完成后進行sha256 check；
timeout: 下載超時時間, 默認10s
url: 下載的URL
url_password、url_username: 主要用於需要用戶名密碼進行驗證的情況
dest: 將文件下載到哪里的絕對路徑。如果dest是目錄, 則使用服務器提供的文件名, 或者如果沒有提供, 將使用遠程服務器上的URL的基本名稱。
headers: 以格式“key: value, key: value”為請求添加自定義HTTP標頭

[root@ansible-server ~]# ansible web-nodes -m get_url -a "url=http://lan.Okay686.com/RDPWrap-v1.6.1.zip dest=/usr/local/src/"

[root@ansible-server ~]# ansible web-nodes -m get_url -a "url=http://10.0.8.50/ops.sh  dest=/opt/shell.sh mode=0440"

[root@ansible-server ~]# ansible web-nodes -m get_url -a 'url=http://10.0.8.50/ops.sh dest=/opt/shell.sh headers="key:value,key:value"' 

[root@ansible-server ~]# ansible web-nodes -m get_url -a 'url=http://10.0.8.50/ops.sh dest=/opt/shell.sh checksum=sha256:b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c'

12.  fetch 模塊 (從遠程拉取出來文件)
它用於從遠程機器獲取文件，並將其本地存儲在由主機名組織的文件樹中。
src:  指定從遠程控制節點上要拉取的文件, 記住: 這個只能拉取文件!!  不能拉取目錄!!!  后續版本可能會支持遞歸提取。
dest:  將遠程節點拉取的文件保存到本地的目錄路徑. 例如，如果dest目錄是/backup，在主機host.example.com上命名為/ etc/profile的src文件將被保存到/backup/host.example.com/etc/profile。
flat: 允許覆蓋將目標文件添加到主機名/path/to/file的默認行為。默認為no!!   如果設置為yes, 將不會顯示類似172.16.60.221/root/信息. (即在dest的本機存放目錄下不會創建遠程節點ip命名的目錄)

將web-nodes組內的遠程節點的/root/bobo.file文件拉取到主控節點的/tmp下
[root@ansible-server ~]# ansible web-nodes -m fetch -a "dest=/mnt/ src=/root/bobo.file"

拉取過來后, 會發現dest定義的文件存放目錄下會有以遠程節點ip命名的目錄
[root@ansible-server ~]# ls /mnt/
172.16.60.212  172.16.60.213
[root@ansible-server ~]# ls /mnt/172.16.60.212/root/
bobo.file
[root@ansible-server ~]# ls /mnt/172.16.60.213/root/
bobo.file

flat參數，拉取的時候會自動創建設置的dest中不存在的目錄(同名文件會覆蓋):
[root@ansible-server ~]# ansible web-nodes -m fetch -a "dest=/mnt/wangshibo/ src=/root/bobo.file"
172.16.60.213 | CHANGED => {
    "changed": true, 
    "checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "dest": "/mnt/wangshibo/172.16.60.213/root/bobo.file", 
    "md5sum": "4221d002ceb5d3c9e9137e495ceaa647", 
    "remote_checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "remote_md5sum": null
}
172.16.60.212 | CHANGED => {
    "changed": true, 
    "checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "dest": "/mnt/wangshibo/172.16.60.212/root/bobo.file", 
    "md5sum": "4221d002ceb5d3c9e9137e495ceaa647", 
    "remote_checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "remote_md5sum": null
}

[root@ansible-server ~]# ls /mnt/
172.16.60.212  172.16.60.213  wangshibo
[root@ansible-server ~]# ls /mnt/wangshibo/
172.16.60.212  172.16.60.213
[root@ansible-server ~]# ls /mnt/
172.16.60.212  172.16.60.213  wangshibo
[root@ansible-server ~]# ls /mnt/wangshibo/
172.16.60.212  172.16.60.213
[root@ansible-server ~]# ls /mnt/wangshibo/172.16.60.212/root/
bobo.file
[root@ansible-server ~]# ls /mnt/wangshibo/172.16.60.213/root/
bobo.file

如果不想要從遠程節點拉取過來的文件在本機存放目錄里已遠程節點ip命名的目錄里面, 即去掉上面的/mnt里面的172.16.60.212和172.16.60.213目錄
[root@ansible-server ~]# ansible web-nodes -m fetch -a "dest=/mnt/kevin/ src=/root/bobo.file flat=yes"         
172.16.60.213 | CHANGED => {
    "changed": true, 
    "checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "dest": "/mnt/kevin/bobo.file", 
    "md5sum": "4221d002ceb5d3c9e9137e495ceaa647", 
    "remote_checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "remote_md5sum": null
}
172.16.60.212 | CHANGED => {
    "changed": true, 
    "checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "dest": "/mnt/kevin/bobo.file", 
    "md5sum": "4221d002ceb5d3c9e9137e495ceaa647", 
    "remote_checksum": "804d716fc5844f1cc5516c8f0be7a480517fdea2", 
    "remote_md5sum": null
}

[root@ansible-server ~]# ls /mnt/
172.16.60.212  172.16.60.213  kevin  wangshibo
[root@ansible-server ~]# ls /mnt/kevin/
bobo.file

13.  file 模塊
file模塊主要用於遠程主機上的文件操作，file模塊包含如下選項:
force: 需要在兩種情況下強制創建軟鏈接，一種是源文件不存在但之后會建立的情況下；另一種是目標軟鏈接已存在,需要先取消之前的軟鏈，然后創建新的軟鏈，有兩個選項: yes|no
group: 定義文件/目錄的屬組
mode: 定義文件/目錄的權限
owner: 定義文件/目錄的屬主
path: 必選項，定義文件/目錄的路徑
recurse: 遞歸的設置文件的屬性，只對目錄有效
src: 要被鏈接的源文件的路徑，只應用於state=link的情況
dest: 被鏈接到的路徑，只應用於state=link的情況
state: 表示file的狀態, 主要分為:
         directory: 如果目錄不存在，創建目錄;
     file: 即使文件不存在，也不會被創建;
     link: 創建軟鏈接;
     hard: 創建硬鏈接;
     touch: 如果文件不存在，則會創建一個新的文件，如果文件或目錄已存在，則更新其最后修改時間;
     absent: 刪除目錄、文件或者取消鏈接文件;

[root@ansible-server ~]# ansible web-nodes -m file -a "path=/data/test state=touch mode="600" owner=kevin group=kevin"

[root@ansible-server ~]# ansible web-nodes -m file -a "path=/data/haha state=directory mode="755" owner=kevin group=kevin"

[root@ansible-server ~]# ansible web-nodes -m file -a "path=/data/test state=absent"     

[root@ansible-server ~]# ansible web-nodes -m file -a "path=/data/test state=touch mode="u+rw,g-wx,o-rwx" owner=kevin group=kevin"

文件的軟鏈接和硬鏈接
[root@ansible-server ~]# ansible web-nodes -m file -a "src=/data/test dest=/opt/heihei state=link"

[root@ansible-server ~]# ansible web-nodes -m file -a "src=/data/test dest=/mnt/hh state=hard" 

[root@ansible-server ~]# ansible web-nodes -m file -a "src=/etc/passwd dest=/opt/heihei state=link force=yes"

目錄做軟鏈接
[root@ansible-server ~]# ansible web-nodes -m file -a "src=/data/haha/ dest=/root/aaa state=link"

14.  lineinfile 模塊
用於對遠程受控節點的文件編輯模塊. 主要選項有:
path: 指定要修改的配置文件, 包括:
         regexp:匹配要修改的內容
         line:要增加或者修改的內容
state: 狀態, 包括:
         absent:表示刪除，當匹配到時進行刪除
         present:表示增加，當匹配到時進行修改，當沒有匹配到時在最后增加一行，默認為此項
backrefs: 該參數值包括:
         no:表示如果沒有匹配到，則增加line；如果匹配成功，則替換line；
         yes:表示如果沒有匹配到，則不變line；如果匹配成功，則替換line；
backup: 該參數值包括:
         no:表示如果沒有匹配到，則增加line；如果匹配成功，則替換line；不備份原文件
         yes:表示如果沒有匹配到，則增加line；如果匹配成功，則替換line；備份原文件
insertafter(匹配的是此行): 在匹配到的行之后添加一行.  (經測試, 發現是匹配到的行的最后一行的后面添加一行)
insertbefore(匹配的是此行)： 在匹配到的行之前添加一行.  (經測試, 發現是匹配到的行的最后一行的前面添加一行)

溫馨提示:  經測試，當不添加backerfs: yes參數時，匹配到后也會進行替換，但當匹配到的內容不存在時，會在最后增加一行；所以當不增加backerfs參數時，要確定匹配到的內容存在;

將遠程受控節點的/data/test文件中的"123"字段修改為"wangshibo"
[root@ansible-server ~]# ansible web-nodes -m lineinfile -a 'path=/data/test regexp="123" line="wangshibo" backrefs=no'

[root@ansible-server ~]# ansible web-nodes -m lineinfile -a 'path=/etc/sudoers regexp="SYSTEM,SOFTWARE" line="STAPLES_ADMIN ALL=(ROOT) NOPASSWD:NETWORKING,LOCATE,STORAGE,DELEGATING,DRIVERS,SYSTEM,SOFTWARE,SERVICES,PROCESSES,FILE" backrefs=no'

匹配到的行后增加一行
[root@ansible-server ~]# ansible web-nodes -m lineinfile -a 'dest=/data/test insertafter="wangshibo" line="huihui"'

匹配到的行前增加一行  
[root@ansible-server ~]# ansible web-nodes -m lineinfile -a 'dest=/data/test insertbefore="root" line="huihui"'

刪除匹配到的行：
[root@ansible-server ~]# ansible web-nodes -m lineinfile -a 'path=/data/test regexp="123" state=absent'

15.  unarchive模塊
用於解壓文件，模塊包含如下選項:
copy: 在解壓文件之前，是否先將文件復制到遠程主機，默認為yes。若為no，則要求目標主機上壓縮包必須存在。
creates: 指定一個文件名，當該文件存在時，則解壓指令不執行
dest: 遠程主機上的一個路徑，即文件解壓的絕對路徑。 必須是一個目錄路徑!
group: 解壓后的目錄或文件的屬組;
list_files: 如果為yes，則會列出壓縮包里的文件，默認為no，2.0版本新增的選項;
mode: 解壓后文件的權限;
src: 如果copy為yes，則需要指定壓縮文件的源路徑;
owner: 解壓后文件或目錄的屬主;

經測試, 該模塊解壓時識別zip, tgz , tar.gz, tar.bz2 格式的壓縮包, gzip格式的測試時不支持.

將/usr/local/src/nginx.tgz解壓縮到/data/www中
[root@ansible-server ~]# ansible web-nodes -m unarchive -a "src=/usr/local/src/nginx.tgz dest=/data/www/"

解壓遠程受控節點上已存在的文件
[root@ansible-server ~]# ansible web-nodes -m unarchive -a "src=/root/file.zip dest=/usr/local remote_src=yes" 

解壓文檔需要下載的文件（2.0中添加）
[root@ansible-server ~]# ansible web-nodes -m unarchive -a "src=https://example.com/example.zip dest=/usr/local/bin remote_src=yes"

16.  command模塊 和 shell模塊
用於在各被管理節點運行指定的命令. shell和command的區別：shell模塊可以特殊字符，而command是不支持!!

command 是ansible的默認模塊, 即不指定模塊的時候默認使用的模塊就是command !  使用ansible自帶模塊執行命令 如果要用 > < | & ‘ ‘ 使用shell 模塊, command是不支持管道符之類的。

可以使用"ansible-doc -s shell" 或 "ansible-doc -s command" 查看下shell和command的參數, 兩者之間的參數用法上基本一樣的.

[root@ansible-server ~]# ansible-doc -s shell
- name: Execute commands in nodes.
  shell:
      chdir:                 # 在執行命令之前，先cd到指定的目錄下
      creates:               # 用於判斷命令是否要執行，如果指定的文件存在(可以使用通配符)存在，則不執行
      executable:            # 不再使⽤默認的/bin/sh解析並執⾏命令，⽽是使⽤此處指定的命令解析(例如使⽤expect解析expect腳本。必須為絕對路徑)
      free_form:             # 默認的選項，這里只是顯示，實際上是沒有的
      removes:               # 用於判斷命令是否要執行，如果指定的文件存在(可以使用通配符)不存在，則不執行
      stdin:                 # 將命令的stdin直接設置為指定值
      warn:                  # 設置command的警告信息(在/etc/ansible/ansible.cfg中有配置項)

示例如下: 

[root@ansible-server ~]# ansible all -a "date"
172.16.60.214 | CHANGED | rc=0 >>
Sun Mar 17 15:24:55 CST 2019

172.16.60.212 | CHANGED | rc=0 >>
Sun Mar 17 15:24:55 CST 2019

172.16.60.213 | CHANGED | rc=0 >>
Sun Mar 17 15:24:55 CST 2019

[root@ansible-server ~]# ansible all -m command -a "date"
172.16.60.213 | CHANGED | rc=0 >>
Sun Mar 17 15:25:14 CST 2019

172.16.60.212 | CHANGED | rc=0 >>
Sun Mar 17 15:25:14 CST 2019

172.16.60.214 | CHANGED | rc=0 >>
Sun Mar 17 15:25:14 CST 2019

在命令執行之前, 先切換到指定的目錄路徑下
[root@ansible-server ~]# ansible web-nodes -m command -a "chdir=/tmp pwd"
172.16.60.213 | CHANGED | rc=0 >>
/tmp

172.16.60.212 | CHANGED | rc=0 >>
/tmp

creates 文件是否存在，不存在就執行命令
[root@ansible-server ~]# ansible web-nodes -m command -a "creates=/etc/hosts date"
172.16.60.212 | SUCCESS | rc=0 >>
skipped, since /etc/hosts exists

172.16.60.213 | SUCCESS | rc=0 >>
skipped, since /etc/hosts exists

[root@ansible-server ~]# ansible web-nodes -m command -a "creates=/etc/hosts1231 date"
172.16.60.213 | CHANGED | rc=0 >>
Sun Mar 17 15:26:40 CST 2019

172.16.60.212 | CHANGED | rc=0 >>
Sun Mar 17 15:26:40 CST 2019

removes 文件是否存在，不存在就不執行命令，
[root@ansible-server ~]# ansible web-nodes -m command -a "removes=/etc/hosts uptime"
172.16.60.213 | CHANGED | rc=0 >>
 15:33:01 up 14 days, 12:08,  2 users,  load average: 0.13, 0.04, 0.05

172.16.60.212 | CHANGED | rc=0 >>
 15:33:01 up 14 days, 13:20,  2 users,  load average: 0.06, 0.03, 0.05

[root@ansible-server ~]# ansible web-nodes -m command -a "removes=/etc/hosts1231 uptime"
172.16.60.213 | SUCCESS | rc=0 >>
skipped, since /etc/hosts1231 does not exist

172.16.60.212 | SUCCESS | rc=0 >>
skipped, since /etc/hosts1231 does not exist

shell 模塊：這是個萬能模塊, 執行linux命令時可以用遠程節點執行命令;
注意: shell 模塊在遠程執行腳本時，遠程主機上一定要有相應的腳本;

[root@ansible-server ~]# ansible web-nodes -m shell -a "/bin/bash /opt/test.sh"
172.16.60.212 | CHANGED | rc=0 >>
ansible-node01
it is OK

172.16.60.213 | CHANGED | rc=0 >>
ansible-node02
it is OK

下面的shell模塊命令中使用了特殊字符, 如果使用comand模塊則就不行了!!
[root@ansible-server ~]# ansible web-nodes -m shell -a "cat /etc/passwd > /tmp/test"  

使用command模塊執行下面命令, 則就會報錯!  command模塊不支持特殊字符!
[root@ansible-server ~]# ansible web-nodes -m command -a "cat /etc/passwd > /tmp/test"

17.  hostname模塊
修改遠程受控節點的主機名的模塊

使用hostname模塊修改遠程節點的主機名時, 最好指明遠程單節點ip地址進行設置主機名了. 因為不同節點的主機名不一樣

[root@ansible-server ~]# ansible 172.16.60.213 -m hostname -a 'name="web-node03"'                             
172.16.60.213 | CHANGED => {
    "ansible_facts": {
        "ansible_domain": "", 
        "ansible_fqdn": "web-node03", 
        "ansible_hostname": "web-node03", 
        "ansible_nodename": "web-node03"
    }, 
    "changed": true, 
    "name": "web-node03"
}

18.  script模塊
在遠程受控節點上執行主控節點的腳本，相當於scp+shell組合

比如在遠程受控節點上執行主控節點的/opt/test.sh腳本
[root@ansible-server ~]# ansible all -m script -a "/opt/test.sh"

需要注意: 使用scripts模塊，不用將腳本傳輸到遠程節點，腳本本身不用進行授權，即可利用script模塊執行。直接執行腳本即可，不需要使用sh 或者 /bin/bash

19.  stat模塊
獲取遠程文件的狀態信息，包括atime,ctime,mtime,md5,uid,gid等信息

[root@ansible-server ~]# ansible all -m stat -a "path=/data/test"

20.  cron模塊
遠程受控節點的crontab配置

設置指定的crontab計划任務
[root@ansible-server ~]# ansible web-nodes -m cron -a "name='test' hour='2-5' minute='*/5' day='1' month='3,4' weekday='1' job='ls -l' user=root"
172.16.60.212 | CHANGED => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "test"
    ]
}
172.16.60.213 | CHANGED => {
    "changed": true, 
    "envs": [], 
    "jobs": [
        "test"
    ]
}

然后到172.16.60.212和172.16.60.213受控節點上查看:
[root@ansible-node02 ~]# crontab -l
#Ansible: test
*/5 2-5 1 3,4 1 ls -l

刪除指定crontab
[root@ansible-server ~]# ansible web-nodes -m cron -a "name='test' state=absent"   

======================================================
使用ansible添加一條定時任務
[root@ansible-server ~]# ansible web-nodes -m cron -a "minute=* hour=* day=* month=* weekday=*  job='/bin/sh /server/scripts/test.sh'"

遠程受控節點上查看
[root@ansible-node02 ~]# crontab -l
#Ansible: None
* * * * * /bin/sh /server/scripts/test.sh

設置定時任務注釋信息，防止重復，name設定一個名稱
[root@ansible-server ~]# ansible web-nodes -m cron -a "name='cron01' job='/bin/sh /server/scripts/test.sh'"
[root@ansible-server ~]# ansible web-nodes -m cron -a "name='cron02' job='/bin/sh /server/scripts/test2.sh'"

遠程受控節點上查看
[root@ansible-node02 ~]# crontab -l
#Ansible: cron01
* * * * * /bin/sh /server/scripts/test.sh
#Ansible: cron02
* * * * * /bin/sh /server/scripts/test2.sh

刪除相應定時任務
[root@ansible-server ~]# ansible 172.16.60.212 -m cron -a "name='ansible cron02' minute=0 hour=0 job='/bin/sh /server/scripts/test.sh' state=absent"

注釋相應定時任務，使定時任務失效 (disabled=yes 表示注釋掉, 即無效; disabled=no 表示去掉注釋, 即有效)
[root@ansible-server ~]# ansible web-nodes -m cron -a "name='ansible cron01' minute=0 hour=0 job='/bin/sh /server/scripts/test.sh' disabled=yes"

21.  mount模塊
在遠程受控節點上掛載文件系統。可用參數:
present: 開機掛載，僅將掛載配置寫入/etc/fstab（不常用）
mounted: 掛載設備，並將配置寫入/etc/fstab
unmounted: 卸載設備，不會清除/etc/fstab寫入的配置
absent: 卸載設備，會清理/etc/fstab寫入的配置

mount已經使用path代替了原來的name參數，但是name參數還是可以使用的.

將受控節點的/dev/sd0設備掛載到/mnt/data目錄上, 文件格式為ext4, 只讀屬性
[root@ansible-server ~]# ansible web-nodes -m mount -a "path=/mnt/data src=/dev/sd0 fstype=ext4 ots=ro state=present"

僅將掛載的配置寫入/etc/fstab，並不會執行掛載操作
[root@ansible-server ~]# ansible web-nodes -m mount -a "src=172.16.60.220:/data path=/data fstype=nfs opts=defaults state=present"

臨時掛載設備，並將掛載信息寫入/etc/fstab
[root@ansible-server ~]# ansible web-nodes -m mount -a "src=172.16.60.220:/data path=/data fstype=nfs opts=defaults state=mounted"

臨時卸載，不會清理/etc/fstab
[root@ansible-server ~]# ansible web-nodes -m mount -a "src=172.16.60.220:/data path=/data fstype=nfs opts=defaults state=unmounted"

卸載，不僅臨時卸載，同時會清理/etc/fstab
[root@ansible-server ~]# ansible web-nodes -m mount -a "src=172.16.60.220:/data path=/data fstype=nfs opts=defaults state=absent"

22.  find模塊
幫助在被管理的受控主機中查找符合條件的文件，就像 find 命令一樣.

常用選項:
paths:  必須參數，指定在哪個目錄中查找文件，可以指定多個路徑，路徑間用逗號隔開，此參數有別名，使用別名 path 或者別名 name 可以代替 paths。
recurse: 默認情況下，只會在指定的目錄中查找文件，也就是說，如果目錄中還包含目錄，ansible 並不會遞歸的進入子目錄查找對應文件，如果想要遞歸的查找文件，需要使用 recurse 參數，當 recurse 參數設置為 yes 時，表示在指定目錄中遞歸的查找文件。
hidden: 默認情況下，隱藏文件會被忽略，當 hidden 參數的值設置為 yes 時，才會查找隱藏文件。
file_type: 默認情況下，ansible 只會根據條件查找”文件”，並不會查找”目錄”或”軟鏈接”等文件類型，如果想要指定查找的文件類型，可以通過 file_type 指定文件類型，可指定的文件類型有 any、directory、file、link 四種。
patterns: 使用此參數指定需要查找的文件名稱，支持使用 shell（比如通配符）或者正則表達式去匹配文件名稱，默認情況下，使用 shell 匹配對應的文件名，如果想要使用 python 的正則去匹配文件名，需要將 use_regex 參數的值設置為 yes。
use_regex：默認情況下，find 模塊不會使用正則表達式去解析 patterns 參數中對應的內容，當 use_regex 設置為 yes 時，表示使用 python 正則解析 patterns 參數中的表達式，否則，使用 glob 通配符解析 patterns 參數中的表達式。
contains：使用此參數可以根據文章內容查找文件，此參數的值為一個正則表達式，find 模塊會根據對應的正則表達式匹配文件內容。
age: 使用此參數可以根據時間范圍查找文件，默認以文件的 mtime 為准與指定的時間進行對比，比如，如果想要查找 mtime 在3天之前的文件，那么可以設置 age=3d，如果想要查找 mtime 在3天以內的文件，可以設置 age=-3d，這里所說的3天是按照當前時間往前推3天，可以使用的單位有秒(s)、分(m)、時(h)、天(d)、星期(w)。
age_stamp: 文件的時間屬性中有三個時間種類，atime、ctime、mtime，當我們根據時間范圍查找文件時，可以指定以哪個時間種類為准，當根據時間查找文件時，默認以 mtime 為准。
size: 使用此參數可以根據文件大小查找文件，比如，如果想要查找大於3M的文件，那么可以設置 size=3m,如果想要查找小於50k的文件，可以設置 size=-50k，可以使用的單位有 t、g、m、k、b。
get_checksum: 當有符合查找條件的文件被找到時，會同時返回對應文件的 sha1校驗碼，如果要查找的文件比較大，那么生成校驗碼的時間會比較長

在受控主機的 /data目錄中查找文件內容中包含wang字符串的文件，隱藏文件會被忽略，不會進行遞歸查找。
[root@ansible-server ~]# ansible web-nodes -m find -a "paths=/data contains=".*wang.*"" 

在受控主機的的 /data目錄以及其子目錄中查找文件內容中包含wang字符串的文件，隱藏文件會被忽略。
[root@ansible-server ~]# ansible web-nodes -m find -a "paths=/data contains=".*wang.*" recurse=yes" 

在受控主機的的 /data目錄中查找以 .sh 結尾的文件，包括隱藏文件，但是不包括目錄或其他文件類型，不會進行遞歸查找。
[root@ansible-server ~]# ansible web-nodes -m find -a 'paths=/data patterns="*.sh" file_type=any hidden=yes'

在受控主機的的 /data目錄中查找以 .sh 結尾的文件，只不過patterns對應的表達式為正則表達式，查找范圍包括隱藏文件，包括所有文件類型，
但是不會進行遞歸查找，不會對/data目錄的子目錄進行查找。
[root@ansible-server ~]# ansible web-nodes -m find -a 'paths=/data patterns=".*\.sh" use_regex=yes file_type=any hidden=yes'  

在受控主機的的 /data目錄中以及其子目錄中查找 mtime 在1天以內的文件，不包含隱藏文件，不包含目錄或軟鏈接文件等文件類型。
[root@ansible-server ~]# ansible web-nodes -m find -a "path=/data age=-1d recurse=yes"

在受控主機的的 /data目錄中以及其子目錄中查找大於 2g 的文件，不包含隱藏文件，不包含目錄或軟鏈接文件等文件類型。
[root@ansible-server ~]# ansible web-nodes -m find -a "paths=/data size=2g recurse=yes"

在受控主機的的 /data目錄中以及其子目錄中查找以 .sh 結尾的文件，並且返回符合條件文件的 sha1 校驗碼，包括隱藏文件
[root@ansible-server ~]# ansible web-nodes -m find -a "paths=/data patterns=*.sh get_checksum=yes hidden=yes recurse=yes"

23.  selinux模塊
管理遠程受控節點的selinux的模塊

[root@ansible-server ~]# ansible web-nodes -m selinux -a 'state=disabled'  
172.16.60.212 | SUCCESS => {
    "changed": false, 
    "configfile": "/etc/selinux/config", 
    "msg": "", 
    "policy": "targeted", 
    "reboot_required": false, 
    "state": "disabled"
}
172.16.60.213 | SUCCESS => {
    "changed": false, 
    "configfile": "/etc/selinux/config", 
    "msg": "", 
    "policy": "targeted", 
    "reboot_required": false, 
    "state": "disabled"
}

24.  setup模塊
用於收集遠程受控主機的一些基本信息. 

filter參數：用於進行條件過濾。如果設置，僅返回匹配過濾條件的信息

不加過濾參數, 就會將受控主機的所有信息都打印出來
[root@ansible-server ~]# ansible web-nodes -m setup

獲取受控主機的 IPV4 地址
[root@ansible-server ~]# ansible web-nodes -m setup -a "filter=ansible_all_ipv4_addresses"
172.16.60.212 | SUCCESS => {
    "ansible_facts": {
        "ansible_all_ipv4_addresses": [
            "172.16.60.212"
        ]
    }, 
    "changed": false
}
172.16.60.213 | SUCCESS => {
    "ansible_facts": {
        "ansible_all_ipv4_addresses": [
            "172.16.60.213", 
            "172.19.0.1", 
            "172.17.0.1"
        ]
    }, 
    "changed": false
}


獲取受控主機的內存信息
[root@ansible-server ~]# ansible web-nodes -m setup -a "filter=ansible_memory_mb"
172.16.60.213 | SUCCESS => {
    "ansible_facts": {
        "ansible_memory_mb": {
            "nocache": {
                "free": 7244, 
                "used": 578
            }, 
            "real": {
                "free": 4772, 
                "total": 7822, 
                "used": 3050
            }, 
            "swap": {
                "cached": 0, 
                "free": 8063, 
                "total": 8063, 
                "used": 0
            }
        }
    }, 
    "changed": false
}
172.16.60.212 | SUCCESS => {
    "ansible_facts": {
        "ansible_memory_mb": {
            "nocache": {
                "free": 7194, 
                "used": 628
            }, 
            "real": {
                "free": 3544, 
                "total": 7822, 
                "used": 4278
            }, 
            "swap": {
                "cached": 0, 
                "free": 8063, 
                "total": 8063, 
                "used": 0
            }
        }
    }, 
    "changed": false
}


通過通配符實現模糊匹配，比如以”mb”關鍵字結尾的信息
[root@ansible-server ~]# ansible web-nodes -m setup -a "filter=*mb"
172.16.60.212 | SUCCESS => {
    "ansible_facts": {
        "ansible_memfree_mb": 3543, 
        "ansible_memory_mb": {
            "nocache": {
                "free": 7193, 
                "used": 629
            }, 
            "real": {
                "free": 3543, 
                "total": 7822, 
                "used": 4279
            }, 
            "swap": {
                "cached": 0, 
                "free": 8063, 
                "total": 8063, 
                "used": 0
            }
        }, 
        "ansible_memtotal_mb": 7822, 
        "ansible_swapfree_mb": 8063, 
        "ansible_swaptotal_mb": 8063
    }, 
    "changed": false
}
172.16.60.213 | SUCCESS => {
    "ansible_facts": {
        "ansible_memfree_mb": 4771, 
        "ansible_memory_mb": {
            "nocache": {
                "free": 7243, 
                "used": 579
            }, 
            "real": {
                "free": 4771, 
                "total": 7822, 
                "used": 3051
            }, 
            "swap": {
                "cached": 0, 
                "free": 8063, 
                "total": 8063, 
                "used": 0
            }
        }, 
        "ansible_memtotal_mb": 7822, 
        "ansible_swapfree_mb": 8063, 
        "ansible_swaptotal_mb": 8063
    }, 
    "changed": false
}

其他常用信息列出:

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個數(只顯示總的個數).

########  Ansible常用命令說明  ########                                                                         

Ansible命令是日常工作中最長使用的命令，主要的使用場景為非固化需求，臨時一次性的操作。

1)  ansible命令的用法
ansible命令其實在運維工作中用的最多的命令，它的主要目的或者說是主要的應用場景是：在做臨時性的操作的時候(比如只想看看被控端的一台主機或者多台主機是否存活),在man中的定義是:run a command somewhere else ansible通過ssh實現配置管理、應用部署、任務執行等功能，建議配置ansible端能基於密鑰認證的方式聯系各個被管理節點.  ansible命令在運維工作中是尤為重要的在操作的時候結合ansible的模塊(ansible-doc --list命令查看模塊)可以實現很多功能:

語法:ansible <host-pattern> [options]

使用ansible --help可以查看到命令參數, 
常用選項參數：
--version               #顯示版本
-m module               #指定使用的模塊，默認為command
-v                      #查看執行的詳細過程(-vv、-vvvv更詳細)
--list-hosts            #顯示主機列表(可以簡寫為--list)
-k,--ask-pass           #提示輸入ssh連接密碼，默認使用key驗證
-K,--ask-become-pass    #提示執行輸入sudo的密碼
-C,--check              #檢查，並不執行
-T,--timeout=TIMEOUT    #執行命令的超時時間，默認10s
-u,--user=REMOTE_USER   #指定遠程執行的執行用戶
-b,--become             #代替舊版本的sudo切換
-h,--help               #顯示使用幫助
-u                      #指定遠程主機運行此命令的用戶
-s                      #相當於sudo
-S                      #使用sudo

======================================================
[普通選項]
-a MODULE_ARGS
--args=MODULE_ARGS
傳遞參數給模塊
 
--ask-vault-pass
詢問vault的密碼
 
-B SECONDS
--background=SECONDS
異步后台⽅式執⾏任務，並在指定的秒數后超時，超時會殺掉任務的進程。默認是同步，即保持長連接，它會等待
所有執⾏完畢（即阻塞模式）。但有時候是沒必要這樣的，⽐如某些命令的執⾏時間⽐ssh的超時時間還長。如果
不指定超時秒數，將以同步⽅式運⾏任務
 
-P POLL_INTERVAL
--poll=POLL_INTERVAL
異步模式下輪詢任務的時間間隔，默認60秒
 
-C
--check
不對遠程主機做一些改變，而是預測某些可能發生的改變(檢查功能)
 
-e EXTRA_VARS
--extra-vars=EXTRA_VARS
配置額外的配置變量(key=value或者YAML/JSON格式)
 
-f FORKS
--forks=FORKS
指定並行處理的進程數量，默認5個
 
-h
--help
顯示幫助信息
 
-i INVENTORY
--inventory-file=INVENTORY
指定inventory⽂件，多個⽂件使⽤逗號分隔。默認為/etc/ansible/hosts
 
-l SUBSET
--limit=SECONDS
使⽤額外的匹配模式來篩選⽬標主機列表。
此處的匹配模式是在已有匹配模式下進⾏的，所以是更嚴格的篩選。例如指定了主機組的情況下，使⽤-l選項從中只選⼀台主機進⾏控制
 
--list-hosts
不會執行任何操作，而是列出匹配到的主機列表
 
-m MODULE_NAME
--module-name=MODULE_NAME
指定要執行的模塊名，默認的模塊為"command"
 
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE
new vault password f ile f or rekey
 
-o
--one-line
簡化輸出(一行輸出模式)
 
--output-OUTPUT_FILE
output f ile name f or encrypt or decrypt; use - f or stdout
 
--syntax-check
檢查playbook的語法，不會執行
 
-t TREE
--tree=TREE
記錄輸出到此⽬錄中（測試時以每個host名如IP地址為⽂件名記錄，結果記錄到對應的⽂件中）。
此選項在ansible巨慢的時候(如瞬間應該返回的命令還需要10多秒才完成)有奇⽤，或者將ansible的結果重
定向到某個⽂件中也能解決，為什么如此，我也不明⽩(表⾯看來和輸出⽅式有關系)，多次親測有效。
 
--vault-password-file=VAULT_PASSWORD_FILE
指定vault密碼文件
 
-v
--verbose
輸出詳細信息，-vvv和-vvvv輸出更詳細的信息
 
--version
顯示ansbile的版本
 
======================================================
[以下是連接選項，⽤於控制誰以及如何連接主機]
-k
--ask-pass
詢問連接時的密碼
 
--private-key=KEY_FILE
--key-file=KEY_FILE
使用文件來認證SSH連接的過程
 
-u REMOTE_USER
--user=REMOTE_USER
使用指定的用戶名進行連接
 
-c CINNECTION
--connection=CINNECTION
連接類型，默認為ssh。paramiko (SSH), ssh, winrm and local. local is mostly usef ul f or crontab or kickstarts.
 
-T TIMEOUT
--time=TIMEOUT
連接的超時時間，單位為秒，默認10秒
 
--ssh-common-args=SSH_COMMON_ARGS
指定傳遞給sftp/scp/ssh等⼯具的通⽤額外參數
 
--sftp-extra-args=SFTP_EXTRA_ARGS
指定只傳遞給sftp的額外參數，如-f
 
--scp-extra-args=SCP_EXTRA_ARGS
指定只傳遞給scp的額外參數，如-l
 
--ssh-extra-args=SSH_EXTRA_ARGS
指定只傳遞給ssh的額外參數，如-R
 
======================================================
[以下是權限控制選項：控制在⽬標主機上以什么⾝份和權限運⾏任務]
-s
--sudo
為運行ansible命令的用戶提升權限為sudo_user的權限，此命令已經報廢，使用become代替
 
-u SUDO_USER
--sudo-user=SUDO_USER
期望的sudo_user,默認為root，已報廢，使用become代替
 
-S
--su
使⽤su的⽅式執⾏操作，已廢棄，使⽤become替代
 
-R SU_USER
--su-user=SU_USER
使⽤此user的su執⾏操作，默認為root，已廢棄，使⽤become替代
 
-b
--become
使用become的方式升級權限
 
--become-method=BECOME_METHOD
指定提升權限的方式,可選以下⼏種：sudo/su/pbrun/pf exec/doas/dzdo/ksu/runas值
 
--become-user=BECOME_USER
要提升為哪個user的權限，默認為root
 
--ask-sudo-pass
詢問sudo密碼，已廢棄，使⽤become替代
 
--ask-su-pass
詢問su的密碼，已廢棄，使⽤become替代
 
-K
--ask-become-pass
詢問become提升權限時的密碼

 Ansible返回結果一般會使用紅色，橘色，橘黃色顯示，紅色表示執行過程異常，會終止剩余任務的執行，綠色和橘黃色表示執行過程沒有異常，但橘黃色表示命令執行結束后目標有狀態變化，綠色表示命令執行結束后目標沒有狀態變化。

2)  ansible-doc
ansible-doc是查看ansible模塊(插件)文檔說明，針對每個模塊都有詳細的用法說明，功能和Linux的man命令類似

語法:ansible-doc [-l|-F|-s] [options] [-t <plugin type> ] [plugin]
參數:
-a, --all                                   #顯示文檔所有的模塊(這個選項有個bug)
-h, --help                                  #顯示使用幫助
-j, --json                                  #將所有的模塊轉儲為JSON格式
-l, --list                                  #查看模塊列表
-F, --list_files                            #顯示模塊的名稱和模塊原路徑
-M MODULE_PATH, --module-path=MODULE_PATH   #
-s, --snippet                               #簡介的顯示模塊的幫助信息
-t TYPE, --type=TYPE                        #指定模塊類型(默認為module)
-v, --verbose                               #查看執行的詳細過程(-vv、-vvvv更詳細)
--version                                   #查看版本
 
執行 ansible-doc 模塊名  查看模塊的詳細信息
示例:
查看模塊詳細信息
[root@ansible ~]# ansible-doc ping
> PING    (/usr/lib/python2.7/site-packages/ansible/modules/system/ping.py)
 
        A trivial test module, this module always returns `pong' on successful contact. It does not make sense in playbooks, but it is useful from `/usr/bin/ansible' to verify the
        ability to login and that a usable Python is configured. This is NOT ICMP ping, this is just a trivial test module that requires Python on the remote-node. For Windows targets,
        use the [win_ping] module instead. For Network targets, use the [net_ping] module instead.
 
OPTIONS (= is mandatory):
 
- data
        Data to return for the `ping' return value.
        If this parameter is set to `crash', the module will cause an exception.
        [Default: pong]
 
 
NOTES:
      * For Windows targets, use the [win_ping] module instead.
      * For Network targets, use the [net_ping] module instead.
 
AUTHOR: Ansible Core Team, Michael DeHaan
        METADATA:
          status:
          - stableinterface
          supported_by: core
         
 
EXAMPLES:
# Test we can logon to 'webservers' and execute python with json lib.
# ansible webservers -m ping
 
# Example from an Ansible Playbook
- ping:
 
# Induce an exception to see what happens
- ping:
    data: crash
 
RETURN VALUES:
 
 
ping:
    description: value provided with the data parameter
    returned: success
    type: string
    sample: pong
 
查看模塊的簡單信息
[root@ansible ~]# ansible-doc -s ping
- name: Try to connect to host, verify a usable python and return `pong' on success
  ping:
      data:                  # Data to return for the `ping' return value. If this parameter is set to `crash', the module will cause an exception.

3)  ansible-playbook
ansible-playbook是日常用的最多的命令，其工作機制是:通過讀取預先編寫好的playbook文件實現批量管理，要實現的功能與命令ansbile一樣，可以理解為按一定的條件組成ansible的任務集ansible-playbook命令后跟YML格式的playbook文件，執行事先編排好的任務集

語法: ansible-playbook [options] playbook.yml [playbook2 ...]
參數：大部分的參數和ansible的參數一致
可以使用:ansible-playbook --help可以查看到命令參數

例如: 使用ansible-playbook執行一個yaml文件
[root@ansible ~]# ansible-playbook -C /opt/ansible-playbook/test.yaml

4)  ansible-console (ansible自己的終端)
Ansible-console是ansible為用戶提供的一款交互式工具，用戶可在ansible-console虛擬出的終端上使用ansible內置的各種命令。所有的操作與shell類似，並支持tab補全.

語法：ansible-console [<host-pattern>] [options]
參數：大部分的參數和ansible的參數一直，因為不常用所有就不列舉了
可以使用:ansible-console --help 查看幫助

===============使用示例================
對所有的被控客戶機進行終端命令操作
[root@ansible ~]# ansible-console
Welcome to the ansible console.
Type help or ? to list commands.
 
root@all (3)[f:5]$ 然后在虛擬終端里執行命令, 比如輸入"uptime", 就會顯示所有被控客戶機的uptime命令結果
 
對/etc/ansible/hosts里面定義的某個清單列表進行終端命令操作
[root@ansible ~]# ansible-console web-nodes
Welcome to the ansible console.
Type help or ? to list commands.

root@web-nodes (9)[f:5]$ list
172.16.60.212
172.16.60.213

root@web-nodes (9)[f:5]$ cat /etc/passwd|grep root
172.16.60.212 | CHANGED | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin
dockerroot:x:998:995:Docker User:/var/lib/docker:/sbin/nologin

172.16.60.213 | CHANGED | rc=0 >>
root:x:0:0:root:/root:/bin/bash
operator:x:11:0:operator:/root:/sbin/nologin
dockerroot:x:998:995:Docker User:/var/lib/docker:/sbin/nologin
 
root@web (2)[f:5]$
 
在終端可做的操作
設置並發數: forks n  例如:forks 10
切換組: cd 組名      例如:cd web
列出當前組主機列表   例如:list
列出所有的內置命令(其實就是內置的模塊)   例如:?或者help
 
exit命令退出終端

5)  ansible-inventory
查看被控制端主機清單的詳細信息默認情況下它使用庫存腳本,返回JSON格式:

[root@ansible ~]# ansible-inventory --list
{
    "_meta": {
        "hostvars": {
            "172.16.60.205": {}, 
            "172.16.60.206": {}, 
            "172.16.60.207": {}, 
            "172.16.60.212": {}, 
            "172.16.60.213": {}, 
            "172.16.60.214": {}, 
            "172.16.60.220": {}, 
            "172.16.60.221": {}, 
            "172.16.60.222": {}
        }
    }, 
    "all": {
        "children": [
            "test", 
            "ungrouped", 
            "web-nodes"
        ]
    }, 
    "test": {
        "hosts": [
            "172.16.60.212", 
            "172.16.60.213"
        ]
    }, 
    "ungrouped": {}, 
    "web-nodes": {
        "hosts": [
            "172.16.60.205", 
            "172.16.60.206", 
            "172.16.60.207", 
            "172.16.60.212", 
            "172.16.60.213", 
            "172.16.60.214", 
            "172.16.60.220", 
            "172.16.60.221", 
            "172.16.60.222"
        ]
    }
}

6)  ansible-vault
ansible-vault主要用於配置文件的加密，如編寫的playbook配置文件中包含敏感的信息，不希望其他人隨便的看，ansible-vault可加密/解密這個配置文件:

語法:ansible-vault [create|decrypt|edit|encrypt|encrypt_string|rekey|view] [options] [vaultfile.yml]
參數:
--ask-vault-pass      ask for vault password
-h, --help                                          #查看幫助信息
--new-vault-id=NEW_VAULT_ID                         #設置用於rekey的新vault標識
--new-vault-password-file=NEW_VAULT_PASSWORD_FILE   #新的保險庫密碼文件為rekey
--vault-id=VAULT_IDS                                #要使用的保險庫標識
--vault-password-file=VAULT_PASSWORD_FILES          #庫密碼文件
-v, --verbose                                       #查看執行的詳細過程(-vv、-vvvv更詳細)
--version                                           #查看版本
 
使用參數:
encrypt (加密)
decrypt (解密)
create (創建)
view (查看)
edit (編輯)
rekey (修改密碼)
 
示例說明
新建一個yml的文件，寫入一些數據
[root@ansible-server ~]# echo "kevin123" > bo.yaml

給test.yml設置密碼
[root@ansible-server ~]# ansible-vault encrypt bo.yaml
New Vault password: 
Confirm New Vault password: 
Encryption successful

查看這個yaml文件
[root@ansible-server ~]# cat bo.yaml 
$ANSIBLE_VAULT;1.1;AES256
33663035323365353562633732366331336261356561636531393039336166623537383263346533
3634363730303134376230653163376239386536626533640a356461633233663937343061313563
36313036643738626531373331623237373636313332313830333738343561306132643836306232
3139393632343163620a313939333639333362373663323065666161646231663263363338663934
6431

上面查看到明顯被加密了. 正確的查看方式如下 (即先解密, 然后再查看):
[root@ansible-server ~]# ansible-vault decrypt bo.yaml 
Vault password: 
Decryption successful

[root@ansible-server ~]# cat bo.yaml
kevin123

查看被加密的文件
[root@ansible-server ~]# ansible-vault encrypt bo.yaml 
New Vault password: 
Confirm New Vault password: 
Encryption successful

[root@ansible-server ~]# ansible-vault view bo.yaml   
Vault password: 
kevin123

接着編輯被加密的文件
[root@ansible-server ~]# ansible-vault edit bo.yaml 
Vault password:   #輸入密碼后, 就進入了bo.yaml文件的打開方式(相當於vim進入編輯)

[root@ansible-server ~]# ansible-vault view bo.yaml 
Vault password: 
kevin123
this is test

創建被加密的文件
[root@ansible-server ~]# ansible-vault create grace.yaml
New Vault password:     #輸定這個新文件密碼
Confirm New Vault password:   #再次確認密碼后, 就直接進入到這個新文件中進行編輯

 [root@ansible-server ~]# ansible-vault view grace.yaml
Vault password: 
this is test of grace

########  其他常規用法  ########

1)  ansible限制后台運行時間

后台運行總是耗費比較長的時間，從而其狀態在隨后總是能夠查看的，如果踢掉主機，又不想輪訓，如下:
[root@ansible-server ~]# ansible web-nodes -B 3600 -P 0 -a "/usr/bin/long_running_operation --do-stuff"

如果要檢查服務的狀態，可以使用模塊async_status，傳遞job id，如下:
[root@ansible-server ~]# ansible web-nodes -m async_status -a "jid=488359678239.2844"

輪訓是內建的, 如下:
[root@ansible-server ~]# ansible web-nodes -B 1800 -P 60 -a "/usr/bin/long_running_operation --do-stuff"

解釋說明:
參數-B表示運行最多30分鍾，30*60，-P 60 輪訓其狀態每60S，
當時間運行在-B參數后的時間之后，此服務會被停止運行。
可以使用參數—forksvalue，來確保服務盡快運行

2)  ansible收集和查看相關信息, 用於過濾等

[root@ansible-server ~]# ansible all -m setup
[root@ansible-server ~]# ansible web-nodes -m setup
[root@ansible-server ~]# ansible 172.16.60.214 -m setup

3)  Ansible的委托、並發、任務超時

Ansible-playbook 並發運行async、poll, 即ansible的異步執行
ansible方便在於能批量下發，並返回結果和呈現。簡單、高效。但有的任務執行起來卻不那么直接，可能會花比較長的時間，甚至可能會比ssh的超時時間還要長。這種情況任務是不是沒法執行了？
ansible考慮到了這種情況，解決方法就是讓下發的任務執行的連接變為異步：任務下發之后，長連接不再保持，而是每隔一段時間輪詢結果，直到任務結束。這就需要在playbook的任務中加入兩個參數：async和poll。其中:
-> async參數值代表了這個任務執行時間的上限值。即任務執行所用時間如果超出這個時間，則認為任務失敗。此參數若未設置，則為同步執行。
-> poll參數值代表了任務異步執行時輪詢的時間間隔。

ansible默認只會創建5個進程,所以一次任務只能同時控制5台機器執行，那如果你有大量的機器需要控制，或者你希望減少進程數,那你可以采取異步執行。ansible的模塊可以把task放進后台，然后輪詢它.這使得在一定進程數下能讓大量需要的機器同時運作起來。使用async和poll這兩個關鍵字便可以並行運行一個任務。async這個關鍵字觸發ansible並行運作任務，而async的值是ansible等待運行這個任務的最大超時值，而poll就是ansible檢查這個任務是否完成的頻率時間。

1.  異步和輪詢
Ansible 有時候要執行等待時間很長的操作， 這個操作可能要持續很長時間，設置超過ssh的timeout，這時候你可以在step中指定async 和 poll 來實現異步操作。
async 表示這個step的最長等待時長，如果設置為0，表示一直等待下去直到動作完成。
poll 表示檢查step操作結果的間隔時長。

示例1

---
- name: Test
  hosts: localhost
  tasks:
    - name: wair for
      shell: sleep 16
      async: 10
      poll: 2

結果:
TASK: [wair for] ************************************************************** 
ok: [localhost]
<job 207388424975.101038> polling, 8s remaining
ok: [localhost]
<job 207388424975.101038> polling, 6s remaining
ok: [localhost]
<job 207388424975.101038> polling, 4s remaining
ok: [localhost]
<job 207388424975.101038> polling, 2s remaining
ok: [localhost]
<job 207388424975.101038> polling, 0s remaining
<job 207388424975.101038> FAILED on localhost

這個step失敗, 因為操作時間超過了最大等待時長

示例2

---
- name: Test
  hosts: localhost
  tasks:
    - name: wair for
      shell: sleep 16
      async: 10
      poll: 0

結果:
TASK: [wair for] ************************************************************** 
<job 621720484791.102116> finished on localhost

PLAY RECAP ********************************************************************

poll 設置為0, 表示不用等待執行結果, 該step執行成功

示例3

---
- name: Test
  hosts: localhost
  tasks:
    - name: wair for
      shell: sleep 16
      async: 0
      poll: 10

結果:
# time ansible-playbook xiama.yml 
TASK: [wair for] ************************************************************** 
changed: [localhost]

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


real    0m16.693s

async設置為0, 會一直等待直到該操作完成.

2.  ansible-playbook執行時的並發限制
一般情況下, ansible會同時在所有服務器上執行用戶定義的操作, 但是用戶可以通過serial參數來定義同時可以在多少太機器上執行操作。

- name: test play
  hosts: webservers
  serial: 3

webservers組中的3台機器完全完成play后, 其他3台機器才會開始執行

serial參數在ansible-1.8以后就開始支持百分比

最大失敗百分比
默認情況下, 只要group中還有server沒有失敗, ansible就是繼續執行tasks. 實際上, 用戶可以通過"max_fail_percentage" 來定義, 只要超過max_fail_percentage台的server失敗, ansible 就可以中止tasks的執行:

- hosts: webservers
  max_fail_percentage: 30
  serial: 10

注意: 實際失敗機器必須大於這個百分比時, tasks才會被中止. 等於時是不會中止tasks的

3.  委托
通過"delegate_to", 用戶可以把某一個任務放在委托的機器上執行.

- hosts: webservers
  serial: 5

  tasks:

  - name: take out of load balancer pool
    command: /usr/bin/take_out_of_pool {{ inventory_hostname }}
    delegate_to: 127.0.0.1

上面的task會在跑ansible的機器上執行, "delegate_to: 127.0.0.1" 可以用local_action來代替:

  tasks:

  - name: take out of load balancer pool
    local_action: command /usr/bin/take_out_of_pool {{ inventory_hostname }}

委托者的facts
默認情況下, 委托任務的facts是inventory_hostname中主機的facts, 而不是被委托機器的facts。在ansible 2.0 中, 設置delegate_facts為true可以讓任務去收集被委托機器的facts

- hosts: app_servers
  tasks:
    - name: gather facts from db servers
      setup:
      delegate_to: "{{item}}"
      delegate_facts: True
      with_items: "{{groups[‘dbservers‘}}"

該例子會收集dbservers的facts並分配給這些機器, 而不會去收集app_servers的facts

RUN ONCE
通過run_once: true來指定該task只能在某一台機器上執行一次. 可以和delegate_to 結合使用

- command: /opt/application/upgrade_db.py
  run_once: true
  delegate_to: web01.example.org

指定在"web01.example.org"上執行這

如果沒有delegate_to, 那么這個task會在第一台機器上執行

4）ansible清單文件里設置ip的別名

注意：別名后面要記得跟上ansible_ssh_host內置變量，指定別名多對應的ip）：
[root@localhost ansible]# ansible --version
ansible 2.4.2.0

從ansible2.0開始，ansible_ssh_user，ansible_ssh_host，ansible_ssh_port 這三個inventory內置參數可以變為ansible_user，ansible_host，ansible_port。

[root@localhost ansible]# cat /etc/ansible/hosts
kevin ansible_host=172.16.60.236 ansible_user=root ansible_port=22
grace ansible_host=172.16.60.238 ansible_user=root ansible_port=22
 
執行命令：
[root@localhost ansible]# ansible -i /etc/ansible/hosts kevin,grace -m shell -a "hostname -I"
kevin | SUCCESS | rc=0 >>
172.16.60.236 

grace | SUCCESS | rc=0 >>
172.16.60.238

5）ansible分發密鑰 （authorized_key模塊）

首先保證host_key_checking是false，即跳過ssh首次連接提示驗證部分! 默認是check的, 取消注釋，確保設置為False。
[root@localhost ansible]# vim /etc/ansible/ansible.cfg
host_key_checking = False

清單配置如下：
[root@localhost ansible]# cat /etc/ansible/hosts 
172.16.60.238

[test_host]
172.16.60.234
172.16.60.235

[test_host:vars]
ansible_ssh_user=root
ansible_ssh_port=22
ansible_ssh_pass=bR7k@1YU234

執行命令，這里需要用到authorized_key模塊：
[root@localhost ansible]# ansible -i /etc/ansible/hosts test_host -m  authorized_key  -a "user=root key='{{ lookup('file', '/root/.ssh/id_rsa.pub') }}'"

上面命令執行后，則ansible本機即將公鑰分發到test_host組下機器，ssh信任關系也將做好！

##########################
需要注意：如果上面示例中，沒有使用ansible_ssh_pass指明密碼，則在執行authorized_key密鑰分發命令中可以使用-k命令輸入密碼，如下：
[root@localhost ansible]# cat /etc/ansible/hosts
172.16.60.238

[test_host]
172.16.60.234
172.16.60.235

[test_host:vars]
ansible_ssh_user=root
ansible_ssh_port=22

使用-k 參數，回車輸入密碼即可：
[root@localhost ansible]# ansible -i /etc/ansible/hosts test_host -m authorized_key -a "user=root state=present key=\"{{ lookup('file', '/root/.ssh/id_rsa.pub') }} \"" -k

6）Ansible 通過private key私鑰配置來免密登錄（ansible_ssh_private_key_file，前提是使用了paramiko庫）

ansible_ssh_private_key_file是ansible配置使用的私鑰文件，適用於有多個密鑰, 並且又不想使用SSH代理的情況.

需要注意：
1. ansible使用私鑰, 確保ansible啟用了paramiko庫!!（這一點非常重要！！ansible2版本后，默認使用smart庫）
2. 在/etc/ansible/ansible.cfg文件里 [ssh_connection] 區域下面指定contrl_path選項的配置, 
   如果不指定的話，會一直報"group-readable or world-readable and thus insecure"

操作記錄如下：
一、ansible服務端配置
1）配置ansible.cfg文件，確保ansible啟用了paramiko庫，確保配置了存放客戶機私鑰文件位置
[root@localhost ansible]# cat /etc/ansible/ansible.cfg |grep control_path
[defaults]
.......
transport      = paramiko              # 添加這一行，ansible2以上版本默認為smart
[ssh_connection]
.......
control_path = /etc/ansible/ssh_keys   # 添加這一行，指定ansible服務端存放客戶機私鑰文件的路徑

2）創建存放私鑰文件位置的目錄，並授權700
創建ssh_keys 文件夾，並且給ssh_keys文件夾授權為700, 一定要700！！否則會報錯.
[root@localhost ~]# mkdir -p /etc/ansible/ssh_keys
[root@localhost ~]# chmod 777 /etc/ansible/ssh_keys
[root@localhost ansible]# ll -d /etc/ansible/ssh_keys
drwx------ 2 root root 6 Dec 28 19:53 /etc/ansible/ssh_keys

3）配置清單文件
[root@localhost ansible]# cat /etc/ansible/hosts
172.16.60.238
[test_host]
172.16.60.233 ansible_ssh_private_key_file=/etc/ansible/ssh_keys/172.16.60.233.key ansible_ssh_user=root ansible_ssh_port=22
172.16.60.234 ansible_ssh_private_key_file=/etc/ansible/ssh_keys/172.16.60.234.key ansible_ssh_user=root ansible_ssh_port=22
172.16.60.235 ansible_ssh_private_key_file=/etc/ansible/ssh_keys/172.16.60.235.key ansible_ssh_user=root ansible_ssh_port=22

4) 將配置的遠程客戶機的公鑰記錄到本地的known_hosts (這一步，其實可以不用操作！！！)
[root@localhost ansible]# ssh-keyscan 172.16.60.233 172.16.60.234 172.16.60.235 >> /root/.ssh/known_hosts

這里注意兩個很重要的命令：
ssh-keygen： 這個命令是用來生成本機的公鑰和私鑰的。 
ssh-keyscan：這條命令是用來把遠程服務器的公鑰來獲取到本地的。

二、ansible遠程客戶機操作（上面配置的三台機器都要操作）
1) 在遠程客戶機上生成密鑰，並將公鑰內容拷貝到authorized_keys文件內
[root@localhost ~]# ssh-keygen -t rsa
[root@localhost ~]# cat /root/.ssh/id_rsa.pub >> authorized_keys

2) 將遠程客戶機上的私鑰回傳到ansible服務器端，並更名為服務端清單文件里配置的key名稱
即分別將上面服務端配置的三個客戶機的私鑰文件id_rsa的內容拷貝到ansible服務端的/etc/ansible/ssh_keys目錄下，並分別保存為清單文件里配置的文件：
172.16.60.233.key、172.16.60.234.key、172.16.60.235.key

三、ansible服務端執行命令：
[root@localhost ansible]# ansible -i /etc/ansible/hosts test_host -m command -a "hostname -I"
172.16.60.235 | SUCCESS | rc=0 >>
172.16.60.235 

172.16.60.233 | SUCCESS | rc=0 >>
172.16.60.233 

172.16.60.234 | SUCCESS | rc=0 >>
172.16.60.234 

[root@localhost ansible]# ansible -i /etc/ansible/hosts test_host -m command -a "cat /etc/redhat-release"
172.16.60.235 | SUCCESS | rc=0 >>
CentOS Linux release 7.7.1908 (Core)

172.16.60.233 | SUCCESS | rc=0 >>
CentOS Linux release 7.7.1908 (Core)

172.16.60.234 | SUCCESS | rc=0 >>
CentOS Linux release 7.7.1908 (Core)

如上，已經實現了ansible通過private key私鑰配置來免密登錄！！

7）Ansible的權限提升設置  (become代替ansible sudo)
Ansible下有些task任務，使用普通權限無法完成時，可以使用sudo來提升執行的權限。在ansible1.9版本后， ansible sudo命令已經變更為become。當需要執行某些特殊操作需要專門權限時，可以用become_user強制切換。

#######################################################
1) ansible.cfg文件中有默認的become設置
[root@localhost ansible]# vim /etc/ansible/ansible.cfg
......
......
[privilege_escalation]
#become=True
#become_method=sudo
#become_user=root
#become_ask_pass=False

#######################################################
2）ansible中become的說明
2.1 Ansible允許你成為另一個用戶，與登錄到本機的用戶或遠程用戶不同，這是使用現有的特權升級工具（privilege escalation tools）完成的：
    在1.9 Ansible之前，大多數情況下都允許使用sudo和有限的su來允許登錄/遠程用戶成為不同的用戶並執行任務，用第二個用戶的權限創建資源。從1.9開始become代替舊的sudo / su，同時仍然向后兼容。
    這個新系統也使得添加諸如pbrun（Powerbroker），pfexec，dzdo（Centrify）等其他特權升級工具變得更加容易。
2.2 變量和指令是獨立的，即設置become_user並不是設置become。

#######################################################
3）Ansible中become的使用
3.1 become
    使用"true"或"yes"來表示啟用這個特權，如：become=true
    表示打開了become開關。
3.2 become_user
    設置為root賬戶，相當於我們以普通賬戶登入到遠程主機時，再使用su - root切換為root賬戶。如：become_user=root 
3.3 become_method
    表示用什么方式將普通賬戶切換到root或所需的其他賬戶，這里可以用su或sudo。如：become_method=sudo
3.4 become_flags
    表示允許為任務或角色使用特定的標志。一個常見的用法是在shell設置為不登錄時將用戶更改為nobody。ansible2.2版本中增加。

#######################################################
4）ansible中become的使用舉例

示例1: 以kevin用戶登陸遠程機器，然后sudo到root用戶下執行命令!!!
如下配置，要搞清楚：
remote_user是你登陸遠程主機的用戶
become_user是登陸遠程主機后sudo切換的用戶
[root@localhost ansible]# cat /etc/ansible/hosts
[test_host]
172.16.60.236 ansible_ssh_user=kevin

[root@localhost ansible]# cat /etc/ansible/haha.yaml
---
- hosts: test_host
  remote_user: kevin
  gather_facts: no
  
  tasks:
    - name: test
      shell: rm -f /root/a.sh
      become: yes
      become_user: root
      become_method: sudo

執行結果：
[root@localhost ansible]# ansible-playbook haha.yaml

PLAY [test_host] *********************************************************************************************************************************

TASK [test] **************************************************************************************************************************************
 [WARNING]: Consider using file module with state=absent rather than running rm

changed: [172.16.60.236]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.236              : ok=1    changed=1    unreachable=0    failed=0 

必須要注意的是：
前提是在ansible遠程主機那邊，要將kevin用戶提前設置sudo權限！！(如下，kevin用戶可以無密碼執行sudo命令)
[root@localhost ~]# visudo 
kevin  ALL=(ALL)       NOPASSWD: ALL

如果ansible遠程主機不設置Kevin的sudo權限，則執行時會報錯：
[root@localhost ansible]# ansible-playbook haha.yaml

PLAY [test_host] *********************************************************************************************************************************

TASK [test] **************************************************************************************************************************************
fatal: [172.16.60.236]: FAILED! => {"changed": false, "module_stderr": "", "module_stdout": "sudo: a password is required\r\n", "msg": "MODULE FAILURE", "rc": 1}
        to retry, use: --limit @/etc/ansible/haha.retry

PLAY RECAP ***************************************************************************************************************************************
172.16.60.236              : ok=0    changed=0    unreachable=0    failed=1 

如果ansible遠程主機設置的Kevin的sudo權限里沒有免密，如下：
[root@localhost ~]# visudo 
kevin  ALL=(ALL)       ALL

則執行playbook命令時，需要帶上-K參數，輸入sudo密碼（即"sudo su root"命令的密碼, 也就是輸入kevin用戶密碼）：
[root@localhost ansible]# ansible-playbook haha.yaml -K
SUDO password: 

PLAY [test_host] *********************************************************************************************************************************

TASK [test] **************************************************************************************************************************************
 [WARNING]: Consider using file module with state=absent rather than running rm

changed: [172.16.60.236]

PLAY RECAP ***************************************************************************************************************************************
172.16.60.236              : ok=1    changed=1    unreachable=0    failed=0   

示例2:
[root@localhost ansible]# cat haha.yaml
---
- hosts: test_host
  remote_user: kevin
  gather_facts: no
  become: yes
  become_user: root
  become_method: sudo
  
  tasks:
    - name: test1
      shell: rm -f /root/a.sh
    - name: test2
      file: path=/opt/task1.txt state=touch
    - name: test3
      file: path=/opt/task1.txt mode=777 owner=root group=root

示例3:
[root@localhost ansible]# cat haha.yaml 
---
- hosts: test_host
  remote_user: root
  gather_facts: no
  
  tasks:
    - name: test1
      shell: hostname > /tmp/a.list
      become: true
      become_method: su
      become_user: kevin
      become_flags: '-s /bin/sh'

#######################################################
5）become變量在hosts使用
說明：允許設置每個組和/或主機的選項，這些選項通常在hosts中定義，但可以用作正常變量來使用。
5.1 ansible_become
    相當於成為指令，決定是否使用特權升級。
5.2 ansible_become_method
    允許設置權限升級方法,一般為su或sudo
5.3 ansible_become_user
    允許通過權限升級來設置你成為用戶，記得同時使用ansible_become：true
5.4 ansible_become_pass
    允許設置特權密碼

配置示例：
[root@localhost ansible]# cat /etc/ansible/hosts
[test_host]
172.16.60.236 ansible_ssh_user=kevin ansible_become_user=root ansible_become=true  ansible_become_pass='kevin@123'
172.16.60.237 ansible_ssh_user=xiaoru ansible_become_user=root ansible_become=true  ansible_become_method=sudo ansible_become_pass='xiaoru@123'

　　

 


免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 自動化運維Ansible之常用模塊 Ansible自動化運維筆記1(安裝配置) Python 運維常用模塊 Ansible 日常使用技巧 - 運維總結 Ansible運維自動化工具19個常用模塊使用實例【轉】 Ansible-playbook 運維筆記 10.Python之Ansible自動化運維常用模塊 Apache運維中常用功能配置筆記梳理 Nginx的location配置規則總結 - 運維筆記 Ansible入門筆記（2）之常用模塊
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM