dev-machine

Provide your team with a minimally-invasive, local-only way to get things setup and keep things in sync.

Platforms

Package managers and Docker/Compose are installed if not present.

OS

Tested Version

Packages

Docker

macOS

12.5.1

brew

Docker Desktop

Ubuntu

22.04 LTS

apt

docker-ce

Windows

11

choco

Docker Desktop

Implementation

The heart of dev-machine is Ansible via Docker run for/against the local machine. To get there across platforms we start with scripts that run package managers that install Docker which then runs Ansible.

After getting started your team will have a Git repository you can customize with dev-machine core setup as a sub-tree. The README and other documention in your repository is written for end users.

Developer machines will have a dev-machine command that can check and update their machine against the team’s repository. Developer machines will never be automatically updated and all changes require confirmation.

Development

To contribute, check out the development overview.