Skip to content

feat: add global.imageRegistry support - #968

Open
katieg12345 wants to merge 1 commit into
temporalio:mainfrom
katieg12345:feat/global-image-registry
Open

feat: add global.imageRegistry support#968
katieg12345 wants to merge 1 commit into
temporalio:mainfrom
katieg12345:feat/global-image-registry

Conversation

@katieg12345

@katieg12345 katieg12345 commented Aug 10, 2026

Copy link
Copy Markdown

What was changed

This PR adds support for configuring a global image registry via:

global:
  imageRegistry: <registry>

When set, this value is used as a prefix for all Temporal chart container images.
When unset/empty, image rendering remains unchanged from current behavior.

Why?

Today, using a private/mirrored registry requires overriding multiple repositories separately, which is repetitive and error-prone.
A global registry setting is a common Helm pattern and simplifies installation, especially for air-gapped/private registry environments/dependency-chart use-cases where we'd want one registry override in one place
This change is backward-compatible and non-breaking:

if global.imageRegistry is not set, behavior is exactly as before.

Checklist

  1. Closes [Feature Request] Support global.imageRegistry in temporal chart #967

  2. How was this tested:
    Helm unit tests:
    helm unittest charts/temporal
    Result: all suites pass (15/15), all tests pass (188/188)
    Render checks with valid chart values:
    Without global.imageRegistry: images render as current defaults (temporalio/...)
    With global.imageRegistry=registry.example.com: all chart images render with registry.example.com/ prefix

  3. Any docs updates needed?

values.yaml was updated to include and describe global.imageRegistry.
A README values table update could be added as a follow-up.

When we want to use a different registry than Docker Hub we currently
have to override each image repository individually:

```yaml
server:
  image:
    repository: registry.example.com/temporalio/server
admintools:
  image:
    repository: registry.example.com/temporalio/admin-tools
web:
  image:
    repository: registry.example.com/temporalio/ui
```

This requires duplicating the registry in multiple places. This change
adds a global registry setting so the same result is achieved with:

```yaml
global:
  imageRegistry: registry.example.com
```

This becomes especially useful when the Temporal chart is used as a
dependency in another chart. When all sub-charts honour
global.imageRegistry the installer only has to set the registry once.

This change is non-breaking and backwards compatible. If
global.imageRegistry is not set the chart behaves exactly as before.
@katieg12345
katieg12345 requested a review from a team as a code owner August 10, 2026 13:13
@CLAassistant

CLAassistant commented Aug 10, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request] Support global.imageRegistry in temporal chart

4 participants