Dev Container Setup#

DevOps-OS provides a pre-configured VS Code Dev Container that gives you a consistent, multi-language development environment with all CI/CD tools included.

Quick Start#

python -m cli.devopsos scaffold devcontainer \
  --languages python,go \
  --cicd-tools docker,kubectl,helm \
  --kubernetes-tools k9s,argocd_cli,flux
# Output: .devcontainer/devcontainer.json
#         .devcontainer/devcontainer.env.json

Then open VS Code and run “Dev Containers: Reopen in Container” from the Command Palette.

Run python -m cli.devopsos scaffold devcontainer --help to see all available options.

Options#

Option	Default	Description
`--languages LANGS`	`python`	Comma-separated languages: `python`, `java`, `node`, `ruby`, `csharp`, `php`, `rust`, `typescript`, `kotlin`, `c`, `cpp`, `javascript`, `go`
`--cicd-tools TOOLS`	`docker,github_actions`	CI/CD tools: `docker`, `terraform`, `kubectl`, `helm`, `github_actions`, `jenkins`
`--kubernetes-tools TOOLS`	(none)	K8s tools: `k9s`, `kustomize`, `argocd_cli`, `lens`, `kubeseal`, `flux`, `kind`, `minikube`, `openshift_cli`
`--build-tools TOOLS`	(none)	Build tools: `gradle`, `maven`, `ant`, `make`, `cmake`
`--code-analysis TOOLS`	(none)	Analysis tools: `sonarqube`, `checkstyle`, `pmd`, `eslint`, `pylint`
`--devops-tools TOOLS`	(none)	DevOps tools: `nexus`, `prometheus`, `grafana`, `elk`, `jenkins`
`--python-version VER`	`3.11`	Python version
`--java-version VER`	`17`	Java JDK version
`--node-version VER`	`20`	Node.js version
`--go-version VER`	`1.21`	Go version
`--output-dir DIR`	`.`	Root directory; files written to `<dir>/.devcontainer/`

All options can be set via environment variables prefixed DEVOPS_OS_DEVCONTAINER_.

Generated Files#

.devcontainer/
├── devcontainer.json     VS Code dev container configuration
└── devcontainer.env.json Tool / language selection & versions

devcontainer.json contains: build args, VS Code extensions, forwarded ports, and post-create commands.

devcontainer.env.json controls which languages and tools are enabled — it drives the Dockerfile build args.

Full-stack Example#

python -m cli.devopsos scaffold devcontainer \
  --languages python,java,javascript \
  --cicd-tools docker,terraform,kubectl,helm \
  --kubernetes-tools k9s,kustomize,argocd_cli,flux \
  --devops-tools prometheus,grafana \
  --python-version 3.12

This generates a dev container with:

Python 3.12, Java 17, Node.js 20
Docker, Terraform, kubectl, Helm
K9s, Kustomize, ArgoCD CLI, Flux CD
Prometheus (port 9090) and Grafana (port 3000) forwarded

Manual Configuration#

Edit .devcontainer/devcontainer.env.json directly:

{
  "languages": {
    "python": true,
    "java": true,
    "javascript": true,
    "go": false
  },
  "cicd": {
    "docker": true,
    "terraform": true,
    "kubectl": true,
    "helm": true,
    "github_actions": true
  },
  "kubernetes": {
    "k9s": true,
    "kustomize": true,
    "argocd_cli": true,
    "flux": true
  },
  "versions": {
    "python": "3.11",
    "java": "17",
    "node": "20",
    "go": "1.21"
  }
}

After editing, rebuild the container: “Dev Containers: Rebuild Container”.

Using with Existing Projects#

Copy the generated .devcontainer/ directory to your project:

# In the devops_os repo:
python -m cli.devopsos scaffold devcontainer \
  --languages python,go \
  --output-dir /path/to/my-project

# Open your project in VS Code and reopen in container
cd /path/to/my-project
code .

Included Tools (by category)#

Category	Tools
Languages	Python · Java · Node.js · Go · Ruby · C/C++ · Rust
Containers	Docker CLI · Docker Compose
IaC	Terraform · AWS CLI · Azure CLI
Kubernetes	kubectl · Helm · K9s · Kustomize · KinD · Minikube
GitOps	ArgoCD CLI · Flux CD
Observability	Prometheus · Grafana · ELK Stack
Build	Maven · Gradle · npm · pip · Go tools
Code Quality	SonarQube · ESLint · Pylint · CheckStyle

Dev Container