Установка Ansible

На этой странице описано, как установить Ansible на различных платформах. Ansible — это инструмент без агентов для автоматизации, который по умолчанию управляет машинами через протокол SSH. После установки Ansible не добавляет базу данных и нет демонов, которые нужно запускать или поддерживать. Вам нужно установить его только на одну машину (которая может быть ноутбуком), и она может управлять целым флотом удаленных машин из этой центральной точки. Когда Ansible управляет удаленными машинами, он не оставляет установленного или работающего на них программного обеспечения, поэтому нет реальных вопросов о том, как обновить Ansible при переходе на новую версию.

• Предварительные требования
  • Требования к контрольному узлу
  • Требования к управляемому узлу
• Выбор версии Ansible для установки
• Установка Ansible на RHEL, CentOS или Fedora
• Установка Ansible на Ubuntu
• Установка Ansible на Debian
• Установка Ansible на Gentoo с portage
• Установка Ansible на FreeBSD
• Установка Ansible на macOS
• Установка Ansible на Solaris
• Установка Ansible на Arch Linux
• Установка Ansible на Slackware Linux
• Установка Ansible на Clear Linux
• Установка Ansible с pip
• Запуск Ansible из исходного кода (devel)
• Поиск tar-архивов помеченных релизов
• Автозаполнение команд Ansible
  • Установка argcomplete на RHEL, CentOS или Fedora
  • Установка argcomplete с apt
  • Установка argcomplete с pip
  • Настройка argcomplete
    • Глобально
    • По команде
  • argcomplete с zsh или tcsh
• Ansible на GitHub

Предварительные требования

Вы устанавливаете Ansible на контрольном узле, который затем использует SSH (по умолчанию) для связи с управляемыми узлами (этими конечными устройствами, которые вы хотите автоматизировать).

Требования к контрольному узлу

В настоящее время Ansible можно запускать с любой машины, на которой установлены Python 2 (версия 2.7) или Python 3 (версии 3.5 и выше). Это включает Red Hat, Debian, CentOS, macOS, любые из BSD и так далее. Windows не поддерживается для контрольного узла.

При выборе контрольного узла помните, что любая система управления выигрывает от запуска рядом с управляемыми машинами. Если вы запускаете Ansible в облаке, рассмотрите возможность запуска с машины внутри этого облака. В большинстве случаев это будет работать лучше, чем в открытом Интернете.

Требования к управляемому узлу

На управляемых узлах вам нужен способ связи, который обычно является SSH. По умолчанию используется SFTP. Если это недоступно, вы можете переключиться на SCP в ansible.cfg. Вам также нужен Python 2 (версия 2.6 или выше) или Python 3 (версия 3.5 или выше).

Выбор версии Ansible для установки

Версия Ansible, которую следует установить, зависит от ваших конкретных потребностей. Вы можете выбрать любой из следующих способов установки Ansible:

• Установить последнюю версию с помощью менеджера пакетов вашей ОС (для Red Hat Enterprise Linux (TM), CentOS, Fedora, Debian или Ubuntu).
• Установить с pip (менеджером пакетов Python).
• Установить из исходного кода, чтобы получить версию разработки (devel) для разработки или тестирования последних функций.

Ansible создает новые релизы два-три раза в год. Из-за этого короткого цикла выпуска, мелкие ошибки, как правило, будут исправлены в следующем релизе, а не поддерживая обратные порты на стабильной ветке. Серьёзные ошибки всё ещё будут иметь релизы поддержки при необходимости, хотя они редки.

Установка Ansible на RHEL, CentOS или Fedora

На Fedora:

$ sudo dnf install ansible

На RHEL и CentOS:

$ sudo yum install ansible

RPM-пакеты для RHEL 7 и RHEL 8 доступны из репозитория репозитория Ansible Engine.

Чтобы включить репозиторий Ansible Engine для RHEL 8, выполните следующую команду:

$ sudo subscription-manager repos --enable ansible-2.9-for-rhel-8-x86_64-rpms

Чтобы включить репозиторий Ansible Engine для RHEL 7, выполните следующую команду:

$ sudo subscription-manager repos --enable rhel-7-server-ansible-2.9-rpms

RPM-пакеты для поддерживаемых версий RHEL, CentOS и Fedora также доступны из EPEL, а также releases.ansible.com.

Ansible версии 2.4 и выше может управлять более ранними операционными системами, содержащими Python 2.6 или выше.

Вы также можете самостоятельно создать RPM. Из корневой директории развёртывания или tar-архива используйте команду make rpm для создания RPM-пакета, который вы можете распространять и устанавливать.

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

Установка Ansible на Ubuntu

Пакеты для Ubuntu доступны здесь.

Для настройки PPA на вашей машине и установки Ansible выполните эти команды:

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

Debian/Ubuntu пакеты также можно собрать из исходного кода, выполнив:

$ make deb

Вы также можете запустить из исходного кода, чтобы получить ветку разработки, которая описана ниже.

Установка Ansible на Debian

Пользователи Debian могут использовать тот же источник, что и PPA Ubuntu.

Добавьте следующую строку в /etc/apt/sources.list:

deb http://ppa.launchpad.net/ansible/ansible/ubuntu trusty main

Затем выполните эти команды:

$ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 93C4A3FD7BB9C367
$ sudo apt update
$ sudo apt install ansible

Установка Ansible на Gentoo с помощью portage

$ emerge -av app-admin/ansible

Для установки последней версии вам может потребоваться размаскировать пакет Ansible перед его выходом:

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

Установка Ansible на FreeBSD

Хотя Ansible работает с версиями Python 2 и 3, FreeBSD имеет разные пакеты для каждой версии Python. Поэтому для установки можно использовать:

$ sudo pkg install py27-ansible

или:

$ sudo pkg install py36-ansible

Вы также можете установить его из портов, выполнив:

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

Вы также можете выбрать определенную версию, например ansible25.

Более старые версии FreeBSD работали с чем-то вроде этого (замените на ваш выбор менеджера пакетов):

$ sudo pkg install ansible

Установка Ansible на macOS

Предпочтительный способ установки Ansible на Mac — с помощью pip.

Инструкции можно найти в Установка Ansible с помощью pip. Если вы используете macOS версии 10.12 или более старой, вам следует обновить до последней версии pip для безопасного подключения к Python Package Index.

Установка Ansible на Solaris

Ansible доступен для Solaris в виде пакета SysV от OpenCSW.

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

Установка Ansible на Arch Linux

Ansible доступен в репозитории Community:

$ pacman -S ansible

AUR содержит PKGBUILD для прямого извлечения из GitHub, называемый ansible-git.

Также см. страницу Ansible на ArchWiki.

Установка Ansible на Slackware Linux

Скрипт сборки Ansible доступен в репозитории SlackBuilds.org. Его можно собрать и установить с помощью sbopkg.

Создайте очередь с Ansible и всеми зависимостями:

# sqg -p ansible

Соберите и установите пакеты из созданного файла очереди (ответьте Q на вопрос, если sbopkg должен использовать очередь или пакет):

# sbopkg -k -i ansible

Установка Ansible на Clear Linux

Ansible и его зависимости доступны как часть пакета инструментов управления хостами sysadmin:

$ sudo swupd bundle-add sysadmin-hostmgmt

Обновление программного обеспечения будет управляться инструментом swupd:

$ sudo swupd update

Установка Ansible с pip

Ansible можно установить с помощью pip, менеджера пакетов Python. Если pip еще не доступен в вашей системе Python, выполните следующие команды для его установки:

$ curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
$ python get-pip.py --user

Затем установите Ansible [1]:

$ pip install --user ansible

Или, если вы ищете версию разработки:

$ pip install --user git+https://github.com/ansible/ansible.git@devel

Если вы устанавливаете на macOS Mavericks (10.9), вы можете столкнуться с некоторыми сообщениями от вашего компилятора. Рабочий обход — выполнить следующее:

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

Для использования плагина подключения paramiko или модулей, требующих paramiko, установите необходимый модуль [2]:

$ pip install --user paramiko

Ansible также можно установить внутри нового или существующего virtualenv:

$ python -m virtualenv ansible  # Create a virtualenv if one does not already exist
$ source ansible/bin/activate   # Activate the virtual environment
$ pip install ansible

Если вы хотите установить Ansible глобально, выполните следующие команды:

$ sudo python get-pip.py
$ sudo pip install ansible

Запуск Ansible из исходного кода (devel)

Запуск Ansible из исходного кода прост. Вам не нужны права root для его использования, и не нужно устанавливать какое-либо программное обеспечение. Не требуются демоны или настройка базы данных.

Для установки из исходного кода клонируйте репозиторий Ansible git:

$ git clone https://github.com/ansible/ansible.git
$ cd ./ansible

После того, как git клонировал репозиторий Ansible, настройте среду Ansible:

Используя Bash:

$ source ./hacking/env-setup

Используя Fish:

$ source ./hacking/env-setup.fish

Если вы хотите подавить ложные предупреждения/ошибки, используйте:

$ source ./hacking/env-setup -q

Если у вас не установлен pip в вашей версии Python, установите его:

$ curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
$ python get-pip.py --user

Ansible также использует следующие модули Python, которые необходимо установить [1]:

$ pip install --user -r ./requirements.txt

Для обновления проверок Ansible используйте pull-with-rebase, чтобы любые локальные изменения были переиграны.

$ git pull --rebase

$ git pull --rebase #same as above
$ git submodule update --init --recursive

После запуска скрипта env-setup вы будете запускаться из раздела и файл инвентаризации по умолчанию будет /etc/ansible/hosts. Вы можете необязательно указать файл инвентаризации (см. Как создать свой файл инвентаризации) вместо /etc/ansible/hosts:

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

Вы можете узнать больше о файле инвентаризации на странице Как создать свой файл инвентаризации.

Теперь давайте протестируем это с командой ping:

$ ansible all -m ping --ask-pass

Вы также можете использовать «sudo make install».

Поиск tar-архивов помеченных выпусков

Упаковывание Ansible или создание локального пакета самостоятельно, но не хотите выполнять git checkout? Tar-архивы выпусков доступны на странице загрузки Ansible.

Эти выпуски также помечены в репозитории git с версией выпуска.

Автозаполнение команд Ansible

Начиная с Ansible 2.9, доступно автозаполнение командной строки Ansible, которое предоставляется необязательной зависимостью под названием argcomplete. argcomplete поддерживает bash и имеет ограниченную поддержку zsh и tcsh.

Вы можете установить python-argcomplete из EPEL на дистрибутивах Red Hat Enterprise и/или из стандартных репозиториев ОС для многих других дистрибутивов.

Для получения дополнительной информации об установке и настройке см. документацию по argcomplete.

Установка argcomplete на RHEL, CentOS или Fedora

В Fedora:

$ sudo dnf install python-argcomplete

В RHEL и CentOS:

$ sudo yum install epel-release
$ sudo yum install python-argcomplete

Установка argcomplete с apt

$ sudo apt install python-argcomplete

Установка argcomplete с pip

$ pip install argcomplete

Настройка argcomplete

Существует 2 способа настройки argcomplete для включения автозаполнения командной строки Ansible: глобально или по команде.

Глобально

Для глобального автозаполнения требуется bash 4.2.

$ sudo activate-global-python-argcomplete

Это запишет файл автозаполнения bash в глобальную папку. Используйте --dest для изменения расположения.

По команде

Если у вас нет bash 4.2, вы должны зарегистрировать каждый скрипт индивидуально.

$ eval $(register-python-argcomplete ansible)
$ eval $(register-python-argcomplete ansible-config)
$ eval $(register-python-argcomplete ansible-console)
$ eval $(register-python-argcomplete ansible-doc)
$ eval $(register-python-argcomplete ansible-galaxy)
$ eval $(register-python-argcomplete ansible-inventory)
$ eval $(register-python-argcomplete ansible-playbook)
$ eval $(register-python-argcomplete ansible-pull)
$ eval $(register-python-argcomplete ansible-vault)

Вы должны поместить эти команды в свой файл профиля оболочки, такой как ~/.profile или ~/.bash_profile.

argcomplete с zsh или tcsh

См. документацию по argcomplete.

Ansible на GitHub

Вы также можете следить за проектом GitHub, если у вас есть учетная запись GitHub. Там же находится система отслеживания проблем для обмена ошибками и идеями новых функций.