Azure Kubernetes Service (AKS) como origen de Event Grid

Artículo
06/15/2023

En este artículo se proporcionan las propiedades y los esquemas de los eventos de AKS. También proporciona una lista de inicios rápidos y tutoriales para usar AKS como un origen de eventos. Para ver una introducción a los esquemas de eventos, consulte Esquema de eventos de Azure Event Grid y Esquema de eventos en la nube.

Tipos de eventos disponibles

AKS emite los siguientes tipos de eventos:

Tipo de evento	Descripción
Microsoft.ContainerService.NewKubernetesVersionAvailable	Se desencadena cuando se actualiza la lista de versiones disponibles de Kubernetes.
Microsoft.ContainerService.ClusterSupportEnded	Se desencadena cuando el clúster deja de ser compatible
Microsoft.ContainerService.ClusterSupportEnding	Se desencadena cuando la versión de Kubernetes de los clústeres pronto dejará de ser compatible
Microsoft.ContainerService.NodePoolRollingFailed	Se desencadena cuando se produce un error en NodepoolRolling como resultado de una actualización
Microsoft.ContainerService.NodePoolRollingStarted	Se desencadena cuando NodepoolRolling se inicia como resultado de una actualización
Microsoft.ContainerService.NodePoolRollingSucceeded	Se desencadena cuando NodepoolRolling se ha realizado correctamente como resultado de una actualización

Propiedades comunes para todos los eventos

Esquema de eventos en la nube
Esquema de eventos de Event Grid

Cuando se desencadena un evento, el servicio Event Grid envía datos sobre ese evento al punto de conexión correspondiente. Esta sección contiene un ejemplo del aspecto que deben tener los datos para cada evento. Cada evento tiene los siguientes datos de nivel superior:

Propiedad	Tipo	Description
`source`	string	Ruta de acceso completa a los recursos del origen del evento. En este campo no se puede escribir. Event Grid proporciona este valor.
`subject`	string	Ruta al asunto del evento definida por el anunciante.
`type`	string	Uno de los tipos de eventos registrados para este origen de eventos.
`time`	string	La hora de generación del evento en función de la hora UTC del proveedor.
`id`	string	Identificador único para el evento
`data`	object	Datos de eventos de Blob Storage.
`specversion`	string	Versión de especificación del esquema CloudEvents.

Propiedad	Tipo	Description
`topic`	string	Ruta de acceso completa a los recursos del origen del evento. En este campo no se puede escribir. Event Grid proporciona este valor.
`subject`	string	Ruta al asunto del evento definida por el anunciante.
`eventType`	string	Uno de los tipos de eventos registrados para este origen de eventos.
`eventTime`	string	La hora de generación del evento en función de la hora UTC del proveedor.
`id`	string	Identificador único para el evento
`data`	object	Datos de eventos de Blob Storage.
`dataVersion`	string	Versión del esquema del objeto de datos. El publicador define la versión del esquema.
`metadataVersion`	string	Versión del esquema de los metadatos del evento. Event Grid define el esquema de las propiedades de nivel superior. Event Grid proporciona este valor.

Eventos de ejemplo


{
    "source": "/subscriptions/<id>/resourceGroups<rg>/providers/Microsoft.ContainerService/managedClusters/<cluster>",
    "subject": "<cluster>",
    "type": "Microsoft.ContainerService.NewKubernetesVersionAvailable",
    "id": "1234567890abcdef1234567890abcdef12345678",
    "data": {
      "latestSupportedKubernetesVersion": "1.20.7",
      "latestStableKubernetesVersion": "1.19.11",
      "lowestMinorKubernetesVersion": "1.18.19",
      "latestPreviewKubernetesVersion": "1.21.1"
    },
    "specversion": "1.0",
    "time": "2021-07-01T04:52:57.0000000Z"
}

{
    "topic": "/subscriptions/<id>/resourceGroups<rg>/providers/Microsoft.ContainerService/managedClusters/<cluster>",
    "subject": "<cluster>",
    "eventType": "Microsoft.ContainerService.NewKubernetesVersionAvailable",
    "id": "1234567890abcdef1234567890abcdef12345678",
    "data": {
      "latestSupportedKubernetesVersion": "1.20.7",
      "latestStableKubernetesVersion": "1.19.11",
      "lowestMinorKubernetesVersion": "1.18.19",
      "latestPreviewKubernetesVersion": "1.21.1"
    },
    "dataVersion": "1",
    "metadataVersion": "1",
    "eventTime": "2021-07-01T04:52:57.0000000Z"
}

El objeto de datos contiene las siguientes propiedades:

Propiedad	Tipo	Description
`latestSupportedKubernetesVersion`	string	La versión compatible más reciente de Kubernetes disponible.
`latestStableKubernetesVersion`	string	La versión compatible más reciente y estable de Kubernetes disponible.
`lowestMinorKubernetesVersion`	string	La versión compatible más baja de Kubernetes disponible.
`latestPreviewKubernetesVersion`	string	La versión preliminar más baja de Kubernetes disponible.

Pasos siguientes

Consulte el siguiente tutorial: Inicio rápido: Suscripción a eventos de Azure Kubernetes Service (AKS) con Azure Event Grid.

Compartir a través de