Solución de problemas de implementación errónea de una oferta de aplicación de Kubernetes

Artículo
04/12/2024

En este artículo se describe cómo solucionar problemas de una implementación errónea de una oferta de aplicación de Kubernetes que se aceptó en microsoft Azure Marketplace. Al iniciar la compra de una oferta de Kubernetes, Azure implementa una plantilla de Azure Resource Manager (plantilla de ARM) que intenta instalar los recursos necesarios para satisfacer la oferta. Sin embargo, la implementación de la plantilla de ARM puede producir un error por varias razones.

Lista de comprobación para la solución de problemas

Examen de los registros de operaciones de implementación

Para determinar la causa del error de implementación, debe examinar los registros de operaciones de implementación. Si sigue viendo la página Error de implementación en el Azure Portal, comience en el paso 5 del procedimiento siguiente. Si, en su lugar, ha salido del Azure Portal o ha navegado a otra página del portal, siga estos pasos:

En el Azure Portal, busque y seleccione Grupos de recursos.
En la lista de grupos de recursos, seleccione el nombre del grupo de recursos en el que intentó implementar la aplicación kubernetes.
En la página Información general del grupo de recursos, busque la sección Essentials y, a continuación, seleccione el texto con hipervínculo que aparece junto al campo Implementaciones. Este texto muestra la tasa de éxito del historial de implementación de recursos del grupo de recursos (por ejemplo, 4 errores, 30 correctos).
En la lista de implementaciones que se han intentado para el grupo de recursos, seleccione el valor Nombre de implementación de la implementación que produjo un error, en función de los siguientes campos correspondientes:
- Última modificación (una marca de tiempo)
- Duración
- Estado (muestra Error en lugar de Correcto)
En la lista Detalles de implementación de la página de implementación, busque el recurso para el que el campo Estado tiene el valor Conflicto. Seleccione el vínculo Detalles de la operación para ese recurso.
En el panel Detalles de la operación, busque la propiedad Status (muestra un valor de Conflict) y examine el cuadro de mensaje Estado debajo de la propiedad .

El código JSON del mensaje de estado muestra una status propiedad de Failed. También muestra una error propiedad que contiene las propiedades secundarias de (un nombre de código de code error, como "ExtensionOperationFailed") y message (una descripción del mensaje de error, como "Error en la operación de extensión con el siguiente error: No se pudo resolver la versión de la extensión a partir de los valores especificados"). El código JSON es similar al texto siguiente:
```
{
    "status": "Failed",
    "error": {
        "code": "ExtensionOperationFailed",
        "message": "The extension operation failed with the following error: Failed to resolve the extension version from the given values."
    }
}
```

En las secciones siguientes se describe la causa y la solución de algunos escenarios de error comunes.

Causa 1: La aplicación no se ha instalado en el clúster de AKS seleccionado

Si la aplicación kubernetes no se insinsó en el clúster de Azure Kubernetes Service (AKS) seleccionado, recibirá un mensaje de error similar al texto siguiente:

No se pudo solicitar https://management.azure.com/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01. Código de error: Prohibido. Motivo: Prohibido.
{  
  "error": {  
    "code": "AuthorizationFailed",  
    "message": "The client '<client-guid>' with object id '<client-guid>' does not have authorization to perform action 'Microsoft.ContainerService/managedclusters/extensionaddons/read' over scope '/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default' or the scope is invalid. If access was recently granted, please refresh your credentials."  
  }  
} 

Solución 1a: Registro del proveedor de recursos Microsoft.KubernetesConfiguration

Registre el proveedor de recursos Microsoft.KubernetesConfiguration. En este caso, se produjo un error en la instalación porque el proveedor de recursos Microsoft.KubernetesConfiguration es necesario para implementar la aplicación Kubernetes. Para obtener instrucciones de registro, consulte la sección "Registrar proveedores de recursos" en el artículo Implementación de una oferta de contenedor desde Azure Marketplace.

Solución 1b: Mantenimiento del estado del clúster de AKS

En general, debe comprobar el estado del clúster de AKS para evitar que se produzcan otros problemas durante el período de instalación. Para asegurarse de que el clúster está en buen estado, resuelva los problemas que se identifican en el clúster.

Solución 1c: Examen del registro de actividad de Azure Monitor

¿Qué ocurre si el clúster está en buen estado, pero la instalación sigue generando errores? En ese caso, examine el registro de actividad de Azure Monitor en el clúster de AKS para buscar la causa del error en esa fase de la instalación.

Causa 2: La suscripción tiene restricciones de recursos

Dado que la suscripción de Azure tiene restricciones de recursos, se produce un error que genera un mensaje de error similar al texto siguiente:

Los instrumentos de pago "desconocidos" no se admiten para la oferta con OfferId: "offer-name>"<, PlanId "<subscription-plan-name>".

Solución 2: Asegúrese de que la suscripción cumple la configuración de facturación necesaria.

Compruebe la configuración de facturación de la suscripción para asegurarse de que cumple los requisitos de recursos de la aplicación Kubernetes. Para obtener más información, consulte Comprobaciones de validación de compra.

Causa 3: La oferta no estaba disponible en su región

Recibe un mensaje de error que indica que la oferta no se puede vender en una región geográfica determinada. El mensaje de error podría ser similar al texto siguiente:

La oferta: "<offer-name>" no se puede comprar por suscripción: "<subscription-guid>" ya que no se va a vender en el mercado: "<two-letter-region-code".

Solución 3: Vuelva a comprobar si la oferta sigue estando disponible y dónde está disponible.

Compruebe que la oferta sigue estando disponible y compruebe las regiones a las que se aplica la oferta.

Causa 4: Error interno del servidor

La aplicación Kubernetes no se ha instalado porque no se ha instalado un recurso de extensión. Este error genera el siguiente mensaje de error:

No se pudo implementar la extensión con un error interno del servidor

Solución 4: Eliminación y reinstalación de la extensión

En primer lugar, elimine el recurso de extensión que forma parte de la compra de la oferta. A continuación, vuelva a instalar la extensión.

Causa 5: El gráfico de Helm no se ha instalado

Los errores del gráfico de Helm generan el siguiente mensaje de error:

Error al instalar el gráfico desde la ruta de acceso [] para la versión

Solución 5: Vuelva a comprobar las entradas que realizó en la plantilla de ARM.

Asegúrese de que los valores y las selecciones que especificó en la Azure Portal para la implementación de plantillas de ARM son aceptables en la aplicación Kubernetes.

Causa 6: No ha aceptado los términos legales de la suscripción para este plan.

Para poder usar la suscripción, debe aceptar los términos legales de la imagen. De lo contrario, recibirá el siguiente mensaje de error:

No ha aceptado los términos legales de esta suscripción: "<subscription-guid>" para este plan. Para poder usar la suscripción, debe aceptar los términos legales de la imagen.

Solución 6: Aceptar los términos legales

Puede implementar a través de la Azure Portal. El Azure Portal proporciona una experiencia de interfaz de usuario para leer y aceptar los términos legales.

Pasos siguientes

Solución de problemas de errores al implementar extensiones de clúster de AKS

Aviso de declinación de responsabilidades sobre la información de terceros

Los productos de otros fabricantes que se mencionan en este artículo han sido creados por compañías independientes de Microsoft. Microsoft no ofrece ninguna garantía, ya sea implícita o de otro tipo, sobre la confiabilidad o el rendimiento de dichos productos.

Ponte en contacto con nosotros para obtener ayuda

Si tiene preguntas o necesita ayuda, cree una solicitud de soporte o busque consejo en la comunidad de Azure. También puede enviar comentarios sobre el producto con los comentarios de la comunidad de Azure.

Compartir a través de