ansible.builtin.apt_repository – Добавление и удаление репозиториев APT
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев можно использовать короткое имя модуля apt_repository, даже не указывая ключевое слово collections:. Несмотря на это, рекомендуется использовать FQCN для лёгкой ссылки на документацию модуля и чтобы избежать конфликтов с другими коллекциями, которые могут иметь такое же имя модуля.
Новое в версии 0.7: of ansible.builtin
Описание
- Добавление или удаление репозиториев APT в Ubuntu и Debian.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python-apt (python 2)
- python3-apt (python 3)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| codename строка добавлен в 2.3 of ansible.builtin | Переопределяет кодовое имя дистрибутива для использования в репозиториях PPA. Обычно следует устанавливать только при работе с PPA на целевом сервере не Ubuntu (например, Debian или Mint). | |
| filename строка добавлен в 2.1 of ansible.builtin | Устанавливает имя файла списка источников в sources.list.d. По умолчанию имя файла основывается на URL источника репозитория. Расширение .list будет автоматически добавлено. | |
| install_python_apt булево |
| Автоматически пытаться установить библиотеку Python apt, если она ещё не установлена. Без этой библиотеки модуль не работает. Выполняет apt-get install python-apt для Python 2 и apt-get install python3-apt для Python 3.Работает только с системным Python 2 или Python 3. Если используется Python на удалённом сервере, который не является системным Python, установите install_python_apt=false и убедитесь, что библиотека Python apt для вашей версии Python установлена каким-либо другим способом. |
| mode raw добавлен в 1.6 of ansible.builtin | Восьмеричный режим для вновь создаваемых файлов в sources.list.d. По умолчанию используется режим системы (вероятно, 0644). | |
| repo строка / обязательно | Строка источника репозитория. | |
| state строка |
| Состояние строки источника. |
| update_cache булево |
| Выполнить эквивалент apt-get update при возникновении изменения. Обновления кэша выполняются после внесения изменений.псевдонимы: update-cache |
| update_cache_retries целое число добавлен в 2.10 of ansible.builtin | Значение по умолчанию: 5 | Количество попыток повторного выполнения, если обновление кэша завершилось ошибкой. Также см. update_cache_retry_max_delay. |
| update_cache_retry_max_delay целое число добавлен в 2.10 of ansible.builtin | Значение по умолчанию: 12 | Использовать экспоненциальную задержку повторных попыток (см. update_cache_retries) до максимальной задержки в секундах. |
| validate_certs булево добавлен в 1.8 of ansible.builtin |
| Если no, сертификаты SSL для целевого репозитория не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. |
Примечания
Примечание
- Этот модуль работает в Debian, Ubuntu и их производных.
- Этот модуль поддерживает Debian Squeeze (версия 6), а также его преемников.
- Поддерживает
check_mode.
Примеры
- name: Add specified repository into sources list
ansible.builtin.apt_repository:
repo: deb http://archive.canonical.com/ubuntu hardy partner
state: present
- name: Add specified repository into sources list using specified filename
ansible.builtin.apt_repository:
repo: deb http://dl.google.com/linux/chrome/deb/ stable main
state: present
filename: google-chrome
- name: Add source repository into sources list
ansible.builtin.apt_repository:
repo: deb-src http://archive.canonical.com/ubuntu hardy partner
state: present
- name: Remove specified repository from sources list
ansible.builtin.apt_repository:
repo: deb http://archive.canonical.com/ubuntu hardy partner
state: absent
- name: Add nginx stable repository from PPA and install its signing key on Ubuntu target
ansible.builtin.apt_repository:
repo: ppa:nginx/stable
- name: Add nginx stable repository from PPA and install its signing key on Debian target
ansible.builtin.apt_repository:
repo: 'ppa:nginx/stable'
codename: trusty
Авторы
- Александр Солтанцев (@sashka)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/apt_repository_module.html
