Ansible Ad-Hoc與常用模塊

ansible 執行結果信息–各顏色說明;ansible Ad-Hoc 說明;ansible 如何查看幫助文檔與常用模塊詳解

主機規劃

主機名稱 操作系統版本 內網IP 外網IP(模擬) 安裝軟件
ansi-manager CentOS7.5 172.16.1.180 10.0.0.180 ansible
ansi-haproxy01 CentOS7.5 172.16.1.181 10.0.0.181
ansi-haproxy02 CentOS7.5 172.16.1.182 10.0.0.182
ansi-web01 CentOS7.5 172.16.1.183 10.0.0.183
ansi-web02 CentOS7.5 172.16.1.184 10.0.0.184
ansi-web03 CentOS7.5 172.16.1.185 10.0.0.185

添加用戶賬號

說明:

1、 運維人員使用的登錄賬號;

2、 所有的業務都放在 /app/ 下「yun用戶的家目錄」,避免業務數據亂放;

3、 該用戶也被 ansible 使用,因爲幾乎所有的生產環境都是禁止 root 遠程登錄的(因此該 yun 用戶也進行了 sudo 提權)。

# 使用一個專門的用戶,避免直接使用root用戶
# 添加用戶、指定家目錄並指定用戶密碼
# sudo提權
# 讓其它普通用戶可以進入該目錄查看信息
useradd -u 1050 -d /app yun && echo '123456' | /usr/bin/passwd --stdin yun
echo "yun  ALL=(ALL)       NOPASSWD: ALL" >>  /etc/sudoers
chmod 755 /app/

Ansible 配置清單Inventory

之後文章都是如下主機配置清單

[yun@ansi-manager ansible_info]$ pwd
/app/ansible_info
[yun@ansi-manager ansible_info]$ cat hosts_key 
# 方式1、主機 + 端口 + 密鑰
[manageservers]
172.16.1.180:22

[proxyservers]
172.16.1.18[1:2]:22

# 方式2:別名 + 主機 + 端口 + 密碼
[webservers]
web01 ansible_ssh_host=172.16.1.183 ansible_ssh_port=22
web02 ansible_ssh_host=172.16.1.184 ansible_ssh_port=22
web03 ansible_ssh_host=172.16.1.185 ansible_ssh_port=22

Ansible執行返回 => 顏色信息說明

黃色:成功執行並且伴隨着狀態的改變

ansible proxyservers -m command -a 'cat /etc/hosts' -i hosts_key

在這裏插入圖片描述

綠色:成功執行並且沒有發生狀態的改變,或者只是對遠程節點狀態信息進行查看

ansible proxyservers -m ping -i hosts_key

在這裏插入圖片描述

紅色:操作執行命令有異常

ansible proxyservers -m command -a 'll /tmp' -i hosts_key

在這裏插入圖片描述

紫色:表示對命令執行發出警告信息(可能存在的問題,給你一下建議)

# 其中 hosts_kkk 文件不存在
ansible proxyservers -m command -a 'll /tmp' -i hosts_kkk

在這裏插入圖片描述

Ansible 之 Ad-Hoc

Ansible中有兩種模式, 分別是 Ad-Hoc 模式和 Playbooks 模式。

ad-hoc簡而言之,就是“臨時命令”,不會保存。

ad-hoc模式的使用場景

場景一,在多臺機器上,查看某個進程是否啓動

場景二,在多臺機器上,拷貝指定日誌文件到本地,等等

ad-hoc模式的命令使用

在這裏插入圖片描述

Ansible查看幫助方法

[yun@ansi-manager ~]$ ansible-doc -l       # 查看所有模塊與簡要說明
[yun@ansi-manager ~]$ ansible-doc copy     # 查看指定模塊方法「可優先查看 EXAMPLES 信息」★★★★★
[yun@ansi-manager ~]$ ansible-doc -s copy  # 查看指定模塊的 Playbooks 代碼段

Ansible常用模塊

工作目錄與主機清單

當前所在的工作目錄和主機清單

[yun@ansi-manager ansible_info]$ pwd
/app/ansible_info
[yun@ansi-manager ansible_info]$ ll
total 4
-rw-rw-r-- 1 yun yun 226 Oct  8 16:07 hosts_key
[yun@ansi-manager ansible_info]$ cat hosts_key 
# 方式1、主機 + 端口 + 密鑰
[manageservers]
172.16.1.180:22

[proxyservers]
172.16.1.18[1:2]:22

# 方式2:別名 + 主機 + 端口 + 密碼
[webservers]
web01 ansible_ssh_host=172.16.1.183 ansible_ssh_port=22
web02 ansible_ssh_host=172.16.1.184 ansible_ssh_port=22
web03 ansible_ssh_host=172.16.1.185 ansible_ssh_port=22

command 命令模塊

默認模塊, 用於執行命令。但不支持管道或重定向。

正常示例

[yun@ansi-manager ansible_info]$ ansible proxyservers -a 'df -h' -i hosts_key
# 或者
[yun@ansi-manager ansible_info]$ ansible proxyservers -m command -a 'df -h' -i hosts_key

異常示例

# 重定向不支持
ansible proxyservers -m command -a 'df -h > /tmp/df.info' -i hosts_key
# 管道不支持
ansible proxyservers -m command -a "df -h | grep 'boot'" -i hosts_key

shell 命令模塊

功能和 command 相同,且支持管道和重定向。與 command 相比,優先使用該模塊。

示例

ansible proxyservers -m shell -a "df -h | grep 'boot'" -i hosts_key
ansible proxyservers -m shell -a "df -h > /tmp/df.info" -i hosts_key 

script 腳本模塊

在本地運行模塊,等同於在遠程執行。且不需要將腳本文件推送到目標主機進行執行。

示例

腳本中有 sudo 提權

# 在 ansible 管理機操作
[yun@ansi-manager ansible_info]$ cat /app/yunwei/yum_test.sh 
#!/bin/sh
# 由於使用的是 yun 用戶,而不是 root 用戶,因此需要 sudo 提權
sudo yum install -y iftop
[yun@ansi-manager ansible_info]$ ansible proxyservers -m script -a "/app/yunwei/yum_test.sh" -i hosts_key

腳本中無 sudo 提權

# 在 ansible 管理機操作
[yun@ansi-manager ansible_info]$ cat /app/yunwei/yum_test.sh 
#!/bin/sh 
yum install -y iftop
#######################################
# 由於我們使用的是 yun 普通用戶
# 因此這裏需要使用 -b 選擇進行提權,這樣在遠程會以 root 用戶執行
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m script -a "/app/yunwei/yum_test.sh" -i hosts_key

在目標機器查看是否在 yum 安裝 iftop

[root@ansi-haproxy01 ~]# ps -ef | grep 'iftop'
root       3867   3866  0 23:25 pts/1    00:00:00 sudo yum install -y iftop
root       3868   3867 48 23:25 pts/1    00:00:12 /usr/bin/python /bin/yum install -y iftop
root       4144   3155  0 23:25 pts/0    00:00:00 grep --color=auto iftop

yum 安裝軟件模塊

在目標機器實現 yum 安裝軟件

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc yum 
# 由於我們使用的是 yun 普通用戶
# 因此必須使用 -b 選擇進行提權
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m yum -a 'name=httpd state=present' -i ./hosts_key 

相關選項說明:

name:要安裝軟件包的名稱

state:狀態說明

     ‘present’ 和 ‘installed’ 簡單地確保安裝了所需的包。「優先使用 present」

     ‘latest’ 將更新指定的軟件包,如果它不是最新可用的版本。

     ‘absent’ and ‘removed’ 將刪除指定的包【慎用!!!】。「如要使用優先使用 absent」

download_only:只下載包,不安裝

copy 文件拷貝模塊「本地到遠端」

將控制機的文件或目錄拷貝到受控機,並且可以指定目標文件/目錄的屬性信息。

控制機操作

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc copy 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
# 將 content 中的內容直接寫入目標文件中
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m copy -a "content='123\n' dest=/tmp/copy_test2 owner=root group=root mode=0644 backup=yes" -i ./hosts_key 
## 拷貝文件
[yun@ansi-manager ansible_info]$ cat /tmp/copy_test 
111111
222222
333333
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m copy -a "src=/tmp/copy_test dest=/tmp/ owner=root group=root mode=0644 backup=yes" -i ./hosts_key
## 拷貝目錄
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m copy -a "src=/app/yunwei dest=/tmp/ owner=root group=root mode=0644 backup=yes" -i ./hosts_key

被控端查看

[yun@ansi-haproxy01 tmp]$ cat copy_test2
123
[yun@ansi-haproxy01 tmp]$ cat /tmp/copy_test 
111111
222222
333333

相關選項說明:

src:源文件「可以是絕對路徑或相對路徑」

remote_src:爲 False「默認」,則源文件在本地;爲 True ,則源文件在遠端「瞭解」

dest:推送數據的目標路徑或目標文件

owner:指定遠端文件的屬主

group:指定遠端文件的屬組

mode:指定遠端文件的權限

backup:如果推送的目標文件存在且與源文件內容不同,那麼會對目標文件進行備份「通過 checksum 校驗」

content:將 content 中的內容直接寫入目標文件中

注意事項:

1、同一個源文件,如果源文件內容沒有任何修改,那麼進行第二次相同的操作時,檢測到要拷貝的文件和目標文件內容相同「通過 checksum 校驗」,且目標文件屬性前後未發生改變,那麼就不會進行拷貝。由於目標文件屬性未發生改變,所以返回數據顏色爲綠色。如下圖所示。

在這裏插入圖片描述

在這裏插入圖片描述

2、同一個源文件,如果源文件內容沒有任何修改,那麼進行第二次相同的操作時,如果源文件和目標文件內容相同「通過 checksum 校驗」,但目標文件屬性前後要求發生改變「屬主、屬組、權限」,那樣也不會進行拷貝。但由於目標文件屬性發生改變,所以返回數據顏色爲黃色。

fetch 文件拷貝模塊「遠端到本地」

該模塊功能類似於 copy 模塊,但是是反向的。將遠端的文件拷貝到本地。備註:當前僅支持文件,暫不支持遞歸拷貝。

由於ansible使用的是 yun 用戶,因此從遠端拷貝過來的文件屬主、屬組都是 yun。

控制機操作

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc fetch 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權

被控端文件準備1

[test1@ansi-haproxy01 tmp]$ ll /tmp/test1 
-rw-rw-r-- 1 test1 test1 20 Nov  2 11:04 /tmp/test1
[test1@ansi-haproxy01 tmp]$ cat /tmp/test1 
111
222
333
aaa
bbb

被控端文件準備2

[test1@ansi-haproxy02 tmp]$ ll /tmp/test1 
-rw-rw-r-- 1 test1 test1 20 Nov  2 11:04 /tmp/test1
[test1@ansi-haproxy02 tmp]$ cat /tmp/test1 
1111

拷貝方式1

[yun@ansi-manager ansible_info]$ ansible 172.16.1.181 -b -m fetch -a "src=/tmp/test1 dest=/tmp/" -i ./hosts_key  # 拷貝 172.16.1.181 主機的
或者
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m fetch -a "src=/tmp/test1 dest=/tmp/" -i ./hosts_key  # 拷貝 proxyservers 主機組的
## 查看拷貝結果「注意目錄層次」
[yun@ansi-manager ansible_info]$ ll /tmp/
total 4
drwxrwxr-x 3 yun  yun  17 Nov  2 11:21 172.16.1.181
drwxrwxr-x 3 yun  yun  17 Nov  2 11:23 172.16.1.182
[yun@ansi-manager ansible_info]$ tree /tmp/172.16.1.18*
/tmp/172.16.1.181
└── tmp
    └── test1
/tmp/172.16.1.182
└── tmp
    └── test1

2 directories, 2 files

拷貝方式2

# 如果使用 flat=yes,那麼最好只拷貝一臺遠端主機的文件,如果是多臺那麼後面執行的結果,會把前面的覆蓋掉。
# dest 路徑有 / 結尾
[yun@ansi-manager ansible_info]$ ansible 172.16.1.181 -b -m fetch -a "src=/tmp/test1 dest=/tmp/kkk2/ flat=yes" -i ./hosts_key # 推薦,只拷貝一臺
# dest 路徑無 / 結尾
[yun@ansi-manager ansible_info]$ ansible 172.16.1.181 -b -m fetch -a "src=/tmp/test1 dest=/tmp/kkk flat=yes" -i ./hosts_key  # 推薦,只拷貝一臺
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m fetch -a "src=/tmp/test1 dest=/tmp/kkk flat=yes" -i ./hosts_key  # 不推薦,會產生覆蓋
## 查看拷貝結果
[yun@ansi-manager ansible_info]$ cat /tmp/kkk2/test1 
111
222
333
aaa
bbb
[yun@ansi-manager ansible_info]$ ll /tmp/kkk 
-rw-rw-r-- 1 yun yun 20 Nov  2 11:25 /tmp/kkk
[yun@ansi-manager ansible_info]$ cat /tmp/kkk   # 該文件沒有 "11111"信息; 產生了覆蓋效應
111
222
333
aaa
bbb

相關選項說明:

src:源文件,當前僅支持文件,不支持目錄

dest:推送數據的目標路徑,默認爲:dest[路徑]/hostname/src[路徑]。參見上面示例

flat: 默認 False。當爲 yes/True 時,那麼拷貝效果類似於本地的 copy。

template 模板使用

該模塊功能類似於 copy 模塊,但 copy 模塊不支持變量,不支持模板。

template 模塊支持變量,支持 Jinja 模板。因此如果生成中的配置文件涉及變量,那麼請使用 template 模塊。

涉及到 playbook、變量和 Jinja ,這些在後面的文章會有詳解。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc template 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
# palybook
[yun@ansi-manager ansible_info]$ pwd
/app/ansible_info
[yun@ansi-manager ansible_info]$ ll
total 16
drwxrwxr-x 2 yun yun  35 Oct 11 11:23 file
-rw-rw-r-- 1 yun yun 226 Oct  8 16:07 hosts_key
-rw-rw-r-- 1 yun yun 304 Oct 11 11:40 test_template.yml
[yun@ansi-manager ansible_info]$ ll file/  # 涉及的文件
total 4
-rw-rw-r-- 1 yun yun 175 Oct 11 11:23 test_template.conf.j2
[yun@ansi-manager ansible_info]$ cat file/test_template.conf.j2 
# facts 變量
dns_info={{ ansible_dns['nameservers'][0] }}
mem_total={{ ansible_memtotal_mb }}
# 自定義變量
listen_port={{ listen_port }}
access_addr={{ access_addr }}

[yun@ansi-manager ansible_info]$ 
[yun@ansi-manager ansible_info]$ cat test_template.yml  # 涉及的 playbook
---
# template 示例
- hosts: proxyservers
  vars:
    - listen_port: 8080
    - access_addr: zhangblog.com

  tasks:
    - name: "template conf"
      template:
        src: ./file/test_template.conf.j2
        dest: /tmp/test_template.conf
        owner: root
        group: yun
        mode: '0600'
[yun@ansi-manager ansible_info]$ ansible-playbook -b -i ./hosts_key test_template.yml  # 執行

目標機器查看

[root@ansi-haproxy01 tmp]# pwd
/tmp
[root@ansi-haproxy01 tmp]# cat test_template.conf 
# facts 變量
dns_info=223.5.5.5
mem_total=1821
# 自定義變量
listen_port=8080
access_addr=zhangblog.com

相關選項說明:

src:源文件「可以是絕對路徑或相對路徑」

dest:推送數據的目標路徑或目標文件

owner:指定遠端文件的屬主

group:指定遠端文件的屬組

mode:指定遠端文件的權限

backup:如果推送的目標文件存在且與源文件內容不同,那麼會對目標文件進行備份

file 文件配置模塊

在受控機創建文件或目錄,或修改屬性信息「如:屬主、屬組、權限」

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc file 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
## 在受控機改變目標文件的屬性【該文件是已存在的】
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m file -a "path=/tmp/yum_test.sh owner=yun group=yun mode=0600" -i ./hosts_key 
## 在受控機創建軟連接
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m file -a "src=/tmp/yum_test.sh dest=/tmp/yum_link.sh owner=yun group=yun state=link" -i ./hosts_key
## 在受控機創建硬鏈接
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m file -a "src=/tmp/yum_test.sh dest=/tmp/yum_hard.sh owner=yun group=root state=hard" -i ./hosts_key
## 在受控機,如果目標文件不存在則創建
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m file -a "path=/tmp/dest_file owner=yun group=yun state=touch" -i ./hosts_key
## 在控制機,如果目標目錄不存在則創建「可創建多級目錄」
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m file -a "path=/tmp/desc_dir/aaa/bbb owner=yun group=root mode=700 state=directory" -i ./hosts_key
## 在控制機,改變目標目錄和目錄下所有目錄或文件的屬性信息「遞歸修改」
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m file -a "path=/tmp/desc_dir owner=yun group=zhang mode=766 state=directory recurse=yes" -i ./hosts_key
## 在受控機,如果目標文件或目錄存在,則刪除「慎用!!!」
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m file -a "path=/tmp/desc_dir state=absent " -i ./hosts_key

相關選項說明:

path:指定目標文件或目錄

owner:指定目標文件的屬主

group:指定目標文件的屬組

mode:指定目標文件的權限

state:狀態說明

    file:默認值,指定文件

    link:創建軟連接

    hard:創建硬鏈接

    touch:如果文件不存在則創建

    directory:如果目錄不存在則創建

    absent:如果目標文件或目錄存在,則刪除「慎用!!!」

recurse:遞歸授權

lineinfile 行編輯模塊

此模塊確保文件中有特定的行,或者使用反向引用的正則表達式替換現有的行。當您只想更改文件中的一行時,這非常有用。

如果您想要更改多個相似的行,請查看[replace]模塊。如果你想要插入/更新/刪除文件中的一個行塊,請查看[blockinfile]模塊。對於其他情況,請參見[copy]或[template]模塊。

數據文件準備

[yun@ansi-manager tmp]$ cat /tmp/lineinfile_test 
#     disabled - No SELinux policy is loaded.
SELINUX=disabled1
#     disabled - No SELinux policy is loaded.
SELINUX=disabled2
#     disabled - No SELinux policy is loaded.
SELINUX=disabled3
# SELINUXTYPE= can take one of three two values:

# httpd listen port
Listen 80

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc lineinfile 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權

行插入

# 如果文件中沒有 line 中的字符串,那麼就追加在文件末尾;有則不作任何操作。
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test line='# who are you?'" -i ./hosts_key
# 首先保證line 中的字符串在文件中沒有,如果有則不會添加
# 其次會使用insertafter中的正則規則進行正則匹配,匹配成功則在最後一次匹配行後面插入line,如果沒匹配成功則在文件末尾插入
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test insertafter='SELINUX' line='insertafter test1'" -i ./hosts_key
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test insertafter='SELINUXXX' line='insertafter test2'" -i ./hosts_key
# 首先保證line 中的字符串在文件中沒有,如果有則不會添加
# 其次會使用insertbefore中的正則規則進行正則匹配,匹配成功則在最後一次匹配行前面插入line,如果沒匹配成功則在文件末尾插入
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test insertbefore='SELINUX' line='insertbefore test1'" -i ./hosts_key
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test insertbefore='SELINUXXX' line='insertbefore test2'" -i ./hosts_key

行替換

# state=present時,如果多次匹配,那麼最後一次匹配會被修改;如果沒有匹配成功則在文件末尾追加,不管line是否存在。
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test regexp='^SELINUX=' line='SELINUX=enforcing'" -i ./hosts_key
# state=present時,如果多次匹配,那麼最後一次匹配會被修改;如果沒有匹配成功則文件保持不變,使用backrefs=yes。
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test regexp='^ELINUX=' line='SELINUX=enforcing' backrefs=yes" -i ./hosts_key

行刪除

# state=absent時,如果多次匹配,那麼每一次匹配都會刪除匹配行
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test regexp='^SELINUX=' state=absent" -i ./hosts_key
# 根據line匹配,如果匹配則刪除匹配行
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m lineinfile -a "path=/tmp/lineinfile_test line='# httpd listen port' state=absent" -i ./hosts_key

相關選項說明:

path:要修改的文件。

line:與 state=present 配合使用;在文件中要插入或者替換的行。

state:狀態說明

    present:添加或修改,默認值

    absent:刪除

backrefs:與 state=present 配合使用;如果設置了 line 可以包含反向引用(位置和命名),當‘regexp’匹配,就會填充反向引用。

    這個參數稍微改變了模塊的操作;‘insertbefore’ 和 ‘insertafter’ 將被忽略,如果 ‘regexp’ 與文件中的任何地方不匹配,文件將保持不變

regexp:對文件的每行進行正則匹配;對於 state=present 只有最後的一次行匹配會被替換;對於 state=absent 只要匹配就會刪除該行。

backup:對源文件備份。默認:False

create:與 state=present 配合使用;如果不存在則創建文件。默認:False

insertafter:與 state=present 配合使用;在匹配行後插入。使用正則表達式,在指定正則表達式的最後一次匹配之後插入該行。如果需要第一個匹配,則使用(firstmatch=yes)。

    如果沒有匹配成功,那麼會在文件末尾處插入。優先級低於 regexp。

insertbefore:與 state=present 配合使用;在匹配行前插入。使用正則表達式,在指定正則表達式的最後一次匹配之前插入該行。如果需要第一個匹配,則使用(firstmatch=yes)。

    如果沒有匹配成功,那麼會在文件末尾處插入。優先級低於 regexp。

firstmatch:與 insertafter 或 insertbefore 配合使用;在 insertafter 或 insertbefore 的首次正則匹配。默認:False

owner:指定遠端文件的屬主

group:指定遠端文件的屬組

mode:指定遠端文件的權限

blockinfile 多行編輯模塊

該模塊可以幫助我們在指定的文件中插入"一段文本",這段文本是被標記過的。

換句話說就是,我們在這段文本上做了記號,以便在以後的操作中可以通過"標記"找到這段文本,然後修改或者刪除它

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc blockinfile
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權

對不存在的文件進行——多行插入與修改

# /tmp/blockinfile_test 文件是不存在的,因此使用了create選項
# 插入/修改  如果沒有則插入,如果之前有信息則修改
##### 這裏之前沒有,則是創建文件並【插入】信息
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m blockinfile -a 'path=/tmp/blockinfile_test block="Match User ansible-agent\nPasswordAuthentication no" create=yes' -i ./hosts_key
[root@ansi-manager ansible_info]# cat /tmp/blockinfile_test  # 查看文件信息
# BEGIN ANSIBLE MANAGED BLOCK
Match User ansible-agent
PasswordAuthentication no
# END ANSIBLE MANAGED BLOCK
##### 文件已存在,mark標記已存在,這裏是【修改】
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m blockinfile -a 'path=/tmp/blockinfile_test block="iface eth0 inet static\n    address 192.0.2.23\n    netmask 255.255.255.0" create=yes' -i ./hosts_key
[root@ansi-manager ansible_info]# cat /tmp/blockinfile_test  # 查看文件信息
# BEGIN ANSIBLE MANAGED BLOCK
iface eth0 inet static
    address 192.0.2.23
    netmask 255.255.255.0
# END ANSIBLE MANAGED BLOCK

對已存在的文件進行——多行插入與修改

[root@ansi-manager ansible_info]# cat /tmp/blockinfile_test2  # 查看文件信息
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html>
<head>
<title>blockinfile info</title>
</head>
<body>
<h1>welcome to here.</h1>
</body></html>
##### 插入多行標記塊信息  這裏也使用了 insertafter 選項
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m blockinfile -a 'path=/tmp/blockinfile_test2 marker="<!-- {mark} ANSIBLE MANAGED BLOCK -->" insertafter="<body>" block="<h1>Welcome to blockinfile</h1>\n<p>Last Login By you!</p>"' -i ./hosts_key
[root@ansi-manager ansible_info]# cat /tmp/blockinfile_test2  # 查看文件信息
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html>
<head>
<title>blockinfile info</title>
</head>
<body>
<!-- BEGIN ANSIBLE MANAGED BLOCK -->
<h1>Welcome to blockinfile</h1>
<p>Last Login By you!</p>
<!-- END ANSIBLE MANAGED BLOCK -->
<h1>welcome to here.</h1>
</body></html>
##### 刪除標記塊信息
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m blockinfile -a 'path=/tmp/blockinfile_test2 marker="<!-- {mark} ANSIBLE MANAGED BLOCK -->" block=""' -i ./hosts_key
[root@ansi-manager ansible_info]# cat /tmp/blockinfile_test2  # 查看文件信息
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html>
<head>
<title>blockinfile info</title>
</head>
<body>
<h1>welcome to here.</h1>
</body></html>

相關選項說明:

path:要修改的文件。

block:要插入標記行內的文本。如果該選項缺失或是一個空字符串,該塊將被刪除,就像 “state” 被指定爲 “absent” 。(別名:content)

state:狀態說明

    present:添加或修改,默認值

    absent:刪除

create:文件不存在則創建。默認:False

backup:對源文件備份。默認:False

insertafter:在匹配行後插入。使用正則表達式,在指定正則表達式的最後一次匹配之後插入該block。

    如果沒有匹配成功,那麼會在文件末尾處插入。

insertbefore:在匹配行前插入。使用正則表達式,在指定正則表達式的最後一次匹配之前插入該block。

    如果沒有匹配成功,那麼會在文件末尾處插入。

marker:標記線模板。’{mark}’ 將被替換爲 ‘in marker_begin’ 的值【默認:BEGIN】和 ‘marker_end’ 的值【默認:END】

marker_begin:開始的標記變量信息。默認:BEGIN

marker_end:結尾的標記變量信息。默認:END

owner:指定遠端文件/目錄的屬主

group:指定遠端文件/目錄的屬組

mode:指定遠端文件/目錄的權限

ini_file INI格式配置模塊

在一個ini的文件中管理(添加、刪除、更改)單獨的配置,而不必使用[template]或[assemble]來管理整個文件。添加不存在的section。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc ini_file
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權

添加與修改

# 第一次執行,如果文件不存在,默認會創建  添加 section 和 option 信息
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m ini_file -a "path=/tmp/test.ini section=drinks option=username value=bobe mode='0644'" -i ./hosts_key
# 修改 option 信息
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m ini_file -a "path=/tmp/test.ini section=drinks option=username value=alice" -i ./hosts_key
# 添加另外一個section信息
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m ini_file -a "path=/tmp/test.ini section=base_info option=address value='BeiJing'" -i ./hosts_key
# 添加一個option信息,還是放在 drinks 這個section下
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m ini_file -a "path=/tmp/test.ini section=drinks option=password value=123456" -i ./hosts_key

刪除

# 刪除整個section, 刪除drinks這個section
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m ini_file -a "path=/tmp/test.ini section=drinks state=absent" -i ./hosts_key
# 刪除指定section下的option
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m ini_file -a "path=/tmp/test.ini section=base_info option=address state=absent" -i ./hosts_key

相關選項說明:

path:INI格式文件路徑。如果沒有則默認會創建。

section:INI文件中的 section 名。當設置單個值時,如果是 ‘state=present’ 則會自動添加這個值。如果留空或設置爲 ‘null’,‘option’ 將放在第一個 ‘section’ 之前。

    如果配置格式不支持 section,也需要使用 “null”。

option:如果設置(需要更改的 value),這是選項的名稱。如果添加/刪除整個“section”,可以省略。默認:null

value:option 的值。刪除 “option” 時可以省略。

state:狀態說明

    present:添加或修改,默認值

    absent:刪除

backup:對源文件備份。默認:False

create:如果不存在則創建文件。默認:True

owner:指定遠端文件的屬主

group:指定遠端文件的屬組

mode:指定遠端文件的權限

no_extra_spaces:在 = 符號前後不插入空格。默認:False

replace 多行替換模塊

對文件所匹配的內容進行替換/刪除。

數據文件準備

[yun@ansi-manager ~]$ cat /tmp/replace_test 
172.16.1.181 test1.zhangblog.com
172.16.1.182 test2.zhangblog.org
172.16.1.183 test3.zhangblog.net

# httpd listen port
Listen 80
ServerRoot "/etc/httpd"
User apache
Group apache
# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc replace
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
# 將regexp正則匹配到的行,替換爲replace的內容;且這裏使用了反向引用。
[yun@ansi-manager ansible_info]$ ansible  manageservers -b -m replace -a "path=/tmp/replace_test regexp='(\s+)test\d+\.zhangblog\.(\w+)?$' replace='\1new.host.name.\2'" -i ./hosts_key
# 將 after 之後的每行都替換爲 replace 中的內容
[yun@ansi-manager ansible_info]$ ansible  manageservers -b -m replace -a "path=/tmp/replace_test after='# httpd listen port' regexp='^(.+)$' replace='after replace'" -i ./hosts_key
# 如果 after沒有匹配完一行,那麼 after匹配之後未匹配的該行內容也會替換爲replace 中的內容
[yun@ansi-manager ansible_info]$ ansible  manageservers -b -m replace -a "path=/tmp/replace_test after='# httpd listen' regexp='^(.+)$' replace='# after replace'" -i ./hosts_key
# 將 before 之前的每行都替換爲 replace 中的內容
[yun@ansi-manager ansible_info]$ ansible  manageservers -b -m replace -a "path=/tmp/replace_test before='listen port' regexp='^(.+)$' replace='before replace'" -i ./hosts_key
# 如果 before沒有匹配完一行,那麼 before匹配之前未匹配的該行內容也會替換爲replace 中的內容
[yun@ansi-manager ansible_info]$ ansible  manageservers -b -m replace -a "path=/tmp/replace_test before='listen port' regexp='^(.+)$' replace='before replace'" -i ./hosts_key
# 刪除匹配內容,行數不會改變。如果整行匹配,則最終爲空行。
[yun@ansi-manager ansible_info]$ ansible  manageservers -b -m replace -a "path=/tmp/replace_test regexp='zhangblog'" -i ./hosts_key
[yun@ansi-manager ansible_info]$ ansible  manageservers -b -m replace -a "path=/tmp/replace_test regexp='.*test.*'" -i ./hosts_key

相關選項說明:

path:要操作的文件路徑。

after:如果指定,只有after匹配之後的內容將被替換/刪除。可以與before組合使用。after可能匹配一行也可能匹配一行的部分;且不支持正則匹配。

before:如果指定,只有before匹配之前的內容將被替換/刪除。可以與after組合使用。before可能匹配一行也可能匹配一行的部分;不支持正則匹配。

regexp:要在文件內容中查找的正則表達式。

replace:替換regexp匹配項的字符串。可能包含反向引用,如果regexp匹配,將使用regexp捕獲組展開這些反向引用。如果沒有設置,則完全刪除匹配項。

    反向引用可以像 ‘\1’ 那樣含糊地使用,也可以像 ‘\g<1>’ 那樣顯式地使用。

backup:對源文件備份。默認:False

encoding:用於讀寫文件的字符編碼。默認:utf-8

owner:指定遠端文件的屬主

group:指定遠端文件的屬組

mode:指定遠端文件的權限

sysctl 修改內核參數模塊

這個模塊操作 sysctl 條目,並在更改它們之後可選地執行 /sbin/sysctl -p 。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc sysctl
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
# 會修改 /etc/sysctl.conf 文件並執行 /sbin/sysctl -p 使其生效
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m sysctl -a 'name=net.ipv4.ip_forward value=1' -i ./hosts_key
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m sysctl -a 'name=vm.swappiness value=5' -i ./hosts_key

相關選項說明:

name:內核參數變量名。(別名:key)

value:sysctl鍵的期望值。(別名:val)

reload:當爲 yes 時,如果 sysctl_file 文件被修改,那麼會執行 /sbin/sysctl -p,使修改的參數生效。當爲 no 時,則不重載 sysctl ,儘管 sysctl_file 已被修改。

state:狀態說明

    present:添加或修改,默認值

    absent:刪除

sysctl_file:指定 sysctl.conf 文件的絕對路徑。默認:/etc/sysctl.conf

sysctl_set:使用sysctl命令驗證令牌值,必要時使用 -w 進行設置。默認:no

ignoreerrors:使用此選項可忽略關於未知鍵的錯誤。默認:no

get_url 文件下載模塊

通過 HTTP,HTTPS或 FTP 下載一個文件。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc get_url 
## 下載一個文件
[yun@ansi-manager ansible_info]$ ansible proxyservers -m get_url -a "url='http://www.zhangblog.com/uploads/jvm/jvm-01-01.png' dest=/tmp/ mode=0640" -i ./hosts_key
## 下載前會比對校驗和,如果不匹配則不下載
[yun@ansi-manager ansible_info]$ ansible proxyservers -m get_url -a "url='http://www.zhangblog.com/uploads/jvm/jvm-01-01.png' dest=/tmp/jvm-001.png checksum='md5:9af3f6066ea46ea81c0b3c9d719dbce0'" -i ./hosts_key

相關選項說明:

mode:指定目標文件的權限

url:指定文件來源「支持 HTTP,HTTPS 和 FTP」

dest:指定目標存放的目錄或文件

checksum:校驗和「支持 sha256 和 md5」

timeout:請求超時時間,默認 10 秒。

owner:指定遠端文件的屬主

group:指定遠端文件的屬組

mode:指定遠端文件的權限

backup:源文件備份

service、systemd 服務管理模塊

如果在 CentOS 6 及以下版本,優先使用 service 。

如果在 CentOS 7 及以上版本,優先使用 systemd 。

這裏考慮到我們使用的 CentOS 7,因此使用的是 systemd 。至於 service 請自行查看文檔。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc service 
[yun@ansi-manager ansible_info]$ ansible-doc systemd 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
## 啓動 httpd 服務,並且加入開機自啓動
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m systemd -a "name=httpd state=started enabled=yes" -i ./hosts_key
## 重啓 httpd 服務,並且重新加載 /usr/lib/systemd/system/httpd.service 服務配置文件,且加入開機自啓動
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m systemd -a "name=httpd state=restarted daemon_reload=yes enabled=yes" -i ./hosts_key
## 停止 httpd 服務,並且不加入開機自啓動
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m systemd -a "name=httpd state=stopped enabled=no" -i ./hosts_key

相關選項說明:

name:服務名稱

state:服務狀態

    started:啓動服務

    stopped:停止服務

    reloaded:重加載服務

    restarted:重啓動服務

enabled:是否加入開機自啓動「yes 加入, no 不加入, 默認 null」

daemon_reload:當我們修改了服務管理配置文件,是否重加載其配置「yes 重加載服務配置文件, no 不加載,默認值」

group 組模塊

創建或刪除用戶組

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc group 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
## 創建 test 組,並指定組ID
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m group -a " name=test gid=9001" -i ./hosts_key
## 創建 testsystem 組,並指定爲系統組
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m group -a "name=testsystem system=true" -i ./hosts_key
## 刪除 testsystem 組
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m group -a "name=testsystem state=absent" -i ./hosts_key

相關選項說明:

gid:指定組ID,默認 null

name:指定組名稱

state:組狀態

    present:創建組,默認

    absent:刪除組

system:是否爲系統組

    true:是系統組

    false:不是系統組

user 用戶模塊

創建或刪除用戶

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc user 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權

1、創建用戶,指定 UID,指定附加組,不創建家目錄,不可以登錄

[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m user -a "name=zhangtest uid=1005 groups=zhang,yun create_home=no shell=/sbin/nologin" -i ./hosts_key

受控機查看信息

[yun@ansi-haproxy02 ~]$ id zhangtest
uid=1005(zhangtest) gid=1005(zhangtest) groups=1005(zhangtest),1000(zhang),1050(yun)
[yun@ansi-haproxy02 ~]$ tail -n1 /etc/passwd
zhangtest:x:1005:1005::/home/zhangtest:/sbin/nologin  # /home/zhangtest 該目錄不存在

2、刪除用戶,但不刪除用戶的家目錄

[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m user -a "name=zhangtest state=absent" -i ./hosts_key

3、爲用戶創建密碼或SSH key 祕鑰

[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m user -a "name=zhangtest2 generate_ssh_key=yes ssh_key_bits=2048 ssh_key_file=.ssh/id_rsa" -i ./hosts_key

4、爲用戶創建密碼

# 得到密碼串
[yun@ansi-manager ansible_info]$ ansible localhost -m debug -a "msg={{ '123456' | password_hash('sha512', 'salt') }}"
localhost | SUCCESS => {
    "msg": "$6$salt$MktMKPZJ6t59GfxcJU20DwcwQzfMvOlHFVZiOVD71w.igcOo1R7vBYR65JquIQ/7siC7VRpmteKvZmfSkNc69."
}
## 注意 -a '' 是單引號,而不是雙引號。如果使用雙引號,特殊字符會被解析
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m user -a 'name=zhangtest2 password=$6$salt$MktMKPZJ6t59GfxcJU20DwcwQzfMvOlHFVZiOVD71w.igcOo1R7vBYR65JquIQ/7siC7VRpmteKvZmfSkNc69.' -i ./hosts_key

相關選項說明:

name:用戶名稱

state:用戶狀態

    present:默認值,創建用戶

    absent:刪除用戶

password:用戶密碼,默認:null

shell:設置用戶的shell

uid:指定用戶 UID

group:設置用戶主組,默認:null

groups:設置用戶附加組,默認:null

system:如果爲 yes 則創建系統用戶,默認:false

home:設置用戶家目錄

create_home:是否創建家目錄,默認:true,如果不創建爲:no

comment:用戶描述,默認:null

expires:用戶賬號失效日期,默認:null

update_password:更新密碼

    always:如果密碼不同,則更新,默認值

    on_create:只有新建用戶時使用

remove:只有在 state=absent 時生效,作用:刪除用戶家目錄

generate_ssh_key:是否生成SSH key 密鑰對,默認:false

ssh_key_bits:設置 SSH key 字節長度,默認:有 ssh-keygen 設置

ssh_key_comment:設置 SSH key 的描述,默認爲:$HOSTNAME

ssh_key_file:指定 SSH key 的文件名,默認:null 【即爲:.ssh/id_rsa】

ssh_key_passphrase:指定 SSH key 密碼,如果不提供則沒有密碼,默認:null

ssh_key_type:設置 SSH key 類型,默認:rsa

cron 定時任務模塊

創建、註釋或刪除定時任務

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc cron 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
## 創建定時任務, name 爲定時任務說明
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m cron -a 'name="crond test" minute=0 hour="2,5" job="ls /tmp >/dev/null 2>&1"' -i ./hosts_key
## 註釋指定定時任務,其中 name ,時間參數,和 job 都需要。
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m cron -a 'name="crond test" minute=0 hour="2,5" job="ls /tmp >/dev/null 2>&1" disabled=true' -i ./hosts_key
## 刪除定時任務
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m cron -a 'name="crond test" state=absent' -i ./hosts_key

相關選項說明:

name:定時任務描述

state:狀態

    present:添加,默認值

    absent:刪除

user:指定哪個用戶的定時任務會修改,默認是 root 用戶,默認:null

minute:哪個分鐘執行 ( 0-59, *, */2, etc ),默認:*

hour:哪個小時執行 ( 0-23, *, */2, etc ),默認 *

day:每月的哪天執行 ( 1-31, *, */2, 等 ),默認:*

month:哪個月執行 ( 1-12, *, */2, etc ),默認:*

weekday:每週的哪天執行 ( 0-6 爲 Sunday-Saturday, *, etc ),默認:*

disabled:是否註釋指定定時任務,默認:false

job:定時任務要操作的具體信息

mount 文件系統掛載模塊

文件系統的掛載與取消。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc mount 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權

案例示例:

在 ansi-manager 機器作爲 NFS 的服務端,ansi-haproxy01、ansi-haproxy02 作爲 NFS 的客戶端。

1、在所有機器安裝 NFS 必要的包

[yun@ansi-manager ansible_info]$ ansible manageservers,proxyservers -b -m yum -a "name=nfs-utils,rpcbind state=present" -i ./hosts_key 

2、NFS 服務端配置與啓動

[yun@ansi-manager ansible_info]$ ansible manageservers -b -m copy -a 'content="/data   172.16.1.0/24(rw,sync,root_squash,all_squash)\n" dest=/etc/exports' -i ./hosts_key
# 創建 /data 目錄,屬主、屬組爲 nfsnobody
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m file -a "path=/data owner=nfsnobody group=nfsnobody state=directory" -i ./hosts_key
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m systemd -a "name=rpcbind state=started enabled=yes" -i ./hosts_key
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m systemd -a "name=nfs state=started enabled=yes" -i ./hosts_key
## 查看 Export list 信息
[yun@ansi-manager ansible_info]$ ansible manageservers -b -m shell -a "showmount -e" -i ./hosts_key

3、NFS 客戶端操作

[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m systemd -a "name=rpcbind state=started enabled=yes" -i ./hosts_key
## 檢查共享信息
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m shell -a "showmount -e 172.16.1.180" -i ./hosts_key

4、NFS 客戶端掛載

## 不掛載設備,僅在 /etc/fstab 中寫入掛載配置信息
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m mount -a "src=172.16.1.180:/data path=/mnt fstype=nfs state=present backup=yes" -i ./hosts_key
## 掛載設備,並在 /etc/fstab 中寫入掛載配置信息
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m mount -a "src=172.16.1.180:/data path=/mnt fstype=nfs state=mounted" -i ./hosts_key
## 不卸載設備,僅在 /etc/fstab 中刪除掛載配置信息
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m mount -a "src=172.16.1.180:/data path=/mnt fstype=nfs state=unmounted" -i ./hosts_key
## 卸載設備,並在 /etc/fstab 中刪除掛載配置信息
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m mount -a "src=172.16.1.180:/data path=/mnt fstype=nfs state=absent" -i ./hosts_key

相關選項說明:

src:要掛在的設備/磁盤

path:掛載點

opts:掛載參數選項,如:ro,noauto;默認:null

fstype:文件系統類型

state:狀態

    present:不掛載設備,僅在 /etc/fstab 中寫入掛載配置信息

    mounted:掛載設備,並在 /etc/fstab 中寫入掛載配置信息

    unmounted:不卸載設備,僅在 /etc/fstab 中刪除掛載配置信息

    absent:卸載設備,並在 /etc/fstab 中刪除掛載配置信息

backup:對之前的文件備份

debug 調試模塊與 register 變量

這裏會使用 playbook 書寫。具體的 playbook 詳解,參見後面的文章。

涉及到 playbook、變量和 Jinja ,這些在後面的文章會有詳解。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc debug 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
# Ad-Hoc 方式
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m debug  -i ./hosts_key 
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m debug -a 'msg="print customized message"' -i ./hosts_key
##################################################
# Playbooks 方式
[yun@ansi-manager ansible_info]$ pwd
/app/ansible_info
[yun@ansi-manager ansible_info]$ ll
total 24
-rw-rw-r-- 1 yun yun  483 Aug 18 09:12 hosts_key
-rw-rw-r-- 1 yun yun  245 Aug 18 21:55 test_debug_register.yml
[yun@ansi-manager ansible_info]$ cat test_debug_register.yml 
---
# 如何使用 debug 模塊與 register 變量
- hosts: proxyservers

  tasks:
    - name: "get host port info"
      shell: netstat -lntp
      register: host_port

    - name: "print host port"
      debug:
        #msg: "{{ host_port }}"   # 輸出全部信息
        #msg: "{{ host_port.cmd }}"   # 引用方式一
        msg: "{{ host_port['stdout_lines'] }}"  # 引用方式二

[yun@ansi-manager ansible_info]$ ansible-playbook -b -i ./hosts_key test_debug_register.yml 

第一個 task 中,使用了 register 註冊變量,名爲 host_port ;當 shell 模塊執行完畢後,會將數據放到該變量中。

第二給 task 中,使用了 debug 模塊,並從 host_port 中獲取數據。

assert 斷言模塊【瞭解】

對自定義消息斷言。

涉及到 playbook、變量和 Jinja ,這些在後面的文章會有詳解。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc assert 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
# Ad-Hoc 方式
[yun@ansi-manager ansible_info]$ ansible proxyservers -m assert -a "that='2 == 3' success_msg=ok fail_msg=fail" -i ./hosts_key # 斷言失敗
[yun@ansi-manager ansible_info]$ ansible proxyservers -m assert -a "that='2 <= 3' success_msg=ok fail_msg=fail" -i ./hosts_key # 斷言成功
[yun@ansi-manager ansible_info]$ ansible proxyservers -m assert -a "that='2 < 3' success_msg=ok fail_msg=fail" -i ./hosts_key  # 斷言成功
[yun@ansi-manager ansible_info]$ ansible proxyservers -m assert -a "that='2 < 3 and 4 == 4' success_msg=ok fail_msg=fail quiet=yes" -i ./hosts_key # 斷言成功
[yun@ansi-manager ansible_info]$ ansible proxyservers -m assert -a "that='2 < 3 and 4 > 4' success_msg=ok fail_msg=fail quiet=yes" -i ./hosts_key # 斷言失敗
[yun@ansi-manager ansible_info]$ ansible proxyservers -m assert -a "that='3 < 3 or 4 == 4' success_msg=ok fail_msg=fail quiet=yes" -i ./hosts_key # 斷言成功
##################################################
# Playbooks 方式
[yun@ansi-manager ansible_info]$ pwd
/app/ansible_info
[yun@ansi-manager ansible_info]$ ll
total 12
-rw-rw-r-- 1 yun yun 226 Oct  8 16:07 hosts_key
-rw-rw-r-- 1 yun yun 902 Oct 11 10:57 test_assert.yml
[yun@ansi-manager ansible_info]$ cat test_assert.yml  # playbook 信息
---
# assert 示例
- hosts: proxyservers
  # 使用如下變量,分別測試下
  vars:
    #- my_param: 20
    #- my_param: -2
    - my_param: 200

  tasks:
    - name: "assert example 1"
      assert:
        # ansible_os_family 爲 facts 中的變量信息
        that:
          - ansible_os_family == "RedHat"
        success_msg: "success info"
        fail_msg: "fail info"

    - name: "assert example 2"
      assert:
        # that 下面的列表,爲 && 關係
        that:
          - my_param >= 0
          - my_param <= 100
        fail_msg: "'my_param' must be between 0 and 100"
        success_msg: "success info"
      # 是否忽略該 task 的錯誤
      ignore_errors: True

    - name: "assert example 3"
      assert:
        that:
          - my_param <= 10 or my_param >= 100
        fail_msg: "'my_param' must be <= 10 or >= 100"
        success_msg: "success info"

[yun@ansi-manager ansible_info]$ ansible-playbook -b -i ./hosts_key test_assert.yml  # 執行

相關選項說明:

that:列表字符串表達式

success_msg:當斷言成功時輸出的信息

fail_msg:別名 msg,當斷言失敗時輸出的信息

quiet:默認 False,設置爲 yes 避免冗長輸出

selinux 安全模塊

配置 SELinux 。

# 查看 yum 模塊方法「可優先查看 EXAMPLES 信息的使用案例,知曉如何使用」
[yun@ansi-manager ansible_info]$ ansible-doc selinux 
# 由於我們使用的是 yun 普通用戶
# 因此有時需要使用 -b 選擇進行提權
## 關閉 selinux
[yun@ansi-manager ansible_info]$ ansible proxyservers -b -m selinux -a "state=disabled" -i ./hosts_key

相關選項說明:

state:狀態

    disabled:不可用

    enforcing:強制執行

    permissive:會提醒


———END———
如果覺得不錯就關注下唄 (-^O^-) !

在這裏插入圖片描述

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章