documentation an some refactoring, release alpha

.devcontainer/devops-dev/devcontainer.json

@@ -1,12 +1,22 @@
-// For format details, see https://aka.ms/devcontainer.json. For config options, see the
-// README at: https://github.com/devcontainers/templates/tree/main/src/ubuntu
+// ⚠️ Temporary / Testing Only ⚠️
+// -----------------------------------------------------------------------------
+// This devcontainer.json is provided solely for local testing and experimentation.
+// It is NOT the canonical configuration for DevOps projects.
+// 
+// ✅ The single source of truth lives in:
+//    - README.md (usage instructions)
+//    - /devops/templates/devcontainer.json (baseline template)
+// 
+// Always consult those files before making changes. This file may diverge,
+// and should never be treated as the authoritative definition.
+// -----------------------------------------------------------------------------
 {
 	"build": {
-		"dockerfile": "Dockerfile",        
-		"context": "."                   
+		"dockerfile": "../../devops/Dockerfile",        
+		"context": "../../devops"                   
 	},
 	"remoteUser": "vscode",
-	"name": "devops",
+	"name": "devops-devs",
 	"runArgs": [
 		"--hostname=devops"
 	],
@@ -20,7 +30,10 @@
 				"yzhang.markdown-all-in-one",
 				"davidanson.vscode-markdownlint",
 				"eamodio.gitlens",
-				"m4ns0ur.base64"
+				"m4ns0ur.base64",
+				"rogalmic.bash-debug",
+				"streetsidesoftware.code-spell-checker",
+				"ms-azuretools.vscode-containers"
 			]
 		}
 	}

.devcontainer/devops/Dockerfile

@@ -1,62 +0,0 @@
-FROM mcr.microsoft.com/devcontainers/base:jammy
-
-
-ENV DEBIAN_FRONTEND=noninteractive
-
-# Base packages
-RUN apt-get update && apt-get install -y \
-    curl \
-    wget \
-    git \
-    python3 \
-    python3-pip \
-    jq \
-    ca-certificates \
-    software-properties-common \
-    ansible \
-    rclone \
-    rsync \
-    && rm -rf /var/lib/apt/lists/*
-
-
-
-# --- Install kubectl ---
-RUN curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" \
-    && install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl \
-    && rm kubectl
-
-# --- Install Helm ---
-RUN curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
-
-# --- Install yq ---
-RUN wget https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 \
-    -O /usr/bin/yq && chmod +x /usr/bin/yq
-
-# -- install chroma for zsh
-RUN curl -s https://api.github.com/repos/alecthomas/chroma/releases/latest \
-    | grep "browser_download_url.*linux-amd64.*tar.gz" \
-    | cut -d '"' -f 4 \
-    | wget -O /tmp/chroma.tar.gz -i - \
-    && tar -xzf /tmp/chroma.tar.gz -C /usr/local/bin \
-    && chmod +x /usr/local/bin/chroma \
-
-    # --- Install act (GitHub Actions local runner) ---
-RUN curl -s https://api.github.com/repos/nektos/act/releases/latest \
-    |  grep "browser_download_url.*linux-amd64.*tar.gz" \
-    | cut -d '"' -f 4 \
-    | wget -O /usr/local/bin/act -i - \
-    && chmod +x /usr/local/bin/act
-
-
-# --- set zsh shell ---
-RUN chsh -s /usr/bin/zsh vscode
-
-RUN git clone https://github.com/zdharma-continuum/fast-syntax-highlighting.git /home/vscode/.oh-my-zsh/custom/plugins/fast-syntax-highlighting
-RUN git clone https://github.com/zsh-users/zsh-autosuggestions /home/vscode/.oh-my-zsh/custom/plugins/zsh-autosuggestions
-
-COPY ./assets/.zshrc /home/vscode
-
-# ACT_RUNNER_VERSION=0.2.13
-# curl -sSL https://dl.gitea.com/act_runner/${ACT_RUNNER_VERSION}/act_runner-${ACT_RUNNER_VERSION}-linux-amd64 \
-#   -o /usr/local/bin/act_runner
-# chmod +x /usr/local/bin/act_runner