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

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

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

  • Создайте проект Fabric Apps на основе шаблона.
  • Запустите приложение локально.
  • Войдите в Fabric через интерфейс командной строки.
  • Разверните приложение в рабочей области Fabric.
  • Проверьте состояние развертывания.

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

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

Создайте приложение с AI-подсказкой

Используйте следующее задание с GitHub Copilot или другим программным агентом для создания, исследования, запуска, настройки и развертывания приложения Fabric:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

Агент выполняет команды интерактивно и запрашивает необходимые настройки проекта или рабочего пространства. Просматривайте сгенерированные файлы и командные выводы перед развертыванием. Если рабочая нагрузка Fabric Apps ещё не включена, попросите администратора Fabric включить Fabric Apps (предпросмотр) в каталоге>OneLake Govern>Configurations>Workloads.

Создайте новое приложение из CLI

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

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

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

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

cd my-app

Подсказка

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

npx rayfin init .

Просмотр сгенерированного проекта

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

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

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

Локальный запуск приложения

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

npx rayfin dev

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

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

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

npx rayfin up

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

npx rayfin up --dry-run

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

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

npx rayfin up status

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

npx rayfin up status --json

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

Развёртывайте только базу данных или статический контент

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

npx rayfin up db apply

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

npx rayfin up staticapp deploy

Добавить функции

Функции — это функции TypeScript, которые работают на сервере внутри вашего приложения Fabric. Используйте функции логики, которые не должны выполняться в браузере, такие как работа с секретами, доступ к привилегированным данным и вызов последующих сервисов от имени авторизованного пользователя.

npx rayfin functions init

GitHub Copilot может генерировать и обновлять необходимые файлы и компоненты. Вы также можете попросить агента запустить приложение, локально отладить функции и развернуть приложение. Например, вы можете использовать следующий промпт, чтобы создать ИИ-ассистента для проверки pull request с помощью функций:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

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

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

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

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

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

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

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

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

  • Последнее обновление: