Установка Ansible

Установка Ansible

Используйте pipx в своей среде для установки полного пакета Ansible:

$ pipx install --include-deps ansible

Можно установить минимальный пакет ansible-core:

$ pipx install ansible-core

Также можно установить определённую версию ansible-core:

$ pipx install ansible-core==2.12.3

Обновление Ansible

Чтобы обновить существующую установку Ansible до последней выпущенной версии:

$ pipx upgrade --include-injected ansible

Установка дополнительных зависимостей Python

Чтобы установить необходимые дополнительные зависимости Python, например пакет Python argcomplete, как описано ниже:

$ pipx inject ansible argcomplete

Добавьте параметр --include-apps, чтобы приложения из дополнительной зависимости Python стали доступны в PATH. Это позволит запускать команды этих приложений из командной оболочки.

$ pipx inject --include-apps ansible argcomplete

Если вам нужно установить зависимости из файла требований, например при установке коллекции Azure, можно использовать runpip.

$ pipx runpip ansible install -r ~/.ansible/collections/ansible_collections/azure/azcollection/requirements.txt

Поиск Python

Найдите и запомните путь к интерпретатору Python, с помощью которого вы хотите запускать Ansible. В следующих инструкциях этот Python обозначается как python3. Например, если вы решили установить Ansible под Python, расположенный по пути /usr/bin/python3.9, укажите его вместо python3.

Проверка доступности pip

Чтобы проверить, установлен ли уже pip для выбранного вами Python:

$ python3 -m pip -V

Если всё в порядке, вы увидите примерно следующее:

$ python3 -m pip -V
pip 21.0.1 from /usr/lib/python3.9/site-packages/pip (python 3.9)

Если это так, pip доступен, и можно перейти к следующему шагу.

Если появится ошибка, например No module named pip, прежде чем продолжить, необходимо установить pip для выбранного интерпретатора Python. Возможно, потребуется установить дополнительный пакет ОС (например, python3-pip) или установить последнюю версию pip непосредственно из Python Packaging Authority, выполнив следующую команду:

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

Прежде чем запускать Ansible, может потребоваться выполнить дополнительную настройку. Дополнительную информацию см. в документации Python о установке в пользовательский каталог.

Установка Ansible

Используйте pip в выбранной среде Python, чтобы установить полный пакет Ansible для текущего пользователя:

$ python3 -m pip install --user ansible

Для текущего пользователя можно установить минимальный пакет ansible-core:

$ python3 -m pip install --user ansible-core

Также можно установить определённую версию ansible-core:

$ python3 -m pip install --user ansible-core==2.12.3

Обновление Ansible

Чтобы обновить существующую установку Ansible в этой среде Python до последней выпущенной версии, просто добавьте --upgrade к приведённой выше команде:

$ python3 -m pip install --upgrade --user ansible

Установка devel из GitHub с помощью pip

Ветку devel проекта ansible-core можно установить непосредственно из GitHub с помощью pip:

$ python3 -m pip install --user https://github.com/ansible/ansible/archive/devel.tar.gz

Чтобы установить более старые версии Ansible, версии alpha или beta с тегами, а также кандидаты на выпуск, замените devel в указанном выше URL на любую другую ветку или тег в GitHub.

Запуск ветки devel из клона

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

1. Клонируйте репозиторий ansible-core

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

2. Настройте среду Ansible

   • Для Bash

     $ source ./hacking/env-setup
     

   • Для Fish

     $ source ./hacking/env-setup.fish
     

   • Чтобы отключить ложные предупреждения и ошибки, используйте -q

     $ source ./hacking/env-setup -q
     

3. Установите зависимости Python

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

4. Обновите ветку devel проекта ansible-core на локальном компьютере

   Используйте команду извлечения с rebase, чтобы повторно применить все локальные изменения.

   $ git pull --rebase
   

Установка argcomplete

Если вы выбрали инструкции по установке pipx:

$ pipx inject --include-apps ansible argcomplete

Если вы выбрали инструкции по установке pip:

$ python3 -m pip install --user argcomplete

Настройка argcomplete

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

$ activate-global-python-argcomplete --user

$ 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)