Rustup

This is a guide for installing rustup along with packages for rust.

Description

Setting up a new Rust build can be time-consuming because you often need to install Rust manually. This role aims to make that process easier by providing a common Rust installation, plus additional packages that are ready for use.

The role installs rustup and enables autocomplete for your chosen shell. The available packages are categorized into two groups. The first group includes common packages in the common.crates section of defaults/main.yml. The second group consists of more specific packages tailored to the author's preferences, found in the specific section of defaults/main.yml. If you want to disable the specific packages or make changes, you can find that information in the Usage section.

Common Packages

• rustfmt
• racer
• pijul

Specific Packages

• Target Platforms

  • aarch64-linux-android
  • aarch64-unknown-linux-gnu
  • arm-unknown-linux-musleabi
  • arm-unknown-linux-musleabihf
  • armv7-unknown-linux-gnueabihf
  • armv7-unknown-linux-musleabihf
  • x86_64-unknown-linux-musl

• Toolchains

  • nightly-x86_64-unknown-linux-gnu

• Crates

  • exa
  • way-cooler
  • iota
  • parallel
  • [rust-clippy]

Role Variables

This role includes three variables that you might want to update based on your needs. You can find the default values in defaults:

conf:

  # Set the shell for autocomplete (bash|fish|zsh)
  shell: fish

  # Whether to install specific packages
  specifics: true

  # Decide whether to use the parallel package
  parallel: true

Requirements

You must change the default variables listed above to fit your needs when using this role.

Usage

Other than the role variables (except for parallel), you only need to activate the role in your playbook. If you want to use your own crates, targets, or toolchains, you can replace the variables found in defaults.

To use the parallel package, you'll need to run the role with become enabled to access madvise mode.

- hosts: servers
    roles:
        - abaez.rustup

Author Information

Alejandro Baez