Начало работы с навыками Azure

В этом кратком руководстве вы подготовите, проверите и развернете приложение в Azure с помощью Azure Skills.

Необходимые условия

• Azure Навыки установлены (Установка и настройка навыков Azure)
• Проверка подлинности Azure CLI выполнена (az login успешно завершено)
• GitHub Copilot CLI или Claude Code готовы к использованию
• Пример приложения (или создание приложения Node.js)

Сценарий

У вас есть приложение Node.js. Вы хотите развернуть его в Azure с помощью:

• Размещение веб-приложений (Служба приложений Azure)
• Учетная запись хранения для данных приложения
• Мониторинг с помощью Application Insights

Подготовьте ваше приложение

В помощнике по ИИ перейдите в каталог проекта и попросите:

Prepare my application for Azure deployment

Навык:azure-prepare

1. Анализирует базу кода
2. Определяет стек технологий (Node.js, npm и т. д.)
3. Создает .azure/plan.md с помощью стратегии развертывания
4. Создает инфраструктуру в виде кода
5. Ожидает утверждения

Просмотр созданного плана

Откройте .azure/plan.md и проверьте:

• Project Information — имя приложения и режим развертывания
• Требования— классификация и масштабирование (небольшие, средние, крупные)
• Компоненты — обнаруженные технологии
• Стратегия развертывания — технология, используемая для развертывания вашего приложения (Azure Developer CLI, Bicep, Terraform или Azure CLI).
• Architecture — выбранные службы Azure
• План реализации— пошаговые задачи

Пример содержимого плана:

# 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

Утверждение плана

Если план выглядит правильно, сообщите своему помощнику по искусственному интеллекту:

Approve this plan and proceed to validation

Навык обновляет статус плана до Approved и переходит к следующему шагу.

Подсказка

Если навык не распознает тип проекта, убедитесь, что вы находитесь в корневом каталоге проекта с распознаваемым файлом проекта (package.json, или requirements.txt.csprojаналогичным).

Проверка плана развертывания

Ваш ИИ помощник выполняет навык azure-validate для проверки.

• Доступ и права в Azure CLI
• синтаксис шаблона Bicep или Terraform, если применимо
• Доступность подписок и регионов Azure
• Ограничения квоты службы
• Необходимые разрешения для учетной записи

Проверка завершается и записывает подтверждение всех проверок в плане. Состояние плана обновляется Validated.

Проверка результатов проверки

Проверьте .azure/plan.md секцию доказательства проверки, в которой показано:

• Выполняемые команды
• Отметка времени
• Результаты (успешные или неуспешные)

Пример:

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

Если проверка завершается ошибкой, просмотрите ошибки и попросите помощника по искусственному интеллекту устранить проблемы:

Fix the validation errors and try again

Подсказка

Если проверка завершается ошибкой, убедитесь, что у вашей учетной записи Azure есть необходимые разрешения, а ресурсы, указанные в плане, доступны в выбранном регионе.

Развертывание в Azure

Когда план проверяется, сообщите помощнику по ИИ:

Deploy my application to Azure

Навык:azure-deploy

1. Подтверждает статус плана Validated
2. Подготавливает ресурсы Azure (хранилища, службы приложений, мониторинг)
3. Развертывание кода приложения
4. Настройка параметров приложения
5. Предоставляет конечную точку приложения

Развертывание обычно занимает 3–5 минут.

Просмотр развернутого приложения

После успешного развертывания помощник по искусственному интеллекту предоставляет:

• URL-адрес приложения (для службы приложений)
• Имя учетной записи хранения и ключи доступа
• Ключ инструментирования Application Insights

Пример:

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/...

Чтобы убедиться, что приложение запущено, посетите URL-адрес приложения в браузере.

Подсказка

Если развертывание завершается ошибкой, проверьте сообщения об ошибках на наличие проблем с разрешениями или квотами. Выполните az account show, чтобы проверить, что вы аутентифицированы в правильной подписке.

Проверьте ваше развертывание

Протестируйте приложение:

1. Посетите свой URL-адрес — откройте URL-адрес приложения в браузере.
2. Проверьте мониторинг— просмотр журналов в Application Insights.
3. Тестирование функциональных возможностей. Используйте ключевые функции приложения.

Попросите помощника по искусственному интеллекту о состоянии мониторинга:

Show me the application logs and performance metrics

Помощник по искусственному интеллекту запрашивает Application Insights и отображает последние действия, ошибки и данные о производительности.

Обновление и повторное развертывание

При внесении изменений в код выполните повторное развертывание легко.

1. Обновите код в редакторе.

2. Попросите помощника по искусственному интеллекту:

   Update the deployment with my latest changes
   

3. Навык выполняется azure-prepare для проверки изменений, а затем azure-deploy для обновления ресурсов.

Обновленные ресурсы повторно используют существующую инфраструктуру. Повторное развертывание только измененных компонентов.

Очистите ресурсы

Если приложение больше не требуется, удалите ресурсы Azure, чтобы избежать расходов:

Delete all Azure resources for this application

Помощник по искусственному интеллекту:

1. Список ресурсов для удаления (для подтверждения)
2. Удаляет группу ресурсов и все содержимое
3. Подтверждает завершение очистки

Пример:

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

Are you sure? (yes/no)

Введите yes для подтверждения удаления.

Troubleshooting

Сбой развертывания с ошибкой аутентификации

Problem: Помощник по ИИ не может пройти проверку подлинности в Azure.

Решение: Повторно выполните проверку подлинности с помощью az login и повторите попытку.

Сбой проверки плана

Проблема: Azure сообщает об ошибках проверки навыков.

Решение: Попросите помощника по искусственному интеллекту просмотреть и устранить проблемы:

Why did validation fail? Fix the errors.

Приложение недоступно после развертывания

Проблема: Указанный URL-адрес возвращает ошибку или время ожидания.

Solution:

1. Проверьте правильность URL-адреса.

2. Подождите 1–2 минуты распространения DNS.

3. Проверьте журналы Application Insights на наличие ошибок.

   Show me recent errors in Application Insights
   

Дальнейшие действия

• документация по серверу протокола контекста модели Azure (MCP) — более подробные технические сведения