Поделиться через

Запуск эмулятора интерфейса командной строки Статические веб-приложения

  • Статья

Внимание

Чтобы повысить безопасность развертываний из интерфейса командной строки Статические веб-приложения, было введено критическое изменение, требующее обновления до последней версии (2.0.2) Статические веб-приложения CLI к январю 15 января 2025 года.

Статические веб-приложения — это облачная платформа, на которой размещаются и выполняются веб-приложения. При локальном запуске приложения вам потребуются специальные средства, которые помогут вам приблизить способ работы приложения в облаке.

Интерфейс командной строки Статические веб-приложения (SWA CLI) включает эмулятор, который имитирует, как ваше приложение будет работать в Azure, но вместо этого выполняется исключительно на компьютере.

Команда swa start запускает эмулятор с параметрами по умолчанию. По умолчанию эмулятор использует порт 4280.

Дополнительные сведения об отдельных командах см. в справочнике по CLI.

Обслуживание статических файлов из файловой системы

Интерфейс командной строки SWA позволяет напрямую обслуживать статическое содержимое из файловой системы без других необходимых средств. Вы можете обслуживать статическое содержимое из текущего каталога или определенной папки.

Служить из... Команда Примечания.
Текущая папка swa start По умолчанию интерфейс командной строки запускает и обслуживает статическое содержимое (HTML, изображение, скрипт и CSS-файлы) из текущего рабочего каталога.
Конкретная папка swa start ./my-dist Вы можете переопределить поведение, чтобы запустить эмулятор с другой папкой статических ресурсов.

Использование сервера разработки

При разработке внешнего интерфейса приложения может потребоваться использовать сервер разработки платформы по умолчанию. Использование сервера платформы позволяет воспользоваться преимуществами, такими как динамическая перезагрузка и горячая замена модуля (HMR).

Например, разработчики Angular часто используют ng serve или npm start запускают сервер разработки.

Вы можете настроить Статические веб-приложения интерфейс командной строки SWA для прокси-запросов к серверу разработки, что дает преимущества интерфейса командной строки платформы при одновременной работе с Статические веб-приложения CLI.

Существует два шага для использования сервера разработки платформы вместе с интерфейсом командной строки SWA:

  1. Запустите локальный сервер разработки платформы как обычно. Обязательно запишите URL-адрес (включая порт), используемый платформой.

  2. Запустите интерфейс командной строки SWA в новом терминале, передав URL-адрес сервера разработки.

    swa start <DEV_SERVER_URL>

Примечание.

Обязательно замените <DEV_SERVER_URL> заполнитель собственным значением.

Запуск сервера разработки

Чтобы упростить рабочий процесс, запустите сервер разработки с помощью интерфейса командной строки SWA.

Вы можете передать пользовательскую команду --run параметру в swa start команду.

swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>

Ниже приведены некоторые примеры запуска эмулятора с несколькими разными платформами:

Платформа Команда
React swa start http://localhost:3000 --run "npm start"
Blazor swa start http://localhost:5000 --run "dotnet watch run"
Jekyll swa start http://localhost:4000 --run "jekyll serve"

Вы также можете использовать --run параметр, если вы хотите запустить настраиваемый скрипт при запуске сервера разработки.

swa start http://localhost:4200 --run "./startup.sh"

Используя приведенную выше команду, вы можете получить доступ к приложению с эмулированными службами из http://localhost:4280

Следующие шаги

Запуск сервера API