Configures devcontainer for function development in codespaces

Sets up the devcontainer for efficient Azure Functions development by:

- Adds Azurite for local storage emulation.
- Exposes necessary ports (7071, 10000, 10001, 10002).
- Installs Azure Functions Core Tools v4 via npm.
- Includes Azure Developer CLI (azd).
- Incorporates Mechanical-Markdown for documentation validation.
- Installs Powershell 7.x

This streamlines the development process and provides a consistent environment.

Author: thegovind

.devcontainer/Dockerfile

@@ -1,27 +1,33 @@
+# Snippy Functions – Dev Container image
 FROM mcr.microsoft.com/vscode/devcontainers/universal:latest
 
-# Copy custom first notice message.
+# ──────────────────────────────────────────────────────────────
+# 1 – First‑run welcome notice
 COPY first-run-notice.txt /tmp/staging/
-RUN sudo mv -f /tmp/staging/first-run-notice.txt /usr/local/etc/vscode-dev-containers/ \
+RUN sudo mv -f /tmp/staging/first-run-notice.txt \
+        /usr/local/etc/vscode-dev-containers/ \
     && sudo rm -rf /tmp/staging
 
-# Install PowerShell 7.x
+# ──────────────────────────────────────────────────────────────
+# 2 – PowerShell 7.x
 RUN sudo apt-get update \
-    && sudo apt-get install -y wget apt-transport-https software-properties-common \
-    && wget -q https://packages.microsoft.com/config/ubuntu/$(. /etc/os-release && echo $VERSION_ID)/packages-microsoft-prod.deb \
-    && sudo dpkg -i packages-microsoft-prod.deb \
-    && sudo apt-get update \
-    && sudo apt-get install -y powershell
+ && sudo apt-get install -y wget apt-transport-https software-properties-common \
+ && wget -q https://packages.microsoft.com/config/ubuntu/$(. /etc/os-release && echo $VERSION_ID)/packages-microsoft-prod.deb \
+ && sudo dpkg -i packages-microsoft-prod.deb \
+ && sudo apt-get update \
+ && sudo apt-get install -y powershell \
+ && sudo apt-get clean \
+ && rm -rf /var/lib/apt/lists/*
 
-# Install Azure Functions Core Tools
-RUN curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg \
-    && sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg \
-    && sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-$(lsb_release -cs)-prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list' \
-    && sudo apt-get update \
-    && sudo apt-get install -y azure-functions-core-tools-4
+# ──────────────────────────────────────────────────────────────
+# 3 – Azure Functions Core Tools v4
+# Using npm ensures the latest build and works on any distro.
+RUN npm install -g azure-functions-core-tools@4 --unsafe-perm
 
-# Install Azure Developer CLI
+# ──────────────────────────────────────────────────────────────
+# 4 – Azure Developer CLI
 RUN curl -fsSL https://aka.ms/install-azd.sh | bash
 
-# Install mechanical-markdown for quickstart validations
-RUN pip install mechanical-markdown
+# ──────────────────────────────────────────────────────────────
+# 5 – Mechanical‑Markdown (quick‑start doc validation)
+RUN pip install --no-cache-dir mechanical-markdown

.devcontainer/devcontainer.json

@@ -1,38 +1,46 @@
 {
   "name": "Snippy Functions Codespace",
   "dockerFile": "Dockerfile",
+
+  // ── Features ────────────────────────────────────────────────────────────
   "features": {
     "ghcr.io/devcontainers/features/azure-cli:1": {},
     "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {},
-    "ghcr.io/devcontainers/features/node:1": {
-      "version": "lts"
-    }
+    "ghcr.io/devcontainers/features/node:1": { "version": "lts" },
+
+    // Starts Azurite (blob/queue/table) automatically on container boot
+    "ghcr.io/devcontainers/features/azurite:1": {}
   },
-  "forwardPorts": [
-    7071
-  ],
+
+  // ── Port forwards ───────────────────────────────────────────────────────
+  "forwardPorts": [7071, 10000, 10001, 10002],
+
+  // ── Lifecycle commands ──────────────────────────────────────────────────
   "postCreateCommand": "./.devcontainer/setup.sh",
-  "postStartCommand": "bash .devcontainer/start.sh",
+  "postStartCommand":  "bash .devcontainer/start.sh",
+
+  // ── VS Code customisation ───────────────────────────────────────────────
   "customizations": {
     "vscode": {
       "extensions": [
         "ms-azuretools.vscode-azurefunctions",
         "ms-azuretools.vscode-docker",
         "GitHub.copilot",
-        "Azurite.azurite"
+        "Azurite.azurite" // UI & table explorer
       ]
     }
   },
+
+  // ── Misc ────────────────────────────────────────────────────────────────
   "mounts": [
     "source=codespaces-linux-var-lib-docker,target=/var/lib/docker,type=volume"
   ],
   "overrideCommand": false,
   "remoteUser": "codespace",
   "runArgs": [
     "--cap-add=SYS_PTRACE",
-    "--security-opt",
-    "seccomp=unconfined",
+    "--security-opt", "seccomp=unconfined",
     "--init",
     "--privileged"
   ]
-}
+}