Cambiar tu registro de contenedores
Datadog publica imágenes de contenedor en gcr.io de Google, Azure ACR, AWS ECR, y en Docker Hub:
| datadoghq.azurecr.io | dockerhub.io | gcr.io | public.ecr.aws |
|---|
| datadoghq.azurecr.io/agent | datadog/agent | gcr.io/datadoghq/agent | public.ecr.aws/datadog/agent |
| datadoghq.azurecr.io/cluster-agent | datadog/cluster-agent | gcr.io/datadoghq/cluster-agent | public.ecr.aws/datadog/cluster-agent |
| datadoghq.azurecr.io/operator | datadog/operator | gcr.io/datadoghq/operator | public.ecr.aws/datadog/operator |
| datadoghq.azurecr.io/dogstatsd | datadog/dogstatsd | gcr.io/datadoghq/dogstatsd | public.ecr.aws/datadog/dogstatsd |
| datadoghq.azurecr.io/synthetics-private-location-worker | datadog/synthetics-private-location-worker | gcr.io/datadoghq/synthetics-private-location-worker | public.ecr.aws/datadog/synthetics-private-location-worker |
La extracción de registros ACR, GCR o ECR funciona igual (excepto para Notary) que la extracción de Docker Hub. Puedes utilizar el mismo comando (con diferentes parámetros) y obtener la misma imagen.
Nota: ACR, ECR y GCR no son compatibles con Notary. Si estás verificando la firma de imágenes extraídas de Docker, esta función no funciona en GCR o ECR.
Si quieres actualizar tu registro, necesitarás actualizar tus valores de registro según el tipo de entorno de contenedor que estés utilizando para el despliegue.
Nota: También puedes utilizar un registro privado, pero tendrás que crear un secreto pull para poder extraer las imágenes del registro privado.
Para obtener más información sobre cómo crear un secreto pull, consulta la documentación de Kubernetes.
Docker
Actualizar tu registro
Para actualizar tu registro de contenedores, ejecuta el comando pull para el nuevo registro. Para ver los comandos pull de Docker para diferentes registros de contenedores, consulta los ejemplos en la página de información general sobre la documentación de Docker.
Kubernetes con charts de Helm
Para actualizar tu registro de contenedores al desplegar el Datadog Agent (o el Datadog Cluster Agent) con el chart de Helm de Datadog en Kubernetes (incluidos GKE, EKS, AKS y OpenShift) actualiza values.yaml para especificar un registro diferente:
Datadog Helm chart >= v2.7.0
- Actualiza tu
values.yaml:registry: gcr.io/datadoghq
- Elimina todas las anulaciones de
agents.image.repository, clusterAgent.image.repository o clusterChecksRunner.image.repository en el values.yaml.
Charts de Helm v2.7.0 o anterior en Datadog
Cambia el repositorio a gcr.io:
agents:
image:
repository: gcr.io/datadoghq/agent
clusterAgent:
image:
repository: gcr.io/datadoghq/cluster-agent
clusterChecksRunner:
image:
repository: gcr.io/datadoghq/agent
Para obtener más información sobre el uso de charts de Helm en Datadog, consulta la documentación de Kubernetes Datadog y el archivo de ejemplo values.yaml.
Si utilizas un registro privado, deberás añadir un secreto pull en el campo [key].image.pullSecrets de cada imagen.
agents:
image:
pullSecrets:
- name: PrivateRegistrySecret
clusterAgent:
image:
pullSecrets:
- name: PrivateRegistrySecret
clusterChecksRunner:
image:
pullSecrets:
- name: PrivateRegistrySecret
Kubernetes con el Datadog Operator
Para actualizar tu registro durante el despliegue del Datadog Agent (o del Datadog Cluster Agent) con el Datadog Operator:
- Actualiza el archivo del manifiesto del Datadog Agent para sobreescribir el registro por defecto (
gcr.io/datadoghq). Por ejemplo, con public.ecr.aws/datadog:
apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
name: datadog
spec:
global:
registry: gcr.io/datadoghq
// ..
- Elimina todas las anulaciones de los campos
spec.override.nodeAgent.image.name, spec.override.clusterAgent.image.name y spec.override.clusterChecksRunner.image.name. - Si utilizas un registro privado, deberás añadir un secreto pull en el campo
[key].image.pullSecrets de cada imagen.
apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
name: datadog
spec:
override:
nodeAgent:
image:
pullSecrets:
- name: PrivateRegistrySecret
clusterAgent:
image:
pullSecrets:
- name: PrivateRegistrySecret
clusterChecksRunner:
image:
pullSecrets:
- name: PrivateRegistrySecret
// ..
Para obtener más información sobre el Datadog Operator, consulta Desplegar el Agent con el Operator.
Uso de otro registro de contenedores con Helm
También podrías cambiar del registro por defecto gcr.io/datadoghq a otro registro, como datadoghq.azurecr.io al instalar el Operator con el Helm chart:
Actualiza values.yaml con la nueva imagen:
image:
repository: datadoghq.azurecr.io
ECS
Para actualizar tu registro durante el despliegue en ECS, en el archivo datadog-agent-ecs.json cambia el valor de la clave "image" en containerDefinitions por "public.ecr.aws/datadog/agent:latest":
"image": "public.ecr.aws/datadog/agent:latest",
Para obtener más información sobre el despliegue de Datadog en ECS, consulta la documentación de ECS en Datadog y el archivo de ejemplo datadog-agent-ecs.json.
Fargate
Para actualizar tu registro mientras llevas a cabo el despliegue en Fargate, actualiza la imagen en la definición de tareas de Fargate para usar public.ecr.aws:
"image": "public.ecr.aws/datadog/agent:latest"
La próxima vez que se inicie la tarea, la extracción se realizará desde public.ecr.aws en lugar del Docker Hub. Para obtener más información sobre el despliegue en Fargate, consulta Desplegar el Agent en ECS y Desplegar el Agent en EKS.
Agent del clúster
Si estás utilizando el chart de Helm para desplegar el Datadog Agent y el Datadog Cluster Agent, sigue las instrucciones en Kubernetes con charts de Helm y no necesitarás realizar ninguna otra actualización. El cambio de values.yaml de Helm descrito anteriormente cambia el repositorio del que se extraen tanto el Cluster Agent como el Datadog Agent.
Si estás utilizando el Datadog Operator para desplegar el Datadog Cluster Agent, sigue las instrucciones en Kubernetes con el Datadog Operator y no necesitarás realizar ninguna otra actualización. Las instrucciones para actualizar la configuración del Operator actualizan el repositorio del que se extraen tanto el Cluster Agent como el Datadog Agent.
Para obtener más información sobre el Datadog Cluster Agent, consulta la documentación del Cluster Agent, y la documentación para la configuración.
Kubernetes Helm para el worker de localizaciones privadas de Datadog
Para actulaizar tu registro para el worker de localizaciones privadas, actualiza la imagen de datadog/synthetics-private-location-worker a las de public.ecr.aws/datadog/synthetics-private-location-worker o gcr.io/datadoghq/synthetics-private-location-worker.
Para cambiar el repositorio por defecto (gcr.io/datadoghq), actualiza values.yaml con la nueva imagen:
image:
repository: gcr.io/datadoghq/synthetics-private-location-worker