Создание первого приложения Fabric

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

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

Включить приложение Fabric в параметрах администратора клиента

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

  1. Войдите на портал администрирования Fabric.
  2. Перейдите к параметрам клиента.
  3. В разделе приложения Fabric (предварительная версия) установите для параметра значение Включено.
  4. Выберите, следует ли включить его для всей организации или определенных групп безопасности.
  5. Нажмите кнопку "Применить".

Для распространения изменений может потребоваться несколько минут. После включения этого параметра пользователи в пределах разрешенной области могут создавать приложения Fabric в своих рабочих областях.

От нуля к запущенному приложению

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

npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev

Запустите npx rayfin up status, чтобы подтвердить развертывание бэкенда.

Пусть агент создаёт приложение

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

Set up a new Rayfin app for me, end to end.

Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.

Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.

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

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

Откройте Fabric в браузере и войдите с помощью учетная запись Майкрософт.

Выберите рабочую область

После входа выберите рабочую область на левой панели навигации. Если у вас нет существующей рабочей области, создайте ее:

  1. Выберите Рабочие области в левой панели навигации.
  2. Выберите новую рабочую область.
  3. Введите имя рабочей области и выберите емкость Fabric.

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

  1. В представлении рабочей области выберите новый элемент.
  2. Найдите приложение в списке типов элементов или прокрутите его, чтобы найти его.
  3. Выберите элемент приложения , чтобы открыть диалоговое окно создания.
  4. Введите имя приложения Fabric (например, my-rayfin-app).
  5. Нажмите кнопку "Создать".

Откройте, отредактируйте и разверните своё приложение

Вы можете разрабатывать локально с помощью интерфейса командной строки Rayfin.

  1. Откройте терминал вашего выбора.

  2. Используйте скрипт команды CLI, показанный на портале, и запустите в терминале, чтобы скачать приложение локально.

    Example

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. Перейдите в каталог проекта.

    cd <your project directory>
    
  4. Настройте приложение, изменив код непосредственно или с помощью GitHub Copilot.

  5. Проверьте локальные изменения с серверной частью Fabric с помощью команды.

    npm run dev
    
  6. Публикация изменений с помощью:

    npx rayfin up 
    

    Чтобы выполнить развертывание в другой рабочей области, можно указать параметр --workspace.

    npx rayfin up --workspace <workspacename>
    

    Чтобы переключиться между этими двумя рабочими областями, выполните команду npx rayfin switch --workspace <workspace>.

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