dynatrace/dynatrace-configuration-as-code

Dynatrace Configuration as Code 镜像文档

1. 镜像概述

本容器镜像是Dynatrace配置即代码工具Monaco的容器化版本，旨在简化Monaco CLI在CI/CD流水线中的集成与使用。Monaco（Monitoring as Code）工具从监控即代码CLI演进而来，提供可观测性与安全即代码能力，支持全自动化配置Dynatrace平台，覆盖从标准化配置所有Dynatrace环境到满足单个环境特定需求的全场景。

2. 核心功能与特性

• CI/CD原生集成：作为构建容器直接集成到CI/CD流水线，内部预装Monaco CLI，可直接通过monaco命令调用
• 命令参数透传：运行容器时的命令行参数将直接传递给内部Monaco CLI，使用方式与原生CLI一致
• 简化部署流程：无需手动安装Monaco CLI依赖，通过容器化方式实现环境一致性
• 完整功能支持：与官方Monaco CLI功能完全一致，支持所有配置自动化操作

3. 使用场景与适用范围

• Dynatrace环境标准化配置：通过CI/CD流水线自动化部署标准化配置到多个Dynatrace环境
• 环境特定配置管理：针对单个Dynatrace环境的定制化配置需求自动化实现
• 配置版本控制与审计：结合代码仓库实现配置变更的版本控制与审计追踪
• 多环境配置同步：跨开发、测试、生产等多环境的配置同步与一致性维护

4. 使用方法与配置说明

4.1 基本使用方式

容器镜像的使用方式与原生Monaco CLI一致，命令行参数通过容器运行命令直接传递给内部Monaco CLI。

4.1.1 检查Monaco版本

bash
docker run --rm dynatrace/configuration-as-code:latest monaco --version

4.1.2 部署配置示例

假设本地存在Monaco配置文件目录./configs，部署到目标环境：

bash
docker run --rm -v $(pwd)/configs:/workspace dynatrace/configuration-as-code:latest deploy -e /workspace/environments.yaml /workspace/projects

4.2 CI/CD流水线集成

在CI/CD流水线中，可将本镜像作为构建容器，直接通过monaco命令执行配置操作。

示例：GitLab CI配置片段

yaml
deploy-dynatrace-config:
  image: dynatrace/configuration-as-code:latest
  script:
    - monaco deploy -e environments.yaml projects/
  only:
    - main

4.3 详细使用文档

关于Monaco CLI的完整使用方法（如配置文件格式、命令参数等），请参考官方文档。

5. 支持信息

5.1 支持范围

Monaco 2.0及以上版本由Dynatrace支持团队提供官方支持。

5.2 获取支持

支持服务详情及联系方式请参考Dynatrace支持页面。

6. 其他配置工具

除Monaco外，Dynatrace还提供Terraform Provider作为配置即代码的另一种实现方式，适用于已采用Terraform的用户场景。

6.1 Dynatrace Terraform Provider

• GitHub仓库：https://github.com/dynatrace-oss/terraform-provider-dynatrace
• Terraform Registry：registry.terraform.io/providers/dynatrace-oss/dynatrace

推荐场景：已使用Terraform或计划采用Terraform进行基础设施即代码管理的用户，建议优先使用Terraform Provider。

7. 补充资源

• Monaco CLI下载：可从https://github.com/Dynatrace/dynatrace-configuration-as-code/releases%E8%8E%B7%E5%8F%96CLI%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E5%8F%8A%E8%BD%AF%E4%BB%B6%E7%89%A9%E6%96%99%E6%B8%85%E5%8D%95%EF%BC%88SBOM%EF%BC%89
• Monaco学习资源：Monaco 2.0相关教程可参考Observability Clinic on Monaco 2.0