community.general.easy_install 模块 – 安装 Python 库

注意

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

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

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

要在剧本中使用它，请指定： community.general.easy_install。

概要

  • 安装 Python 库，可选地在 virtualenv 中安装

需求

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

  • virtualenv

参数

参数

注释

executable

字符串

要用来运行 easy_install 的显式可执行文件或可执行文件的路径名，用于系统中安装的特定版本的 Python。例如 easy_install-3.3，如果系统中同时安装了 Python 2.7 和 3.3，并且您想为 Python 3.3 安装运行 easy_install。

默认值： "easy_install"

name

字符串 / 必需

Python 库名称。

state

字符串

库的所需状态。 latest 确保安装最新版本。

选项

  • "present" ← (默认)

  • "latest"

virtualenv

字符串

一个可选的 virtualenv 目录路径，用于安装。如果 virtualenv 不存在，则会自动创建。

virtualenv_command

字符串

创建虚拟环境的命令。例如 pyvenv、virtualenv、virtualenv2。

默认值： "virtualenv"

virtualenv_site_packages

布尔值

虚拟环境是否将继承来自全局 site-packages 目录的包。请注意，如果此设置在一个已存在的虚拟环境中更改，则不会有任何影响，必须删除该环境并重新创建。

选项

  • false ← (默认)

  • true

属性

属性

支持

描述

check_mode

支持：完全支持

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

diff_mode

支持：不支持

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

备注

注意

  • 请注意，easy_install 模块只能安装 Python 库。因此，此模块无法删除库。通常建议使用 ansible.builtin.pip 模块，您可以首先使用 community.general.easy_install 安装。

  • 另请注意，如果指定了 virtualenv 参数，则必须在远程主机上安装 virtualenv。

示例

- name: Install or update pip
  community.general.easy_install:
    name: pip
    state: latest

- name: Install Bottle into the specified virtualenv
  community.general.easy_install:
    name: bottle
    virtualenv: /webapps/myapp/venv

作者

  • Matt Wright (@mattupstate)