Windows Development Environment

This describes how to setup a Windows development environment using the Windows Subsystem for Linux (WSL) and Ubuntu.

This repo contains Ansible scripts to provision Ubuntu in the WSL.

Development tools

Install the following development tools manually.

• Visual Studio Code
• Windows terminal
• WSL
• Git for Windows

A list of recommended Visual Studio Code extensions will be offered when this repository is open in Visual Studio Code.

Setup

Clone this repo in the WSL.

You will need to install some pre-requisites prior to running the provisioning scripts.

./setup.sh

Then you can run the provision command.

make provision

This will:

• Setup zsh and oh-my-zsh for terminal
• Perform an apt update and upgrade
• Install the following:
  • curl
  • zip
  • jq
  • yq
  • Node.js LTS
  • Go
  • Rush
  • pip and venv
  • ngrok
  • tmpreaper
  • Java Runtime Environment from OpenJDK
  • QDirStat
  • AWS CDK CLI
  • AWS CLI
  • AWS SAM CLI
  • Azure CLI
  • Liquibase CLI
  • cowsay (very important)

Note: GitHub CLI is currently disabled in provisioning because the upstream repository does not provide Release files for Ubuntu 24.04 (noble). You can install it manually with:

curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg && \
sudo apt update && sudo apt install gh

Once the repository supports noble, you can re-enable it by uncommenting gh.yml in ansible/roles/wsl/tasks/main.yml.

Follow these tutorials to configure the CLI tools.

• AWS CLI

Update

The provision command can also be used to update all the above packages.

make provision