Descripción general

Las reversiones de Network Configuration Management (NCM) le permiten restaurar un dispositivo de red a una configuración anterior directamente desde Datadog. Las reversiones utilizan un Private Action Runner (PAR) para aplicar la configuración seleccionada de nuevo al dispositivo.

Las reversiones son compatibles con los siguientes proveedores y plataformas:

  • Cisco IOS
  • Arista (EOS)

Requisitos previos

  • Network Configuration Management debe estar configurado para sus dispositivos.
  • El Datadog Agent debe estar en la versión 7.83.0 o posterior.
  • Un Private Action Runner al que el puerto IPC del Agent (predeterminado 5001) pueda acceder, ya sea en el mismo servidor o a través de la red.

Configuración

Agent

  1. Agregue lo siguiente a su datadog.yaml para habilitar las reversiones:

    network_devices:
      config_management:
        rollback:
          enabled: true
    

    Alternativamente, configure la opción de configuración network_devices.config_management.rollback.enabled en true.

  2. En conf.d/network_config_management.d/conf.yaml, configure opcionalmente con qué frecuencia el Agent informa su inventario de configuración:

    init_config:
      ## @param inventory_report_max_interval - integer - optional - default: 3600 (1 hour)
      ## Maximum interval, in seconds, between inventory reports.
      inventory_report_max_interval: 3600
    
  3. Opcionalmente, configure el almacenamiento local que contiene las configuraciones elegibles para la reversión:

    init_config:
      store:
        ## @param min_configs_per_device - integer - optional - default: 2
        ## Minimum number of configurations to retain per device, regardless of age.
        min_configs_per_device: 2
        ## @param max_configs_per_device - integer - optional - default: 24
        ## Maximum number of configurations to retain per device before older ones are evicted.
        max_configs_per_device: 24
        ## @param max_raw_config_store_bytes - integer - optional - default: 2000000000 (2 GB)
        ## Maximum size, in bytes, of the local configuration store before older configurations are evicted.
        max_raw_config_store_bytes: 2000000000
    
  4. El proceso del Agent necesita acceso de escritura al directorio run_path donde se almacenan los datos de reversión localmente.

  5. Reinicie el Agent para aplicar los cambios de configuración.

Private Action Runner

  1. Set up a Private Action Runner en un servidor al que el puerto IPC del Agent pueda acceder.

  2. Agregue com.datadoghq.remoteaction.networkconfigmanagement.rollbackConfig a la sección private_action_runner.actions_allowlist de /etc/datadog-agent/datadog.yaml. Consulte Cambiar la lista de permitidos de un runner para obtener más detalles.

  3. Registre el runner en Datadog y asígnelo a un grupo de ejecución. Dentro de ese grupo, cree una política que permita la acción com.datadoghq.remoteaction.networkconfigmanagement.rollbackConfig.

    • La política debe otorgar acceso Editor a los usuarios con el rol NCM Device Config Write.
    Captura de pantalla que muestra cómo agregar el rol NCM Write a una política de grupo de ejecución

Permisos

Los rollbacks utilizan los siguientes permisos de NCM:

PermisoPermite
NCM ReadVer configuraciones de dispositivos
NCM WriteActivar un rollback

Activar un rollback

  1. Navegue a la pestaña Configuración de un dispositivo en la vista de dispositivos de NDM.

  2. Seleccione la versión de configuración a la que desea volver. El panel lateral muestra un botón Rollback para esa versión.

  3. Haga clic en Rollback, revise la diferencia en el modal de confirmación.

  4. Haga clic en Rollback nuevamente para confirmar.

    Captura de pantalla que muestra cuándo se ha iniciado una reversión y qué esperar

Lecturas adicionales

Documentación, enlaces y artículos útiles adicionales: