Разверните приложение Fabric в Fabric

Разверните приложение Fabric в Fabric, войдя в систему, выполнив процесс развертывания через CLI и просмотрев, что npx rayfin up настраивает для вашего приложения. В этой статье описывается концепция того, что происходит во время развертывания.

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

  • Проект приложений Fabric с файлом конфигурации rayfin/rayfin.yml. Если у вас еще нет проекта, ознакомьтесь с Создайте свой первый проект Fabric Apps.
  • Учетная запись Microsoft Entra ID с доступом к рабочей области Fabric.

Развертывание приложения

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

npx rayfin up

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

Что происходит при развертывании

Команда rayfin up выполняет следующие действия по порядку:

  1. Создает элемент Fabric Apps в рабочей области Fabric (или повторно использует существующий в последующих развертываниях).
  2. Извлекает доступный для публикации ключ из удаленной службы.
  3. Синхронизирует настройки среды выполнения из rayfin.yml в удалённую службу, включая конфигурацию аутентификации и флаги службы.
  4. Применяет схему базы данных, созданную на основе декораторов модели данных TypeScript.
  5. Создает и развертывает статический контент, если в rayfin.yml включен параметр staticHosting — выполняет команду сборки, упаковывает выходную папку в ZIP-файл и загружает его.
  6. Сохраняет сведения о развертывании в файлы rayfin.yml и .env.fabric-* для последующих развертываний.

После развертывания интерфейс командной строки печатает:

  • URL-адрес размещения, в котором находится ваше приложение
  • Ссылка на портал Fabric для управления развертыванием
  • Идентификатор развертывания для справки

Настройка проверки подлинности

В развернутых приложениях поддерживается только брокерная аутентификация Fabric (Entra SSO). Проверка подлинности электронной почты и пароля доступна во время локальной разработки, но не работает после развертывания в Fabric.

Убедитесь, что на rayfin.yml включена аутентификация Fabric перед запуском rayfin up:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Предварительная версия развертывания без изменений

Используйте --dry-run для просмотра того, что интерфейс командной строки будет делать без создания или изменения ресурсов:

npx rayfin up --dry-run

Применение изменений базы данных

После обновления моделей данных отправьте изменения схемы в удаленную базу данных без повторного развертывания полного стека:

npx rayfin up db apply

Если изменение схемы включает потенциально разрушительные операции (удаление столбцов, переименование таблиц), интерфейс командной строки предупреждает вас и отказывается продолжить. Используйте --force для переопределения проверки безопасности:

npx rayfin up db apply --force

Предостережение

Использование --force может привести к потере данных. Внимательно просмотрите перечисленные операции и подтвердите, что вы принимаете последствия перед продолжением.

Повторное развертывание статического содержимого

При изменении только интерфейсного кода повторно разверните статический контент независимо для более быстрого цикла итерации:

npx rayfin up staticapp deploy

Эта команда выполняет настроенную команду buildCommand, упаковает выходные данные и отправляет ее в удаленную службу.

Чтобы пропустить шаг сборки и развернуть существующие выходные данные:

npx rayfin up staticapp deploy --skip-build

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

Просмотрите текущее состояние развертывания Fabric:

npx rayfin up status

Добавьте --json для выходных данных, доступных для машинного чтения:

npx rayfin up status --json

Обновление существующих развертываний

После первого развертывания rayfin.yml хранит сведения о развертывании (rayfinItemId, fabricWorkspaceId и конечную точку элемента). Повторный запуск npx rayfin up обновляет то же развертывание, а не создает новое.

Для целевых обновлений используйте подкоманды:

Command Что он обновляет
npx rayfin up Все: параметры, база данных и статическое содержимое.
npx rayfin up db apply Только схема базы данных.
npx rayfin up staticapp deploy Только статический контент.

Устранение ошибок развертывания

Развертывание завершается ошибкой 401 или 403

Возможно, срок действия сеанса истек. Запустите npx rayfin login, чтобы повторно пройти аутентификацию, затем повторите попытку npx rayfin up.

База данных применяет отчеты о разрушительных изменениях

Интерфейс командной строки Rayfin блокирует изменения схемы, которые могут привести к потере данных. Просмотрите перечисленные операции и используйте npx rayfin up db apply --force только после того, как вы подтвердите, что принимаете потерю данных.

Статическое развертывание превышает ограничение по размеру

Сжатый архив не должен превышать 100 МБ. Оптимизируйте выходные данные сборки, исключив карты источников и большие ресурсы разработки, или переместите двоичные файлы в хранилище приложений Fabric.

Управление приложением на портале Fabric

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

Просмотр свойств элемента

Откройте приложение Fabric на портале Fabric, чтобы увидеть:

  • URL-адрес приложения — общедоступный URL-адрес , в котором размещено статическое содержимое.
  • URL-адрес серверной части приложения — базовый URL-адрес для всех внутренних служб.

Управление дочерними службами

Выберите приложение Fabric, чтобы просмотреть дочерние службы:

  • SQL Database — открывает редактор запросов Fabric SQL. Вы можете выполнять запросы на чтение данных. Изменения схемы, внесенные непосредственно в портале Fabric, будут перезаписаны при следующем развертывании rayfin up.
  • Проверка подлинности — просмотр пользователей, прошедших проверку подлинности, и управление ими в таблице "Пользователи " в дочерней базе данных SQL.

Разрешения приложения

Для всех участников приложения Fabric для развертывания приложения Fabric требуется как минимум Edit разрешение на элемент.

Связанный контент

  • Last updated on