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

En este artículo se describe cómo solucionar errores en la implementación 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, es posible que se produzca un error en la implementación de la plantilla de ARM por diversos motivos.

Lista de comprobación de 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 Azure Portal, comience en el paso 5 del procedimiento siguiente. Si, en su lugar, salió de Azure Portal o ha navegado a otra página del portal, siga estos pasos:

1. En Azure Portal, busque la opción Grupos de recursos y selecciónela.

2. En la lista de grupos de recursos, seleccione el nombre del grupo de recursos en el que intentó implementar la aplicación de Kubernetes.

3. 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 con errores, 30 correctos).

4. En la lista de implementaciones intentadas 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)
   • Duration
   • Estado (muestra Failed en lugar de Succeeded)

5. En la lista Detalles de implementación de la página de implementación, busque el recurso para el que el campo Estado tiene un valor de Conflicto. Seleccione el vínculo Detalles de la operación para ese recurso.

   

6. 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 code código de 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 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 instaló en el clúster de AKS seleccionado

Si la aplicación de Kubernetes no se instaló 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 de 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 es correcto, resuelva los problemas identificados en el clúster.

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

¿Qué ocurre si el clúster es correcto, pero se produce un error en la instalación? En ese caso, examine el registro de actividad de Azure Monitor dentro del clúster de AKS para encontrar 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 de 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 determinada región geográfica. El mensaje de error puede parecerse 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: Comprobar si la oferta sigue estando disponible y dónde está disponible

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

Causa 4: Error interno del servidor

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

La extensión no se pudo implementar con un error interno del servidor

Solución 4: Eliminar y reinstalar 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 instaló

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

No se pudo instalar el gráfico desde la ruta de acceso [] para la versión

Solución 5: Vuelva a comprobar las entradas realizadas en la plantilla de ARM

Asegúrese de que los valores y selecciones especificados en Azure Portal para la implementación de plantillas de ARM son aceptables en la aplicación de 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

Portal

Puede realizar la implementación a través de Azure Portal. Azure Portal proporciona una experiencia de interfaz de usuario para leer y aceptar los términos legales.

CLI

Puede usar los comandos de la CLI de Azure que se describen en los términos legales de la CLI de Azure. Aunque los comandos son para las máquinas virtuales, los comandos también funcionan para los contenedores.

PowerShell

Para aceptar los términos legales mediante PowerShell, ejecute los cmdlets que se describen en los términos legales de PowerShell.

Pasos siguientes

Solución 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.