community.general.opkg 模块 – OpenWrt 和基于 Openembedded/Yocto 的 Linux 发行版的软件包管理器

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您正在使用 ansible 包,则可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install community.general。您需要其他需求才能使用此模块,有关详细信息,请参阅 需求

要在剧本中使用它,请指定:community.general.opkg

概要

  • 管理 OpenWrt 和基于 Openembedded/Yocto 的 Linux 发行版的 ipk 包

需求

执行此模块的主机需要以下需求。

  • opkg

  • python

参数

参数

注释

executable

路径

在 community.general 7.2.0 中添加

opkg 的可执行文件位置。

force

字符串

使用的 opkg --force 参数。

状态 "" 已弃用,将在 community.general 12.0.0 中删除。请省略参数 force 以获得相同的行为。

选项

  • ""

  • "depends"

  • "maintainer"

  • "reinstall"

  • "overwrite"

  • "downgrade"

  • "space"

  • "postinstall"

  • "remove"

  • "checksum"

  • "removal-of-dependent-packages"

name

别名:pkg

列表 / 元素=字符串 / 必需

要安装/删除的软件包名称。

NAME=VERSION 语法也支持安装特定版本的软件包。请参阅示例。这仅适用于基于 Yocto 的 Linux 发行版 (opkg>=0.3.2),而不适用于 OpenWrt。自 community.general 6.2.0 起支持此功能。

state

字符串

软件包的状态。

选项

  • "present" ← (默认)

  • "absent"

  • "installed"

  • "removed"

update_cache

布尔值

首先更新软件包数据库。

选项

  • false ← (默认)

  • true

属性

属性

支持

描述

check_mode

支持:不支持

可以在 check_mode 中运行,并在不修改目标的情况下返回更改状态预测。

diff_mode

支持:不支持

在差异模式下,将返回有关已更改内容(或可能需要在 check_mode 中更改的内容)的详细信息。

示例

- name: Install foo
  community.general.opkg:
    name: foo
    state: present

- name: Install foo in version 1.2 (opkg>=0.3.2 on Yocto based Linux distributions)
  community.general.opkg:
    name: foo=1.2
    state: present

- name: Update cache and install foo
  community.general.opkg:
    name: foo
    state: present
    update_cache: true

- name: Remove foo
  community.general.opkg:
    name: foo
    state: absent

- name: Remove foo and bar
  community.general.opkg:
    name:
      - foo
      - bar
    state: absent

- name: Install foo using overwrite option forcibly
  community.general.opkg:
    name: foo
    state: present
    force: overwrite

返回值

公共返回值已记录在 此处,以下是此模块独有的字段

描述

version

字符串

在 community.general 10.0.0 中添加

opkg 的版本。

返回:始终

示例:"2.80.0"

作者

  • Patrick Pelletier (@skinp)