Crie uma aplicação Fabric com a CLI Rayfin

Este tutorial mostra-te como usar a CLI Rayfin para criar um projeto, executá-lo localmente e implementá-lo no Microsoft 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 Microsoft Fabric através da interface de linha de comandos.
  • Implementa a aplicação num espaço de trabalho Fabric.
  • Verifica o estado da implementação.

Pré-requisitos

  • Acesso ao Microsoft 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.

Se a carga de trabalho Fabric Apps ainda não estiver ativada, pede a um administrador de Fabric para ativar Fabric Apps (pré-visualização) no portal de administração Fabric.

Etapa 1: Criar um novo projeto

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 .

Passo 2: Rever 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.

Passo 3: Executar a aplicação localmente

Inicie o ambiente de desenvolvimento local:

npm run 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.

Passo 4: 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

Passo 5: Verificar a implementaçã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.

Passo 6: Implementar apenas a base de dados ou conteúdo 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

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

  • Last updated on