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

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

前提条件

  • Fabric にアクセスできる Microsoft アカウント。
  • 共同作成者または管理者のアクセス許可を持つFabric ワークスペース。
  • 設定でテナント管理者が有効化した Fabric アプリです。 テナント管理者の設定でEnable Fabric アプリを参照してください。
  • Node.js 20 以降。

テナント管理者設定Fabricアプリを有効にする

Fabric テナント管理者は、ユーザーが Rayfin 項目を作成する前に、Fabric アプリワークロードを有効にする必要があります。 テナント管理者でない場合は、組織のFabric管理者に連絡して、この手順を完了してください。

  1. Fabric 管理ポータルにサインインします。
  2. [テナント設定] に移動します。
  3. [Fabric アプリ (プレビュー) で、設定を Enabled に切り替えます。
  4. 組織全体または特定のセキュリティ グループに対して有効にするかどうかを選択します。
  5. を選択してを適用します。

変更が反映されるまでに数分かかる場合があります。 設定を有効にすると、許可されたスコープ内のユーザーは、ワークスペースにFabricアプリを作成できます。

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

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.

アプリを展開する前に、生成されたファイルやコマンド出力を確認しましょう。

ポータルからアプリを作成する

ブラウザーでFabricを開き、Microsoft アカウントでサインインします。

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

サインインした後、左側のナビゲーション パネルからワークスペースを選択します。 既存のワークスペースがない場合は、次のものを作成します。

  1. 左側のナビゲーションで [ワークスペース] を選択します。
  2. 新しいワークスペースを選択します。
  3. ワークスペースの名前を入力し、Fabric 容量を選択します。

新しいFabricアプリを作成する

  1. ワークスペース ビューで、[ 新しい項目] を選択します。
  2. 項目の種類の一覧で アプリ を検索するか、スクロールして検索します。
  3. [ アプリ ] 項目を選択して作成ダイアログを開きます。
  4. Fabric アプリの名前を入力します (例: my-rayfin-app)。
  5. を選択してを作成します。

アプリを開いて編集し、デプロイしてください

Rayfin CLI を使用してローカルで開発できます。

  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>

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

次のステップ

関連するコンテンツ

  • 最終更新: