Improve GHCR asset publishing and expand trigger events to include `pull_request` by desrosj · Pull Request #78211 · WordPress/gutenberg

desrosj · 2026-05-12T17:57:55Z

What?

Expands the publish-to-container-registry job in build-plugin-zip.yml to run on more event types, and publishes a second, mutable tag alongside the existing SHA tag.

Previously the job ran only on push to trunk, release/**, and wp/**. It now also runs on:

workflow_dispatch
pull_request — only when the head branch lives in WordPress/gutenberg (fork PRs are explicitly excluded via github.event.pull_request.head.repo.full_name == github.repository)

Every successful publish now produces two tags pointing at the same OCI manifest (added via oras tag, so no duplicated blob storage):

Trigger	SHA tag (immutable)	Mutable tag
`push` to `trunk`	`<github.sha>`	`trunk`
`push` to `release/X.Y`	`<github.sha>`	`release-X.Y`
`push` to `wp/X.Y`	`<github.sha>`	`wp-X.Y`
`workflow_dispatch`	`<github.sha>`	matches branch
`pull_request` (internal branch)	`<pull_request.head.sha>`	`pr-<N>`

The SHA tag scheme is unchanged so that https://github.com/WordPress/wordpress-develop/ and any other downstream that pins to gutenberg.sha continues to work without modification.

See WordPress/wordpress-develop#11809 as a companion PR that would add support for this in wordpress-develop.

Why?

There is currently no way to test unmerged changes in the Gutenberg repository in the context of https://github.com/WordPress/wordpress-develop/.

By publishing assets for pull requests, this is now possible. The mutable tag also gives contributors a stable "latest of stream" reference that doesn't require frequent updating of the pinned SHA on every new build. This is especially useful when working on a pull request to ensure the latest changes are present.

How?

This adjusts the workflow logic and makes changes to how the image is tagged through ORAS.

Use of AI Tools

AI assistance: Yes
Tool(s): Claude Code
Model(s): Opus 4.7
Used for: Analysis and initial draft patch.

github-actions · 2026-05-12T17:58:08Z

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message.

Co-authored-by: desrosj <desrosj@git.wordpress.org>
Co-authored-by: westonruter <westonruter@git.wordpress.org>

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

westonruter · 2026-05-12T18:12:12Z

+            # Add a mutable tag alongside the SHA tag so developers can pull "the latest build for this stream"
+            # (e.g. :trunk, :pr-12345, :release-19.5) without needing to update a pinned SHA.
+            - name: Add mutable tag for the built plugin
+              env:
+                  SOURCE_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+                  MUTABLE_TAG: ${{ steps.mutable_tag.outputs.value }}
+              run: |
+                  oras tag "ghcr.io/wordpress/gutenberg/gutenberg-wp-develop-build:${SOURCE_SHA}" "${MUTABLE_TAG}"


So would the MUTABLE_TAG be usable in gutenberg.sha in the wordpress-develop package.json?

That's right! I've created WordPress/wordpress-develop#11809 to show how I picture this working from a consumer standpoint.

Co-Authored-By: Weston Ruter <134745+westonruter@users.noreply.github.com>

Copilot

Pull request overview

Updates the build-plugin-zip.yml workflow to publish the wordpress-develop build artifact to GHCR for additional event types (including internal PRs), and to add a mutable “stream” tag alongside the existing immutable SHA tag so downstream consumers can reference “latest for X”.

Changes:

Expand publish-to-container-registry to run on workflow_dispatch and internal pull_request events (excluding fork PRs).
Use ORAS to push the artifact under a SHA-based tag and then add a second mutable tag derived from branch name or PR number.
Record a SOURCE_SHA value in .gutenberg-hash and OCI annotations for PR runs (using the PR head SHA instead of the ephemeral merge SHA).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

westonruter

Thank you so much for this!

desrosj · 2026-05-15T04:47:46Z

I'm going to merge this once the tests pass to give it a shot! I will commit WordPress/wordpress-develop#11809 tomorrow.

…ull_request` (#78211) (#78324) * Publish assets for pull requests and add mutable tags. * Remove unnecessary environment variable. Co-authored-by: westonruter <westonruter@git.wordpress.org>

Publish assets for pull requests and add mutable tags.

39a8dfc

desrosj self-assigned this May 12, 2026

westonruter reviewed May 12, 2026

View reviewed changes

Remove unnecessary environment variable.

f1350f4

Co-Authored-By: Weston Ruter <134745+westonruter@users.noreply.github.com>

desrosj requested a review from Copilot May 12, 2026 18:37

desrosj added [Type] Build Tooling Issues or PRs related to build tooling GitHub Actions Pull requests that update GitHub Actions code labels May 12, 2026

Copilot started reviewing on behalf of desrosj May 12, 2026 18:38 View session

desrosj mentioned this pull request May 12, 2026

Output container details in the workflow summary #78207

Open

desrosj added the props-bot Manually triggers Props Bot to ensure the list of props is up to date. label May 12, 2026

github-actions Bot removed the props-bot Manually triggers Props Bot to ensure the list of props is up to date. label May 12, 2026

Copilot AI reviewed May 12, 2026

View reviewed changes

Comment thread .github/workflows/build-plugin-zip.yml

westonruter approved these changes May 12, 2026

View reviewed changes

Merge branch 'trunk' into add/publishing-built-assets-for-prs

1d0ce34

desrosj added the props-bot Manually triggers Props Bot to ensure the list of props is up to date. label May 15, 2026

github-actions Bot removed the props-bot Manually triggers Props Bot to ensure the list of props is up to date. label May 15, 2026

desrosj enabled auto-merge (squash) May 15, 2026 04:47

desrosj merged commit 123cebb into trunk May 15, 2026
44 checks passed

desrosj deleted the add/publishing-built-assets-for-prs branch May 15, 2026 05:16

github-actions Bot added this to the Gutenberg 23.3 milestone May 15, 2026

desrosj added the Backport to WP 7.0 Beta/RC Pull request that needs to be backported to the WordPress major release that's currently in beta label May 15, 2026

desrosj mentioned this pull request May 15, 2026

Manual cherry-pick of #78211: Improve GHCR asset publishing and expand trigger events to include pull_request #78324

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Improve GHCR asset publishing and expand trigger events to include `pull_request`#78211

Improve GHCR asset publishing and expand trigger events to include `pull_request`#78211
desrosj merged 3 commits into
trunkfrom
add/publishing-built-assets-for-prs

desrosj commented May 12, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented May 12, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

westonruter May 12, 2026

Uh oh!

desrosj May 12, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

westonruter left a comment

Uh oh!

desrosj commented May 15, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

desrosj commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What?

Why?

How?

Use of AI Tools

Uh oh!

github-actions Bot commented May 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

westonruter May 12, 2026

Choose a reason for hiding this comment

Uh oh!

desrosj May 12, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

westonruter left a comment

Choose a reason for hiding this comment

Uh oh!

desrosj commented May 15, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

desrosj commented May 12, 2026 •

edited

Loading

github-actions Bot commented May 12, 2026 •

edited

Loading