Ansible 詳細用法說明(一)

1、概述

運維工具按需不須要有代理程序來劃分的話分兩類:html

  • agent(須要有代理工具):基於專用的agent程序完成管理功能,puppet, func, zabbixnode

  • agentless(無須代理工具):基於ssh服務完成管理,ansible, fabricpython

2、簡介

  Ansible是一個簡單的自動化運維管理工具,基於Python語言實現,由Paramiko和PyYAML兩個關鍵模塊構建,可用於自動化部署應用、配置、編排task(持續交付、無宕機更新等)。主版本大概每2個月發佈一次。
linux

  Ansible與Saltstack最大的區別是Ansible無需在被控主機部署任何客戶端代理,默認直接經過SSH通道進行遠程命令執行或下發配置:相同點是都具有功能強大、靈活的系統管理、狀態配置,二者都提供豐富的模板及API,對雲計算平臺、大數據都有很好的支持。web

一、特色:

  • 部署簡單,只需在主控端部署Ansible環境,被控端無需作任何操做;shell

  • 默認使用SSH協議對設備進行管理;vim

  • 主從集中化管理;緩存

  • 配置簡單、功能強大、擴展性強;ruby

  • 支持API及自定義模塊,可經過Python輕鬆擴展;bash

  • 經過Playbooks來定製強大的配置、狀態管理;

  • 對雲計算平臺、大數據都有很好的支持;

  • 提供一個功能強大、操做性強的Web管理界面和REST API接口——AWX平臺。

  • 冪等性:一種操做重複屢次結果相同

簡評:
(1)、輕量級,無需在客戶端安裝agent,更新時,只需在操做機上進行一次更新便可;
(2)、批量任務執行能夠寫成腳本,並且不用分發到遠程就能夠執行;
(3)、使用python編寫,維護更簡單,ruby語法過於複雜;
(4)、支持sudo。

二、Ansible架構圖


Ansible核心組件說明:

  • Ansible:Ansible的核心程序

  • Host Lnventory:記錄了每個由Ansible管理的主機信息,信息包括ssh端口,root賬號密碼,ip地址等等。能夠經過file來加載,能夠經過CMDB加載

  • Playbooks:YAML格式文件,多個任務定義在一個文件中,使用時能夠統一調用,「劇本」用來定義那些主機須要調用那些模塊來完成的功能.

  • Core Modules:Ansible執行任何管理任務都不是由Ansible本身完成,而是由核心模塊完成;Ansible管理主機以前,先調用core Modules中的模塊,而後指明管理Host Lnventory中的主機,就能夠完成管理主機。

  • Custom Modules:自定義模塊,完成Ansible核心模塊沒法完成的功能,此模塊支持任何語言編寫。

  • Connection Plugins:鏈接插件,Ansible和Host通訊使用

三、ansible執行過程,其中暖色調的表明已經模塊化。


3、基礎環境的安裝與配置

一、ssh免密登陸 配置

(1)、SSH免密鑰登陸設置

  • ansiblemaster:10.1.6.172 Centos7.2

  • ansibleslave1:10.1.6.72 Centos7.2

  • ansibleslave2:10.1.6.73 Centos7.2

  • ansibleslave3:10.1.6.68 Centos6.8

生成公鑰/私鑰

# ssh-keygen -N ''


分發密鑰

# ssh-copy-id root@10.1.6.73
# ssh-copy-id root@10.1.6.72
# ssh-copy-id root@10.1.6.68

測試


注意

[root@ansible_master ~]# ssh-copy-id -i ~/.ssh/id_rsa.pub 10.1.6.72
    -bash: ssh-copy-id: command not found
報錯了
解決方法:
    yum -y install openssh-clients

二、ansible安裝及程序環境:

安裝

# yum install ansible

程序:

ansible
ansible-playbook 
ansible-doc

配置文件:

/etc/ansible/ansible.cfg
host_key_checking = False

主機清單:

/etc/ansible/hosts

插件目錄:

/usr/share/ansible_plugins/

3.ansible命令的使用說明

經常使用選項

ansible -m MOD_NAME -a MOD_ARGS
表示調用什麼模塊,使用模塊的那些參數

ansible -h

 [root@localhost ~]# ansible -h
Usage: ansible <host-pattern> [options]

Options:
  -a MODULE_ARGS, --args=MODULE_ARGS    模塊的參數,若是執行默認COMMAND的模塊,便是命令參數,如:「date」,"pwd"等等
                        module arguments    模塊參數
  -k, --ask-pass        ask for SSH password  登陸密碼,提示輸入SSH密碼而不是假設基於密鑰的驗證
  --ask-su-pass         ask for su password    su切換密碼
  -K, --ask-sudo-pass   ask for sudo password  提示密碼使用sudo,sudo表示提權操做
  --ask-vault-pass      ask for vault password
  -B SECONDS, --background=SECONDS     後臺運行超時時間
                        run asynchronously, failing after X seconds
                        (default=N/A)
  -C, --check           don't make any changes; instead, try to predict some    只是測試一下會改變什麼內容,不會真正去執行;相反,試圖預測一些可能發生的變化
                        of the changes that may occur
  -c CONNECTION, --connection=CONNECTION   鏈接類型使用。可能的選項是paramiko(SSH),SSH和地方。當地主要是用於crontab或啓動。
                        connection type to use (default=smart)
  -f FORKS, --forks=FORKS   並行任務數。NUM被指定爲一個整數,默認是5
                        specify number of parallel processes to use
                        (default=5)
  -h, --help            show this help message and exit   打開幫助文檔API
  -i INVENTORY, --inventory-file=INVENTORY    指定庫存主機文件的路徑,默認爲/etc/ansible/hosts
                        specify inventory host file
                        (default=/etc/ansible/hosts)
  -l SUBSET, --limit=SUBSET    進一步限制所選主機/組模式  --limit=192.168.91.135 只對這個ip執行
                        further limit selected hosts to an additional pattern
  --list-hosts          outputs a list of matching hosts; does not execute
                        anything else
  -m MODULE_NAME, --module-name=MODULE_NAME   執行模塊的名字,默認使用 command 模塊,因此若是是隻執行單一命令能夠不用 -m參數
                        module name to execute (default=command)
  -M MODULE_PATH, --module-path=MODULE_PATH    要執行的模塊的路徑,默認爲/usr/share/ansible/
                        specify path(s) to module library
                        (default=/usr/share/ansible/)
  -o, --one-line        condense output      壓縮輸出,摘要輸出.嘗試一切都在一行上輸出。
  -P POLL_INTERVAL, --poll=POLL_INTERVAL    調查背景工做每隔數秒。須要- b
                        set the poll interval if using -B (default=15)
  --private-key=PRIVATE_KEY_FILE    私鑰路徑,使用這個文件來驗證鏈接
                        use this file to authenticate the connection
  -S, --su              run operations with su    用 su 命令
  -R SU_USER, --su-user=SU_USER      指定SU的用戶,默認是root用戶
                        run operations with su as this user (default=root)
  -s, --sudo            run operations with sudo (nopasswd)    
  -U SUDO_USER, --sudo-user=SUDO_USER    sudo到哪一個用戶,默認爲 root  
                        desired sudo user (default=root)
  -T TIMEOUT, --timeout=TIMEOUT    指定SSH默認超時時間,  默認是10S
                        override the SSH timeout in seconds (default=10)
  -t TREE, --tree=TREE  log output to this directory     將日誌內容保存在該輸出目錄,結果保存在一個文件中在每臺主機上。
  -u REMOTE_USER, --user=REMOTE_USER    遠程用戶, 默認是root用戶
                        connect as this user (default=root)
  --vault-password-file=VAULT_PASSWORD_FILE  
                        vault password file
  -v, --verbose         verbose mode (-vvv for more, -vvvv to enable    詳細信息
                        connection debugging)
  --version             show program's version number and exit   輸出ansible的版本

四、ansible主機清單的配置

vim /etc/ansible/hosts

定義方式:

  • 直接指明主機地址或主機名

      blue.example.com
      192.168.100.1
  • 定義一個主機組[組名]把地址或主機名加進去

      [webservers]
      alpha.example.org
      beta.example.org
      192.168.1.100
    
      #組成員可使用通配符來匹配,以下
      www[001:006].example.com  #表示從www001-www006主機
  • 若是你沒有使用公鑰,想要使用密碼,你也能夠這樣寫(適用於第一次登錄控制)

      格式:【主機名】 【主機地址】 【主機密碼】  默認是root用戶來進行的
    
      [keepalived]
      keepalived1  ansible_ssh_host=192.168.146.136 ansible_ssh_pass="test"
      keepalived2  ansible_ssh_host=192.168.146.137 ansible_ssh_pass="test"


[testhost]
10.6.0.152
10.6.0.153  ansible_ssh_host=10.6.0.153 ansible_ssh_pass="yanjin"

10.6.0.153  ansible_ssh_host=10.6.0.153 ansible_ssh_pass="yanjin"

五、ansible的使用ansible-doc

通常用法:

ansible-doc -l 獲取模塊信息

ansible-doc -s MOD_NAME 獲取指定模塊的使用幫助

[root@localhost ~]# ansible-doc  -h
Usage: ansible-doc [options] [module...]

Show Ansible module documentation     顯示Ansible模塊文檔

Options:
  --version             show program's version number and exit    顯示ansible-doc的版本號
  -h, --help            show this help message and exit  顯示命令參數API文檔
  -M MODULE_PATH, --module-path=MODULE_PATH   查詢模塊,--module-path=MODULE_PATH  指定模塊的路徑
                        Ansible modules/ directory
  -l, --list            List available modules   顯示已存在的全部模塊列表
  -s, --snippet         Show playbook snippet for specified module(s)   顯示playbook制定模塊的用法
  -v                    Show version number and exit   顯示ansible-doc的版本號

測試:成功


ansible 10.6.0.152 -m command -a "id root"

10.6.0.152 | SUCCESS | rc=0 >>

uid=0(root) gid=0(root) groups=0(root)

ansible 10.6.0.153 -m command -a "id root"
10.6.0.153 | SUCCESS | rc=0 >>
uid=0(root) gid=0(root) groups=0(root)

ansible testhost -m command -a "id root"
10.6.0.152 | SUCCESS | rc=0 >>
uid=0(root) gid=0(root) groups=0(root)
10.6.0.153 | SUCCESS | rc=0 >>
uid=0(root) gid=0(root) groups=0(root)

[root@master ~]# ansible proxy -m command -a "ls -lh /var/log/squid/access.log"
10.6.0.100 | SUCCESS | rc=0 >>
-rw-r----- 1 squid nogroup 0 Nov 17 11:02 /var/log/squid/access.log
[root@master ~]# ansible proxy -m command -a "ls -lh /var/log/squid/store.log"
10.6.0.100 | SUCCESS | rc=0 >>
-rw-r----- 1 squid nogroup 320 Nov 17 11:03 /var/log/squid/store.log
[root@master ~]# 

4、ansible使用 之一 「命令管理方式」

經常使用模塊:

=================================
ping:探測目標主機是否存活;

=================================

command:在遠程主機執行命令;不支持|管道命令

=================================

ansible storm_cluster -m command -a "ls –al /tmp/resolv.conf"

相關選項以下:
creates:一個文件名,當該文件存在,則該命令不執行
free_form:要執行的linux指令
chdir:在執行指令以前,先切換到該目錄
removes:一個文件名,當該文件不存在,則該選項不執行
executable:切換shell來執行指令,該執行路徑必須是一個絕對路徑

shell:在遠程主機上調用shell解釋器運行命令,支持shell的各類功能,例如管道等 ;

注意:command和shell模塊的核心參數直接爲命令自己;而其它模塊的參數一般爲「key=value」格式;

================================

copy:複製文件到遠程主機,能夠改權限等

================================

用法:
(1) 複製文件
    -a "src=  dest=  "
(2) 給定內容生成文件
        -a "content=  dest=  "
  • 經常使用用法

    第一種:直接複製

    第二種:生成內容的複製


  • ansible test -m copy -a "src=/root/test dest=/home/testcopy mode=640"
    10.6.0.152 | SUCCESS => {
        "changed": true,
        "checksum": "da39a3ee5e6b4b0d3255bfef95601890afd80709",
        "dest": "/home/testcopy",
        "gid": 0,
        "group": "root",
        "md5sum": "d41d8cd98f00b204e9800998ecf8427e",
        "mode": "0640",
        "owner": "root",
        "size": 0,
        "src": "/root/.ansible/tmp/ansible-tmp-1479352868.18-83082559134161/source",
        "state": "file",
        "uid": 0

    }
相關選項以下:
backup:在覆蓋以前,將源文件備份,備份文件包含時間信息。有兩個選項:yes|no
content:用於替代「src」,能夠直接設定指定文件的值
dest:必選項。要將源文件複製到的遠程主機的絕對路徑,若是源文件是一個目錄,那麼該路徑也必須是個目錄
directory_mode:遞歸設定目錄的權限,默認爲系統默認權限
force:若是目標主機包含該文件,但內容不一樣,若是設置爲yes,則強制覆蓋,若是爲no,則只有當目標主機的目標位置不存在該文件時,才複製。默認爲yes
others:全部的file模塊裏的選項均可以在這裏使用
src:被複制到遠程主機的本地文件,能夠是絕對路徑,也能夠是相對路徑。若是路徑是一個目錄,它將遞歸複製。在這種狀況下,若是路徑使用「/」來結尾,則只複製目錄裏的內容,若是沒有使用「/」來結尾,則包含目錄在內的整個內容所有複製,相似於rsync。

===============================
file :設置文件屬性。

===============================

用法:
(1) 建立目錄:

-a "path=。。。  state=directory"

(2) 建立連接文件:

-a "path=。。。  src=...  state=link"

(3) 刪除文件:

-a "path=。。。  state=absent"


相關選項以下:

force:須要在兩種狀況下強制建立軟連接,一種是源文件不存在,但以後會創建的狀況下;另外一種是目標軟連接已存在,須要先取消以前的軟鏈,而後建立新的軟鏈,有兩個選項:yes|no
group:定義文件/目錄的屬組
mode:定義文件/目錄的權限
owner:定義文件/目錄的屬主
path:必選項,定義文件/目錄的路徑
recurse:遞歸設置文件的屬性,只對目錄有效
src:被連接的源文件路徑,只應用於state=link的狀況
dest:被連接到的路徑,只應用於state=link的狀況
state:
       directory:若是目錄不存在,就建立目錄
       file:即便文件不存在,也不會被建立
       link:建立軟連接
       hard:建立硬連接
       touch:若是文件不存在,則會建立一個新的文件,若是文件或目錄已存在,則更新其最後修改時間
       absent:刪除目錄、文件或者取消連接文件

==============================
fetch: 從遠程某一個主機獲取文件到本地

==============================

cron: 管理cron計劃任務

==============================


ansible all -m cron -a "name='sync time' state=absent" 表示刪除此任務

- a "": 設置管理節點生成定時任務
action: cron
backup=    # 若是設置,建立一個crontab備份
cron_file=          #若是指定, 使用這個文件cron.d,而不是單個用戶crontab
day=       # 日應該運行的工做( 1-31, *, */2, etc )
hour=      # 小時 ( 0-23, *, */2, etc )
job=       #指明運行的命令是什麼
minute=    #分鐘( 0-59, *, */2, etc )
month=     # 月( 1-12, *, */2, etc )
name=     #定時任務描述
reboot    # 任務在重啓時運行,不建議使用,建議使用special_time
special_time       # 特殊的時間範圍,參數:reboot(重啓時),annually(每一年),monthly(每個月),weekly(每週),daily(天天),hourly(每小時)

state        #指定狀態,prsent表示添加定時任務,也是默認設置,absent表示刪除定時任務

user         # 以哪一個用戶的身份執行
weekday      # 周 ( 0-6 for Sunday-Saturday, *, etc )

=========================
yum:yum安裝軟件,也有apt,zypper

=========================

conf_file         #設定遠程yum安裝時所依賴的配置文件。如配置文件沒有在默認的位置。
disable_gpg_check    #是否禁止GPG checking,只用於`present' or `latest'。
disablerepo   #臨時禁止使用yum庫。 只用於安裝或更新時。
enablerepo    #臨時使用的yum庫。只用於安裝或更新時。
name=            #所安裝的包的名稱
state               #present安裝, latest安裝最新的, absent 卸載軟件。
update_cache  #強制更新yum的緩存。

==============================
service: 服務程序管理

==============================

arguments         #命令行提供額外的參數
enabled           #設置開機啓動。
name=             #服務名稱
runlevel          #開機啓動的級別,通常不用指定。
sleep             #在重啓服務的過程當中,是否等待。如在服務關閉之後等待2秒再啓動。
state     #started啓動服務, stopped中止服務, restarted重啓服務, reloaded重載配置

啓動httpd服務:

ansible all -m service -a 'name=httpd state=started'

開機自啓動

ansible all -m service -a "name=httpd  enabled=true"

================================
group: 組管理

================================

[root@node1 ~]# ansible-doc -s group
- name: 添加或刪除組
action: group
gid       # 設置組的GID號
name=     # 管理組的名稱
state     # 指定組狀態,默認爲建立,設置值爲absent爲刪除
system    # 設置值爲yes,表示爲建立系統組

================================
User:用戶管理

================================

-a ""
action: user
comment    # 用戶的描述信息
createhom  # 是否建立家目錄
force      # 在使用`state=absent'是, 行爲與`userdel --force'一致.
group      # 指定基本組
groups     # 指定附加組,若是指定爲('groups=')表示刪除全部組
home       # 指定用戶家目錄
login_class     #能夠設置用戶的登陸類 FreeBSD, OpenBSD and NetBSD系統.
move_home       # 若是設置爲`home='時, 試圖將用戶主目錄移動到指定的目錄
name=           # 指定用戶名
non_unique      # 該選項容許改變非惟一的用戶ID值
password        # 指定用戶密碼
remove          # 在使用 `state=absent'時, 行爲是與 `userdel --remove'一致.
shell           # 指定默認shell
state           #設置賬號狀態,不指定爲建立,指定值爲absent表示刪除
system          # 當建立一個用戶,設置這個用戶是系統用戶。這個設置不能更改現有用戶。
uid             #指定用戶的uid
update_password  # 更新用戶密碼
expires         #指明密碼的過時時間

:建立用戶並添加密碼


===================================
setup:獲取指定主機的facts。




相關文章
相關標籤/搜索