rak-phillip/dorm

dorm is a command-line tool that spins up a fresh, testable instance of Rancher on DigitalOcean, preloaded with a custom version of the Rancher dashboard. It is designed for developers who need a quick, disposable environment to test changes they are making to the Rancher dashboard without having to manually configure servers. At a high level, the tool talks to DigitalOcean's API and creates a new virtual server (called a Droplet) for you. You provide a few key pieces of information: your DigitalOcean access token, the fingerprint of your SSH key, the specific GitHub repository URL of the dashboard fork you want to test, and the target branch. Once you run the command, the tool takes about 10 minutes to build everything. When it finishes, you get an IP address where you can access your running Rancher instance. The setup process uses cloud-init, a standard tool for customizing cloud servers, and you can SSH into the server to view the build logs if needed. The primary audience for this project is developers actively working on the Rancher dashboard. For example, if a developer forks the dashboard repository to try out a new feature or fix a bug, they can use this tool to instantly deploy an environment running their specific changes. It removes the friction of setting up infrastructure, letting them focus purely on testing their code in a realistic environment. To use the tool, you need a supported version of Go installed on your machine. It also supports configuration through environment variables, so you can save your DigitalOcean credentials locally rather than passing them in every time you run a command.