Autoschematic

The recommended method of installing Autoschematic is with Cargo, Rust's package manager.

If you don't have Cargo or Rust installed yet, you'll need to install them first. See the official Rust docs for instructions.

Note: you will also need the protobuf compiler in order to build with cargo install as below.

On Mac:

brew install protobuf

On Debian/Ubuntu:

apt-get install protobuf-compiler

On Red Hat/Fedora:

dnf install protobuf-compiler

Finally, to install Autoschematic, run:

cargo install autoschematic

There's also an extension available for Visual Studio Code users. We highly recommend this extension if you use Visual Studio Code.

Once you have Autoschematic installed, verify it by running autoschematic at the command line. You should see the standard help listing as below:

Usage: autoschematic <COMMAND>

Commands:
  init      Create an Autoschematic config if not already present
  safety    Set or unset the safety lock file. When set, the safety lock prevents any operations that would modify infrastructure (Executing ConnectorOps or Tasks)
  validate  Validate that the Autoschematic config within this repository is well-formed. Includes autoschematic.lock.ron and autoschematic.rbac.ron if present
  install   Install or upgrade the connectors listed in autoschematic.ron
  seal      Seal a secret against a server's public key
  plan      Display the series of operations needed to apply the changeset
  apply     Execute the series of operations needed to apply the changeset
  unbundle  Unpack bundle files to produce or refresh their children
  run-task  Execute a workflow task as defined by a connector
  import    Import remote resources into the repository
  create    Scaffold new resource definitions from templates
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

These commands will all be covered in guides like this one. Move on to the next section, "Creating a Repo", to continue. Alternatively, you can skip to the in-depth examples if you'd rather dive in.

Up next: Creating a Repo