Enhancement: Update devcontainer configuration with essential packages and SSH setup

Signed-off-by: Ihor Dvoretskyi <ihor@linux.com>

Author: idvoretskyi

.devcontainer/Dockerfile

@@ -1,13 +1,20 @@
 FROM mcr.microsoft.com/devcontainers/base:ubuntu-24.04
 
-# Install additional packages if needed
+# Install essential packages
 RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
     && apt-get -y install --no-install-recommends \
         curl \
         wget \
         jq \
         build-essential \
+        openssh-server \
     && apt-get clean -y \
     && rm -rf /var/lib/apt/lists/*
 
-# Set up additional configuration if needed
+# Set up SSH directory
+RUN mkdir -p /run/sshd
+
+# Create the directory structure for the SSH keys
+RUN mkdir -p /home/vscode/.ssh && \
+    chown -R vscode:vscode /home/vscode/.ssh && \
+    chmod 700 /home/vscode/.ssh

.devcontainer/devcontainer.json

@@ -1,6 +1,8 @@
 {
     "name": "Generic Development Environment",
-    "image": "mcr.microsoft.com/devcontainers/base:ubuntu-24.04",
+    "dockerComposeFile": "docker-compose.yml",
+    "service": "app",
+    "workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
     "features": {
         "ghcr.io/devcontainers/features/common-utils:2": {
             "installZsh": true,
@@ -48,7 +50,7 @@
         }
     },
     "forwardPorts": [22],
-    "postCreateCommand": "sudo apt-get clean && sudo rm -rf /var/lib/apt/lists/* && echo '🚀 Development environment ready! Docker, Kubernetes (Minikube), and SSH are configured.' && sudo service ssh start",
+    "postCreateCommand": "echo '🚀 Development environment ready! Docker, Kubernetes (Minikube), and SSH are configured.' && sudo service ssh start",
     "postStartCommand": "sudo service ssh restart",
     "remoteUser": "vscode"
 }

.devcontainer/docker-compose.yml

@@ -7,5 +7,12 @@ services:
       dockerfile: Dockerfile
     volumes:
       - ../..:/workspaces:cached
+      - vscode:/vscode:cached
+    ports:
+      - "22:22"
     command: sleep infinity
-    # Add any additional environment variables, ports, or services as needed
+    environment:
+      - DOCKER_HOST=unix:///var/run/docker.sock
+
+volumes:
+  vscode:

CLAUDE.md

@@ -0,0 +1,52 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Repository Overview
+
+This is a generic GitHub Codespace/devcontainer template repository that provides a standardized development environment. The repository focuses on devcontainer configuration rather than specific application code.
+
+## Architecture
+
+- **Base Environment**: Ubuntu 24.04 via Microsoft devcontainer base image
+- **Container Configuration**: Uses Docker Compose with devcontainer.json for proper service orchestration
+- **Tool Stack**: Pre-configured with Docker-in-Docker, Kubernetes (kubectl, helm, minikube), Git, GitHub CLI, and SSH
+- **User Dotfiles**: Integrates with idvoretskyi/dotfiles repository for personalized shell configuration
+- **SSH Access**: Pre-configured SSH server with proper directory structure for remote development
+
+## Key Components
+
+- `.devcontainer/devcontainer.json`: Main devcontainer configuration using Docker Compose with features, VS Code extensions, and settings
+- `.devcontainer/Dockerfile`: Custom Ubuntu image with essential development packages (curl, wget, jq, build-essential, openssh-server)
+- `.devcontainer/docker-compose.yml`: Container orchestration with volume mounts and SSH port forwarding
+
+## Common Commands
+
+### Development Environment
+The environment includes these pre-configured tools:
+- Docker and Docker Compose (via docker-in-docker)
+- Kubernetes tools: kubectl, helm, minikube
+- GitHub CLI (gh)
+- SSH server (automatically started on port 22)
+
+## VS Code Configuration
+
+Pre-installed extensions:
+- Docker support (ms-azuretools.vscode-docker)
+- GitHub Copilot and Copilot Chat
+- YAML support (redhat.vscode-yaml)  
+- Kubernetes tools (ms-kubernetes-tools.vscode-kubernetes-tools)
+
+Editor settings enforce:
+- Format on save
+- 80/120 character rulers
+- Zsh as default terminal
+- Trailing whitespace trimming
+- Bracket pair colorization
+
+## Environment Customization
+
+To customize this template:
+- Modify `.devcontainer/devcontainer.json` for VS Code extensions/settings
+- Edit `.devcontainer/Dockerfile` for additional system packages
+- Update `.devcontainer/docker-compose.yml` for additional services