Configurar seu ambiente (visualização)

Este artigo destina-se a desenvolvedores que desejam criar uma carga de trabalho usando o Microsoft Fabric Workload Development Kit. O artigo irá guiá-lo através do processo de configuração do seu ambiente de desenvolvimento para que você possa começar a criar sua carga de trabalho.

Pré-requisitos

As etapas a seguir são necessárias antes de começar com o desenvolvimento da carga de trabalho.

Git

Um sistema de controle de versão distribuído que usamos para gerenciar e rastrear alterações em nosso projeto.

npm (Gerenciador de Pacotes de Nós)

O gerenciador de pacotes padrão para Node.js usado para gerenciar e compartilhar os pacotes que você usa em seu projeto.

Node.js

Um ambiente de tempo de execução JavaScript de código aberto, multiplataforma, que executa código JavaScript fora de um navegador da Web. Usaremos isso para executar nosso código JavaScript do lado do servidor.

Pacote Web

Um empacotador de módulo estático para aplicativos JavaScript modernos. Ele ajuda a agrupar arquivos JavaScript para uso em um navegador.

Webpack CLI

A interface de linha de comando para Webpack. Isso nos permite usar o Webpack a partir da linha de comando.

DevGateway

No modo local, apenas é necessário para permitir que o back-end da carga de trabalho, que é hospedado localmente, se comunique com o locatário. A carga de trabalho opera na máquina do desenvolvedor. As chamadas de API de carga de trabalho do Fabric para a carga de trabalho são canalizadas por meio do Azure Relay, com o lado da carga de trabalho do canal de Retransmissão do Azure gerenciado pelo utilitário de linha de comando DevGateway. As chamadas de API de controle de carga de trabalho são feitas diretamente da carga de trabalho para a Malha, não exigindo o canal de Retransmissão do Azure. O utilitário DevGateway também gerencia o registro da instância local (de desenvolvimento) da carga de trabalho com o Fabric dentro de um contexto de capacidade específico, tornando a carga de trabalho acessível em todos os espaços de trabalho atribuídos a essa capacidade.

Nota

Encerrar o utilitário DevGateway remove automaticamente o registro da instância de carga de trabalho.

Crie o seu ambiente

Siga as etapas abaixo para criar seu ambiente.

Autenticação do ambiente de carga de trabalho

A configuração do acesso à carga de trabalho para o locatário da malha requer a configuração da ID do Microsoft Entra para seu aplicativo de carga de trabalho. O Microsoft Entra ID é necessário para garantir o acesso seguro e a operação da API do plano de dados do seu aplicativo.

As principais etapas incluem:

1. Adicionando escopos para a API do plano de dados: esses escopos representam grupos de operações expostas pela API do plano de dados. Quatro escopos de exemplo são fornecidos no exemplo de back-end, abrangendo operações de leitura e gravação para itens de carga de trabalho e arquivos Lakehouse.

2. Pré-autorizando o aplicativo cliente de malha: o aplicativo cliente de malha precisa ser pré-autorizado para os escopos que você definiu. Isso garante que ele possa executar as operações necessárias em seus itens de carga de trabalho e arquivos do Lakehouse.

3. Gerando um segredo para seu aplicativo: esse segredo é usado para proteger seu aplicativo e será usado ao configurar o exemplo de back-end.

4. Adicionando declaração opcional 'idtyp': Esta declaração é adicionada ao token de acesso e é usada para fins de identidade.

Essas etapas são necessárias ao configurar a carga de trabalho, Para obter um guia detalhado sobre como executar essas etapas, consulte Configuração de autenticação.

Aplicação Web (apenas no modo de nuvem)

A implantação da carga de trabalho no modo de nuvem (em conjunto com o modo de máquina local) requer a configuração de um domínio de aplicativo Web para o Frontend (FE) e o Backend (BE). Estes devem ser subdomínios do ID do recurso com um máximo de mais um segmento. O domínio do host da URL de resposta deve ser o mesmo que o domínio do host FE. Para obter mais informações, consulte Criando e implantando o aplicativo Web de back-end clichê.

Configurando um locatário de desenvolvimento do Fabric

No contexto da execução do exemplo de SDK de carga de trabalho e da criação de uma carga de trabalho, é recomendável empregar um locatário de desenvolvimento dedicado. Esta prática garante um ambiente isolado, minimizando o risco de interrupções ou modificações inadvertidas nos sistemas de produção. Além disso, fornece uma camada adicional de segurança, protegendo os dados de produção de possíveis exposições ou comprometimentos. A adesão a esta recomendação está alinhada com as melhores práticas do setor e contribui para um ciclo de vida de desenvolvimento robusto, confiável e seguro.

Configuração de locatário e configurações de desenvolvimento

1. A permissão do administrador da malha é necessária para poder iniciar o desenvolvimento e conectar-se com sua máquina local a uma capacidade de malha. Somente desenvolvedores com permissão de administrador de capacidade podem se conectar e registrar sua carga de trabalho em uma capacidade. O desenvolvimento frontend não requer permissões de administrador de capacidade.

   Para permitir que um usuário inicie o desenvolvimento, inclua-o na configuração de locatário Os administradores de capacidade podem desenvolver cargas de trabalho adicionais.

   

2. Depois que o usuário tiver recebido permissão na etapa anterior, cada usuário poderá habilitar o modo de desenvolvimento para a área de configurações de desenvolvimento no modo de desenvolvedor de malha.

   

Conteúdos relacionados

• Guia de início rápido
• Visão geral da autenticação