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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general.

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

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

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

Параметры

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

Атрибуты

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

Примечания

Примечание

name и upgrade нельзя использовать одновременно.
При использовании с loop: каждый пакет обрабатывается отдельно. Передавать список непосредственно параметру name гораздо эффективнее.
Этот модуль предполагает, что apk выполняется в неинтерактивном режиме. В Chimera Linux apk по умолчанию работает в интерактивном режиме, из-за чего модуль зависнет. Интерактивный режим можно настроить в /etc/apk/config. Несмотря на отсутствие официальной поддержки, модуль должен работать и в других системах, использующих apk, если apk по умолчанию выполняется в неинтерактивном режиме.

Примеры

- 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

Возвращаемые значения

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

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

Авторы

Kevin Brebanov (@kbrebanov)

Ссылки на коллекцию

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