Crie a sua primeira aplicação Fabric

As aplicações Fabric ajudam-no a construir e distribuir serviços backend mais rapidamente, fornecendo infraestrutura pronta a usar para autenticação, persistência de dados e alojamento estático. Este quickstart mostra-lhe como criar a sua primeira aplicação no Fabric.

Pré-requisitos

Ativar a aplicação Fabric nas definições de administrador do tenant

Um administrador de tenant Fabric deve ativar a carga de trabalho da aplicação Fabric antes de os utilizadores poderem criar itens Rayfin. Se não for administrador de inquilinos, contacte o administrador do Fabric da sua organização para completar este passo.

  1. Inicie sessão no portal de administração Fabric.
  2. Navegue até às definições do Inquilino.
  3. Em Fabric aplicações (pré-visualização), alterne a definição para Ativado.
  4. Escolha se o ativa para toda a organização ou para grupos de segurança específicos.
  5. Selecione Aplicar.

As alterações podem demorar alguns minutos a propagar-se. Depois de a configuração estar ativada, os utilizadores no âmbito permitido podem criar aplicações Fabric nos seus espaços de trabalho.

Do zero a uma aplicação funcional

Cria e executa uma aplicação Fabric com quatro comandos. O Rayfin implementa o seu backend no Microsoft Fabric, e você executa o seu frontend localmente contra ele. Não executas o backend localmente.

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

Executa npx rayfin up status para confirmar a implementação do backend.

Deixe um agente criar a aplicação

Copie o seguinte prompt para o GitHub Copilot ou outro agente de programação que tenha acesso a um terminal:

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.

Revise os ficheiros gerados e a saída dos comandos antes de implementar a aplicação.

Crie uma aplicação a partir do portal

Abra o Fabric no seu navegador e inicie sessão com a sua conta Microsoft.

Selecionar um espaço de trabalho

Depois de iniciar sessão, selecione um espaço de trabalho no painel de navegação esquerdo. Se não tiver um espaço de trabalho existente, crie um:

  1. Selecione Espaços de Trabalho na navegação à esquerda.
  2. Selecionar novo espaço de trabalho.
  3. Introduza um nome para o espaço de trabalho e selecione a capacidade do Fabric.

Crie uma nova aplicação Fabric

  1. Na vista do espaço de trabalho, selecione Novo item.
  2. Procure App na lista de tipos de item ou deslize até a encontrar.
  3. Selecione o item da App para abrir o diálogo de criação.
  4. Introduza um nome para a sua aplicação de Fabric (por exemplo, my-rayfin-app).
  5. Selecione Criar.

Abre, edite e implemente a sua aplicação

Pode desenvolver localmente usando o Rayfin CLI.

  1. Abra um terminal à sua escolha.

  2. Usa o script de comandos CLI mostrado no portal e corre no teu terminal para descarregar a aplicação localmente.

    Example

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. Vai ao diretório do projeto.

    cd <your project directory>
    
  4. Personalize a sua aplicação editando o código diretamente ou com a ajuda do GitHub Copilot.

  5. Teste as alterações locais com a infraestrutura de back-end do Fabric utilizando o comando.

    npm run dev
    
  6. Publique as suas alterações com:

    npx rayfin up 
    

    Para implementar para outro espaço de trabalho, pode fornecer o --workspace parâmetro.

    npx rayfin up --workspace <workspacename>
    

    Para alternar entre estes dois espaços de trabalho, execute npx rayfin switch --workspace <workspace>.

Passos seguintes