Ansible 詳細用法說明(一)


一、概述

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

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

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

二、簡介

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

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

1、特點:

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

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

  • 主從集中化管理;

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

  • 支持API及自定義模塊,可通過Python輕松擴展;

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

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

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

  • 冪等性:一種操作重復多次結果相同

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

2、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通信使用

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


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

1、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

2、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的版本

4、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"

5、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 ~]# 

四、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。







免責聲明!

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



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM