zuul-jobs/roles/ensure-rust/README.rst
Ian Wienand 048aff6c98 Add ensure-rust role
Add a role to install Rust via the rustup tool.  It defaults to
installing globally, which avoids having to worry too much about
setting paths for follow-on jobs.

Packaged Rust and the upstream rustup install tool can live together,
and there's various documentation about it.  Thus I've made this such
that we can expand it with packaged Rust support if there is a need,
but I have not implemented that yet.

Change-Id: I32f9b285904a7036f9a80ada8a49fa9cf31b5163
2020-08-25 09:04:43 +10:00

29 lines
658 B
ReStructuredText

Install Rust
Install the Rust toolchain
**Role Variables**
.. zuul:rolevar:: ensure_rust_rustup
:default: True
Install Rust via the ``rustup`` installer.
.. zuul:rolevar:: ensure_rust_rustup_toolchain
:default: stable
The Rust toolchain to install with ``rustup``.
.. zuul:rolevar:: ensure_rust_rustup_path
:default: /usr
Where to install Rust/Cargo with ``rustup``. ``/usr`` provides the
tools globally. This may conflict with distribution Rust packages
if installed.
.. zuul:rolevar:: ensure_rust_packages
:default: False
Install Rust via system packages. This role does not currently
support package install.