From 1cdbc7824b4bd4da860e2a019051067b34f5cde1 Mon Sep 17 00:00:00 2001 From: Brett Blue Date: Fri, 24 Apr 2026 16:07:56 -0600 Subject: [PATCH 1/2] [DOCS-11896] Add rolling tag warning for Ingress-NGINX init container Warn users that version tags on the ingress-nginx-injection image are rolling tags and the underlying Datadog NGINX module may update. Suggest using image digests to pin exact versions. --- content/en/tracing/trace_collection/proxy_setup/nginx.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/en/tracing/trace_collection/proxy_setup/nginx.md b/content/en/tracing/trace_collection/proxy_setup/nginx.md index f9e4997c983..a522ec1487c 100644 --- a/content/en/tracing/trace_collection/proxy_setup/nginx.md +++ b/content/en/tracing/trace_collection/proxy_setup/nginx.md @@ -120,6 +120,8 @@ Check your Ingress-NGINX Controller version and ensure you have the matching Dat The init-container version ([datadog/ingress-nginx-injection][1]) must exactly match your controller version to prevent startup issues. For example, if you're running Ingress-NGINX v1.11.3, you need [datadog/ingress-nginx-injection:v1.11.3][2]. +
Version tags like v1.11.3 are rolling tags. The underlying Datadog NGINX module may be updated while the tag stays the same. To pin an exact version, reference the image by its digest (for example, datadog/ingress-nginx-injection@sha256:...).
+ **2. Modify your controller's pod specification**
Update the controller pod specification to include the init-container and configure the Datadog Agent host environment variable: @@ -184,6 +186,8 @@ Check your Ingress-NGINX Controller version and ensure you have the matching Dat The init-container version ([datadog/ingress-nginx-injection][1]) must exactly match your controller version to prevent startup issues. For example, if you're running Ingress-NGINX v1.11.3, you need [datadog/ingress-nginx-injection:v1.11.3][2]. +
Version tags like v1.11.3 are rolling tags. The underlying Datadog NGINX module may be updated while the tag stays the same. To pin an exact version, reference the image by its digest (for example, datadog/ingress-nginx-injection@sha256:...).
+ **2. Overriding Helm chart values**
To customize the Ingress-NGINX Helm chart and load the required Datadog module, create a YAML file or modify an existing one with the following configuration: From ca8a1c8b4f6b8926ede464b816ab26d37df3218c Mon Sep 17 00:00:00 2001 From: Brett Blue <84536271+brett0000FF@users.noreply.github.com> Date: Fri, 24 Apr 2026 17:59:21 -0600 Subject: [PATCH 2/2] Change alert type from warning to info in nginx.md --- content/en/tracing/trace_collection/proxy_setup/nginx.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/tracing/trace_collection/proxy_setup/nginx.md b/content/en/tracing/trace_collection/proxy_setup/nginx.md index a522ec1487c..1799de09bf8 100644 --- a/content/en/tracing/trace_collection/proxy_setup/nginx.md +++ b/content/en/tracing/trace_collection/proxy_setup/nginx.md @@ -120,7 +120,7 @@ Check your Ingress-NGINX Controller version and ensure you have the matching Dat The init-container version ([datadog/ingress-nginx-injection][1]) must exactly match your controller version to prevent startup issues. For example, if you're running Ingress-NGINX v1.11.3, you need [datadog/ingress-nginx-injection:v1.11.3][2]. -
Version tags like v1.11.3 are rolling tags. The underlying Datadog NGINX module may be updated while the tag stays the same. To pin an exact version, reference the image by its digest (for example, datadog/ingress-nginx-injection@sha256:...).
+
Version tags like v1.11.3 are rolling tags. The underlying Datadog NGINX module may be updated while the tag stays the same. To pin an exact version, reference the image by its digest (for example, datadog/ingress-nginx-injection@sha256:...).
**2. Modify your controller's pod specification**
Update the controller pod specification to include the init-container and configure the Datadog Agent host environment variable: @@ -186,7 +186,7 @@ Check your Ingress-NGINX Controller version and ensure you have the matching Dat The init-container version ([datadog/ingress-nginx-injection][1]) must exactly match your controller version to prevent startup issues. For example, if you're running Ingress-NGINX v1.11.3, you need [datadog/ingress-nginx-injection:v1.11.3][2]. -
Version tags like v1.11.3 are rolling tags. The underlying Datadog NGINX module may be updated while the tag stays the same. To pin an exact version, reference the image by its digest (for example, datadog/ingress-nginx-injection@sha256:...).
+
Version tags like v1.11.3 are rolling tags. The underlying Datadog NGINX module may be updated while the tag stays the same. To pin an exact version, reference the image by its digest (for example, datadog/ingress-nginx-injection@sha256:...).
**2. Overriding Helm chart values**
To customize the Ingress-NGINX Helm chart and load the required Datadog module, create a YAML file or modify an existing one with the following configuration: