创建第一个Fabric应用

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

先决条件

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

在租户管理员设置中启用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.

在部署应用之前,先检查生成的文件和命令输出。

从门户创建应用

打开您的许可选项门户并登录:

  • 如需使用 Power BI Pro 体验,请使用拥有 Power BI Pro 的账户打开 Power BI 门户。
  • 对于容量支持应用,请打开 Fabric 门户。

选择工作区

选择一个具有贡献者或管理员权限的工作区。 使用 Pro 工作区来体验 Power BI Pro,或者使用分配给 Fabric 容量或有效 Fabric 试用版的工作区来创建容量支持的应用。

如果您没有现有工作区,请创建一个:

  1. 在左侧导航中选择 工作区 。
  2. 选择新建工作区。
  3. 输入工作区的名称。
  4. 为您的部署选择工作区许可模式:选择 Pro 以享受 Power BI Pro 体验,或选择相应容量选项以支持容量支持的应用。

专业选项无需分配 Fabric 容量。 在创建应用之前,请先查看 Power BI Pro 的限制。 对于任一选项,请继续执行以下应用创建步骤。

创建一个新的 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>。

后续步骤