Partilhar via

Início rápido: executar um exemplo 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 exemplo.

Pré-requisitos

Antes de começar, certifique-se de que tem o seguinte instalado no 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, vá para 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 Administradores e colaboradores de capacidade podem adicionar e remover cargas de trabalho adicionais. Você pode habilitá-lo para toda a organização ou grupos específicos.

Configurar o projeto de exemplo

  1. Clone o repositório: Clone o repositório encontrado aqui: Diretório de projeto de exemplo

  2. Instalar dependências: navegue até o Frontend diretório 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 frontend: nas configurações do locatário no portal de administração, na seção Cargas de trabalho adicionais, e ativar o Os administradores de capacidade podem desenvolver cargas de trabalho adicionais. configuração do locatário. Essa configuração permite conexões com o servidor local e persiste nas sessões do navegador.

Executar uma carga de trabalho de exemplo

Quando o servidor local estiver em execução e o Modo de Desenvolvedor estiver habilitado, a nova carga de trabalho de exemplo aparecerá no menu.

  1. Acesse a carga de trabalho de exemplo: para iniciar a experiência Criar , navegue até a página inicial da carga de trabalho de exemplo.

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. Definir configurações de carga de trabalho: Atualize src/Config/workload-dev-mode.json e src/appsettings.json com seus detalhes de configuração específicos:

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

    Nota

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

    • WorkspaceGuid: seu ID de espaço de trabalho. Encontre-o no URL do navegador ao selecionar um espaço de trabalho no Fabric, por exemplo, https://app.fabric.microsoft.com/groups/{WorkspaceID}/.

    • ManifestPackageFilePath: O local do pacote de manifesto. Quando você cria a solução, ela salva 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 corresponder à sua configuração:

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

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

    • ID do aplicativo
    • ResourceID
    • RedirectURI

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

    • Acione 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, um arquivo de erro será gerado especificando a validação com falha.
    • Se o arquivo de erro existir, a compilação falhará com "Erro de validação WorkloadManifest". Você pode clicar duas vezes no erro no estúdio VS e ele mostra 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. Execute o DevGateway: execute 'Microsoft.Fabric.Workload.DevGateway.exe' e entre com um usuário que tenha privilégios de administrador de espaço de trabalho para o espaço de trabalho especificado no WorkspaceGuid campo 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.

Passos adicionais

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

Conteúdos relacionados