Создание приложения Fabric с помощью интерфейса командной строки Rayfin

В этом руководстве показано, как использовать интерфейс командной строки Rayfin для создания проекта, локального запуска и развертывания в Microsoft Fabric. Вы используете тот же рабочий процесс CLI для новых приложений и для последующих обновлений схемы или внешнего интерфейса.

Изучив это руководство, вы:

  • Создайте проект Fabric Apps на основе шаблона.
  • Запустите приложение локально.
  • Войдите в Microsoft Fabric из ИНТЕРФЕЙСА командной строки.
  • Разверните приложение в рабочей области Fabric.
  • Проверьте состояние развертывания.

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

  • Доступ к Microsoft Fabric.
  • Рабочая область Fabric, в которой у вас есть права участника, члена или администратора.
  • Рабочая нагрузка Fabric Apps включена в вашем тенанте.
  • установлен Node.js и npm.

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

Шаг 1. Создание проекта

Чтобы создать новое приложение на основе шаблона, используйте npm create:

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

Эта команда создает новую папку проекта с шаблоном приложения, rayfin конфигурацией и внешним исходным кодом.

Перейдите в каталог проекта:

cd my-app

Подсказка

Если у вас уже есть пустая папка проекта или существующий исходный код, используйте npx rayfin init вместо npm createнего.

npx rayfin init .

Шаг 2. Просмотр созданного проекта

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

  • rayfin/rayfin.yml хранит службы приложений и параметры развертывания.
  • rayfin/.env хранит значения среды, используемые интерфейсом командной строки.
  • rayfin/data/ содержит файлы модели данных.
  • Интерфейсные приложения находятся в корневой структуре проекта, созданной выбранным шаблоном.

Подробные сведения о разбивке по файлам см. в разделе "Общие сведения о структуре проекта".

Шаг 3. Локальное запуск приложения

Запустите локальную среду разработки:

npm run dev

Эта команда запускает сервер разработки фронтенда для сгенерированного приложения и развертывает серверную часть в Fabric. Чтобы убедиться, что приложение запускается правильно, откройте локальный URL-адрес, показанный в терминале.

Шаг 4. Развертывание приложения в Fabric

Создайте дополнительные возможности в приложении. После того как вы протестируете изменения, снова разверните их в Fabric.

npx rayfin up

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

npx rayfin up --dry-run

Шаг 5. Проверка развертывания

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

npx rayfin up status

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

npx rayfin up status --json

После успешного развертывания интерфейс командной строки выводит URL-адрес размещенного приложения и ссылку на портал Fabric для развернутого элемента.

Шаг 6: Разверните только базу данных или статическое содержимое

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

npx rayfin up db apply

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

npx rayfin up staticapp deploy

Устранение распространенных неполадок

Не удается войти или развертывание возвращает код 401 или 403

Снова запустите npx rayfin login, затем повторите попытку npx rayfin up.

Необходимо проверить, что будет делать CLI

Перед развертыванием изменений выполните команду npx rayfin up --dry-run.

Приложение развертывается, но вы изменяете только схему.

Чтобы отправлять изменения схемы отдельно, используйте npx rayfin up db apply. Если вы выполняете разрушительные изменения, например изменение типа столбца или удаление столбца, эта команда завершается ошибкой. Чтобы принудительно применить ваши изменения, можно использовать флаг --force. Это действие может быть критическим изменением.

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

  • Last updated on