Compartilhar via

Guia de início rápido: executar uma amostra de carga de trabalho

  • Artigo

Este guia de início rápido mostra como criar e executar uma carga de trabalho do Microsoft Fabric usando uma carga de trabalho de amostra.

Pré-requisitos

Antes de começar, certifique-se de que os seguintes itens estejam instalados em seu sistema:

Guia passo a passo

Habilitar cargas de trabalho personalizadas

Configure o portal de administração da seguinte maneira:

  1. Faça login no Fabric com uma conta de administrador.

  2. Em Configurações, acesse o Portal de administração.

    Captura de tela mostrando como chegar ao portal de Administração do Fabric.

  3. Na seção Cargas de trabalho adicionais, habilite a configuração de locatário Capacidade para administradores e colaboradores adicionarem e removerem cargas de trabalho adicionais. Você pode habilitá-lo para toda a organização ou para grupos específicos.

Configurar o projeto de exemplo

  1. Clonar o repositório: clone o repositório encontrado aqui: Diretório do projeto de exemplo

  2. Instalar dependências: navegue até o diretório Frontend no repositório clonado e execute o seguinte comando:

    npm install

  3. Inicie o servidor local: inicie um servidor Node.js local usando webpack, executando:

    npm start

    O servidor normalmente é executado na porta 60006. Confirme se o servidor está operacional acessando 127.0.0.1:60006/manifests e verificando o arquivo de configuração .env.dev na pasta front-end.

  4. Habilitar o modo de desenvolvedor front-end: nas configurações do locatário no portal de administração, na seção Cargas de trabalho adicionais (preview), ative a configuração de locatário Capacidade para administradores desenvolver cargas de trabalho adicionais. Essa configuração permite conexões com o servidor local e persiste entre sessões de navegador.

Executar uma carga de trabalho de amostra

Quando o servidor local estiver em execução e o Modo de Desenvolvedor estiver habilitado, a nova Carga de Trabalho de Amostra aparecerá no menu.

  1. Acesse a carga de trabalho de amostra: Para iniciar a experiência de criação, navegue até a página inicial da carga de trabalho de amostra.

Preparar o ambiente de desenvolvimento

  1. Abra a solução: abra a solução no Visual Studio 2022 para garantir a compatibilidade com o net7.

  2. Registro de aplicativo: siga o guia de autenticação para configurar a autenticação do Microsoft Entra ID para interações seguras dentro da arquitetura.

  3. Defina as configurações da carga de trabalho: atualize src/Config/workload-dev-mode.json e src/appsettings.json com os detalhes de configuração específicos:

    • Copie workload-dev-mode.json de src/Config para C:\ e atualize os campos a seguir para corresponder sua configuração:

    Observação

    Você pode copiá-lo para qualquer outro caminho e configurar o argumento da linha de comando "-DevMode:LocalConfigFilePath" em seu projeto para especificar o caminho.

    • WorkspaceGuid: a ID do seu Workspace. Localize-o na URL do navegador ao selecionar um workspace no Fabric, por exemplo, https://app.fabric.microsoft.com/groups/{WorkspaceID}/.

    • ManifestPackageFilePath: o local do pacote de manifesto. Quando você compilar a solução, ela salvará o pacote de manifesto em src\bin\Debug. Mais detalhes sobre o pacote de manifesto podem ser encontrados nas etapas posteriores.

    • WorkloadEndpointURL: URL do ponto de extremidade da carga de trabalho.

    • No arquivo src/appsettings.json, atualize os seguintes campos para que correspondam à sua configuração:

      • PublisherTenantId: a ID do locatário do fornecedor da carga de trabalho.
      • ClientId: ID do cliente (AppID) do aplicativo Microsoft Entra da carga de trabalho.
      • ClientSecret: o segredo do aplicativo Microsoft Entra da carga de trabalho.
      • Público: o público dos tokens de entrada do Microsoft Entra está disponível no registro do aplicativo que você criou na seção "Expor uma API". Isso também é conhecido como o URI do ID do aplicativo.

  4. Configure o arquivo WorkloadManifest.xml: configure o arquivo WorkloadManifest.xml com os seguintes detalhes do aplicativo Microsoft Entra:

    • AppID
    • ResourceID
    • RedirectURI

  5. Gerar pacote de manifesto: crie a solução para criar o arquivo do pacote de manifesto, que inclui validar e empacotar os arquivos XML e JSON necessários.

    • Dispare Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe em workloadManifest.xml em Packages\manifest\files\ (você pode encontrar o código do processo de validação no diretório \workloadManifestValidator). Se a validação falhar, será gerado um arquivo de erro especificando a falha na validação.
    • Se o arquivo de erro existir, o build falhará com "Erro de validação WorkloadManifest". Clique duas vezes no erro no VS Studio, e ele mostrará o arquivo de erro.
    • Após a validação bem-sucedida, empacote os arquivos WorkloadManifest.xml e FrontendManifest.json em ManifestPackage.1.0.0.nupkg. O pacote resultante pode ser encontrado em src\bin\Debug.

    Copie o arquivo ManifestPackage.1.0.0.nupkg para o caminho definido no arquivo de configuração workload-dev-mode.json.

  6. Executar o DevGateway: execute 'Microsoft.Fabric.Workload.DevGateway.exe' e entre com um usuário que tenha privilégios de administrador do workspace para o workspace especificado no campo WorkspaceGuid de workload-dev-mode.json.

  7. Iniciar o projeto: defina o projeto 'Boilerplate' como o projeto de inicialização no Visual Studio e execute-o.

Etapas adicionais

  • Atualizar arquivos de configuração da carga de trabalho conforme necessário.
  • Crie a solução para garantir que todas as dependências estejam vinculadas corretamente.
  • Execute o front-end e o devgateway para estabelecer a comunicação com o back-end do Fabric.
  • Crie itens e execute trabalhos para testar todos os recursos da sua carga de trabalho.

Conteúdo relacionado