github-actions-container-build

Build multi-architecture container images in GitHub Actions with Podman.

5|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/pigfoot/claude-code-hubs --skill github-actions-container-build
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-actions-container-build
Source: https://github.com/pigfoot/claude-code-hubs/tree/main/plugins/github-actions-container-build/skills/github-actions-container-build
Command: npx skills add https://github.com/pigfoot/claude-code-hubs --skill github-actions-container-build

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill automates multi-architecture container image builds in GitHub Actions using Podman, with a push-by-digest workflow that keeps registries clean and enables native ARM64 builds for public repos.

Core Features & Use Cases

  • Workflow templates: matrix-based builds for public repos using native ARM64 runners
  • Private repos: QEMU-based builds or ARM64 larger runners for private teams
  • Podman rootless builds and “push by digest” artifact flow
  • Registry integration: GHCR by default, with optional Docker Hub workflows
  • Practical guidance and templates in the assets folder

Quick Start

Copy and customize the provided workflow templates from assets/github-actions-workflow-matrix-build.yml (for public repos) or assets/github-actions-workflow-qemu.yml (for private/repos on free tier). Then commit these to your repository and trigger a workflow.

Frequently Asked Questions about github-actions-container-build

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

FAQPage Schema
How do I build multi-architecture container images in GitHub Actions?

Multi-architecture container image builds in GitHub Actions use matrix workflows with native ARM64 runners for public repos or QEMU emulation for private repos. Podman executes platform-aware builds with --platform flags, creating separate digests per architecture that are combined into OCI-compatible manifests for registry push.

Can I use Podman for rootless container builds in GitHub Actions workflows?

Yes. Podman supports rootless builds natively in GitHub Actions. The Skill provides workflow templates that implement rootless Podman with push-by-digest artifact flow, keeping registries clean while maintaining security and compatibility across public and private repository scenarios.

What's the difference between building on native ARM64 runners versus QEMU emulation?

Native ARM64 runners execute ARM64 builds directly on hardware, offering faster builds but available only on public repositories. QEMU emulation runs on x86 runners via software translation, slower but accessible on private repos and free-tier accounts, with trade-offs in build time versus accessibility.

How do I push container images by digest in GitHub Actions?

Push-by-digest workflow captures individual architecture digests during Podman builds, stores them as artifacts, then creates and pushes a manifest that references those digests to the registry. This approach prevents intermediate layers from cluttering the registry and enables clean multi-arch image organization.

Does this work with Docker Hub or only GitHub Container Registry?

The Skill defaults to GitHub Container Registry (GHCR) but includes optional workflow templates for Docker Hub integration. Both registries support OCI-compatible manifests and push-by-digest workflows, with template customization enabling registry selection based on your deployment requirements.