Адаптер для статических веб-приложений Azure

Промежуточное ПО Qwik City Azure Static Web Apps позволяет подключить Qwik City к Azure Static Web Apps.

Установка

Чтобы интегрировать адаптер azure-swa, используйте команду add:

npm run qwik add azure-swa

Адаптер добавит новый файл vite.config.ts в каталог adapters/, и создаст файл точки входа:

└── adapters/
    └── azure-swa/
        └── vite.config.ts
└── src/
    └── entry.azure-swa.tsx

Кроме того, в package.json будут обновлены скрипты build.server и deploy.

Сборка для производственной среды

Чтобы собрать приложение для производственной среды, используйте команду build, эта команда автоматически запустит npm run build.server и npm run build.client:

npm run build

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

После установки интеграции с помощью npm run qwik add azure-swa проект готов к развёртыванию в Azure Static Web Apps.

Существует три способа развёртывания:

1. Развёртывание с помощью Static Web Apps CLI

   Вы можете развернуть свое приложение из локальной среды с помощью:

   npx swa deploy

   Эта команда запустит мастер, который проведёт вас через логин и развёртывание в Azure.

2. Развёртывание с помощью GitHub

   Вы можете развернуть своё приложение через GitHub. Создайте репозиторий Git с кодом вашего приложения, а затем опубликуйте свою ветку на GitHub.

   С помощью портала Azure создайте Azure Static Webapp и выберите репозиторий GitHub как источник в свойствах. Когда появится запрос с параметрами сборки выберите "Custom" и установите следующие значения:

   • App location: "."
   • Api location: "./azure-functions"
   • Output location: "./dist"

   Эта настройка установит рабочий процесс GitHub в вашем репозитории. Благодаря этому рабочему процессу ваше приложение будет автоматически развёртываться всякий раз, когда изменения будут отправлены в основную ветку.

   Полученный файл рабочего процесса необходимо адаптировать, добавив в блок "Repository/Build Configurations" следующую команду:

   skip_api_build: true

   Для получения дополнительной информации ознакомьтесь с Azure Static Web Apps quickstart.

3. Развёртывание из любой CI-системы

   Вы можете развернуть статические веб-приложения Azure с помощью любой CI-системы. Установите токен развёртывания Azure SWA в качестве переменной среды SWA_CLI_DEPLOYMENT_TOKEN. Как только это будет сделано, вы можете запустить в своём конвейере сборки следующую команду:

   swa deploy ./dist --api-location ./azure-functions --env production

Обратите внимание, что для выполнения этого шага вам понадобится учётная запись Azure!