QUICKSTART.md

Quick Start Guide

Get up and running with the DevOps DevContainer in 5 minutes!

Prerequisites

• Docker Desktop running
• VS Code installed
• Dev Containers extension installed

Steps

1. Clone the Repository

git clone https://github.com/dbhq-uk/devcontainer-devops.git
cd devcontainer-devops

2. Open in VS Code

code .

3. Open in Container

When prompted, click "Reopen in Container"

Or manually:

• Press F1 or Ctrl+Shift+P
• Type: Dev Containers: Reopen in Container
• Press Enter

4. Wait for the Pull

The pre-built image is pulled from GHCR, so there is no build to wait for. It is a large image, so the first pull still takes a few minutes.

If you are changing the Dockerfile or an install script, switch .devcontainer/devcontainer.json to the local build first - see CONTRIBUTING.md. A full local build takes considerably longer than a pull.

5. Verify Installation

Once inside the container, run:

validate

This checks all tools are installed correctly.

What's Included?

✅ Terraform & Terragrunt ✅ Azure CLI ✅ Docker & Kubernetes (kubectl, helm) ✅ Ansible ✅ PowerShell 7 ✅ Python 3 with DevOps tools ✅ Security scanners (tflint, checkov) ✅ Data tools (jq, yq)

Common Commands

# Terraform
tf init
tf plan
tf apply

# Azure
az login
az account list

# Kubernetes
k get pods
helm list

# Docker
docker ps
docker images

# Run tests
testall

Next Steps

• Review CONTRIBUTING.md for development guidelines
• Check ARCHITECTURE.md for system design
• Set up pre-commit hooks
• Read VERSION_MANAGEMENT.md to pin tool versions

Troubleshooting

Container won't start

# Rebuild without cache
F1 → Dev Containers: Rebuild Container Without Cache

Tools not found

# Verify PATH
echo $PATH

# Re-source environment
source ~/.bashrc

Permission issues

# Fix workspace permissions
sudo chown -R vscode:vscode /workspace

Need Help?

• Check README.md for full documentation
• Review SECURITY.md for security best practices
• Open an issue on GitHub

Happy coding! 🚀