Skip to content

dotnet-dev.md

Latest commit

 

History

History
76 lines (57 loc) · 2.47 KB

dotnet-dev.md

File metadata and controls

76 lines (57 loc) · 2.47 KB
Raw

dotnet-dev

Pre-built devcontainer for .NET services — APIs, workers, gRPC services, and background jobs. Works for both human developers and AI coding agents.

What's included

Tool Version Purpose
.NET SDK 10.0 (patch auto-updates) Build, test, publish
Docker-outside-of-Docker latest Build images and run containers via the host Docker socket
kubectl 1.36 Deploy to and inspect Kubernetes clusters
Helm 4.1.4 Install and manage Helm charts
k3d 5.8.3 Local Kubernetes cluster (auto-started on container start)
git latest Source control
GitHub CLI (gh) latest PRs, issues, releases, Actions

VS Code extensions

Extension Purpose
github.copilot AI completions
github.copilot-chat AI chat and inline edits
anthropics.claude-code Claude Code agent
ms-dotnettools.csdevkit C# Dev Kit (solution explorer, test runner)
ms-dotnettools.csharp C# language server, IntelliSense, debugging

Use cases

ASP.NET Core Web API

// .devcontainer/devcontainer.json in your service repo
{
  "name": "my-api",
  "image": "ghcr.io/dever-labs/devcontainers/dotnet-dev:latest",
  "forwardPorts": [8080, 8443],
  "portsAttributes": {
    "8080": { "label": "HTTP" },
    "8443": { "label": "HTTPS" }
  }
}

Worker service with local Kubernetes

A k3d cluster starts automatically when the container starts. You can deploy Helm charts directly against the local cluster:

helm upgrade --install my-worker ./charts/my-worker --namespace dev --create-namespace
kubectl logs -n dev deploy/my-worker -f

Running tests

dotnet test --logger "console;verbosity=detailed"

AI agent use (Copilot coding agent / Claude Code)

No extra configuration needed. The image is wired for agent use out of the box:

  • GITHUB_TOKEN is forwarded from the host so gh and git operations authenticate without prompts.
  • A k3d cluster is ready for agents that need to validate Kubernetes deployments.
  • Claude Code and Copilot extensions are pre-installed for VS Code / Codespaces agent runs.

Updating the .NET version

Edit images/dotnet-dev/devcontainer.json and change the version field:

"ghcr.io/devcontainers/features/dotnet:2": {
  "version": "11.0"   // bump major.minor; patches flow automatically
}

Push to main — CI rebuilds and pushes the new image. All service repos pick it up on next container rebuild.