🚀 GitHub Actions Publish Docker Image

GitHub Actions builds and publishes Docker images with multi-platform support and multiple registry authentication.

This workflow automates Docker image builds using Buildx, supports caching, SBOM generation, provenance attestation, and publishing to multiple registries (Docker Hub, GHCR, and private registries).

📦 Features

• 🐳 Build and push Docker images automatically
• 🛸 Multi-platform support (linux/amd64, linux/arm64, etc.)
• 🔐 Multiple registry authentication (Docker Hub, GHCR, private registries)
• 🔖 Automatic tagging (branch, git tag, SHA, semantic versioning, latest)
• ⚡ GitHub Actions cache support for faster builds
• 📄 SBOM (Software Bill of Materials) generation for dependency tracking
• 🛡️ Provenance attestation for supply chain security
• ♻️ Concurrency control to avoid parallel build conflicts

🔧 Configuration

⚙️ Variables

Variable	Description	Example
DOCKER_IMAGES	Docker image name(s)	myorg/myapp
USE_GITHUB_REGISTRY	Enable GHCR publishing	true / false
DOCKER_USERNAME	Docker Hub username	myuser
DOCKER_REGISTRY	Custom registry URL	myregistry.com
DOCKER_REGISTRY_USERNAME	Custom registry username	myuser
	build configuration
DOCKER_PLATFORMS	Target platforms for build	linux/amd64,linux/arm64
BUILDX_CONFIG	BuildKit configuration

🔑 Secrets

Secret	Description
DOCKER_TOKEN	Docker Hub access token
DOCKER_REGISTRY_TOKEN	Custom registry token
GITHUB_TOKEN

🔐 Registry Authentication

🐳 Docker Hub

Used when:

• DOCKER_USERNAME is set
• DOCKER_TOKEN secret is provided

GitHub Container Registry (GHCR)

Automatically generate a Docker image: ghcr.io/repository_owner/repository_name

Enabled when:

• USE_GITHUB_REGISTRY = true

👾 Private registry

Used when:

• DOCKER_REGISTRY is set
• DOCKER_REGISTRY_USERNAME is set
• DOCKER_REGISTRY_TOKEN secret is provided

🛸 Multi-platform builds

Enable multi-platform builds by setting the DOCKER_PLATFORMS environment variable.

This variable defines the list of target platforms used during the build process (e.g. linux/amd64, linux/arm64, linux/riscv64, linux/ppc64le, linux/s390x, etc.).

Example:

DOCKER_PLATFORMS=linux/amd64,linux/arm64

🔨 BuildKit configuration (optional)

Configure Docker BuildKit via BUILDX_CONFIG to customize registry access and build behavior.

Example: This allows you to define registry settings such as enabling plain HTTP or marking a registry as insecure (useful for private or local registries without valid TLS certificates).

[registry."myregistry.com:5000"]
  http = true
  insecure = true

🚀 Workflow Triggers

This workflow runs when:

• push to main or master
• push of any git tag
• pull request to main or master
• manual trigger via GitHub Actions UI

🔖 Automatic Tagging

The workflow generates docker images tags automatically:

• sha-abcdefg (commit hash)
• branch name (main, develop, etc.)
• git tag (v1.0.0)
• pull request (pr-1)
• latest (only on default branch)
• semantic versioning:
  • major (1)
  • major.minor (1.2)
  • version (1.2.3)

🧪 Example Setup

🐳 Docker Hub only

⚙️ Variables & Secret

DOCKER_IMAGES=myorg/myapp
DOCKER_USERNAME=myuser
DOCKER_TOKEN=xxxxxx

📊 Output

docker.io/myorg/myapp

🐳 Docker Hub + GitHub Registry + 👾 Private registry

⚙️ Variables & Secret

DOCKER_IMAGES=
  myorg/myapp
  myregistry.com/myapp
DOCKER_USERNAME=myuser
DOCKER_TOKEN=xxxxxx
USE_GITHUB_REGISTRY=true
DOCKER_REGISTRY=myregistry.com
DOCKER_REGISTRY_USERNAME=myuser
DOCKER_REGISTRY_TOKEN=xxxxxx

📊 Output

docker.io/myorg/myapp
myregistry.com/myapp
ghcr.io/repository_owner/repository_name

♥️ Show your support

Give a ⭐ star if this project helped you !

📎 Contribute

Your contribution is always welcome! Please read contribution guideline for details on our code of conduct, and the process for submitting pull requests to us.

📕 License

This project is licensed under the MIT License - see the LICENSE file for details.