初めてのFabric アプリを作成する

Fabric アプリは、認証、データ永続化、静的ホスティングにすぐに使用できるインフラストラクチャを提供することで、バックエンド サービスの構築と出荷を迅速に行うのに役立ちます。 このクイック スタートでは、Fabricで最初のアプリを作成する方法について説明します。

前提条件

  • Fabric または Power BI Pro ライセンスにアクセスできる Microsoft アカウント が必要です。
  • コントリビューターまたは管理者権限を持つワークスペース。
  • 最新 Node.js バージョン

何もない状態から稼働中のアプリへ

4つのコマンドで使う 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 ポータルを開きます。

ワークスペースを選択する

コントリビューターまたは管理者権限があるワークスペースを選択します。 Power BI Pro エクスペリエンスには Pro ワークスペースを使用するか、Fabric 容量に割り当てられたワークスペース、またはキャパシティバック アプリの場合はアクティブな Fabric トライアルを利用します。

既存のワークスペースがない場合は、ワークスペースを 1 つ作成してください:

  1. 左側のナビゲーションで [ワークスペース] を選択します。
  2. 新しいワークスペースを選択します。
  3. ワークスペースの名前を入力します。
  4. デプロイのワークスペース ライセンス モードを選択します: Power BI Pro エクスペリエンスには Pro、または容量ベースのアプリには適切な容量オプションを選択します。

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>
    

    これら 2 つのワークスペースを切り替えるには、 npx rayfin switch --workspace <workspace>実行します。

次のステップ