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 Microsoft 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 Microsoft Fabric pela CLI.
  • Implante o aplicativo em um workspace Fabric.
  • Verifique o status da implantação.

Pré-requisitos

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

Se a carga de trabalho Fabric Aplicativos ainda não estiver habilitada, peça a um administrador do Fabric para ativar Fabric Apps (versão prévia) no portal de administração do Fabric.

Etapa 1: Criar um projeto

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 .

Etapa 2: Examinar 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.

Etapa 3: Executar o aplicativo localmente

Inicie o ambiente de desenvolvimento local:

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

Etapa 4: Implantar 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

Etapa 5: 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.

Etapa 6: Implante apenas banco de dados ou conteúdo 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

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 

  • Last updated on