apt - Управляет пакетами apt
- Описание
- Требования (для хоста, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Управляет пакетами apt (например, для Debian/Ubuntu).
Требования (для хоста, на котором выполняется модуль)
- python-apt (python 2)
- python3-apt (python 3)
- aptitude (до версии 2.4)
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| allow_unauthenticated (добавлен в 2.1)
| нет | нет |
| Игнорировать, если пакеты не могут быть аутентифицированы. Это полезно для среды начальной настройки, которая управляет своей собственной установкой apt-ключей. |
| autoclean (добавлен в 2.4)
| нет |
| Если yes, очищает локальный репозиторий от полученных файлов пакетов, которые больше нельзя загрузить. | |
| autoremove (добавлен в 2.1)
| нет |
| Если yes, удаляет неиспользуемые зависимые пакеты для всех состояний модуля, кроме build-dep. Также может быть использован в качестве единственного параметра.До версии 2.4, autoclean также был алиасом для autoremove, теперь это отдельный параметр. Для получения дополнительной информации смотрите документацию. | |
| cache_valid_time | нет | Обновить кеш apt, если он старше cache_valid_time. Этот параметр задается в секундах. С версии Ansible 2.4, это неявно устанавливает update_cache, если задано. | ||
| deb (добавлен в 1.6)
| нет | Путь к пакету .deb на удаленной машине. Если в пути присутствует ://, Ansible попытается загрузить .deb перед установкой. (Версия добавлена 2.1) | ||
| default_release | нет | Соответствует параметру -t для apt и устанавливает приоритеты привязки. | ||
| dpkg_options | нет | force-confdef,force-confold | Добавить параметры dpkg к команде apt. По умолчанию -o "Dpkg::Options::=--force-confdef" -o "Dpkg::Options::=--force-confold" Параметры должны быть перечислены через запятую. | |
| force | нет | нет |
| Если yes, принудительно устанавливает/удаляет. |
| force_apt_get (добавлен в 2.4)
| нет | Принудительно использовать apt-get вместо aptitude | ||
| install_recommends | нет |
| Соответствует параметру --no-install-recommends для apt. yes устанавливает рекомендуемые пакеты. no не устанавливает рекомендуемые пакеты. По умолчанию Ansible будет использовать те же значения, что и операционная система. Предлагаемые пакеты никогда не устанавливаются. | |
| name | нет | Имя пакета, например foo, или указатель пакета с версией, например foo=1.0. Поддерживаются также шаблоны имен (fnmatch), например apt* и шаблоны версий, например foo=1.0*. Обратите внимание, что команда apt-get поддерживает неявные совпадения с использованием регулярных выражений, но мы этого не делаем, так как это может привести к ошибкам (Если вы напишете foo как fo, apt-get установит пакеты, которые содержат «fo» в их имени, с предупреждением и запросом к пользователю. Поскольку у нас нет предупреждений и запросов перед установкой, мы этого не разрешаем. Используйте явный шаблон fnmatch, если вам нужны шаблоны подстановок)псевдонимы: pkg, package | ||
| only_upgrade (добавлен в 2.1)
| нет | Только обновлять пакет, если он уже установлен. | ||
| purge | нет |
| Принудительно удалит файлы конфигурации, если состояние модуля установлено в absent. | |
| state | нет | present |
| Указывает желаемое состояние пакета. latest гарантирует установку последней версии. build-dep гарантирует установку зависимостей сборки пакета. |
| update_cache | нет |
| Выполнить эквивалент apt-get update перед операцией. Может быть выполнено как часть установки пакета, или как отдельный шаг. | |
| upgrade | нет | нет |
| Если да или safe, выполняет aptitude safe-upgrade. Если full, выполняет aptitude full-upgrade. Если dist, выполняет apt-get dist-upgrade. Примечание: Это не обновляет конкретный пакет, используйте state=latest для этого. Примечание: С версии 2.4, apt-get используется как резервное решение, если aptitude отсутствует. |
Примеры
- name: Update repositories cache and install "foo" package
apt:
name: foo
update_cache: yes
- name: Remove "foo" package
apt:
name: foo
state: absent
- name: Install the package "foo"
apt:
name: foo
state: present
- name: Install the version '1.00' of package "foo"
apt:
name: foo=1.00
state: present
- name: Update the repository cache and update package "nginx" to latest version using default release squeeze-backport
apt:
name: nginx
state: latest
default_release: squeeze-backports
update_cache: yes
- name: Install latest version of "openjdk-6-jdk" ignoring "install-recommends"
apt:
name: openjdk-6-jdk
state: latest
install_recommends: no
- name: Upgrade all packages to the latest version
apt:
name: "*"
state: latest
- name: Update all packages to the latest version
apt:
upgrade: dist
- name: Run the equivalent of "apt-get update" as a separate step
apt:
update_cache: yes
- name: Only run "update_cache=yes" if the last one is more than 3600 seconds ago
apt:
update_cache: yes
cache_valid_time: 3600
- name: Pass options to dpkg on run
apt:
upgrade: dist
update_cache: yes
dpkg_options: 'force-confold,force-confdef'
- name: Install a .deb package
apt:
deb: /tmp/mypackage.deb
- name: Install the build dependencies for package "foo"
apt:
pkg: foo
state: build-dep
- name: Install a .deb package from the internet.
apt:
deb: https://example.com/python-ppq_0.1-1_all.deb
- name: Remove useless packages from the cache
apt:
autoclean: yes
- name: Remove dependencies that are no longer required
apt:
autoremove: yes
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| cache_update_time | время последнего обновления кеша (0, если неизвестно) | успех, в некоторых случаях | int | 1425828348000 |
| cache_updated | был ли кеш обновлен или нет | успех, в некоторых случаях | boolean | True |
| stderr | вывод ошибок от apt | успех, когда нужно | строка | AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.1.1. Set the 'ServerName' directive globally to ... |
| stdout | вывод от apt | успех, когда нужно | строка | Reading package lists... Building dependency tree... Reading state information... The following extra packages will be installed: apache2-bin ... |
Примечания
Примечание
- Три режима обновления (
full,safeи его псевдонимyes) требовалиaptitudeдо версии 2.3, с версии 2.4apt-getиспользуется по умолчанию.
Статус
Этот модуль отмечен как stableinterface, что означает, что разработчики гарантируют отсутствие несовместимых изменений интерфейса.
Информация о поддержке
Для получения дополнительной информации о поддержке этого модуля компанией Red Hat, пожалуйста, обратитесь к этому knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, ознакомьтесь с Информацией о сообществе и участии в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/apt_module.html