Introducción a las aptitudes de Azure

En este inicio rápido, preparará, validará e implementará una aplicación para Azure mediante Azure Skills.

Prerrequisitos

  • Azure Skills instalado (Instalar y configurar Azure Skills)
  • CLI de Azure autenticado (az login completado exitosamente)
  • GitHub Copilot CLI o Claude Code listos para usar
  • Una aplicación de ejemplo (o crear una aplicación de Node.js)

Escenario

Tiene una aplicación de Node.js. Desea implementarlo en Azure con:

  • Hospedaje de aplicaciones web (Azure App Service)
  • Una cuenta de almacenamiento para los datos de la aplicación
  • Supervisión con Application Insights

Preparación de la aplicación

En el asistente de IA, vaya al directorio del proyecto y pregunte:

Prepare my application for Azure deployment

La azure-prepare habilidad:

  1. Analiza el código base
  2. Identifica el stack tecnológico (Node.js, npm, etc.)
  3. Crea .azure/plan.md con una estrategia de implementación
  4. Genera infraestructura como código
  5. Espera su aprobación

Revisión del plan generado

Abra .azure/plan.md y revise:

  • Información del Proyecto—nombre de la aplicación y modo de implementación
  • Requisitos: clasificación y escala (pequeña, mediana, grande)
  • Componentes: tecnologías detectadas
  • Estrategia de implementación: tecnología que se usa para implementar la aplicación (CLI para desarrolladores de Azure, Bicep, Terraform o CLI de Azure).
  • Architecture: Azure servicios seleccionados
  • Plan de implementación: tareas paso a paso

Contenido del plan de ejemplo:

# Azure Deployment Plan

## Project Information
- Application: my-app
- Mode: NEW

## Requirements
- Classification: Web Application
- Scale: Small
- Environment: Production

## Components
- Runtime: Node.js 18+
- Package Manager: NPM
- Application Type: Express web server

## Recipe
- Type: AZD (Azure Developer CLI)

## Azure Services
- Azure App Service (web app hosting)
- Azure Storage Account (data)
- Application Insights (monitoring)

## Status: Awaiting Approval

Aprobación del plan

Si el plan es correcto, indique al asistente de IA:

Approve this plan and proceed to validation

La habilidad actualiza el estado del plan a Approved y pasa al paso siguiente.

Sugerencia

Si la aptitud no reconoce el tipo de proyecto, asegúrese de que está en el directorio raíz del proyecto con un archivo de proyecto reconocible (package.json, requirements.txt, .csprojo similar).

Validación del plan de implementación

El asistente de IA ejecuta la azure-validate aptitud para comprobar lo siguiente:

  • CLI de Azure acceso y permisos
  • Bicep o sintaxis de plantilla de Terraform, si procede
  • Disponibilidad de suscripción de Azure y región
  • Límites de cuota de servicio
  • Permisos necesarios para la cuenta

La validación finaliza y registra evidencia de la finalización de todas las comprobaciones del plan. El estado del plan se actualiza a Validated.

Revisión de los resultados de validación

Busque .azure/plan.md la sección Prueba de validación, que muestra:

  • Comandos ejecutados
  • Marca de tiempo
  • Resultados (aprobados o reprobados)

Ejemplo:

## Validation Proof
- Command: azd provision --preview
- Timestamp: 2026-03-16T14:22:00Z
- Result: ✓ All validation checks passed

Si se produce un error en la validación, revise los errores y pida al asistente de IA que corrija los problemas:

Fix the validation errors and try again

Sugerencia

Si se produce un error en la validación, compruebe que la cuenta de Azure tiene los permisos necesarios y que los recursos especificados en el plan están disponibles en la región seleccionada.

Implementación en Azure

Cuando se valide el plan, indique al asistente de IA:

Deploy my application to Azure

La azure-deploy habilidad:

  1. Confirma que el estado del plan es Validated
  2. Aprovisiona recursos Azure (almacenamiento, app service, supervisión)
  3. Implementa el código de la aplicación
  4. Configura las opciones de la aplicación
  5. Proporciona el punto de conexión de la aplicación

La implementación suele tardar entre 3 y 5 minutos.

Visualización de la aplicación implementada

Después de una implementación correcta, el asistente de IA proporciona lo siguiente:

  • Dirección URL de la aplicación (para App Service)
  • Nombre y claves de acceso de la cuenta de almacenamiento
  • Clave de instrumentación de Application Insights

Ejemplo:

Deployment complete! 

Your app is live at: https://my-app-abcd1234.azurewebsites.net

Resources deployed:
- App Service: my-app-prod
- Storage Account: mystorageabcd1234
- Application Insights: my-app-insights

Monitor your app: https://portal.azure.com/...

Para comprobar que la aplicación se está ejecutando, visite la dirección URL de la aplicación en un explorador.

Sugerencia

Si se produce un error en la implementación, compruebe el mensaje de error para ver si hay problemas de permiso o cuota. Ejecute az account show para comprobar que está autenticado en la suscripción correcta.

Comprobación de la implementación

Pruebe la aplicación:

  1. Visite la dirección URL: abra la dirección URL de la aplicación en un explorador.
  2. Comprobación de la supervisión: vea los registros en Application Insights.
  3. Funcionalidad de prueba: use las características clave de la aplicación.

Pida al asistente de IA que le indique el estado de supervisión:

Show me the application logs and performance metrics

El asistente de IA consulta Application Insights y muestra datos recientes de actividad, errores y rendimiento.

Actualización y reimplementación

Si realiza cambios en el código, vuelva a implementarlo fácilmente:

  1. Actualice el código en el editor.

  2. Pregunte al asistente de IA:

    Update the deployment with my latest changes
    
  3. La habilidad se ejecuta azure-prepare para comprobar si hay cambios y, a continuación, azure-deploy para actualizar tus recursos.

Los recursos actualizados reutilizan la infraestructura existente. Solo los componentes modificados se vuelven a implementar.

Limpieza de recursos

Cuando ya no necesite la aplicación, elimine Azure recursos para evitar cargos:

Delete all Azure resources for this application

El asistente de IA:

  1. Enumera los recursos que se van a eliminar (para su confirmación)
  2. Elimina el grupo de recursos y todo el contenido.
  3. Confirma que se ha completado la limpieza

Ejemplo:

Resources to delete:
- Resource Group: my-app-rg
- All contained resources

Are you sure? (yes/no)

Escriba yes para confirmar la eliminación.

Solución de problemas

El despliegue falla con error de autenticación

Problem: El asistente para IA no se puede autenticar en Azure.

Solución: Vuelva a autenticar mediante az login e inténtelo de nuevo.

Error en la validación del plan

Problem: Azure Skills notifica errores de validación.

Solución: Pida al asistente de IA que revise y corrija los problemas:

Why did validation fail? Fix the errors.

Aplicación no accesible después de la implementación

Problema: La dirección URL proporcionada devuelve un error o agota el tiempo de espera.

Solution:

  1. Compruebe que la dirección URL es correcta.

  2. Espere entre 1 y 2 minutos para la propagación de DNS.

  3. Compruebe si hay errores en los registros de Application Insights.

    Show me recent errors in Application Insights
    

Pasos siguientes