github GitHub Changelog ·

GitHub Actions custom images gain layered build support

infraengineer
feature

GitHub Actions now allows building custom runner images on top of other custom images, enabling layered image workflows. This feature offers teams greater flexibility in managing image-generation pipelines, reducing duplication, and speeding up builds. It also introduces conditional logic for the snapshot keyword, giving more control over image version generation. These enhancements are available now for teams using GitHub-hosted runners with custom images.

  • Layered custom image builds for GitHub Actions runners
  • Conditional logic for snapshotting custom runner images
Features (1)
  • Layered custom image builds for GitHub Actions runners

    GitHub Actions now supports building custom images on top of existing custom images, enabling layered image generation workflows. This allows teams to compose shared base images with common tooling and build upon them with team-specific dependencies, reducing duplication and speeding up builds.

Enhancements (1)
  • Conditional logic for snapshotting custom runner images

    Users can now leverage conditional logic around the snapshot keyword in their GitHub Actions workflows. This provides greater control over when new image versions are generated, offering more flexibility for testing and rollout strategies.

Read the original announcement →

https://github.blog/changelog/2026-06-18-actions-build-custom-images-from-custom-images