Tworzenie pierwszej aplikacji Fabric

Fabric aplikacje pomagają tworzyć i dostarczać usługi zaplecza szybciej, zapewniając gotową do użycia infrastrukturę na potrzeby uwierzytelniania, trwałości danych i hostingu statycznego. W tym przewodniku Szybki start pokazano, jak utworzyć pierwszą aplikację w Fabric.

Wymagania wstępne

Włączanie aplikacji Fabric w ustawieniach administratora dzierżawy

Administrator dzierżawy Fabric musi włączyć obciążenie aplikacji Fabric, zanim użytkownicy będą mogli tworzyć elementy Rayfin. Jeśli nie jesteś administratorem dzierżawy, skontaktuj się z administratorem usługi Fabric w organizacji, aby ukończyć ten krok.

  1. Zaloguj się do portalu administracyjnego Fabric.
  2. Przejdź do Ustawienia dzierżawy.
  3. W sekcji Aplikacje Fabric (wersja zapoznawcza) przełącz ustawienie na Włączone.
  4. Określ, czy ma ona być włączona dla całej organizacji, czy określonych grup zabezpieczeń.
  5. Wybierz i zastosuj.

Propagacja zmian może potrwać kilka minut. Po włączeniu tego ustawienia użytkownicy w dozwolonym zakresie mogą tworzyć aplikacje Fabric w swoich obszarach roboczych.

Od niczego do działającej aplikacji

Stwórz i uruchom aplikację Fabric z czterema poleceniami. Rayfin wdraża backend na Microsoft Fabric, a frontend uruchamiasz lokalnie na nim. Nie uruchamiasz backendu lokalnie.

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

Uruchom npx rayfin up status, aby potwierdzić wdrożenie backendu.

Pozwól agentowi stworzyć aplikację

Skopiuj poniższy prompt do GitHub Copilot lub innego agenta kodującego, który ma dostęp do terminala:

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.

Przejrzyj wygenerowane pliki i wynik poleceń przed wdrożeniem aplikacji.

Stwórz aplikację z portalu

Otwórz Fabric w przeglądarce i zaloguj się przy użyciu konto Microsoft.

Wybieranie obszaru roboczego

Po zalogowaniu wybierz obszar roboczy z panelu nawigacji po lewej stronie. Jeśli nie masz istniejącego obszaru roboczego, utwórz go:

  1. Wybierz pozycję Obszary robocze w obszarze nawigacji po lewej stronie.
  2. Wybierz pozycję Nowy obszar roboczy.
  3. Wprowadź nazwę obszaru roboczego i wybierz pojemność usługi Fabric.

Stwórz nową aplikację Fabric

  1. W widoku obszaru roboczego wybierz pozycję Nowy element.
  2. Wyszukaj pozycję Aplikacja na liście typów elementów lub przewiń ją, aby ją znaleźć.
  3. Wybierz pozycję Element aplikacji, aby otworzyć okno dialogowe tworzenia.
  4. Wprowadź nazwę aplikacji Fabric (na przykład my-rayfin-app).
  5. Wybierz Utwórz.

Otworz, edytuj i wdroż swoją aplikację

Możesz opracowywać lokalnie przy użyciu interfejsu wiersza polecenia Rayfin.

  1. Otwórz wybrany terminal.

  2. Użyj skryptu polecenia CLI wyświetlanego w portalu i uruchom go w terminalu, aby pobrać aplikację na komputer lokalny.

    Example

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. Przejdź do katalogu projektu.

    cd <your project directory>
    
  4. Dostosuj aplikację, edytując kod bezpośrednio lub za pomocą GitHub Copilot.

  5. Przetestuj zmiany lokalne przy użyciu zaplecza Fabric za pomocą polecenia .

    npm run dev
    
  6. Opublikuj zmiany za pomocą:

    npx rayfin up 
    

    Aby wdrożyć do innego obszaru roboczego, możesz podać parametr --workspace.

    npx rayfin up --workspace <workspacename>
    

    Aby przełączyć się między tymi dwoma obszarami roboczymi, uruchom polecenie npx rayfin switch --workspace <workspace>.

Następne kroki