Implantar um aplicativo do Fabric no Fabric

Implante um aplicativo do Fabric no Fabric fazendo login, seguindo o fluxo de implantação da CLI e analisando como o npx rayfin up configura seu aplicativo. Este artigo aborda o conceito do que acontece durante a implantação.

Pré-requisitos

  • Um projeto Fabric Apps com um arquivo de configuração rayfin/rayfin.yml. Se você ainda não tiver um projeto, consulte Criar seu primeiro projeto Fabric Apps.
  • Uma conta do Microsoft Entra ID com acesso a um espaço de trabalho do Fabric.

Implantar seu aplicativo

Execute o seguinte comando na raiz do projeto:

npx rayfin up

Se você não estiver conectado, a CLI iniciará um fluxo de entrada interativo automaticamente.

O que a implantação faz

O rayfin up comando executa estas etapas na ordem:

  1. Cria um item de Aplicativos do Fabric no seu espaço de trabalho do Fabric (ou reutiliza o item existente nas implantações subsequentes).
  2. Recupera a chave publicável do serviço remoto.
  3. Sincroniza as configurações de tempo de execução do seu rayfin.yml para o serviço remoto, incluindo a configuração de autenticação e as flags do serviço.
  4. Aplica o esquema de banco de dados gerado de seus decoradores de modelo de dados TypeScript.
  5. Compila e implanta conteúdo estático se staticHosting estiver habilitado em rayfin.yml— executa seu comando de build, empacota a pasta de saída em um ZIP e o carrega.
  6. Salva os detalhes da implantação nos arquivos rayfin.yml e .env.fabric-* para implantações posteriores.

Após a implantação, a CLI imprime:

  • A URL de hospedagem em que seu aplicativo está ativo
  • Um link do portal Fabric para gerenciar a implantação
  • A ID de implantação para referência

Configurar autenticação

Somente a autenticação agenciada do Fabric (Entra SSO) é compatível com aplicativos implantados. A autenticação de email e senha está disponível durante o desenvolvimento local, mas não funciona após a implantação no Fabric.

Verifique se a autenticação do Fabric está habilitada no rayfin.yml antes de executar rayfin up:

services:
  auth:
    enabled: true
    fabric:
      enabled: true

Versão prévia da implantação sem alterações

Use --dry-run para ver o que a CLI faria sem criar ou modificar recursos:

npx rayfin up --dry-run

Aplicar alterações de banco de dados

Depois de atualizar seus modelos de dados, envie as alterações no esquema para o banco de dados remoto sem fazer uma nova implantação de toda a pilha:

npx rayfin up db apply

Se a alteração do esquema envolver operações potencialmente destrutivas (remover colunas, renomear tabelas), a CLI avisará você e se recusará a continuar. Use --force para substituir a verificação de segurança:

npx rayfin up db apply --force

Caution

O uso --force pode causar perda de dados. Examine as operações listadas com cuidado e confirme se aceita as consequências antes de prosseguir.

Reimplantar conteúdo estático

Quando você alterou apenas o código de front-end, reimplante o conteúdo estático de forma independente para um ciclo de iteração mais rápido:

npx rayfin up staticapp deploy

Esse comando executa sua configuração buildCommand, empacota a saída e a carrega no serviço remoto.

Para ignorar a etapa de compilação e implantar a saída já gerada:

npx rayfin up staticapp deploy --skip-build

Verificar o status da implantação

Exiba o estado atual da implantação do Fabric:

npx rayfin up status

Adicionar --json para saída legível pelo computador:

npx rayfin up status --json

Atualizar implantações existentes

Após a primeira implantação, rayfin.yml armazena os detalhes da implantação (rayfinItemId, fabricWorkspaceId e o endpoint do item). Executar npx rayfin up novamente atualiza a mesma implantação em vez de criar uma nova.

Para atualizações direcionadas, use os subcomandos:

Comando O que ele atualiza
npx rayfin up Tudo: configurações, banco de dados e conteúdo estático.
npx rayfin up db apply Somente esquema de banco de dados.
npx rayfin up staticapp deploy Somente conteúdo estático.

Solucionar problemas de implantação

A implantação falha com erro 401 ou 403

Sua sessão pode ter expirado. Execute npx rayfin login para reautenticar e tente novamente npx rayfin up.

Relatórios de aplicação do banco de dados indicam alterações destrutivas

A CLI do Rayfin bloqueia alterações de esquema que podem causar perda de dados. Examine as operações listadas e use npx rayfin up db apply --force somente depois de confirmar que aceita a perda de dados.

A implantação estática excede o limite de tamanho

O arquivo compactado não deve exceder 100 MB. Otimize a saída da compilação excluindo mapas de código-fonte e recursos de desenvolvimento grandes ou movendo arquivos binários para o armazenamento do Fabric Apps.

Gerenciar seu aplicativo no portal Fabric

Após a implantação, você pode gerenciar seu aplicativo Fabric diretamente no Fabric portal.

Exibir propriedades do item

Abra o aplicativo Fabric no portal do Fabric para ver:

  • URL do aplicativo — A URL pública em que seu conteúdo estático está hospedado.
  • URL de back-end do aplicativo — A URL base de todos os serviços de back-end.

Gerenciar serviços filho

Selecione o aplicativo Fabric para ver seus serviços filho:

  • SQL Database — abre o editor de consultas SQL Fabric. Você pode executar consultas de leitura em seus dados. As alterações de esquema feitas diretamente no portal do Fabric são sobrescritas no próximo rayfin up deploy.
  • Autenticação – exibir e gerenciar usuários autenticados na tabela Usuários no Banco de Dados SQL filho.

Permissões de aplicativos

Para quaisquer colaboradores do aplicativo Fabric, para implantar um aplicativo Fabric, eles precisam ter, no mínimo, a permissão Edit no item.

Conteúdo relacionado

  • Last updated on