Crie uma aplicação Fabric com a CLI Rayfin

Este tutorial mostra-te como usar a CLI do Rayfin para criar um projeto, executá-lo localmente e implementá-lo no Fabric. Usas o mesmo fluxo de trabalho de CLI para novas aplicações e para atualizações futuras do teu esquema ou frontend.

Neste tutorial, você:

  • Crie um projeto Fabric Apps a partir de um template.
  • Inicia a aplicação localmente.
  • Inicie sessão no Fabric através da CLI.
  • Implementa a aplicação num espaço de trabalho Fabric.
  • Verifica o estado da implementação.

Pré-requisitos

  • Acesso ao Fabric.
  • Um espaço de trabalho Fabric onde tens permissões de Contribuidor, Membro ou Administrador.
  • A carga de trabalho do Fabric Apps ativada no seu tenant.
  • Node.js e npm instalados.

Crie uma aplicação com um prompt de IA

Use o seguinte prompt com o GitHub Copilot ou outro agente de programação para criar, explorar, executar, personalizar e implementar uma aplicação Fabric:

Set up a new Fabric App project called "rayfin-app-ws".

1. Run: npm create @microsoft/rayfin@latest
2. Open the scaffolded project directory.
3. Explore the project structure and understand the Rayfin app framework.
4. Run: npm run dev
5. Make changes to the app based on my instructions.
6. When ready, deploy with: npx rayfin up

O agente executa os comandos de forma interativa e pede quaisquer definições necessárias do projeto ou espaço de trabalho. Revise os ficheiros gerados e a saída de comandos antes da implementação. Se a carga de trabalho do Fabric Apps ainda não estiver ativada, peça a um administrador do Fabric para ativar o Fabric Apps (pré-visualização) no catálogo do OneLake>Governação>Configurações>Cargas de trabalho.

Criar uma nova aplicação a partir do CLI

Para criar uma nova aplicação a partir de um modelo, use npm create:

npm create @microsoft/rayfin@latest -- my-app --workspace <workspacename>

Este comando cria uma nova pasta de projeto com o modelo da aplicação, a rayfin configuração e o código-fonte do frontend.

Vai ao diretório do projeto:

cd my-app

Sugestão

Se já tiver uma pasta de projeto vazia ou código-fonte existente, use npx rayfin init em vez de npm create.

npx rayfin init .

Revise o projeto gerado

Após a estruturação, o projeto inclui os ficheiros que precisa de começar a desenvolver:

  • rayfin/rayfin.yml Armazena serviços de aplicação e definições de implementação.
  • rayfin/.env armazena os valores do ambiente usados pela CLI.
  • rayfin/data/ contém os ficheiros do seu modelo de dados.
  • A sua aplicação frontend está na estrutura raiz do projeto criada pelo modelo selecionado.

Para uma análise detalhada ficheiro a ficheiro, veja Compreender a estrutura do projeto.

Executar a aplicação localmente

Inicie o ambiente de desenvolvimento local:

npx rayfin dev

Este comando inicia o servidor de desenvolvimento frontend para a aplicação estruturada e implanta o backend no Fabric. Para confirmar que a aplicação começa corretamente, abra o URL local mostrado no terminal.

Implemente a aplicação no Fabric

Incorpore mais funcionalidades na sua aplicação. Depois de testares as tuas alterações, implementa novamente no Fabric.

npx rayfin up

Para pré-visualizar a implementação sem fazer alterações, execute:

npx rayfin up --dry-run

Verificar a implantação

Verifique o estado atual da implementação:

npx rayfin up status

Para uma resposta legível por máquina, use a saída JSON:

npx rayfin up status --json

Após uma implementação bem-sucedida, a CLI imprime o URL da aplicação alojada e o link do portal Fabric para o item implementado.

Implementar apenas conteúdo de base de dados ou estático

Se apenas mudou o modelo de dados, aplique as alterações à base de dados sem uma redistribuição completa:

npx rayfin up db apply

Se só mudaste o código frontend, redistribui os assets estáticos:

npx rayfin up staticapp deploy

Adicionar funções

As funções são funções TypeScript que correm no servidor dentro da tua aplicação Fabric. Utilize funções lógicas que não possam ser executadas no navegador, como trabalhar com segredos, aceder a dados privilegiados e chamar serviços a jusante em nome do utilizador iniciado.

npx rayfin functions init

O GitHub Copilot pode gerar e atualizar os ficheiros e componentes necessários. Também pode pedir ao agente para executar a aplicação, depurar funções localmente e implementar a aplicação. Por exemplo, pode usar o seguinte prompt para construir um assistente de revisão de pull requests de IA usando funções:

Build an app that lets me view all pull requests for the repository
<repoURL>, chat with my Azure AI Foundry agent <agentName> to review
pull requests, and post review comments. Use functions with delegated
authentication to connect to Azure AI Foundry and Azure DevOps.

Resolver problemas comuns

O início de sessão falha ou a implementação devolve um erro 401 ou 403

Executa npx rayfin login novamente e depois tenta npx rayfin up.

É preciso verificar o que a CLI vai fazer

Antes de implementar as alterações, execute npx rayfin up --dry-run.

A aplicação é implementada, mas só mudas o esquema

Para promover alterações de esquema de forma independente, use npx rayfin up db apply. Se realizar alterações destrutivas, como alterar o tipo de uma coluna ou remover uma coluna, este comando falha. Para forçar as tuas alterações, podes usar a --force bandeira. Esta ação pode ser uma mudança decisiva.

Passos seguintes

  • Última atualização a