Skip to content

Update Agent registry documentation defaults#36536

Open
AliDatadog wants to merge 7 commits into
masterfrom
codex-update-agent-registry-docs
Open

Update Agent registry documentation defaults#36536
AliDatadog wants to merge 7 commits into
masterfrom
codex-update-agent-registry-docs

Conversation

@AliDatadog
Copy link
Copy Markdown
Contributor

@AliDatadog AliDatadog commented May 7, 2026

What changed

  • Updated English Kubernetes, Cluster Agent, Operator, and related Agent docs to describe how the Datadog Agent Helm chart resolves the Agent image registry from site, cluster type, and registryMigrationMode.
  • Clarified that registryMigrationMode is a Datadog Agent Helm chart setting. As of Datadog Operator chart version 2.19.0, when the Operator chart is installed through the Agent chart dependency, it applies to Agent images managed by the Operator; it is not a setting in the standalone Operator Helm chart.
  • Clarified that the Operator pod image is controlled separately by the Operator chart image.repository value.
  • Replaced stale direct Agent image examples that used gcr.io/datadoghq/agent or implicit Docker Hub references with registry.datadoghq.com/agent where an explicit Datadog registry image is appropriate.
  • Kept AWS-specific examples on public.ecr.aws/datadog/... where the surrounding docs are AWS/ECS/EKS-specific, and kept Docker Hub as the Operator tag-browsing link.

Why

registry.datadoghq.com is the migration target for Agent images, but the resolved Agent image registry can still depend on datadog.site, cluster type, registryMigrationMode, environment exclusions, and explicit registry overrides. The docs should avoid implying a single universal default or implying that registryMigrationMode exists in the standalone Operator Helm chart.

Jira

https://datadoghq.atlassian.net/browse/BARX-1838

Validation

  • git diff --check
  • Targeted rg scan for stale direct Agent/Operator image overrides and oversimplified default-registry wording.

@github-actions github-actions Bot added Architecture Everything related to the Doc backend Guide Content impacting a guide labels May 7, 2026
@AliDatadog AliDatadog marked this pull request as ready for review May 11, 2026 09:07
@AliDatadog AliDatadog requested review from a team as code owners May 11, 2026 09:07
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e22b4e3f34

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/en/containers/guide/changing_container_registry.md Outdated
Comment thread content/en/containers/kubernetes/configuration.md
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6773b49583

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/en/containers/guide/changing_container_registry.md Outdated
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5428a84193

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

## Kubernetes with the Datadog Operator

As of Operator chart version 2.19.0, the Datadog Operator is migrating to `registry.datadoghq.com` for both the operator image and Agent images it manages. Previously, Agent images were pulled from site-specific registries (`gcr.io/datadoghq`, `eu.gcr.io/datadoghq`, `asia.gcr.io/datadoghq`, or `datadoghq.azurecr.io`). To keep using the previous site-specific registries, set `registryMigrationMode: ""` in your Operator Helm `values.yaml`.
As of Datadog Operator chart version 2.19.0, when the Operator is installed through the Datadog Agent Helm chart dependency, the Datadog Agent Helm chart's `registryMigrationMode` can use `registry.datadoghq.com` for Agent images managed by the Operator. Earlier versions pulled Agent images from site-specific registries (`gcr.io/datadoghq`, `eu.gcr.io/datadoghq`, `asia.gcr.io/datadoghq`, or `datadoghq.azurecr.io`). To use the previous site-specific registries for Agent images in this deployment path, set `registryMigrationMode: ""` in your Datadog Agent Helm chart `values.yaml`. This setting has no effect when you explicitly set a registry, and it is not a setting in the standalone Operator Helm chart. To use a different registry for the Operator pod image, set `image.repository` in your Operator Helm `values.yaml`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Document standalone Operator registryMigrationMode

For standalone datadog/datadog-operator installs, this now says registryMigrationMode is not an Operator chart setting, but the current standalone Operator chart values list registryMigrationMode (default auto) and use it to add Agent registry override environment variables unless global.registry is set. Users following this section to keep Agent images on the previous site-specific registries with a standalone Operator install would skip the actual registryMigrationMode: "" knob and unexpectedly migrate managed Agent image pulls to registry.datadoghq.com.

Useful? React with 👍 / 👎.

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

Labels

Architecture Everything related to the Doc backend Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants