Docker image publishing

Automate multi-arch Docker image publishing to GHCR via GitHub Actions.

147|5|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/rcarmo/agentbox --skill docker-image-publishing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Docker image publishing
Source: https://github.com/rcarmo/agentbox/tree/main/skel/.github/skills/docker
Command: npx skills add https://github.com/rcarmo/agentbox --skill docker-image-publishing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publishing and distributing multi-architecture Docker images to GHCR via GitHub Actions is complex and error-prone; this Skill provides a repeatable pattern to simplify and automate the process.

Core Features & Use Cases

  • Automates multi-arch image builds using docker buildx and pushes to GHCR.
  • Leverages GitHub Actions workflows to publish per-tag releases and maintain image manifests.
  • Use Case: when releasing a new version, trigger a workflow that builds amd64 and arm64 images and updates the GHCR manifest.

Quick Start

Tag a release to trigger the multi-arch publish workflow and publish images to GHCR.

Frequently Asked Questions about Docker image publishing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish multi-arch Docker images to GHCR using GitHub Actions?

Publish multi-arch Docker images to GHCR by automating builds with Docker Buildx in GitHub Actions workflows, generating per-architecture manifests, and pushing the combined image to the GitHub Container Registry upon release.

What is the best way to automate tag-based releases for Docker images in CI?

Automating tag-based releases for Docker images in CI involves leveraging the docker/metadata-action to extract semantic version tags, triggering GitHub Actions workflows on new tags, and building the images with Docker Buildx before pushing to GHCR.

Do I need Docker Buildx to build amd64 and arm64 images for GitHub Container Registry?

Docker Buildx is required to build amd64 and arm64 images for GitHub Container Registry, as it provides the necessary build capabilities to construct per-architecture image manifests and simplify multi-arch publishing workflows.

Can I use GitHub Actions workflows to maintain per-architecture Docker image manifests?

GitHub Actions workflows can maintain per-architecture Docker image manifests by orchestrating Docker Buildx builds for multiple architectures like amd64 and arm64, then consolidating and pushing the final multi-arch manifest to GHCR.

Why does publishing multi-architecture Docker images via GitHub Actions require semantic tagging?

Semantic tagging is required when publishing multi-architecture Docker images via GitHub Actions because the docker/metadata-action uses semantic versioning to correctly label and organize per-tag releases and image manifests in GHCR.

What are the limitations of using GitHub Actions for multi-arch Docker image builds?

Multi-arch Docker image builds via GitHub Actions are limited by their complexity and error-prone nature without a repeatable pattern, requiring precise configuration of Docker Buildx, docker/metadata-action, and workflow triggers to successfully publish to GHCR.