Inicio rápido: Implementación y administración de aplicaciones mediante el escritorio de AKS

La implementación y administración de aplicaciones de Kubernetes normalmente requiere escribir manifiestos YAML, ejecutar comandos kubectl y cambiar entre varias herramientas. El escritorio de AKS elimina esta complejidad con flujos de trabajo guiados que permiten a los desarrolladores e ingenieros de DevOps implementar, supervisar, solucionar problemas y limpiar aplicaciones sin conocimientos profundos de Kubernetes.

Esta guía le guía a través de la implementación de una aplicación TypeScript mediante el escritorio de AKS, desde la creación de un clúster mediante la exploración de registros de aplicaciones, métricas, escalado y herramientas de solución de problemas integradas.

Prerequisites

Una suscripción a Azure. Si no tiene una suscripción de Azure, puede crear una cuenta gratuita de Azure.
La VERSIÓN 2.64.0 o posterior de la CLI de Azure debe estar instalada. Compruebe la versión con el comando az --version. Para la instalación o la actualización, consulte Instalación de la CLI de Azure.
Extensión de la CLI de aks-preview Azure. Instálelo mediante el az extension add --name aks-preview comando .
AKS Desktop instalado. El escritorio de AKS admite los siguientes sistemas operativos (SO): Windows, Linux y Mac.
Si usa un clúster existente, el clúster debe autenticarse con el identificador de Microsoft Entra. Para asegurarse de que el clúster está autenticado por microsoft Entra ID, use un clúster automático de AKS. También necesita el rol de administrador de clústeres RBAC de Azure Kubernetes Service o permisos equivalentes en el clúster de destino.

Creación de recursos de Azure

Si no tiene un clúster de AKS existente y Azure Container Registry (ACR), puede crearlos mediante la CLI de Azure. En estas secciones se muestra cómo crear un nuevo grupo de recursos, un clúster de AKS y ACR. Si ya tiene estos recursos, puede saltar a Registrar su clúster con AKS Desktop.

Establecimiento de variables de entorno

Para simplificar los comandos, establezca las siguientes variables de entorno en el terminal. Asegúrese de establecer myLocation en la región de Azure. En el ejemplo siguiente se usa RAND para crear nombres de recursos únicos. Puede reemplazarlos por sus propios valores si lo prefiere.

RAND=$RANDOM
export RAND
echo "Random resource identifier will be: ${RAND}"
myResourceGroup=bbash$RAND
myLocation=westus3
myClusterName=clu-$RAND
registryName=bbashreg$RAND

Creación de un grupo de recursos

Cree un grupo de recursos de Azure con el comando az group create.

az group create --name $myResourceGroup --location $myLocation

Creación de un registro de contenedor de Azure

Cree un registro de contenedor de Azure mediante el comando az acr create.

az acr create --resource-group $myResourceGroup --name $registryName --sku Basic

Creación de un clúster de AKS con integración de ACR

Cree un clúster de AKS con la integración de ACR mediante el az aks create comando . El --attach-acr parámetro concede al clúster de AKS permiso para extraer imágenes de ACR. Este comando de ejemplo también establece el --sku a automatic. Se recomienda usar clústeres automáticos de AKS para obtener la mejor experiencia con el escritorio de AKS, pero también puede usar un clúster estándar.

az aks create --resource-group $myResourceGroup --name $myClusterName --sku automatic --attach-acr $registryName

Concesión de permisos de administrador de clústeres

Obtenga el identificador de recurso del clúster mediante el az aks show comando y establézcalo en una variable de entorno.
```
AKS_ID=$(az aks show --resource-group $myResourceGroup --name $myClusterName --query id --output tsv)
```
Otorgue permisos de administrador al clúster utilizando el comando az role assignment create con el rol de administrador de clúster de RBAC en Azure Kubernetes Service. Asegúrese de reemplazar <your-entra-id> por el ID de objeto de Microsoft Entra.
```
az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \
   --assignee <your-entra-id> \
   --scope $AKS_ID
```

Creación de una imagen de contenedor para pruebas

En este ejemplo se crea una imagen a partir de la aplicación de ejemplo contoso Air, pero puede usar cualquier imagen de contenedor para probar la implementación de una aplicación con el escritorio de AKS. Si desea usar una imagen diferente, asegúrese de reemplazar los detalles de la imagen en los pasos de implementación.

Cree un nuevo directorio, navegue hacia él y clone la aplicación de muestra Contoso Air. A continuación, vaya al directorio de la aplicación web. Si usa una estructura de directorio o aplicación diferente, ajuste estos comandos en consecuencia.
```
mkdir myapp
cd myapp
git clone https://github.com/Azure-Samples/contoso-air
cd contoso-air/src/web
```
Compila y sube la imagen del contenedor a su registro de contenedores mediante el comando az acr build. Si usa una imagen diferente, asegúrese de actualizar el nombre de la imagen y la ruta de acceso según corresponda.
```
az acr build --resource-group $myResourceGroup --registry $registryName --image contosoair:v1 .
```

Registrar su clúster con AKS en el entorno de escritorio

Asegúrese de que ha iniciado sesión en el escritorio de AKS con la misma cuenta que tiene acceso al clúster de AKS. Una vez que haya iniciado sesión, seleccione Agregar desde la suscripción de Azure.
Escriba el nombre de la suscripción de Azure si tiene más de uno. (Como alternativa, seleccione la flecha para abrir la lista desplegable y, a continuación, seleccione la suscripción de Azure).
Seleccione su clúster y, a continuación, seleccione Registrar clúster.

Creación de un proyecto administrado en el escritorio de AKS

En el escritorio de AKS, vaya a la pestaña Proyectos y seleccione Crear un nuevo proyecto administrado.
Configure las siguientes opciones de Project:
- Conceptos básicos:
  - Nombre del proyecto: por ejemplo, my-dev-frontend
  - Suscripción: <your-subscription-name>
  - Clúster: <your-cluster-name>
Note

Cuando se establece la suscripción de Azure y el clúster de AKS, el escritorio de AKS comprueba si hay compatibilidad con las características de clúster y suscripción necesarias para la experiencia de escritorio de AKS.
- Directivas de red: puede dejar la configuración predeterminada para este inicio rápido o actualizarlas según sea necesario.
  - Para exponer la aplicación públicamente, cambie Entrada a Allow all traffic.
- Cuota de proceso: deje el valor predeterminado para la aplicación de prueba.
- Access: agregue a alguien o elimine la entrada eliminando el elemento de línea.
En Revisar, compruebe la configuración del proyecto y, a continuación, seleccione Crear proyecto.

Implementar una aplicación

Proporcione un nombre de aplicación y, a continuación, seleccione Crear aplicación.
Seleccione un origen para la aplicación. En este ejemplo, seleccione Imagen de contenedor>Siguiente.
Configure las siguientes opciones de aplicación. Puede aceptar los valores predeterminados o actualizarlos según sea necesario.
- Nombre de la imagen de contenedor:
  - Agregue el nombre de la imagen del contenedor. En este ejemplo, usamos myacr.azurecr.io/contosoair:v1.
  Importante
  
  No se puede usar la latest etiqueta . Especifique una etiqueta explícita como v1.
- Redes:
  - Puerto de destino: para el contenedor de ejemplo, establezca en 3000.
  - Habilitar el acceso público: establezca si desea acceder a la aplicación desde una dirección URL pública.
- HPA (Escalador automático horizontal de pods):
  - Habilitar HPA: establézcalo para habilitar el escalado automático de la aplicación en función del uso de recursos.
Seleccione Implementar para implementar la aplicación. La aplicación puede tardar unos minutos en finalizar la implementación. Puede ver el estado de implementación en la página Información general del proyecto. Espere hasta que todos los recursos muestren un estado correcto antes de explorar la aplicación.

Exploración de la aplicación

En la página Información general del proyecto, puede explorar la aplicación con las pestañas siguientes:

Recursos: vea todos los recursos de Kubernetes para la aplicación.
Mapa: Visualice cómo interactúan todos los recursos de Kubernetes y dependen entre sí.
Registros: vea los registros de pod.
Métricas: vea el consumo de recursos de la aplicación principal.
Escalado: vea los eventos de escalado y realice actualizaciones.
Conclusiones: Solución de errores de DNS, tráfico de red y uso de recursos (versión preliminar). Para más información, consulte Solución de problemas de una aplicación en el escritorio de AKS mediante Insights.
Eliminar: elimine el proyecto.
Asistente de IA: Use lenguaje natural para diagnosticar y resolver problemas en el clúster (vista previa). Para más información, consulte Uso del asistente para la solución de problemas de IA en el escritorio de AKS.

Limpieza de recursos

Cuando haya terminado con el inicio rápido, puede limpiar los recursos que creó para evitar costos innecesarios.

Para quitar el proyecto, seleccione Eliminar. Si también desea quitar el recurso subyacente de espacio de nombres administrado de Azure, seleccione También eliminar los espacios de nombres.

Para obtener más información sobre el escritorio de AKS, consulte los siguientes recursos:

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-04-23