Módulo 1 — Configuración como código SaaS: ¿Monaco o Terraform?

Configuración como código SaaS: versionar la configuración de Dynatrace, Monaco o Terraform, manifiesto y autenticación, con ejercicio y cuestionario.
Module 1 — Configuration as code SaaS : Monaco ou Terraform ?

Este primer módulo de la formación Monaco SaaS sienta las bases de la configuración como código SaaS: describir la configuración de un entorno Dynatrace SaaS en archivos versionados en lugar de introducirla a mano en la interfaz, y entender dónde encaja cada herramienta (Monaco o el provider de Terraform).

Ruta: Monaco SaaS · Módulo 1 · Duración: ~35 min · Nivel: Principiante

Objetivos:

  • Explicar el interés de describir la configuración en archivos
  • Situar Monaco y el provider de Terraform, y saber cuál elegir
  • Leer un manifiesto de Monaco y una configuración de Monaco
  • Identificar los métodos de autenticación de un entorno SaaS

Requisitos previos: un entorno Dynatrace SaaS (la prueba gratuita basta), nociones de Git y de YAML. Esta ruta trata únicamente de Dynatrace SaaS.

¿Por qué la configuración como código SaaS?

La documentación oficial presenta la configuración como código como un enfoque declarativo: se configura Dynatrace «sin tener que parametrizarlo todo en la interfaz». Los archivos se pueden versionar, reutilizar, compartir y sincronizar entre entornos.

Para un equipo SRE, de ahí se derivan tres beneficios:

  • Reproducibilidad: el entorno de preproducción y el de producción reciben la misma definición, y por tanto las mismas alertas.
  • Trazabilidad: cada cambio pasa por un commit y una revisión. Una alerta modificada por error se localiza y se revierte en pocos minutos, lo que reduce el MTTR.
  • Menos toil: una regla escrita una vez se despliega en diez entornos sin copiar pantallas.

El principio sigue siendo simple: el repositorio Git se convierte en la fuente de verdad y la herramienta aplica esa descripción al entorno.

Dos herramientas: Monaco y el provider de Terraform

La documentación de Dynatrace menciona dos herramientas. Monaco es una herramienta de línea de comandos publicada por Dynatrace, autónoma, que trabaja con JSON nativo. El provider de Terraform (dynatrace-oss/dynatrace) se usa con Terraform, herramienta que la página describe como la referencia del sector para la configuración como código.

Criterio Monaco Provider de Terraform
Naturaleza CLI de Dynatrace autónoma Provider para Terraform
Formato YAML (manifiesto, configuraciones) y plantillas JSON HCL
Recomendado si Terraform no se puede o no se quiere usar Terraform ya está implantado, varios proveedores en un mismo espacio, estado externo, expresiones HCL

Según la documentación, se recomienda Terraform cuando el equipo ya lo conoce; Monaco es la alternativa en caso contrario. El artículo Monaco o Terraform para la configuración de Dynatrace detalla esta elección. Esta ruta enseña Monaco (módulos 1 a 5); Terraform se trata en una formación aparte.

Anatomía de una configuración de Monaco

La documentación describe tres piezas: un manifiesto de despliegue, proyectos y configuraciones. El manifiesto indica qué proyectos (carpetas de archivos) van a qué entornos de destino. Cada configuración asocia un archivo YAML (nombre, parámetros, dependencias) y una plantilla JSON que contiene la carga útil de la API con marcadores para los parámetros.

Este es un manifiesto basado en las claves documentadas, con valores de ejemplo:

Archivo manifest.yaml para la configuración como código SaaS: manifestVersion, proyecto alerting, entorno dev y tokens leídos desde variables de entorno

Conviene fijarse en tres puntos:

  • manifestVersion vale 1.0, versión de manifiesto admitida por el repositorio del proyecto;
  • la URL y los tokens nunca aparecen en claro: name designa el nombre de la variable de entorno que contiene el secreto, no el secreto en sí;
  • si una variable referenciada falta o está vacía, Monaco se niega a cargar el manifiesto (código fuente del repositorio, manifest_loader.go).

Una configuración, por su parte, vive en un archivo config.yaml. Este extracto procede de los juegos de prueba del repositorio oficial (licencia Apache 2.0):

Archivo config.yaml del repositorio de Monaco: dos objetos Settings, builtin:alerting.profile y builtin:management-zones, enlazados por una referencia

La referencia [ builtin:management-zones, zone, id ] crea una dependencia: Monaco despliega primero la zona y después el perfil que usa su identificador. El módulo 4 vuelve sobre ello.

Autenticarse en un entorno SaaS

La elección de la autenticación depende de las API a las que se apunta. Según la documentación de Monaco:

  • token: token de API clásico, para las API de configuración;
  • platformToken u oAuth: para las API de la plataforma (workflows, documentos, buckets de Grail);
  • un token se puede combinar con un platformToken o con un cliente OAuth, pero platformToken y oAuth no se definen juntos para un mismo entorno;
  • según la documentación, la sintaxis platformToken se admite a partir de Monaco 2.24.0.

Los ámbitos (scopes) necesarios dependen de los tipos de recursos gestionados. En el ejemplo oficial dedicado a los SLO, el token de plataforma pide slo:slos:read, slo:slos:write y slo:objective-templates:read. El módulo 2 trata la creación del token y la lista de ámbitos.

El provider de Terraform lee su configuración de variables de entorno. Su documentación indica DYNATRACE_ENV_URL (para un SaaS: https://########.live.dynatrace.com), DYNATRACE_PLATFORM_TOKEN para un token de plataforma, y DT_CLIENT_ID, DT_CLIENT_SECRET, DT_ACCOUNT_ID para OAuth:

Bloque required_providers del provider de Terraform dynatrace-oss/dynatrace y variables de entorno DYNATRACE_ENV_URL, DYNATRACE_PLATFORM_TOKEN y DYNATRACE_HTTP_OAUTH_PREFERENCE

Esta documentación señala dos límites: no todos los recursos admiten OAuth, y un token de plataforma no sirve ni para la API de gestión de cuenta (IAM) ni para los recursos clásicos.

Los comandos que hay que conocer

Monaco expone en particular cuatro comandos (referencia oficial de comandos):

  • monaco deploy aplica un manifiesto; opciones --dry-run, --environment, --group, --project;
  • monaco download exporta una configuración existente (módulo 3);
  • monaco delete elimina las configuraciones listadas en un archivo de eliminación (módulo 5);
  • monaco generate produce archivos auxiliares: archivo de eliminación, grafo, esquema.

El --dry-run valida la estructura del manifiesto, de los proyectos y de las configuraciones, sin conectarse a Dynatrace. No valida el contenido de los JSON: un error HTTP 400 sigue siendo posible en el despliegue real.

Ejercicio práctico

Este ejercicio se hace en un entorno SaaS de prueba. Los comandos siguientes no se han ejecutado para este artículo: el resultado esperado describe el comportamiento documentado, no una salida copiada.

Paso 1 — Crear el repositorio

Crea un repositorio Git vacío con una carpeta alerting/ y un archivo manifest.yaml inspirado en la imagen 1 (URL y tokens en variables de entorno). Resultado esperado: ningún secreto en el repositorio.

Paso 2 — Escribir una primera configuración

Añade en alerting/ un config.yaml y una plantilla JSON, guiándote por la estructura de la imagen 2 y por la documentación del esquema Settings elegido. Resultado esperado: un identificador (id), un tipo y una plantilla por configuración.

Paso 3 — Definir las variables y validar

Exporta DT_ENV_URL, DT_API_TOKEN y PLATFORM_TOKEN con los valores de tu entorno y ejecuta monaco deploy manifest.yaml --dry-run. Resultado esperado: validación de la estructura sin llamar a Dynatrace; una variable ausente hace fallar la carga del manifiesto.

Paso 4 — Elegir la herramienta

Anota en tres líneas por qué tu equipo elegiría Monaco o Terraform, según la tabla anterior. Resultado esperado: un criterio de decisión escrito, para releer en el módulo 8.

Cuestionario

  1. En un manifiesto de Monaco, ¿qué contiene name bajo token? a) El token b) El nombre de una variable de entorno c) La URL del entorno d) El nombre del proyecto
  2. ¿Se pueden definir platformToken y oAuth para un mismo entorno? a) Sí, siempre b) No c) Solo con --dry-run d) Solo con Terraform
  3. El --dry-run de Monaco: a) despliega en modo de prueba b) valida la estructura sin conectarse a Dynatrace c) valida el contenido de los JSON ante la API d) elimina las configuraciones
  4. La documentación recomienda Terraform cuando: a) el equipo ya lo usa b) no se conoce Git c) se quiere evitar YAML d) nunca

Respuestas

  1. b) El secreto queda fuera del repositorio: solo figura el nombre de la variable.
  2. b) Un token se combina con uno u otro, pero no con los dos a la vez.
  3. b) Un error HTTP 400 sigue siendo posible en el despliegue real.
  4. a) Terraform conviene sobre todo a los equipos que ya lo usan para su infraestructura.

Para ir más lejos

← Índice de la ruta · Módulo 2: Instalación de Monaco para Dynatrace SaaS →

Preguntas frecuentes

¿Hay que aprender también Terraform?

No. Una sola herramienta basta para gestionar un ámbito de configuración. Este curso cubre Monaco; si tu equipo prefiere Terraform, existe un curso de Terraform aparte.

¿Dónde guardar los secretos?

Nunca en el repositorio. Monaco lee los secretos de variables de entorno, y el provider de Terraform también recomienda las variables de entorno. En un pipeline, proceden del almacén de secretos de la herramienta de CI.

¿Esta ruta sirve para Dynatrace Managed?

No. Los tokens de plataforma, OAuth y la plataforma de tercera generación son propios de Dynatrace SaaS. Existe una ruta distinta para Managed.

Ya sabes qué cubre la configuración como código SaaS, cómo se componen un manifiesto y una configuración, y qué autenticaciones existen. El módulo siguiente instala Monaco y prepara el manifiesto de tu entorno.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Esta ruta no sustituye a las formaciones y certificaciones oficiales de Dynatrace University. Comprueba siempre las funcionalidades en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Module 1 — Configuration as code Managed : Settings 2.0 et Monaco

Módulo 1 — Configuración como código en Managed: Settings 2.0 y Monaco

Next Post
Module 2 — Installation Monaco Managed : binaire, manifeste et jeton

Módulo 2 — Instalación de Monaco Managed: binario, manifiesto y token

Related Posts