Implementación con infraestructura como código en Azure SRE Agent

Implemente Azure agente de SRE mediante programación mediante plantillas del repositorio microsoft/sre-agent.

Overview

El repositorio microsoft/sre-agent proporciona plantillas iaC listas para producción para implementar Azure agente SRE. Use estas plantillas para:

• Automatización de implementaciones en canalizaciones de CI/CD
• Configuración del agente de control de versiones en Git
• Replicación de agentes entre entornos (de desarrollo a preproducción y a producción)
• Estandarizar la configuración mediante recetas precompiladas

Prerequisites

Permisos de Azure: Propietario de la suscripción o Colaborador + Administrador de acceso de usuario.

Verificación de los requisitos previos:

git clone https://github.com/microsoft/sre-agent.git
cd sre-agent/sreagent-templates
bash bin/check-prerequisites.sh

Inicio rápido

# 1. Generate config from a recipe
./bin/new-agent.sh --recipe azmon-lawappinsights --non-interactive \
  --set agentName=my-agent \
  --set resourceGroup=rg-my-agent \
  --set location=eastus2 \
  --set targetRGs=rg-my-workload \
  -o my-agent/

# 2. Deploy (~3 minutes)
./bin/deploy.sh my-agent/

Después de la implementación, la CLI imprime la dirección URL del portal y el punto de conexión del plano de datos:

Agent (portal):  https://sre.azure.com/#/agent/{sub}/{rg}/my-agent
Data plane:      https://my-agent.eastus2.azuresre.ai

Clonación de un agente existente

./bin/clone-agent.sh \
  --from-agent prod-agent --from-rg rg-prod \
  --set agentName=staging-agent --set resourceGroup=rg-staging \
  -o staging-agent/

Exporta la configuración del agente de origen e implementa en un nuevo nombre y grupo de recursos. Esto es útil para replicar entre entornos.

Recetas

Puntos de partida creados previamente para escenarios comunes, como Azure Monitor respuesta a alertas, administración de incidentes pagerDuty e integración de Dynatrace. Microsoft agrega regularmente nuevas recetas.

Examine las recetas disponibles en el repositorio de plantillas.

# List available recipes
ls recipes/

# Generate config from a recipe
./bin/new-agent.sh --recipe azmon-lawappinsights \
  --set agentName=prod-agent \
  --set resourceGroup=rg-prod-agent \
  --set location=swedencentral \
  -o prod-agent/

Implementación de back-ends

Las plantillas admiten cuatro back-end de implementación. Cada uno usa el mismo directorio de configuración: elija el que se adapte a su entorno:

Todos los backends admiten --what-if / --dry-run para la validación sin desplegar. Para consultar la referencia completa de comandos, opciones y requisitos, consulte el README del repositorio.

Estructura de directorios de configuración

Al ejecutar new-agent.sh, genera un directorio de configuración:

my-agent/
├── agent.json              # Agent identity, model, settings
├── connectors.json         # Data sources (App Insights, Log Analytics, MCP endpoints)
├── connectors.secrets.env  # Secrets — auto-gitignored
├── roles.yaml              # RBAC role assignments
├── config/
│   ├── skills/             # Skill instructions (YAML + markdown)
│   ├── subagents/          # Subagent definitions (YAML + markdown instructions)
│   ├── hooks/              # Safety guardrails (YAML)
│   ├── common-prompts/     # Shared prompt instructions
│   └── repos/              # Code repository connections
├── automations/
│   ├── scheduled-tasks/    # Recurring automated tasks
│   ├── incident-filters/   # Incident routing rules
│   └── incident-platforms/  # Incident platform connections
└── data/
    ├── knowledge/          # Upload docs, runbooks, reference material
    └── synthesized-knowledge/ # Agent's learned context

Edite estos archivos para personalizar el agente antes de la implementación.

¿Qué se implementa?

La implementación se produce en dos fases.

Fase 1: ARM (infraestructura)

Fase 2: Plano de datos (configuración que ARM aún no puede controlar)

Parámetros clave

Al generar una configuración mediante new-agent.sh --set, escriba valores como agentName, resourceGroup, locationy targetRGs. El proceso convierte estos valores en parámetros de implementación para Bicep o Terraform.

Para consultar la lista completa de parámetros, interruptores de funciones y sus valores predeterminados, consulte el README del repositorio.

Operaciones del día 2

Las plantillas incluyen scripts para la administración en curso:

Para consultar los comandos y su uso, consulte el README del repositorio.

Contenido relacionado

• Referencia de API
• Regiones admitidas
• Precios y facturación
• Requisitos de red