Модуль community.general.apk — Управление пакетами apk

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в playbook, укажите: community.general.apk.

Обзор
Параметры
Атрибуты
Примечания
Примеры
Значения возврата

Обзор

Управляет apk пакетами для Alpine Linux.

Параметры

Параметр	Комментарии
available boolean	Во время обновления сбрасываются зависимости, связанные с версией, и изменяется логика, чтобы предпочитать замену или понижение версии пакетов (вместо удержания), если установленный пакет больше не доступен ни из одного репозитория. Варианты: `false` ← (по умолчанию) `true`
name список / элементы=строка	Имя пакета, например `foo`, или несколько пакетов, например `foo,bar`. Не включайте дополнительные пробелы при указании нескольких пакетов как строки. Предпочитайте списки YAML вместо разделения нескольких имён пакетов запятыми.
no_cache boolean добавлено в community.general 1.0.0	Не использовать локальный кэш. Варианты: `false` ← (по умолчанию) `true`
repository список / элементы=строка	Репозиторий пакета или несколько репозиториев. В отличие от команды apk, этот список переопределит системные репозитории, а не дополнит их.
state строка	Указывает желаемое состояние пакета(ов). `present` гарантирует наличие пакета(ов). `installed` может использоваться как псевдоним. `absent` гарантирует отсутствие пакета(ов). `removed` может использоваться как псевдоним. `latest` гарантирует наличие пакета(ов) и последней версии. Варианты: `"present"` ← (по умолчанию) `"absent"` `"latest"` `"installed"` `"removed"`
update_cache boolean	Обновить индексы репозиториев. Может быть выполнен вместе с другими шагами или самостоятельно. Варианты: `false` ← (по умолчанию) `true`
upgrade boolean	Обновить все установленные пакеты до последней версии. Варианты: `false` ← (по умолчанию) `true`
world строка добавлено в community.general 5.4.0	Использовать пользовательский файл world при проверке явно установленных пакетов. По умолчанию: `"/etc/apk/world"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз статуса изменения без модификации целевого объекта.
diff_mode	Поддержка: нет	Возвратит подробности о том, что изменилось (или, возможно, должно быть изменено в `check_mode`). в режиме сравнения.

Примечания

Примечание

name и upgrade взаимоисключают друг друга.
При использовании с loop:, каждый пакет будет обрабатываться индивидуально, гораздо эффективнее передать список напрямую в параметр name.

Примеры

- name: Update repositories and install foo package
  community.general.apk:
    name: foo
    update_cache: true

- name: Update repositories and install foo and bar packages
  community.general.apk:
    name: foo,bar
    update_cache: true

- name: Remove foo package
  community.general.apk:
    name: foo
    state: absent

- name: Remove foo and bar packages
  community.general.apk:
    name: foo,bar
    state: absent

- name: Install the package foo
  community.general.apk:
    name: foo
    state: present

- name: Install the packages foo and bar
  community.general.apk:
    name: foo,bar
    state: present

- name: Update repositories and update package foo to latest version
  community.general.apk:
    name: foo
    state: latest
    update_cache: true

- name: Update repositories and update packages foo and bar to latest versions
  community.general.apk:
    name: foo,bar
    state: latest
    update_cache: true

- name: Update all installed packages to the latest versions
  community.general.apk:
    upgrade: true

- name: Upgrade / replace / downgrade / uninstall all installed packages to the latest versions available
  community.general.apk:
    available: true
    upgrade: true

- name: Update repositories as a separate step
  community.general.apk:
    update_cache: true

- name: Install package from a specific repository
  community.general.apk:
    name: foo
    state: latest
    update_cache: true
    repository: http://dl-3.alpinelinux.org/alpine/edge/main

- name: Install package without using cache
  community.general.apk:
    name: foo
    state: latest
    no_cache: true

- name: Install package checking a custom world
  community.general.apk:
    name: foo
    state: latest
    world: /etc/apk/world.custom

END_OF_DOCUMENT_MARKER

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
packages список / элементы=строка	список пакетов, которые были изменены Возвращается: при изменении пакетов Пример: `["package", "other-package"]`

Авторы

Kevin Brebanov (@kbrebanov)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/apk_module.html