community.general.cargo module – Manage Rust packages with cargo
Note
This module is part of the community.general collection (version 8.6.4).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.general
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: community.general.cargo
.
New in community.general 4.3.0
Synopsis
Manage Rust packages with cargo.
Aliases: packaging.language.cargo
Requirements
The below requirements are needed on the host that executes this module.
cargo installed
Parameters
Parameter |
Comments |
---|---|
Path to the If not specified, the module will look |
|
Install with locked dependencies. This is only used when installing packages. Choices:
|
|
The name of a Rust package to install. |
|
-> The base path where to install the Rust packages. Cargo automatically appends |
|
The state of the Rust package. Choices:
|
|
-> The version to install. If |
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full |
Can run in |
|
Support: none |
Will return details on what has changed (or possibly needs changing in |
Examples
- 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