Machine Setup

The idea is to be able to replicate a certain setup (when reseting your machine or using a completely new machine). Additionally, it should be possible to update the setup easily when needed, e.g. an update to your vim config files. So, it will help with managing dotfiles, symlinks, etc.

A real world example can be found in my .dotfiles repository.

You can also use it for other tasks such as making the onboarding process of a new colleague easier by providing them a config that installs certain dependencies and checks out important repositories.

Install

For now, only cargo install is supported.

cargo install machine_setup

Run

Subcommands

By default, machine_setup will look for a file called machine_setup with a supported file format.
Supported file formats are: yaml, yml, and json.

Command line parameters

Supported config file formats

The supported formats are YAML and JSON.

Configure

Tasks can be defined under the tasks root key. Every task can contain an arbitrary number of commands.

Task specific configuration

TODO: Add JSON examples...

Check out the example configuration below:

temp_dir: "~/my_temp" # defaults to "~/.machine_setup"
default_shell: "zsh" # defaults to "bash"
tasks:
  my_task1:
    os: ["linux", "windows"]
    commands:
      - copy:
          src: "./src/files"
          target: "/tmp/target"
      - copy:
          src: "./src/files_2"
          target: "/tmp/target"

  my_task2:
    os: ["linux"]
    commands:
      - shell: "sudo apt-get install git -y"
      - symlink:
          src: "./src/config"
          target: "~/.dotfiles"

Extend a configuration

Extensibility is not explicitly built in. However, it's possible to execute tasks from another configuration via the run command. You could also only execute a single task by providing the task argument.

tasks:
  my_other_config:
    commands:
      - run:
          commands:
          install: "machine_setup install -c ./my_other_config.yaml"
          update: "machine_setup update -c ./my_other_config.yaml"
          uninstall: "machine_setup uninstall -c ./my_other_config.yaml"

Available config commands

copy

This command copies the contents of a directory to another directory.

example

copy:
  src: "./src/files"
  target: "/tmp/target"
  ignore: ["dist", "package-lock.json"]

clone

This command clones a git repository to the specified destination.

example

clone:
  url: "git@github.com:Chroma91/machine_setup.git"
  target: "~/machine_setup"

symlink

This command symlinks all the files from the source directory to the target directory.

If force is set to true, existing files will be removed and replaced by the symlinks.

example

symlink:
  src: "./src/files"
  target: "/tmp/target"
  ignore: ["dist", "package-lock.json"]
  force: true

run

This command executes a shell command.

Hint: Avoid the usage of interactive commands when possible.

By default, shell commands will be skipped when updating or uninstalling. You can change that by prodiving update and/or uninstall.

The following arguments can be passed to commands:

example

inline_command:
  run:
    commands: "sudo apt-get -y install git"

multiline_command:
  run:
    commands:
      - "sudo apt-get update"
      - "sudo apt-get -y install git"

updatable_command:
  run:
    env:
      SOME_TOKEN: "abc123"
    commands:
      install: "sudo apt-get -y install git"
      update: "sudo apt-get -y upgrade git"
      uninstall: "sudo apt-get -y uninstall git"

updatable_multiline_command:
  run:
    env:
      SOME_TOKEN: "abc123"
    commands:
      install:
        - "sudo apt update"
        - "sudo apt-get -y install git"
      update:
        - "sudo apt-get -y upgrade git"
        - ...
      uninstall:
        - "sudo apt-get -y uninstall git"
        - ...

TODOs

1.0.0

• Add other binaries and installation options
• Improve the terminal output
  • hide most of it behind a --verbose flag

1.1.0

• make it possible to specify that all commands in a task should be run in parallel (this might be useful when cloning/updating a chunk of repos for example)
• Add option to run copy and symlink as root user (needed to move/link some system files)

1.2.0

• also make it possible to run tasks in parallel (not only commands inside)

2.0.0

[BREAKING]

• all tasks run in parallel by default
• dependsOn can be set for tasks to make them wait for other tasks

2.1.0

• conditional tasks
  • add the ability to add requirements for a task, e.g. only run if a certain file doesn't exist