Implemente uma aplicação Fabric no Fabric

Implemente uma aplicação Fabric para Fabric iniciando sessão, executando o fluxo de implementação da CLI e revisando o que o npx rayfin up configura para a sua aplicação. Este artigo percorre o conceito do que acontece durante a implantação.

Pré-requisitos

• Um projeto Fabric Apps com um ficheiro de configuração rayfin/rayfin.yml. Se ainda não tens um projeto, vê Cria o teu primeiro projeto Fabric Apps.
• Uma conta Microsoft Entra ID com acesso a um espaço de trabalho Fabric.

Implementar a sua aplicação

Execute o seguinte comando a partir da raiz do seu projeto:

npx rayfin up

Se não tiver iniciado sessão, a CLI inicia automaticamente um processo interativo de início de sessão.

O que a implantação faz

O rayfin up comando executa estes passos por ordem:

1. Cria um item Fabric Apps no seu espaço de trabalho Fabric (ou reutiliza o existente em implementações subsequentes).
2. Recupera a chave publicável do serviço remoto.
3. Sincroniza as definições de execução do seu rayfin.yml para o serviço remoto, incluindo a configuração de autenticação e as opções do serviço.
4. Aplica o esquema da base de dados gerado pelos decoradores do seu modelo de dados TypeScript.
5. Constrói e implementa conteúdo estático se staticHosting estiver ativado em rayfin.yml—executa o comando de compilação, empacota a pasta de saída num ZIP e carrega-a.
6. Guarda os detalhes da implementação nos ficheiros rayfin.yml e .env.fabric-* para implementações posteriores.

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

• A URL de alojamento onde a sua aplicação está ativa
• Um link do portal Fabric para gerir a implementação
• O ID de implementação para consulta

Configurar a autenticação

Apenas a autenticação mediada do Fabric (Entra SSO) é suportada em aplicações implementadas. A autenticação por email e palavra-passe está disponível durante o desenvolvimento local, mas não funciona após a implementação no Fabric.

Assegura-te de que o teu rayfin.yml tem autenticação Fabric ativada antes de executar rayfin up:

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

Implementação de pré-visualização sem alterações

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

npx rayfin up --dry-run

Aplicar alterações na base de dados

Após atualizar os seus modelos de dados, envie as alterações do esquema para a base de dados remota sem ter de voltar a implementar toda a stack:

npx rayfin up db apply

Se a alteração do esquema envolver operações potencialmente destrutivas (eliminar colunas, renomear tabelas), a CLI avisa e recusa-se a avançar. Use --force para anular a verificação de segurança:

npx rayfin up db apply --force

Reimplantar conteúdo estático

Quando só mudaste o código frontend, reimplanta conteúdo estático de forma independente para um ciclo de iteração mais rápido:

npx rayfin up staticapp deploy

Este comando executa o seu configurado buildCommand, empacota a saída e carrega-a para o serviço remoto.

Para saltar a etapa de compilação e implementar a saída existente:

npx rayfin up staticapp deploy --skip-build

Verificar o estado da implementação

Veja o estado atual da sua implementação do Fabric:

npx rayfin up status

Adicionar --json para saída legível por máquina:

npx rayfin up status --json

Atualizar implementações existentes

Após a primeira implementação, rayfin.yml armazena os detalhes da implementaçã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, utilize os subcomandos:

Solucionar problemas de implantação

A implementação falha com erro 401 ou 403

A tua sessão pode ter expirado. Execute npx rayfin login para se reautenticar e, em seguida, tente novamente npx rayfin up.

A aplicação da base de dados reporta alterações destrutivas

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

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

O arquivo comprimido não deve exceder 100 MB. Otimize a saída da sua build excluindo os mapas de origem e os grandes recursos de desenvolvimento, ou mova ficheiros binários para armazenamento do Fabric Apps.

Gere a tua aplicação no portal Fabric

Após a implementação, pode gerir a sua aplicação de Fabric diretamente no portal Fabric.

Visualizar propriedades do item

Abra a aplicação Fabric no portal Fabric para ver:

• URL da aplicação — O URL público onde o seu conteúdo estático está alojado.
• URL de backend da aplicação — O URL de base para todos os serviços de backend.

Gerir os serviços de proteção à criança

Selecione a aplicação Fabric para ver os serviços de proteção à criança:

• SQL Database — Abre o editor de consultas SQL Fabric. Pode executar consultas de leitura sobre os seus dados. As alterações de esquema feitas diretamente no portal de Fabric são sobrescritas na próxima implementação rayfin up.
• Autenticação — Visualize e gere os utilizadores autenticados na tabela Users da base de dados SQL filha.

Permissões de aplicações

Qualquer colaborador da aplicação Fabric precisa de ter, no mínimo, permissão Edit no item para implementar uma aplicação Fabric.

Conteúdo relacionado

• Crie o seu primeiro projeto Fabric Apps
• Definir modelos de dados com decoradores TypeScript
• Compreender a estrutura do projeto do Fabric Apps