Criar seu primeiro aplicativo Fabric

Fabric aplicativos ajudam você a criar e enviar serviços de back-end mais rapidamente, fornecendo infraestrutura pronta para uso para autenticação, persistência de dados e hospedagem estática. Este início rápido mostra como criar seu primeiro aplicativo em Fabric.

Pré-requisitos

Habilitar o aplicativo Fabric nas configurações de administrador do locatário

Um administrador de locatários Fabric deve habilitar a carga de trabalho do aplicativo Fabric antes que os usuários possam criar itens do Rayfin. Se você não for um administrador de locatários, entre em contato com o administrador Fabric da sua organização para concluir esta etapa.

  1. Entre no portal de administração do Fabric.
  2. Navegue até Configurações do locatário.
  3. Em Fabric aplicativos (versão prévia), alterne a configuração para Enabled.
  4. Escolha se deseja habilitá-lo para toda a organização ou grupos de segurança específicos.
  5. Selecione Aplicar.

As alterações podem levar alguns minutos para serem propagadas. Depois que a configuração estiver habilitada, os usuários no escopo permitido poderão criar aplicativos Fabric em seus workspaces.

Do zero a um aplicativo em execução

Crie e execute um aplicativo Fabric com quatro comandos. O Rayfin implanta seu backend no Microsoft Fabric, e você roda seu frontend localmente contra ele. Você não roda o backend localmente.

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

Execute npx rayfin up status para confirmar a implantação do backend.

Deixe um agente criar o aplicativo

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 arquivos gerados e a saída dos comandos antes de implantar o app.

Crie um aplicativo a partir do portal

Abra Fabric no navegador e entre com seu conta Microsoft.

Selecionar um workspace

Depois de fazer login, selecione um espaço de trabalho no painel de navegação à esquerda. Se você não tiver um workspace existente, crie um:

  1. Selecione Workspaces na navegação à esquerda.
  2. Selecione Novo workspace.
  3. Digite um nome para o espaço de trabalho e selecione a capacidade do Fabric.

Crie um novo aplicativo Fabric

  1. No modo de exibição do workspace, selecione Novo item.
  2. Procure por App na lista de tipos de item ou role a lista até encontrá-lo.
  3. Selecione o item App para abrir a caixa de diálogo de criação.
  4. Insira um nome para seu aplicativo Fabric (por exemplo, my-rayfin-app).
  5. Selecione Criar.

Abra, edite e implante seu aplicativo

Você pode desenvolver localmente usando a CLI do Rayfin.

  1. Abra um terminal de sua escolha.

  2. Use o script de comando da CLI mostrado no portal e execute no terminal para baixar o aplicativo localmente.

    Example

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. Vá para o diretório do projeto.

    cd <your project directory>
    
  4. Personalize seu aplicativo editando o código diretamente ou com a ajuda de GitHub Copilot.

  5. Teste as alterações locais no backend do Fabric com o comando.

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

    npx rayfin up 
    

    Para implantar em outro workspace, você pode fornecer o --workspace parâmetro.

    npx rayfin up --workspace <workspacename>
    

    Para alternar entre esses dois workspaces, execute npx rayfin switch --workspace <workspace>.

Próximas Etapas