创建第一个Fabric应用

Fabric应用通过提供可用于身份验证、数据持久性和静态托管的现成基础结构，帮助你更快地生成和交付后端服务。 本快速入门介绍如何在 Fabric 中创建第一个应用。

先决条件

  • 可访问 Fabric 的 Microsoft 帐户。
  • 你在其中具有参与者或管理员权限的 Fabric 工作区。
  • 在设置中由租户管理员启用的 Fabric 应用 请参阅租户管理员设置中的 Enable Fabric 应用。
  • Node.js 20 或更高版本。

在租户管理员设置中启用Fabric应用

Fabric租户管理员必须先启用Fabric应用工作负载，然后用户才能创建 Rayfin 项。 如果你不是租户管理员，请联系你所在组织的 Fabric 管理员，以完成此步骤。

  1. 登录到 Fabric 管理门户。
  2. 导航到 租户设置。
  3. 在 Fabric apps （preview） 下，将设置切换为 Enabled。
  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并使用Microsoft 帐户登录。

选择工作区

登录后，从左侧导航面板中选择工作区。 如果没有现有工作区，请创建一个：

  1. 在左侧导航中选择 工作区 。
  2. 选择新建工作区。
  3. 输入工作区名称，然后选择 Fabric 容量。

创建一个新的 Fabric 应用

  1. 在工作区视图中，选择“ 新建项”。
  2. 在项目类型列表中搜索 应用 或滚动以查找它。
  3. 选择 “应用 ”项以打开“创建”对话框。
  4. 输入Fabric应用的名称（例如，my-rayfin-app）。
  5. 选择“创建”。

打开、编辑并部署你的应用

可以使用 Rayfin CLI 在本地开发。

  1. 打开所选终端。

  2. 使用门户中显示的 CLI 命令脚本，并在终端中运行，在本地下载应用。

    示例

    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>。

后续步骤

相关内容

  • 上次更新时间为