Windows Docker Image with GitHub Actions

This repository demonstrates how to build Windows Docker images using GitHub Actions - perfect for developers who need to create Windows containers without access to a Windows machine.

🚀 Quick Start

Fork this repository
Set up Docker Hub secrets in your GitHub repository:
- DOCKERHUB_USERNAME
- DOCKERHUB_TOKEN
Push to main branch or create a tag to trigger the build

📦 What's Inside

Simple Python Flask web application
Windows-based Dockerfile
GitHub Actions workflow for automated builds
Example of Windows container best practices

🛠️ The Application

A simple Flask web application that displays:

Container hostname
Python version
Operating system information

🐋 Building Locally (Windows Only)

If you have a Windows machine with Docker Desktop:

# Build the image
docker build -t windows-python-app .

# Run the container
docker run -p 80:80 windows-python-app

Visit http://localhost to see the app running.

🔄 GitHub Actions Workflow

This repository uses GitHub Actions to automatically:

Build the Windows Docker image
Push to Docker Hub (on main branch pushes and tags)
Handle versioning and tagging

📁 Repository Structure

.
├── .github/
│   └── workflows/
│       └── build.yaml
├── app.py
├── requirements.txt
├── Dockerfile
└── README.md

🏗️ Dockerfile Explanation

The Dockerfile:

Uses Windows Server Core as base image
Installs Python in a Windows environment
Sets up the application
Configures the container for web access

🔑 Setting Up Secrets

Go to your repository Settings
Navigate to Secrets and Variables → Actions
Add required secrets:
- DOCKERHUB_USERNAME: Your Docker Hub username
- DOCKERHUB_TOKEN: Your Docker Hub access token

bobbyiliev/windows-docker-image-build