Installation¶

從源碼執行¶

從項目的checkout中可以很容易執行Ansible,Ansible的執行不要求root許可權,也不依賴於其他軟體,不要求執行後臺程序,也不需要設定資料庫.因此我們社群的許多使用者一直使用Ansible的開發版本,這樣可以利用最新的功能特性,也方便對項目做貢獻.因為不需要安裝任何東西,跟進Ansible的開發版相對於其他開源項目要容易很多.

從源碼安裝的步驟

$ git clone git://github.com/ansible/ansible.git --recursive
$ cd ./ansible

使用 Bash:

$ source ./hacking/env-setup

使用 Fish:

$ . ./hacking/env-setup.fish

If you want to suppress spurious warnings/errors, use:

$ source ./hacking/env-setup -q

如果沒有安裝pip, 請先安裝對應於你的Python版本的pip:

$ sudo easy_install pip

以下的Python模組也需要安裝 [1]_:

$ sudo pip install paramiko PyYAML Jinja2 httplib2 six

注意,當更新ansible版本時,不只要更新git的源碼樹,也要更新git中指向Ansible自身模組的 “submodules” (不是同一種模組)

$ git pull --rebase
$ git submodule update --init --recursive

一旦執行env-setup指令碼,就意味著Ansible從源碼中執行起來了.預設的inventory檔案是 /etc/ansible/hosts.inventory檔案也可以另行指定 (詳見 Inventory檔案) :

$ echo "127.0.0.1" > ~/ansible_hosts
$ export ANSIBLE_HOSTS=~/ansible_hosts

你可以在手冊的後續章節閱讀更多關於 inventory 檔案的使用,現在讓我們測試一條ping命令:

$ ansible all -m ping --ask-pass

你也可以使用命令 “sudo make install”

通過Yum安裝最新發布版本¶

通過Yum安裝RPMs適用於 EPEL 6, 7, 以及仍在支援中的Fedora發行版.

託管節點的作業系統版本可以是更早的版本(如 EL5), 但必須安裝 Python 2.4 或更高版本的Python.

Fedora 使用者可直接安裝Ansible, 但RHEL或CentOS使用者,需要 配置 EPEL

# install the epel-release RPM if needed on CentOS, RHEL, or Scientific Linux
$ sudo yum install ansible

你也可以自己建立RPM軟體包.在Ansible項目的checkout的根目錄下,或是在一個tarball中,使用 make rpm 命令建立RPM軟體包. 然後可分發這個軟體包或是使用它來安裝Ansible.在建立之前,先確定你已安裝了 rpm-build, make, and python2-devel .

$ git clone git://github.com/ansible/ansible.git
$ cd ./ansible
$ make rpm
$ sudo rpm -Uvh ~/rpmbuild/ansible-*.noarch.rpm

通過Apt (Ubuntu)安裝最新發布版本¶

Ubuntu 編譯版可在PPA中獲得: ` <https://launchpad.net/~ansible/+archive/ansible>`_.

配置PPA及安裝ansible,執行如下命令:

$ sudo apt-get install software-properties-common
$ sudo apt-add-repository ppa:ansible/ansible
$ sudo apt-get update
$ sudo apt-get install ansible

也可從源碼checkout中建立 Debian/Ubuntu 軟體包,執行:

$ make deb

你或許也想從源碼中執行最新發行版本,可看前面的說明.

通過 Portage (Gentoo)安裝最新發布版本¶

$ emerge -av app-admin/ansible

要安裝最新版本,你可能需要在執行 emerge 之前，先做如下操作(unmsk ansible)

$ echo 'app-admin/ansible' >> /etc/portage/package.accept_keywords

若在Gentoo託管節點中,已經安裝了 Python 3 並將之作為預設的 Python slot(這也是預設設定),則你必須在 組變數 或 inventory 變數中設定如下變數 ansible_python_interpreter = /usr/bin/python2

通過 pkg (FreeBSD)安裝最新發布版本¶

$ sudo pkg install ansible

你或許想從ports中安裝:

$ sudo make -C /usr/ports/sysutils/ansible install

在Mac OSX 上安裝最新發布版本¶

在 Mac 上安裝 ansible，最好是通過 pip 安裝，在 通過 Pip 安裝最新發布版本 小節介紹.

通過 OpenCSW 安裝最新發布版本(Solaris)¶

在 Solaris 上安裝 ansible: SysV package from OpenCSW.

# pkgadd -d http://get.opencsw.org/now
# /opt/csw/bin/pkgutil -i ansible

通過 Pacman 安裝最新發布版本(Arch Linux)¶

Ansible 已經放入了 Community repository:

$ pacman -S ansible

The AUR has a PKGBUILD for pulling directly from Github called ansible-git.

Also see the Ansible page on the ArchWiki.

如果在 Arch Linux 上已經安裝了 Python 3，並設定為預設的 Python slot，你必須在 組變數 或 inventory 變數中設定如下變數: ansible_python_interpreter = /usr/bin/python2

通過 Pip 安裝最新發布版本¶

Ansible可通過 “pip” 安裝(安裝和管理Python包的工具),若你還沒有安裝 pip,可執行如下命令安裝:

$ sudo easy_install pip

然後安裝Ansible:

$ sudo pip install ansible

如果你是在 OS X Mavericks 上安裝,編譯器可能或告警或報錯,可通過如下設定避免這種情況:

$ sudo CFLAGS=-Qunused-arguments CPPFLAGS=-Qunused-arguments pip install ansible

使用 virtualenv 的讀者可通過 virtualenv 安裝 Ansible, 然而我們建議不用這樣做,直接在全局安裝 Ansible.不要使用 easy_install 直接安裝 ansible.

發行版的Tarball¶

不想通過git checkout 建立Ansible的軟體包？在這裡可獲取Tarball Ansible downloads

各種版本的Ansible在這裡做了版本標註 git repository