ansible常用子產品

ansible-doc -l 

ansible-doc  -s user

Ansible 通過子產品的方式來完成一些遠端的管理工作。可以通過ansible-doc -l檢視所有子產品，可以使用ansible-doc -s module來檢視某個子產品的參數，也可以使用ansible-doc help module來檢視該子產品更詳細的資訊。下面列出一些常用的子產品：

-m setup  #檢視遠端的主機  

-m ping  #檢視主機的狀态

-m  file  設定檔案屬性

-m  copy 複制檔案到遠端的主機

-m command 遠端主機上執行指令

-m service 用于管理服務

-m  cron  定時任務

-m  yum  用于軟體包的管理

1. setup

可以用來檢視遠端主機的一些基本資訊：

ansible -i /etc/ansible/hosts test -m setup

2.ping

可以用來測試遠端主機的運作狀态：

ansible test -m ping

3.file

設定檔案的屬性

file子產品包含如下選項：

    force：需要在兩種情況下強制建立軟連結，一種是源檔案不存在但之後會建立的情況下；另一種是目标軟連結已存在,需要先取消之前的軟鍊，然後建立新的軟鍊，有兩個選項：yes|no

    group：定義檔案/目錄的屬組

    mode：定義檔案/目錄的權限

    owner：定義檔案/目錄的屬主

    path：必選項，定義檔案/目錄的路徑

    recurse：遞歸的設定檔案的屬性，隻對目錄有效

    src：要被連結的源檔案的路徑，隻應用于state=link的情況

    dest：被連結到的路徑，隻應用于state=link的情況

    state：

            directory：如果目錄不存在，建立目錄

            file：即使檔案不存在，也不會被建立

            link：建立軟連結

            hard：建立硬連結

            touch：如果檔案不存在，則會建立一個新的檔案，如果檔案或目錄已存在，則更新其最後修改時間

            absent：删除目錄、檔案或者取消連結檔案

示例：

    ansible test -m file -a "src=/etc/fstab dest=/tmp/fstab state=link"

    ansible test -m file -a "path=/tmp/fstab state=absent"

    ansible test -m file -a "path=/tmp/test state=touch"

4.copy

複制檔案到遠端主機

copy子產品包含如下選項：

    backup：在覆寫之前将原檔案備份，備份檔案包含時間資訊。有兩個選項：yes|no

    content：用于替代"src",可以直接設定指定檔案的值

    dest：必選項。要将源檔案複制到的遠端主機的絕對路徑，如果源檔案是一個目錄，那麼該路徑也必須是個目錄

    directory_mode：遞歸的設定目錄的權限，預設為系統預設權限

    force：如果目标主機包含該檔案，但内容不同，如果設定為yes，則強制覆寫，如果為no，則隻有當目标主機的目标位置不存在該檔案時，才複制。預設為yes

    others：所有的file子產品裡的選項都可以在這裡使用

    src：要複制到遠端主機的檔案在本地的位址，可以是絕對路徑，也可以是相對路徑。如果路徑是一個目錄，它将遞歸複制。在這種情況下，如果路徑使用"/" 來結尾，則隻複制目錄裡的内容，如果沒有使用"/"來結尾，則包含目錄在内的整個内容全部複制，類似于rsync。

    validate ：The validation command to run before copying into place. The path to the file to validate is passed in via '%s' which must be present as in the visudo example below.

    ansible test -m copy -a "src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644"

    ansible test -m copy -a "src=/mine/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes"

    ansible test -m copy -a "src=/mine/sudoers dest=/etc/sudoers validate='visudo -cf %s'"

5.command

在遠端主機上執行指令

command子產品包含如下選項：

    creates：一個檔案名，當該檔案存在，則該指令不執行

    free_form：要執行的linux指令

    chdir：在執行指令之前，先切換到該指定的目錄

    removes：一個檔案名，當該檔案不存在，則該選項不執行

    executable：切換shell來執行指令，該執行路徑必須是一個絕對路徑

    ansible test -a "/sbin/reboot"

6.shell

切換到某個shell執行指定的指令，參數與command相同。

    ansible test -m shell -a "somescript.sh >> somelog.txt"

7.service

用于管理服務

該子產品包含如下選項：

    arguments：給指令行提供一些選項

    enabled：是否開機啟動  yes|no

    name：必選項，服務名稱

    pattern：定義一個模式，如果通過status指令來檢視服務的狀态時，沒有響應，就會通過ps指令在程序中根據該模式進行查找，如果比對到，則認為該服務依然在運作

    runlevel：運作級别

    sleep：如果執行了restarted，在則stop和start之間沉睡幾秒鐘

    state：對目前服務執行啟動，停止、重新開機、重新加載等操作（started,stopped,restarted,reloaded）

    ansible test -m service -a "name=httpd state=started enabled=yes"

    ansible test -m service -a "name=foo pattern=/usr/bin/foo state=started"

    ansible test -m service -a "name=network state=restarted args=eth0"

8.cron

用于管理計劃任務

包含如下選項：

    backup：對遠端主機上的原任務計劃内容修改之前做備份

    cron_file：如果指定該選項，則用該檔案替換遠端主機上的cron.d目錄下的使用者的任務計劃

    day：日（1-31，*，*/2,……）

    hour：小時（0-23，*，*/2，……）

    minute：分鐘（0-59，*，*/2，……）

    month：月（1-12，*，*/2，……）

    weekday：周（0-7，*，……）

    job：要執行的任務，依賴于state=present

    name：該任務的描述

    special_time：指定什麼時候執行，參數：reboot,yearly,annually,monthly,weekly,daily,hourly

    state：确認該任務計劃是建立還是删除

    user：以哪個使用者的身份執行

    ansible test -m cron -a 'name="check dirs" hour="5,2" job="ls -alh > /dev/null"'

    ansible test -m cron -a 'name="a job for reboot" special_time=reboot job="/some/job.sh"'

    ansible test -m cron -a 'name="yum autoupdate" weekday="2" minute=0 hour=12 user="root" job="YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate" cron_file=ansible_yum-autoupdate'

    ansilbe test -m cron -a 'cron_file=ansible_yum-autoupdate state=absent'

9.filesystem

在塊裝置上建立檔案系統

選項：

    dev：目标塊裝置

    force：在一個已有檔案系統的裝置上強制建立

    fstype：檔案系統的類型

    opts：傳遞給mkfs指令的選項

10.yum

使用yum包管理器來管理軟體包

    config_file：yum的配置檔案

    disable_gpg_check：關閉gpg_check

    disablerepo：不啟用某個源

    enablerepo：啟用某個源

    list

    name：要進行操作的軟體包的名字，也可以傳遞一個url或者一個本地的rpm包的路徑

    state：狀态（present，absent，latest）

    ansible test -m yum -a 'name=httpd state=latest'

    ansible test -m yum -a 'name="@Development tools" state=present'

    ansible test -m yum -a 'name=http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm state=present'

11.user

管理使用者

    home:

    groups:

    uid

    password:

    name:

    createhome:

    system:

    remove:

    state:

    shell:

    需要特别說明的是，password後面指定的密碼不能是明文，後面這一串密碼會被直接傳送到被管理主機的/etc/shadow檔案中，而登陸的時候輸入的密碼會被hash加密以後再去與/etc/shadow中存放的密碼去做對比，會出現不一緻的現象。是以需要先将密碼字元串進行加密處理：openssl passwd -salt -1 "123456"，然後将得到的字元串放到password中即可。

12.group

管理組

13.synchronize

使用rsync同步檔案

    archive

    checksum

    delete

    dest

    src

    dest_port

    existing_only: skip createing new files on receiver

    links

    owner

    mode:(push, pull)

    recursive

    rsync_path

    times:Preserve modification times

    src=some/relative/path dest=/some/absolute/path rsync_path="sudo rsync"

    src=some/relative/path dest=/some/absolute/path archive=no links=yes

    src=some/relative/path dest=/some/absolute/path checksum=yes times=no

    src=/tmp/helloworld dest=/var/www/helloword rsync_opts=--no-motd,--exclude=.git mode=pull

14.mount

配置挂載點

    dump

    fstype：必選項，挂載檔案的類型

    name：必選項，挂載點

    opts：傳遞給mount指令的參數

    passno

    src：必選項，要挂載的檔案

    state：必選項

            present：隻處理fstab中的配置

            absent：删除挂載點

            mounted：自動建立挂載點并挂載之

            umounted：解除安裝

    name=/mnt/dvd src=/dev/sr0 fstype=iso9660 opts=ro state=present

    name=/srv/disk src='LABEL=SOME_LABEL' state=present

    name=/home src='UUID=b3e48f45-f933-4c8e-a700-22a159ec9077' opts=noatime state=present

    ansible test -a 'dd if=/dev/zero of=/disk.img bs=4k count=1024'

    ansible test -a 'losetup /dev/loop0 /disk.img'

    ansible test -m filesystem 'fstype=ext4 force=yes opts=-F dev=/dev/loop0'

    ansible test -m mount 'name=/mnt src=/dev/loop0 fstype=ext4 state=mounted opts=rw'

本文轉自 小小三郎1 51CTO部落格，原文連結：http://blog.51cto.com/wsxxsl/1837819，如需轉載請自行聯系原作者