🦈🏠🐜❗ Initial Commit ❗🐜🦈🏠

2026-06-24 20:01:03 -04:00 · 2026-01-29 19:27:26 -05:00
commit ad74c9c42f
21 changed files with 1499 additions and 0 deletions
@@ -0,0 +1,130 @@
+# GitHub Actions Workflow for Windows Container
+
+This workflow **fully automates** building Windows Server Core containers using GitHub Actions variables.
+
+## 🤖 Fully Automated Setup
+
+### 1. Set Variables (One-time setup)
+
+**Settings → Secrets and variables → Actions → Variables tab → New repository variable**
+
+Add this variable:
+- `DOCKER_USERNAME` - Your Docker Hub username (e.g., `casjaysdevdocker`)
+
+**Settings → Secrets and variables → Actions → Secrets tab → New repository secret**
+
+Add this secret:
+- `DOCKER_PASSWORD` - Your Docker Hub password or access token
+
+### 2. That's It! 🎉
+
+The workflow automatically:
+- ✅ Builds on every push to main/master/develop
+- ✅ Builds monthly (1st of month at 2 AM UTC)
+- ✅ Auto-detects repo name from GitHub
+- ✅ Auto-generates image name: `<username>/<repo-name>`
+- ✅ Auto-creates tags: `latest` and `YYMM` format
+- ✅ Auto-extracts metadata from git
+- ✅ Auto-pushes to Docker Hub (if credentials set)
+- ✅ Creates build summary in Actions tab
+
+## 🏷️ Automatic Image Tags
+
+**Format**: `<DOCKER_USERNAME>/<repo-name>:<tag>`
+
+Examples for January 2026:
+- `casjaysdevdocker/windows:latest`
+- `casjaysdevdocker/windows:2601`
+
+## ⚙️ Automatic Metadata
+
+All OCI labels and annotations automatically include:
+- Build date and time
+- Git commit hash (short)
+- Repository URL from GitHub
+- Docker Hub URL
+- Version (YYMM format)
+
+## 🔄 When Builds Run
+
+1. **On Push** - Any push to main/master/develop branches
+2. **On Pull Request** - Tests build but doesn't push
+3. **Monthly** - Automatic rebuild on 1st of each month at 2 AM UTC
+4. **Manual** - Click "Run workflow" in Actions tab
+
+## 📊 Build Summary
+
+After each successful build, check the Actions tab for:
+- Image name and tags
+- Build date and commit
+- Pull command
+- Image size
+- All metadata labels
+
+## 🚫 No Variables? No Problem!
+
+If `DOCKER_USERNAME` variable is not set:
+- Falls back to repository owner name
+- Example: `owner/windows:latest`
+
+If `DOCKER_PASSWORD` secret is not set:
+- Build and test still run
+- Push step is automatically skipped
+- Perfect for testing or forked repos
+
+## 📝 Example Output
+
+```
+## 📦 Container Build Summary
+
+**Image:** `casjaysdevdocker/windows`
+**Tags:**
+- `latest`
+- `2601`
+
+**Build Date:** 202601231800
+**Commit:** `a1b2c3d`
+
+### 🚀 Pull Command
+```powershell
+docker pull casjaysdevdocker/windows:latest
+```
+
+## 🔧 Advanced: Override Image Name
+
+Want to use a different Docker Hub username? Just set the variable:
+
+**Settings → Secrets and variables → Actions → Variables**
+- `DOCKER_USERNAME` = `yourusername`
+
+Result: `yourusername/windows:latest`
+
+## 🛠️ Troubleshooting
+
+### Build succeeds but doesn't push
+- Check that `DOCKER_PASSWORD` secret is set
+- Verify `DOCKER_USERNAME` variable or repo owner is correct
+- Ensure you're not building from a pull request
+
+### Wrong image name
+- Set `DOCKER_USERNAME` variable to your Docker Hub username
+- Or it defaults to GitHub repo owner
+
+### Need different tags?
+- Edit `.github/workflows/build-windows.yml`
+- Modify the `TAG_YYMM` format in the metadata step
+
+## 📅 Monthly Auto-Build
+
+The workflow includes a cron schedule:
+```yaml
+schedule:
+  - cron: '0 2 1 * *'  # 1st of month at 2 AM UTC
+```
+
+This ensures:
+- Fresh base image updates
+- Latest security patches
+- Regular image rebuilds
+
+To disable: Remove the `schedule:` section from the workflow file.