Обзор интерфейса командной строки Статические веб-приложения Azure
Внимание
Чтобы повысить безопасность развертываний из интерфейса командной строки Статические веб-приложения, было введено критическое изменение, требующее обновления до последней версии (2.0.2) Статические веб-приложения CLI к январю 15 января 2025 года.
Статические веб-приложения Azure веб-сайты размещаются в облаке и часто подключаются к коллекции облачных служб. Во время разработки и в любое время, когда вам нужно запустить приложение локально, вам потребуются средства для имитации работы приложения в облаке.
Интерфейс командной строки Статические веб-приложения (SWA CLI) включает ряд локальных служб, которые приблизит выполнение приложения в Azure, но вместо этого они выполняются исключительно на компьютере.
Интерфейс командной строки Статические веб-приложения Azure предоставляет следующие службы:
- Локальный статический сервер сайта
- Прокси-сервер к серверу разработки интерфейсной платформы
- Прокси-сервер для конечных точек API — доступен через Azure Functions Core Tools
- Имитация сервера проверки подлинности и авторизации
- Принудительное применение локальных маршрутов и параметров конфигурации
Принцип работы
На следующей диаграмме показано, как запросы обрабатываются локально.
Внимание
Перейдите к http://localhost:4280 приложению, обслуживаемого интерфейсом командной строки.
Запросы, отправленные на порт
4280, перенаправляются на соответствующий сервер в зависимости от типа запроса.Запросы статического содержимого, такие как HTML или CSS, обрабатываются внутренним сервером статического содержимого CLI или сервером интерфейсной платформы для отладки.
Запросы проверки подлинности и авторизации обрабатываются эмулятором, который предоставляет приложению фиктивный профиль удостоверения.
Среда выполненияCore Tools функций 1 обрабатывает запросы к API сайта.
Ответы от всех служб возвращаются в браузер, как если бы все они были единственным приложением.
После запуска пользовательского интерфейса и приложений API Функции Azure самостоятельно запустите интерфейс командной строки Статические веб-приложения и укажите его на запущенные приложения с помощью следующей команды:
swa start http://localhost:<DEV-SERVER-PORT-NUMBER> --api-location http://localhost:7071
При необходимости при использовании swa init команды Статические веб-приложения CLI просматривает код приложения и создает файл конфигурации swa-cli.config.json для ИНТЕРФЕЙСА командной строки. При использовании файла swa-cli.config.json можно запустить swa start приложение локально.
1 Функции Azure Core Tools автоматически устанавливаются интерфейсом командной строки, если они еще не находятся в вашей системе.
Начало работы
Начните работу с Статические веб-приложения CLI со следующими ресурсами.
| Ресурс | Description |
|---|---|
| Установка интерфейса командной строки Статические веб-приложения (SWA CLI) | Установите Статические веб-приложения Azure CLI на компьютер. |
| Настройка среды | Настройка того, как приложение считывает сведения о конфигурации. |
| Запуск эмулятора веб-сайта | Запустите службу для локального обслуживания веб-сайта. |
| Запуск локального сервера API | Запустите службу для локального обслуживания конечных точек API. |
| Развертывание в Azure | Разверните приложение в рабочей среде Azure. |
Примечание.
Часто для сайтов, созданных с помощью интерфейсной платформы, требуется параметр конфигурации прокси-сервера для правильной обработки запросов в маршруте api. При использовании интерфейса командной строки для статических веб-приложений Azure значение расположения прокси-сервера равно /api, а без CLI — значение http://localhost:7071/api.