Tutorial: Implementación de una aplicación en Azure Kubernetes Service (AKS)

Kubernetes proporciona una plataforma distribuida para aplicaciones en contenedores. Compile e implemente sus propios servicios y aplicaciones en un clúster de Kubernetes y deje que el clúster administre la disponibilidad y conectividad.

En este tutorial, la cuarta parte de siete, implementa una aplicación de ejemplo en un clúster de Kubernetes. Aprenderá a:

• Actualizar los archivos de manifiesto de Kubernetes
• Ejecutar una aplicación en Kubernetes
• Pruebe la aplicación.

Sugerencia

Con AKS, puede usar los siguientes enfoques para administrar la configuración:

• GitOps: permite aplicar automáticamente al clúster las declaraciones sobre su estado. Para más información sobre cómo usar GitOps para implementar una aplicación con un clúster de AKS, consulte los requisitos previos para clústeres de Azure Kubernetes Service en el tutorial GitOps con Flux v2.

• DevOps: permite compilar, probar e implementar código con integración y entrega continuas (CI/CD). Si desea ver ejemplos de cómo usar DevOps para implementar una aplicación con un clúster de AKS, consulte Compilación e implementación en Azure Kubernetes Service con Azure Pipelines o Compilación, prueba e implementación de contenedores en Azure Kubernetes Service (AKS) mediante Acciones de GitHub.

Antes de empezar

En los tutoriales anteriores, empaquetó una aplicación en una imagen de contenedor, cargó la imagen en Azure Container Registry y creó un clúster de Kubernetes. Para completar este tutorial, necesita el archivo de manifiesto de Kubernetes aks-store-quickstart.yaml creado previamente. Este archivo se descargó en el código fuente de la aplicación de Tutorial 1: Preparación de la aplicación para AKS.

CLI de Azure

Para realizar este tutorial es necesaria la versión 2.0.53 o superior de la CLI de Azure. Compruebe su versión con az --version. Para la instalación o la actualización, consulte Instalación de la CLI de Azure.

Azure PowerShell

Para seguir este tutorial es necesaria la versión 5.9.0 de Azure PowerShell, o cualquier versión posterior. Compruebe su versión con Get-InstalledModule -Name Az. Si necesita instalarla o actualizarla, consulte Instalación de Azure PowerShell.

CLI de desarrollo de Azure

Para realizar este tutorial se necesita la versión 1.5.1 o superior de Azure Developer CLI (azd). Compruebe su versión con azd version. Para instalarla o actualizarla, consulte Instalación de Azure Developer CLI.

Actualización del archivo de manifiesto

En estos tutoriales, la instancia de Azure Container Registry (ACR) almacena la imagen de contenedor de la aplicación de ejemplo. Para implementar la aplicación, debe actualizar el nombre de la imagen en el archivo de manifiesto de Kubernetes para incluir el nombre del servidor de inicio de sesión de ACR.

CLI de Azure

1. Obtenga la dirección del servidor de inicio de sesión con el comando az acr list y consulte el servidor de inicio de sesión.

   az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
   

2. Asegúrese de que está en el directorio clonado aks-store-demo y abra el archivo de manifiesto aks-store-quickstart.yaml con un editor de texto.

3. Actualice la propiedad image de los contenedores reemplazando ghcr.io/azure-samples por el nombre del servidor de inicio de sesión de ACR.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:latest
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:latest
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:latest
   ...
   

4. Guarde y cierre el archivo.

Azure PowerShell

1. Obtenga la dirección del servidor de inicio de sesión con el cmdlet Get-AzContainerRegistry y consulte el servidor de inicio de sesión. Asegúrese de reemplazar <acrName> por el nombre de la instancia de ACR.

   (Get-AzContainerRegistry -ResourceGroupName myResourceGroup -Name $ACRNAME).LoginServer
   

2. Asegúrese de que está en el directorio clonado aks-store-demo y abra el archivo de manifiesto aks-store-quickstart.yaml con un editor de texto.

3. Actualice la propiedad image de los contenedores reemplazando ghcr.io/azure-samples por el nombre del servidor de inicio de sesión de ACR.

   containers:
   ...
   - name: order-service
     image: <acrName>.azurecr.io/aks-store-demo/order-service:latest
   ...
   - name: product-service
     image: <acrName>.azurecr.io/aks-store-demo/product-service:latest
   ...
   - name: store-front
     image: <acrName>.azurecr.io/aks-store-demo/store-front:latest
   ...
   

4. Guarde y cierre el archivo.

CLI de desarrollo de Azure

azd no requiere un paso del registro de contenedor, ya que está en la plantilla.

Ejecución de la aplicación

CLI de Azure

1. Implemente la aplicación con el comando kubectl apply, que analiza el archivo de manifiesto y crea los objetos de Kubernetes definidos.

   kubectl apply -f aks-store-quickstart.yaml
   

   La salida de ejemplo siguiente muestra los recursos que se crearon correctamente en el clúster de AKS:

   statefulset.apps/rabbitmq created
   configmap/rabbitmq-enabled-plugins created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   

2. Compruebe que la implementación se realiza correctamente mediante la visualización de los pods con kubectl

   kubectl get pods
   

Azure PowerShell

1. Implemente la aplicación con el comando kubectl apply, que analiza el archivo de manifiesto y crea los objetos de Kubernetes definidos.

   kubectl apply -f aks-store-quickstart.yaml
   

   La salida de ejemplo siguiente muestra los recursos que se crearon correctamente en el clúster de AKS:

   statefulset.apps/rabbitmq created
   configmap/rabbitmq-enabled-plugins created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   

2. Comprueba que la implementación se realiza correctamente visualizando los pods con kubectl.

   kubectl get pods
   

CLI de desarrollo de Azure

Implementación en azd desglosada en varias fases representadas por enlaces. azd implementa con todos los enlaces de manera predeterminada.

1. Implemente la aplicación mediante el comando azd up.

   azd up
   

2. Selecciona la suscripción y la región que en las que quieres hospedar los recursos de Azure.

   ? Select an Azure Subscription to use:  [Use arrows to move, type to filter]
   > 1. My Azure Subscription (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
   Select an Azure location to use:  [Use arrows to move, type to filter]
   > 43. (US) East US 2 (eastus2)
   

   Puedes actualizar las variables para AZURE_LOCATION y AZURE_SUBSCRIPTION_ID desde dentro del archivo .azure/<your-env-name>/.env.

Prueba de la aplicación

Cuando se ejecuta la aplicación, un servicio de Kubernetes expone el front-end de la aplicación a Internet. Este proceso puede tardar unos minutos en completarse.

Línea de comandos

1. Para supervisar el progreso, utilice el comando kubectl get service con el argumento --watch.

   kubectl get service store-front --watch
   

   En un primer momento, el parámetro EXTERNAL-IP del servicio store-front aparece como <pending>:

   store-front   LoadBalancer   10.0.34.242   <pending>     80:30676/TCP   5s
   

2. Cuando la dirección EXTERNAL-IP cambie de <pending> a una dirección IP pública, use CTRL-C para detener el proceso de inspección de kubectl.

   En la salida del ejemplo siguiente se muestra una dirección IP pública válida asignada al servicio:

   store-front   LoadBalancer   10.0.34.242   52.179.23.131   80:30676/TCP   67s
   

3. Para ver la aplicación en acción, abra un explorador web y vaya a la dirección IP externa del servicio: http://<external-ip>.

   

Si no se carga la aplicación, es posible que haya un problema de autorización con el registro de la imagen. Para ver el estado de los contenedores, use el comando kubectl get pods. Si no puede extraer las imágenes del contenedor, consulte Autenticación con Azure Container Registry desde Azure Kubernetes Service.

Azure portal

Navegue hasta Azure Portal para encontrar la información sobre su implementación.

1. Vaya a su recurso de clúster AKS.

2. En el menú de servicios, en Recursos Kubernetes, seleccione Servicios e ingresos.

3. Copie la IP externa que aparece en la columna correspondiente al servicio store-front.

4. Pegue la IP en su navegador para visitar la página de la tienda.

   

Limpieza de recursos

Puesto que validó la funcionalidad de la aplicación, ahora puede quitar el clúster de la aplicación. Volveremos a implementar la aplicación en el siguiente tutorial.

1. Para detener y quitar las instancias de contenedor y los recursos, use el comando kubectl delete.

   kubectl delete -f aks-store-quickstart.yaml
   

2. Compruebe que se han eliminado todos los pods de aplicación mediante el comando kubectl get pods.

   kubectl get pods
   

Pasos siguientes

En este tutorial ha implementado una aplicación de Azure de ejemplo en un clúster de Kubernetes en AKS. Ha aprendido a:

• Actualizar los archivos de manifiesto de Kubernetes
• Ejecutar una aplicación en Kubernetes
• Pruebe la aplicación.

En el siguiente tutorial aprenderá a usar los servicios PaaS para cargas de trabajo con estado en Kubernetes.

Uso de servicios PaaS para cargas de trabajo con estado en AKS