Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
As aplicações Fabric ajudam-no a construir e distribuir serviços backend mais rapidamente, fornecendo infraestrutura pronta a usar para autenticação, persistência de dados e alojamento estático. Este quickstart mostra-lhe como criar a sua primeira aplicação no Fabric.
Pré-requisitos
- Uma conta Microsoft com acesso ao Fabric.
- Um espaço de trabalho Fabric onde tens permissões de contribuidor ou administrador.
- Aplicação Fabric ativada por um administrador do inquilino nas definições. Consulte Ativar a aplicação Fabric nas definições de administração do inquilino.
- Node.js 20 ou posterior.
Ativar a aplicação Fabric nas definições de administrador do tenant
Um administrador de tenant Fabric deve ativar a carga de trabalho da aplicação Fabric antes de os utilizadores poderem criar itens Rayfin. Se não for administrador de inquilinos, contacte o administrador do Fabric da sua organização para completar este passo.
- Inicie sessão no portal de administração Fabric.
- Navegue até às definições do Inquilino.
- Em Fabric aplicações (pré-visualização), alterne a definição para Ativado.
- Escolha se o ativa para toda a organização ou para grupos de segurança específicos.
- Selecione Aplicar.
As alterações podem demorar alguns minutos a propagar-se. Depois de a configuração estar ativada, os utilizadores no âmbito permitido podem criar aplicações Fabric nos seus espaços de trabalho.
Do zero a uma aplicação funcional
Cria e executa uma aplicação Fabric com quatro comandos. O Rayfin implementa o seu backend no Microsoft Fabric, e você executa o seu frontend localmente contra ele. Não executas o backend localmente.
npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev
Executa npx rayfin up status para confirmar a implementação do backend.
Deixe um agente criar a aplicação
Copie o seguinte prompt para o GitHub Copilot ou outro agente de programação que tenha acesso a um terminal:
Set up a new Rayfin app for me, end to end.
Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.
Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.
Revise os ficheiros gerados e a saída dos comandos antes de implementar a aplicação.
Crie uma aplicação a partir do portal
Abra o Fabric no seu navegador e inicie sessão com a sua conta Microsoft.
Selecionar um espaço de trabalho
Depois de iniciar sessão, selecione um espaço de trabalho no painel de navegação esquerdo. Se não tiver um espaço de trabalho existente, crie um:
- Selecione Espaços de Trabalho na navegação à esquerda.
- Selecionar novo espaço de trabalho.
- Introduza um nome para o espaço de trabalho e selecione a capacidade do Fabric.
Crie uma nova aplicação Fabric
- Na vista do espaço de trabalho, selecione Novo item.
- Procure App na lista de tipos de item ou deslize até a encontrar.
- Selecione o item da App para abrir o diálogo de criação.
- Introduza um nome para a sua aplicação de Fabric (por exemplo,
my-rayfin-app). - Selecione Criar.
Abre, edite e implemente a sua aplicação
Pode desenvolver localmente usando o Rayfin CLI.
Abra um terminal à sua escolha.
Usa o script de comandos CLI mostrado no portal e corre no teu terminal para descarregar a aplicação localmente.
Example
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>Vai ao diretório do projeto.
cd <your project directory>Personalize a sua aplicação editando o código diretamente ou com a ajuda do GitHub Copilot.
Teste as alterações locais com a infraestrutura de back-end do Fabric utilizando o comando.
npm run devPublique as suas alterações com:
npx rayfin upPara implementar para outro espaço de trabalho, pode fornecer o
--workspaceparâmetro.npx rayfin up --workspace <workspacename>Para alternar entre estes dois espaços de trabalho, execute
npx rayfin switch --workspace <workspace>.
Passos seguintes
- Explore modelos de dados e decoradores para definir o seu esquema de backend.
- Aprenda a ligar interfaces frontend através do guia de GraphQL.
- Configurar autenticação com autenticação.