Spec-Zone.ru › Ansible 2.4

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
  • absent
  • present
  • build-dep
Указывает желаемое состояние пакета. latest гарантирует установку последней версии. build-dep гарантирует установку зависимостей сборки пакета.
update_cache
нет
  • да
  • нет
Выполнить эквивалент apt-get update перед операцией. Может быть выполнено как часть установки пакета, или как отдельный шаг.
upgrade
нет нет
  • нет
  • да
  • safe
  • full
  • dist
Если да или 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.4 apt-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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API