Instalar runbooks dinámicos

Además de runbooks predefinidos, la función Sistema de diagnóstico online (ODS) también admite runbooks dinámicos para depurar NSX en tiempo de ejecución.

Los runbooks dinámicos no dependen de la versión de NSX y se pueden instalar en cualquier momento. Los runbooks dinámicos solucionan los siguientes problemas:

Dado que el desarrollo y el mantenimiento de runbooks predefinidos siguen el ciclo de versión de NSX, evita la depuración de problemas que surgen en sitios activos entre ciclos de versión. Con runbooks dinámicos, cualquier requisito de depuración se puede implementar entre ciclos de versiones, ya que los runbooks dinámicos se pueden desarrollar e instalar en cualquier momento.
Si actualiza NSX parcialmente, podría haber una incompatibilidad entre un runbook y la API que lo llama. Por ejemplo, suponga que actualiza el nodo de transporte sin actualizar Unified Appliance (UA), y la actualización instala una nueva versión del runbook en el nodo de transporte. En este caso, es posible que UA no pueda invocar la versión más reciente del runbook con la API anterior, ya que la API podría estar desactualizada.

Solo el equipo de VMware puede crear runbooks dinámicos que usted podrá descargar e instalar en su sistema. Tenga en cuenta que los runbooks no admiten la copia de seguridad ni la restauración de datos.

Para instalar los runbooks dinámicos, debe definir un grupo llamado instancia de runbook dinámico. La instancia de runbook dinámico define todos los grupos de nodos de instalación en los que se instalarán runbooks. Si se agrega un nuevo nodo a un grupo, el runbook se instalará automáticamente en el nuevo nodo.

Con NSX 4.2, el siguiente runbook está disponible para su descarga. Para obtener más información sobre el runbook, descargue el paquete del sitio de VMware https://support.broadcom.com/group/ecx/downloads.

Tabla 1.
Runbook	Descripción
Runbook de HyperBus	El runbook de HyperBus dinámico puede comprobar los siguientes problemas de HyperBus y ofrecer sugerencias de corrección: Conexión de hyperbus Configuraciones de la conexión de HyperBus vmknic Estado de conexión de hyperbus Este runbook toma vif-id como el argumento de entrada.

Para instalar runbooks dinámicos, realice los siguientes pasos:

Requisitos previos

Descargue el paquete dinámico del sitio de VMware https://support.broadcom.com/group/ecx/downloads.

Procedimiento

Obtenga la ruta de los nodos de transporte que se incluirán en el grupo de nodos de instalación.
GET https://10.180.85.179/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes

Cree el grupo de nodos de instalación. El grupo puede ser un grupo de directivas, un grupo de nodos de transporte o un grupo de nodos de UA.

PATCH https://<nsx-mgr>/policy/api/v1/infra/domains/default/groups/<group-name>

{
    "expression": 
   [
        {
            "paths": [
                "/infra/sites/default/enforcement-points/default/host-transport-nodes/TN1"
            ],
            "resource_type": "PathExpression"
        }
    ],
    "extended_expression": [],
    "reference": false,
    "group_type": [],
    "resource_type": "Group"
}

Cree una instancia dinámica de runbook que incluya todos los grupos de nodos de instalación.

POST https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>

{
    "applied_to_group_paths": [
        "/infra/domains/default/groups/TNGroup1"  [Policy Group with node path]
    ],
    "applied_to_nodes": [
        "1e6314a2-a268-4a3a-bcae-4f23b2536ea8"  [The node id can be a host/edge/UA node id]
    ],
    "applied_to_all_appliances": true   [All UA cluster]
}

Cargue el paquete de runbook en la instancia de runbook dinámico.
POST https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>/file

Los datos de runbook dinámicos se aplican a los nodos de destino especificados en este grupo.

Consulte el estado de instalación.

GET https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>/state

{
    "runbook_name": "Example",
    "management_state": "INSTALL_FINISHED",
    "install_state": [
        {
            "node_id": "084583fa-3ae7-4d0c-98f1-6fc4cb5044b1",
            "node_name": "TN301",
            "version": {
                "major": 1,
                "minor": 0
            },
            "status": "INSTALL_FINISHED"
        }
}

Compruebe los detalles de los runbooks instalados mediante la siguiente API.
GET https://{{MANAGER_IP}}/policy/api/v1/infra/sha/dynamic-runbooks
Invoque el runbook mediante los pasos mencionados en el tema Depurar NSX en tiempo de ejecución.

Qué hacer a continuación

Para extender una instancia de runbook dinámico a nodos adicionales, ejecute la siguiente API.

PATCH https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>

{
"applied_to_group_paths":["/infra/domains/default/groups/<tn-group-name>"],
"applied_to_nodes":["<target-edge-id>","<target-ua-id>"]
}

Para desinstalar un runbook, ejecute la siguiente API.

DELETE https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>/file

Para desinstalar una instancia de runbook dinámico, ejecute la siguiente API.

DELETE https://10.180.85.179/policy/api/v1/infra/sha/dynamic-runbook-instances/<dynamic-instanace-id>