Dev Setups

This repository provides a streamlined approach to setting up development environments using Vagrant for provisioning and Ansible for configuration and tooling. It is tailored to support relevant Git repositories and ensure a consistent development setup.

Features

• Automated provisioning with Vagrant.
• Configuration management and tooling setup using Ansible.
• Pre-configured roles for dependencies, development tools, Docker, GitHub CLI, VS Code, and more.

Quick Start

To set up the basic tooling environment, run the following command:

wget --header="Cache-Control: no-cache" -qO- "https://raw.githubusercontent.com/arslan-qamar/devsetups/refs/heads/main/bootstrap.sh?ts=$(date +%s)" | bash -s "main.yml" "localhost," "local" "install" "deps,devbox,docker,githubcli,vscode"

Running Ansible Playbook Against a VM

To run the Ansible playbook directly against a VM (for example, to configure MicroK8s on a remote host), use:

ansible-playbook -i '<vm-name.local | 192.168.0.*>,' -u ubuntu --ssh-common-args="-F $VAGRANT_SSH_CFG " $MAIN_ANSIBLE  --extra-vars "state=present target_hosts=<vm-name.local | 192.168.0.*>" -t="microk8s" -K

Replace <vm-name.local | 192.168.0.*> with your VM's Name or VM's IP address. This command uses the specified SSH config and runs the playbook with the microk8s tag. The -K flag will prompt for the sudo password if needed.

Repository Structure

• bootstrap.sh: Entry point script for setting up the environment.
• roles/: Contains Ansible roles for various tools and configurations.
  • deps/: Handles dependencies.
  • devbox/: Sets up the development box.
  • docker/: Configures Docker.
  • githubcli/: Installs and configures GitHub CLI.
  • vscode/: Sets up Visual Studio Code.
  • zsh/: Configures Zsh shell.
• ubuntu-autoinstall/: Contains files for Ubuntu auto-installation and Vagrant base setup.

How It Works

1. Provisioning: Vagrant is used to create and manage virtual machines.
2. Configuration: Ansible applies configurations and installs necessary tools.

For a comprehensive understanding of how all components work together, see the Codebase Tutorial.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request for any improvements or additional features.

License

This project is licensed under the MIT License. See the LICENSE file for details.