Skip to content

About

Rancher test environments on AWS with automated setup, SSL, and teardown.

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

311 Commits

Folders and files

Repository files navigation

Rancher Runway

A macOS app for creating, testing, and cleaning up disposable Rancher environments.

  • Deploy Rancher on AWS RKE2, hosted/tenant K3s, or Linode Docker.
  • Follow runs, inspect clusters, collect kubeconfigs, and clean up resources.
  • Explore images and Helm charts, run validation tests, and save issue evidence.
  • Use local k3d and Steve labs without provisioning cloud infrastructure.

Install

Requires macOS 12+ and Homebrew. Supports Apple Silicon and Intel.

brew tap hashicorp/tap
brew trust --formula hashicorp/tap/terraform
brew install --cask brudnak/tap/rancher-runway

The install includes Terraform, Helm 4, kubectl, and GitHub CLI. Core setup and cleanup do not require a source checkout, Go, or Node.js.

Open Rancher Runway from Applications. If macOS blocks the first launch, follow the first-launch instructions.

Get started

  1. Open Setup and import a tool-config.yml or fill in the configuration.
  2. Choose your environment and Rancher version, check credentials, and select Resolve & review plan before starting.
  3. Follow progress in Runs and inspect the environment in Clusters.
  4. Use Destroy when finished.

Cloud runs need credentials for the selected provider; Linode Docker also uses AWS Route53 for DNS. See the desktop guide for details.

Destroy live infrastructure before deleting workspace data or using brew uninstall --zap rancher-runway; that data is needed for cleanup.

Develop

Requires Xcode Command Line Tools, Go as specified in go.mod, and Node.js/npm.

make setup            # Build and install the desktop app
make test-regression  # Run local checks without provisioning infrastructure

See the development guide for build targets and architecture.

Documentation

About

Rancher test environments on AWS with automated setup, SSL, and teardown.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages

⌂