Установка Ansible

Установка Ansible

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

$ pipx install --include-deps ansible

Вы можете установить минимальный пакет

$ pipx install ansible-core

$ pipx install ansible-core

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

$ pipx upgrade --include-injected ansible

$ 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

Нахождение Python

Найдите и запомните путь к интерпретатору Python, который вы хотите использовать для запуска Ansible. В следующих инструкциях этот Python называется python3. Например, если вы определили, что хотите использовать 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

Вы можете заменить devel в указанном выше URL любой другой веткой или тегом на GitHub для установки более старых версий Ansible, тегированных как альфа или бета, и кандидатов в релиз.

Запуск ветки 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 на вашей локальной машине

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

   $ git pull --rebase
   

Установка argcomplete

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

$ pipx inject --include-apps ansible argcomplete

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

$ python3 -m pip install --user argcomplete

Настройка argcomplete

Есть 2 способа настроить 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)