ansible經常使用模塊

8.模塊
8.1模塊的分類
8.1.1 Core Module
（1）不須要格外下載和配置就能夠直接使用的
（2）經常使用的module
（3）都是通過嚴格測試的
8.1.2 Extra Module
（1）Extra Module須要下載和配置才能使用
（2）次經常使用的
（3）還有可能存在bug的
注意：在ansible module文檔上查看單個module的時候，每個module文檔的底部都會標識，這是一個「Core Module」，或者這是一個「Extra Module」，好比yum就是一個core module，yum_repository就是一個extra module
8.2常見模塊
可使用ansible-doc -l命令查看有哪些模塊
使用ansible-doc -s copy命令能夠查看模塊的使用方法
8.2.1 command
（1）幫助：[root@pythion ~]# ansible-doc -s command
（2）簡介：Command模塊，命令模塊、默認模塊，用於在遠程執行命令
（3）選項：
free_form：要執行的linux指令
chdir：在執行指令以前，先切換到該目錄
removes：對應的文件不存在就執行command
creates：對應的文件存在就執行command
executable：切換shell來執行指令，該執行路徑必須是一個絕對路徑
（4）案例：遠程查看時間和文件
[root@pythion ansible]# ansible zhang -m command -a "date"
[root@pythion ansible]# ansible all -m command -a "date"
[root@pythion ansible]# ansible wang -m command -a "date"
[root@pythion ansible]# ansible wang -m command -a "tail -1 /etc/passwd"
[root@pythion ansible]# ansible all -a "date"

8.2.2 cron
（1）簡介：用來作計劃任務
（2）state：
present：安裝 默認爲安裝
absent：移除
若是須要移除的話，只須要寫上name和absent就能夠了
（3）案例：寫入一個計劃任務，查看是否已經成功寫入。
須要注意的是不寫的默認都是 ，名字得寫，不寫就會報錯，狀態默認是安裝
[root@pythion ansible]# ansible zhang -m cron -a 'hour="/5" job="/bin/date" name="date test" state=present'
[root@pythion ansible]# ansible zhang -a "crontab -l"

8.2.3 user、group
（1）簡介：實現用戶帳號管理的
（2）案例：建立用戶、建立組、建立組裏邊的成員
（3）注意：system 是不是系統組
[root@pythion ansible]# ansible all -m user -a 'name="user1" state=present' //建立用戶

[root@pythion ~]# ansible zhang -m group -a 'name=pig gid=301 system=yes' //建立組

[root@pythion ~]# ansible zhang -m user -a 'name=pig uid=301 system=yes group=pig' //建立組裏邊的成員

ansible user 的passwd參數的值須要接受加密後的值
[root@dev2 test_deploy]# echo Zmc2tG1m= | openssl passwd -1 -stdin
$1$XI3TNbug$Y14rSXX7JxTtlTub9Car/0
tasks:

• name: add user tech
  user: name=tech password=$1$XI3TNbug$Y14rSXX7JxTtlTub9Car/0
  8.2.4 copy
  （1）簡介：用來操做文件，可是不能傳輸目錄，他不會遞歸目錄
  （2）案例：複製文件、建立新文件，寫入指定內容
  （3）注意：
  src本地源文件路徑，能夠相對，能夠絕對
  dest目標文件，必須絕對路徑
  content：取代src，表示指定生成內容生成文件
  遠端能夠指定傳過去的文件名稱，沒有指定則爲默認名稱，目錄後邊+/和不加是同樣的
  backup：能夠備份原來的文件，前提是原來的文件必須和要推送的文件有不一樣的地方，默認爲no
  state：directory，abset，file，directory會建立目錄，abset會刪除，默認是file
  將本地文件複製到遠程主機
  [root@pythion ~]# ansible wang -m copy -a 'src=/etc/passwd dest=/tmp/ mode=750 owner=root'
  
  建立一個新文件，並寫入指定內容
  [root@pythion ~]# ansible wang -m copy -a 'content="hello\n world\n" dest=/tmp/1.txt
  
  若是要批量複製目錄下的文件到遠端某一個目錄中，可使用with_fileglob模塊，使用案例以下
  tasks:
• name: unity build script
  copy: src={{item}} dest=/data/shell/ owner=root mode=755 backup=yes
  with_fileglob:
  • /data/conf/build/*
    8.2.5 file
    （1）簡介：設置文件屬主、屬組、權限、製做軟連接
    （2）案例：設定遠程文件 歸屬關係和權限
    修改將遠程主機/tmp/1.txt的歸屬關係和權限
    [root@pythion ~]# ansible wang –m file -a 'owner=user1 group=user1 mode=644 path=/tmp/1.txt'
    注意：path：指定文件路徑，可使用name或dest來替換
    
    案例：製做軟連接
    [root@pythion ~]# ansible wang -m file -a 'path=/tmp/1.txt.link src=/tmp/1.txt state=link'
    注意：
    src：指定文件路徑，可使用name或dest來替換
    path：指明符號連接文件路徑
    若是要刪除，則設爲state=absent
    
    建立目錄：
• name: mkdir scripts in zabbix-agent
  file: dest=/etc/zabbix/scripts mode=755 owner=root state=directory
  8.2.6 ping
  （1）簡介：檢測主機是否能連通
  （2）案例：檢測全部主機連通性
  [root@pythion ~]# ansible all -m ping
  
  8.2.7 service
  （1）簡介：控制服務的運行狀態和開機啓動狀態
  （2）案例：
  [root@pythion ~]# ansible wang -a "chkconfig --list named"
  注意：
  enabled：是否開機自動啓動，取值爲true爲false
  name：服務名稱
  state：狀態
  [root@pythion ~]# ansible wang -a "chkconfig --list named" //查看named開機自啓級別
  [root@pythion ~]# ansible wang -m service -a 'enabled=true name=named' //named開機自啓
  named的開機自啓，而且保持運行狀態
  [root@pythion ~]# ansible wang -m service -a 'enabled=true name=named state=started'
  
  8.2.8 shell
  （1）簡介：Shell模塊，在遠程主機上執行命令
  （2）注意：若是涉及管道、變量的最好使用shell模塊
  （3）案例：
  設置密碼
  [root@pythion ~]# ansible zhang -m shell -a 'echo 123456 | passwd --stdin user1'
  
  8.2.9 script
  （1）簡介：在遠程主機執行本地腳本
  （2）案例：在遠程主機執行本地的test.sh腳本
  （3）注意：
  script：將本地腳本複製到遠程主機，並運行
  相對絕對路徑都支持
  [root@pythion ~]# ansible all -m script -a 'test.sh'
  
  8.2.10 yum
  （1）簡介：程序包的安裝和卸載
  （2）案例：安裝zsh包，卸載zsh包
  （3）注意：
  name：指定要安裝的程序包，能夠帶上版本號
  state：present，latest表示安裝，absent表示卸載
  [root@pythion ~]# ansible wang -m yum -a "name=zsh" //安裝zsh包
  
  [root@pythion ~]# ansible wang -m yum -a 'name=zsh state=absent' //卸載zsh包
  
  8.2.11 setup
  （1）簡介：收集遠程主機的facts，每一個被管理節點在接收管理命令以前會將本身主機相關的信息，如操做系統版本，ip地址等報告給遠程的ansbile主機。
  （2）案例：收集wang組裏邊的全部遠程主機信息
  [root@pythion ~]# ansible wang -m setup
  
  案例：把信息以主機名的方式存儲到/tmp/facts
  [root@rsync facts]# ansible jingqu -m setup --tree /tmp/facts
  
  案例：收集網卡信息
  [root@rsync facts]# ansible 172.165.0.7 -m setup -a "filter=ansible_eth[0-9]"
  
  8.2.12 synchronize模塊
  （1）簡介：將src目錄的內容推送到遠端服務器的目錄之下
  （2）案例1：將/home/zhang/目錄下的內容推送到遠端/tmp/wang/目錄下，會把源目錄的全部內容都推送到目標目錄，內容以本地爲主
  [root@rsync ~]# ansible 172.165.0.6 -m synchronize -a 'src=/home/zhang/ dest=/tmp/wang/'
  案例2：將/home/zhang/目錄下的內容推送到遠端/tmp/wang/目錄下，會把源目錄的全部內容都推送到目標目錄，內容以本地爲主，加delete=yes，會讓兩個目錄保持一致，目標目錄中原來的數據也會被刪除
  [root@rsync ~]# ansible 172.165.0.6 -m synchronize -a 'src=/home/zhang/ dest=/tmp/wang/ delete=yes'
  
  案例3：將遠方的文件同步到本地，使用mode選項，可是src就成爲了遠端服務器的目錄，正好相反
  [root@rsync zhang]# ansible 172.165.0.6 -m synchronize -a 'dest=/home/zhang/ src=/tmp/wang/ delete=yes mode=pull'
  
  （3）參數：
  delete=yes：使兩邊的內容同樣（以推送方爲主）
  compress=yes：開啓壓縮，默認爲開啓
  8.2.13 replace模塊
  這個模塊能夠說是至關於shell中的sed，我看了下他的光放文檔中講述的參數做用，基本和個人業務不沾邊，有一個正則，可是它使用的是Python的正則，如今還不懂，等之後把這個學會了，再彎過來學習這個模塊
  8.2.14 raw模塊
  可使用管道，sed,awk之類的
  ansible 192.168.70.78 -m raw -a "chdir=/data ifconfig eth0|head -1|grep Link|awk '{print \$1}'"
  8.2.15unarchive模塊
  copy：在解壓文件以前，是否先將文件複製到遠程主機，默認爲yes。若爲no，則要求目標主機上壓縮包必須存在。
  creates：指定一個文件名，當該文件存在時，則解壓指令不執行
  dest：遠程主機上的一個路徑，即文件解壓的路徑
  grop：解壓後的目錄或文件的屬組
  list_files：若是爲yes，則會列出壓縮包裏的文件，默認爲no，2.0版本新增的選項
  mode：解決後文件的權限
  src：若是copy爲yes，則須要指定壓縮文件的源路徑
  owner：解壓後文件或目錄的屬主

#直接傳過去的
這個模塊能夠把壓縮文件傳輸過去，而且傳輸過去以後解壓的目錄必須存在

• name: add docker tomcat
  unarchive: src=/data/scripts/tms/tomcat.tar.gz dest=/data/docker119/ owner=root mode=755 exclude=Documentation

#須要下載的

• name: Unarchive a file that needs to be downloaded (added in 2.0)
  unarchive:
  src: https://example.com/example.zip
  dest: /usr/local/bin
  remote_src: yes

分爲3種，遠端目錄有的就設置copy=no，默認爲yes，而後若是要從網上下載在傳送，寫url便可
8.2.16 fetch模塊
fetch模塊能夠把遠端服務器的文件拉到本地，而且生成一個以主機名命名的
[root@zabbix-server ~]# ansible test -m fetch -a "src=/etc/fstab dest=/tmp/"
8.2.17 jenkis_job模塊

• name: Test
  hosts: jenkins
  tasks:
  • name: Test jenkins_job module
    jenkins_job:
    name: '{{project}}' #jenkins job的名字
    password: 45ec4d09e9870fd9eea4b92787bb6068 #jenkins server的認證密碼
    url: http://114.55.227.11:8080 #jenkins server的訪問地址
    user: jenkins #認證用戶
    config: "{{ lookup('template', 'config.xml') }}"
    8.2.18 supervisor模塊
  • name: Start {{project}}0..3
    supervisorctl: name="{{item}}" state=started
    with_items:
    • '{{project}}:0'
    • '{{project}}:1'
    • '{{project}}:2'
    • '{{project}}:3'
      when: result | failed
      ignore_errors: True
      管理進程用的模塊
      8.2.19 pause模塊
      
      8.2.20debug
      當知足條件的時候，能夠輸出指定的字符串，當不知足條件時，則會跳過，不會輸出字符串

• name: test
  hosts: self
  vars:
  bianliang: ''
  tasks:

  • name: echo love for vars
    debug: msg='i love you'
    when: ansible_os_family =="RedHatiiii"

  • name: mkdir dir
    file: path=/root/etcd/{{ bianliang }} state=directory

[root@junmpserver etcd]# vim a.yml

• name: test
  hosts: self
  vars:
  bianliang: ''
  tasks:

  • name: echo love for vars
    debug: msg='i love you'
    when: ansible_os_family =="RedHat"

  • name: mkdir dir
    file: path=/root/etcd/{{ bianliang }} state=directory
    
    8.2.21jenkins_job模塊

• name: Add jenkins job
  hosts: jenkins
  tasks:

  • name: Add jenkins job
    jenkins_job:
    name: '{{project}}'
    password: 45ec4d09e9870fd9eea4b92787bb6068
    url: http://114.55.227.11:8080
    user: jenkins
    config: "{{ lookup('template', '/root/playbook/jenkins/config.xml') }}"
    8.2.22 wait_for模塊
    vars:
    port: []

  • name: port check
    wait_for: port={{item}} delay=10 timeout=20
    with_items:
    • "{{port}}"