Inventory檔案

Ansible 可同時操作屬於一個組的多臺主機,組和主機之間的關係通過 inventory 檔案配置. 預設的檔案路徑為 /etc/ansible/hosts

除預設檔案外,你還可以同時使用多個 inventory 檔案(後面會講到),也可以從動態源,或雲上拉取 inventory 配置資訊.詳見 動態 Inventory.

主機與組

/etc/ansible/hosts 檔案的格式與windows的ini配置檔案類似:

mail.example.com

[webservers]
foo.example.com
bar.example.com

[dbservers]
one.example.com
two.example.com
three.example.com

方括號[]中是組名,用於對系統進行分類,便於對不同系統進行個別的管理.

一個系統可以屬於不同的組,比如一臺伺服器可以同時屬於 webserver組 和 dbserver組.這時屬於兩個組的變數都可以為這臺主機所用,至於變數的優先順序關係將於以後的章節中討論.

如果有主機的SSH埠不是標準的22埠,可在主機名之後加上埠號,用冒號分隔.SSH 配置檔案中列出的埠號不會在 paramiko 連線中使用,會在 openssh 連線中使用.

埠號不是預設設定時,可明確的表示為:

badwolf.example.com:5309

假設你有一些靜態IP地址,希望設定一些別名,但不是在系統的 host 檔案中設定,又或者你是通過隧道在連線,那麼可以設定如下:

jumper ansible_ssh_port=5555 ansible_ssh_host=192.168.1.50

在這個例子中,通過 “jumper” 別名,會連線 192.168.1.50:5555.記住,這是通過 inventory 檔案的特性功能設定的變數. 一般而言,這不是設定變數(描述你的系統策略的變數)的最好方式.後面會說到這個問題.

一組相似的 hostname , 可簡寫如下:

[webservers]
www[01:50].example.com

數字的簡寫模式中,01:50 也可寫為 1:50,意義相同.你還可以定義字母範圍的簡寫模式:

[databases]
db-[a:f].example.com

對於每一個 host,你還可以選擇連線類型和連線使用者名稱:

[targets]

localhost              ansible_connection=local
other1.example.com     ansible_connection=ssh        ansible_ssh_user=mpdehaan
other2.example.com     ansible_connection=ssh        ansible_ssh_user=mdehaan

所有以上討論的對於 inventory 檔案的設定是一種速記法,後面我們會討論如何將這些設定儲存為 ‘host_vars’ 目錄中的獨立的檔案.

主機變數

前面已經提到過,分配變數給主機很容易做到,這些變數定義後可在 playbooks 中使用:

[atlanta]
host1 http_port=80 maxRequestsPerChild=808
host2 http_port=303 maxRequestsPerChild=909

組的變數

也可以定義屬於整個組的變數:

[atlanta]
host1
host2

[atlanta:vars]
ntp_server=ntp.atlanta.example.com
proxy=proxy.atlanta.example.com

把一個組作為另一個組的子成員

可以把一個組作為另一個組的子成員,以及分配變數給整個組使用. 這些變數可以給 /usr/bin/ansible-playbook 使用,但不能給 /usr/bin/ansible 使用:

[atlanta]
host1
host2

[raleigh]
host2
host3

[southeast:children]
atlanta
raleigh

[southeast:vars]
some_server=foo.southeast.example.com
halon_system_timeout=30
self_destruct_countdown=60
escape_pods=2

[usa:children]
southeast
northeast
southwest
northwest

如果你需要儲存一個列表或hash值,或者更喜歡把 host 和 group 的變數分開配置,請看下一節的說明.

分檔案定義 Host 和 Group 變數

在 inventory 主檔案中儲存所有的變數並不是最佳的方式.還可以儲存在獨立的檔案中,這些獨立檔案與 inventory 檔案保持關聯. 不同於 inventory 檔案(INI 格式),這些獨立檔案的格式為 YAML.詳見 YAML 語法 .

假設 inventory 檔案的路徑為:

/etc/ansible/hosts

假設有一個主機名為 ‘foosball’, 主機同時屬於兩個組,一個是 ‘raleigh’, 另一個是 ‘webservers’. 那麼以下配置檔案(YAML 格式)中的變數可以為 ‘foosball’ 主機所用.依次為 ‘raleigh’ 的組變數,’webservers’ 的組變數,’foosball’ 的主機變數:

/etc/ansible/group_vars/raleigh
/etc/ansible/group_vars/webservers
/etc/ansible/host_vars/foosball

舉例來說,假設你有一些主機,屬於不同的資料中心,並依次進行劃分.每一個數據中心使用一些不同的伺服器.比如 ntp 伺服器, database 伺服器等等. 那麼 ‘raleigh’ 這個組的組變數定義在檔案 ‘/etc/ansible/group_vars/raleigh’ 之中,可能類似這樣:

---
ntp_server: acme.example.org
database_server: storage.example.org

這些定義變數的檔案不是一定要存在,因為這是可選的特性.

還有更進一步的運用,你可以為一個主機,或一個組,建立一個目錄,目錄名就是主機名或組名.目錄中的可以建立多個檔案, 檔案中的變數都會被讀取為主機或組的變數.如下 ‘raleigh’ 組對應於 /etc/ansible/group_vars/raleigh/ 目錄,其下有兩個檔案 db_settings 和 cluster_settings, 其中分別設定不同的變數:

/etc/ansible/group_vars/raleigh/db_settings
/etc/ansible/group_vars/raleigh/cluster_settings

‘raleigh’ 組下的所有主機,都可以使用 ‘raleigh’ 組的變數.當變數變得太多時,分檔案定義變數更方便我們進行管理和組織. 還有一個方式也可參考,詳見 Ansible Vault 關於組變數的部分. 注意,分檔案定義變數的方式只適用於 Ansible 1.4 及以上版本.

Tip: Ansible 1.2 及以上的版本中,group_vars/ 和 host_vars/ 目錄可放在 inventory 目錄下,或是 playbook 目錄下. 如果兩個目錄下都存在,那麼 playbook 目錄下的配置會覆蓋 inventory 目錄的配置.

Tip: 把你的 inventory 檔案 和 變數 放入 git repo 中,以便跟蹤他們的更新,這是一種非常推薦的方式.

Inventory 參數的說明

如同前面提到的,通過設定下面的參數,可以控制 ansible 與遠端主機的互動方式,其中一些我們已經講到過:

ansible_ssh_host
      將要連線的遠端主機名.與你想要設定的主機的別名不同的話,可通過此變數設定.

ansible_ssh_port
      ssh埠號.如果不是預設的埠號,通過此變數設定.

ansible_ssh_user
      預設的 ssh 使用者名稱

ansible_ssh_pass
      ssh 密碼(這種方式並不安全,我們強烈建議使用 --ask-pass 或 SSH 金鑰)

ansible_sudo_pass
      sudo 密碼(這種方式並不安全,我們強烈建議使用 --ask-sudo-pass)

ansible_sudo_exe (new in version 1.8)
      sudo 命令路徑(適用於1.8及以上版本)

ansible_connection
      與主機的連線類型.比如:local, ssh 或者 paramiko. Ansible 1.2 以前預設使用 paramiko.1.2 以後預設使用 'smart','smart' 方式會根據是否支援 ControlPersist, 來判斷'ssh' 方式是否可行.

ansible_ssh_private_key_file
      ssh 使用的私鑰檔案.適用於有多個金鑰,而你不想使用 SSH 代理的情況.

ansible_shell_type
      目標系統的shell類型.預設情況下,命令的執行使用 'sh' 語法,可設定為 'csh' 或 'fish'.

ansible_python_interpreter
      目標主機的 python 路徑.適用於的情況: 系統中有多個 Python, 或者命令路徑不是"/usr/bin/python",比如  \*BSD, 或者 /usr/bin/python
      不是 2.X 版本的 Python.我們不使用 "/usr/bin/env" 機制,因為這要求遠端使用者的路徑設定正確,且要求 "python" 可執行程式名不可為 python以外的名字(實際有可能名為python26).

      與 ansible_python_interpreter 的工作方式相同,可設定如 ruby 或 perl 的路徑....

一個主機檔案的例子:

some_host         ansible_ssh_port=2222     ansible_ssh_user=manager
aws_host          ansible_ssh_private_key_file=/home/example/.ssh/aws.pem
freebsd_host      ansible_python_interpreter=/usr/local/bin/python
ruby_module_host  ansible_ruby_interpreter=/usr/bin/ruby.1.9.3

See also

動態 Inventory
Pulling inventory from dynamic sources, such as cloud providers
Introduction To Ad-Hoc Commands
Examples of basic commands
Playbooks
Learning ansible’s configuration management language
Mailing List
Questions? Help? Ideas? Stop by the list on Google Groups
irc.freenode.net
#ansible IRC chat channel