Criar um aplicativo Fabric com a CLI do Rayfin

Este tutorial mostra como usar a CLI do Rayfin para criar um projeto, executá-lo localmente e implantá-lo no Fabric. Você usa o mesmo fluxo de trabalho da CLI para novos aplicativos e para atualizações posteriores em seu esquema ou front-end.

Neste tutorial, você:

  • Crie um projeto de aplicativos Fabric a partir de um modelo.
  • Inicie o aplicativo localmente.
  • Faça login no Fabric pela CLI.
  • Implante o aplicativo em um workspace Fabric.
  • Verifique o status da implantação.

Pré-requisitos

  • Acesso ao Fabric.
  • Um workspace Fabric em que você tem permissões de Colaborador, Membro ou Administrador.
  • A carga de trabalho Fabric Aplicativos habilitada em seu locatário.
  • Node.js e npm instalados.

Crie um aplicativo 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 implantar um aplicativo 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 solicita quaisquer configurações necessárias de projeto ou espaço de trabalho. Revise os arquivos gerados e a saída de comandos antes da implantação. Se a carga de trabalho do Fabric Apps ainda não estiver habilitada, peça a um administrador do Fabric que ative o Fabric Apps (versão prévia) em Catálogo do OneLake>>>Cargas de trabalho.

Crie um novo app a partir da CLI

Para criar um novo aplicativo a partir de um modelo, use npm create:

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

Esse comando cria uma nova pasta de projeto com o modelo de aplicativo, a rayfin configuração e o código-fonte de front-end.

Vá para o diretório do projeto:

cd my-app

Dica

Se você 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 gerar a estrutura do projeto, o projeto inclui os arquivos necessários para iniciar o desenvolvimento:

  • rayfin/rayfin.yml armazena os serviços de aplicativo e as configurações de implantação.
  • rayfin/.env armazena valores de ambiente usados pela CLI.
  • rayfin/data/ contém seus arquivos de modelo de dados.
  • Seu aplicativo de front-end reside na estrutura de projeto raiz criada pelo modelo selecionado.

Para obter uma análise detalhada de arquivo por arquivo, consulte Noções básicas sobre a estrutura do projeto.

Executar o aplicativo localmente

Inicie o ambiente de desenvolvimento local:

npx rayfin dev

Esse comando inicia o servidor de desenvolvimento de front-end para o aplicativo scaffolded e implanta o back-end no Fabric. Para confirmar se o aplicativo é iniciado corretamente, abra a URL local mostrada no terminal.

Implante o aplicativo no Fabric

Crie mais recursos em seu aplicativo. Depois de testar suas alterações, implante no Fabric novamente.

npx rayfin up

Para visualizar a implantação sem fazer alterações, execute:

npx rayfin up --dry-run

Verificar a implantação

Verifique o estado de implantação atual:

npx rayfin up status

Para uma resposta legível por computador, use a saída JSON:

npx rayfin up status --json

Após uma implantação bem-sucedida, a CLI imprime a URL do aplicativo hospedado e o link do portal Fabric para o item implantado.

Implantar apenas conteúdo de banco de dados ou estático

Se você alterou apenas os modelos de dados, aplique as alterações de banco de dados sem uma reimplantação completa:

npx rayfin up db apply

Se você alterou apenas o código de front-end, reimplante os ativos estáticos:

npx rayfin up staticapp deploy

Adicionar funções

Funções são funções TypeScript que rodam no servidor dentro do seu aplicativo Fabric. Use funções para lógica que não deve rodar no navegador, como trabalhar com segredos, acessar dados privilegiados e chamar serviços posteriores em nome do usuário logado.

npx rayfin functions init

O GitHub Copilot pode gerar e atualizar os arquivos e componentes necessários. Você também pode pedir para o agente rodar o app, depurar funções localmente e implantar o app. Por exemplo, você 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.

Solucionar problemas comuns

Falha ao entrar ou a implantação retorna 401 ou 403

Execute npx rayfin login novamente e tente novamente npx rayfin up.

Você precisa verificar o que a CLI fará

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

O aplicativo é implantado, mas você altera apenas o esquema

Para aplicar alterações no esquema independentemente, use npx rayfin up db apply. Se você executar alterações destrutivas, como alterar o tipo de uma coluna ou remover uma coluna, esse comando falhará. Para forçar suas alterações, você pode usar o --force sinalizador. Essa ação pode ser uma alteração significativa.

Próximas Etapas 

  • Última atualização em