Initial commit of devcontainer build in GitHub Actions

Signed-off-by: David Stenglein <[email protected]>

Author: David Stenglein

.github/workflows/build-and-publish.yml

@@ -0,0 +1,55 @@
+name: Build and Publish Devcontainer
+
+on:
+  push:
+    branches: [ main ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install devcontainer CLI
+        run: npm install -g @devcontainers/cli
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=ref,event=branch
+            type=ref,event=pr
+            type=sha
+            latest
+
+      - name: Build and push container image
+        run: |
+          devcontainer build --workspace-folder . --image-name ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }} --push

README.md

@@ -1,2 +1,64 @@
 # devcontainer-python-node-claude
-Repo for a common build of a devcontainer
+
+A reusable development container (devcontainer) with Python 3.12, Node.js, and additional tools pre-installed. This container is built and published to GitHub Container Registry (ghcr.io) for easy reuse across projects.
+
+## Features
+
+This devcontainer includes:
+
+- Python 3.12 (Bullseye)
+- Node.js
+- Poetry (Python dependency management)
+- GitHub CLI
+- Docker-outside-of-Docker support
+- Pack CLI (Buildpacks)
+- SQLite
+
+## How It's Built and Published
+
+This devcontainer is automatically built and published to GitHub Container Registry using GitHub Actions. The workflow:
+
+1. Triggers on pushes to the main branch, tag creation, and pull requests
+2. Uses the devcontainer CLI to build the container
+3. Publishes the container to GitHub Container Registry (ghcr.io)
+
+## How to Use
+
+### In a GitHub Codespace or VS Code
+
+1. Create a `.devcontainer/devcontainer.json` file in your project with:
+
+```json
+{
+  "image": "ghcr.io/YOUR-USERNAME/devcontainer-python-node-claude:latest",
+  "forwardPorts": [],
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        // Add your preferred extensions here
+      ]
+    }
+  }
+}
+```
+
+Replace `YOUR-USERNAME` with your GitHub username.
+
+### Available Tags
+
+The container is published with several tags for flexible versioning:
+
+- `latest`: The most recent build from the main branch
+- `vX.Y.Z`: Specific version (when tagged with a semantic version)
+- `vX.Y`: Major.Minor version
+- `vX`: Major version only
+- `main`: Latest build from the main branch
+- `sha-XXXXXXX`: Specific commit SHA
+
+## Development
+
+To modify this devcontainer:
+
+1. Update the `devcontainer.json` file with your desired changes
+2. Push to the main branch or create a pull request
+3. The GitHub Actions workflow will automatically build and publish the updated container

devcontainer.json

@@ -0,0 +1,57 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/python
+{
+	"name": "Python 3",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+	"features": {
+		"ghcr.io/devcontainers-extra/features/bash-command:1": {
+			"command": "(curl -sSL \"https://github.com/buildpacks/pack/releases/download/v0.37.0/pack-v0.37.0-linux.tgz\" | sudo tar -C /usr/local/bin/ --no-same-owner -xzv pack)"
+		},
+		"ghcr.io/devcontainers/features/docker-outside-of-docker": {
+			"version": "latest",
+		},
+		"ghcr.io/devcontainers-extra/features/poetry": {
+			"version": "1.8.2",
+			
+		},
+		"ghcr.io/devcontainers/features/github-cli:1": {
+			"installDirectlyFromGitHubRelease": true,
+			"version": "latest"
+		},
+    	"ghcr.io/devcontainers/features/node:1": {},
+        "ghcr.io/warrenbuckley/codespace-features/sqlite:latest": {}
+
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"RooVeterinaryInc.roo-cline",
+				"bierner.markdown-mermaid"
+			]
+		}
+	},
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "pip3 install --user -r requirements.txt",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	"remoteEnv": {
+		"GITHUB_PERSONAL_ACCESS_TOKEN": "${localEnv:GITHUB_PERSONAL_ACCESS_TOKEN}",
+	},
+
+	//  "runArgs" : [
+	// 		"--network="
+	//  ]
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}