community.general.cargo 模块 – 使用 cargo 管理 Rust 包

注意

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

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

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

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

community.general 4.3.0 中的新增功能

概要

  • 使用 cargo 管理 Rust 包。

需求

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

  • 已安装 cargo

参数

参数

注释

directory

路径

在 community.general 9.1.0 中添加

要从中安装 Rust 包的源目录的路径。

这仅在安装包时使用。

executable

路径

在 community.general 7.5.0 中添加

系统中安装的 cargo 的路径。

如果未指定，模块将在 PATH 中查找 cargo。

locked

布尔值

在 community.general 7.5.0 中添加

使用锁定的依赖项进行安装。

这仅在安装包时使用。

选项

  • false ← (默认)

  • true

name

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

要安装的 Rust 包的名称。

路径

路径

-> 安装 Rust 包的基本路径。Cargo 自动附加 /bin。换句话说，/usr/local 将变为 /usr/local/bin。

state

字符串

Rust 包的状态。

选项

  • "present" ← (默认)

  • "absent"

  • "latest"

version

字符串

-> 要安装的版本。如果 name 包含多个值，则模块将尝试安装此版本中的所有值。

属性

属性

支持

描述

check_mode

支持：完全支持

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

diff_mode

支持：不支持

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

示例

- name: Install "ludusavi" Rust package
  community.general.cargo:
    name: ludusavi

- name: Install "ludusavi" Rust package with locked dependencies
  community.general.cargo:
    name: ludusavi
    locked: true

- name: Install "ludusavi" Rust package in version 0.10.0
  community.general.cargo:
    name: ludusavi
    version: '0.10.0'

- name: Install "ludusavi" Rust package to global location
  community.general.cargo:
    name: ludusavi
    path: /usr/local

- name: Remove "ludusavi" Rust package
  community.general.cargo:
    name: ludusavi
    state: absent

- name: Update "ludusavi" Rust package its latest version
  community.general.cargo:
    name: ludusavi
    state: latest

- name: Install "ludusavi" Rust package from source directory
  community.general.cargo:
    name: ludusavi
    directory: /path/to/ludusavi/source

作者

  • Radek Sprta (@radek-sprta)