Compartilhar via

Validador do Kit de Ferramentas de Extensibilidade do Microsoft Fabric

O Microsoft Fabric Extensibility Toolkit Validator é uma ferramenta de validação abrangente para cargas de trabalho do Microsoft Fabric. Ele ajuda os editores a validar suas cargas de trabalho em relação aos requisitos do Microsoft Fabric antes de enviar para certificação oficial.

Essa ferramenta é a ferramenta de validação pública para parceiros externos e clientes que desenvolvem cargas de trabalho do Fabric.

Visão geral

A ferramenta de validação permite que os criadores de carga de trabalho validem automaticamente suas cargas de trabalho do Microsoft Fabric. Ele foi projetado para ajudar a identificar possíveis problemas no início do processo de desenvolvimento, tornando o processo oficial de validação mais provável de ser bem-sucedido.

Importante

A auto-validação bem-sucedida não é garantia para a aprovação da validação oficial, mas aumenta significativamente a probabilidade de sucesso capturando problemas comuns antecipadamente.

Pré-requisitos

  • Node.js (versão 14 ou superior)
  • Conta do Microsoft Fabric com acesso ao Fabric Workload Hub
  • Navegador Chrome/Chromium (para download automatizado de manifesto)
  • Pacote de carga de trabalho criado usando o Kit de Ferramentas de Extensibilidade do Microsoft Fabric
  • Carga de trabalho publicada – Sua carga de trabalho deve ser publicada em um locatário antes que a validação possa começar.

Dica

Utilize um tenant diferente para validação do que o utilizado para publicação. Isso permite que você experimente o que os usuários finais verão e fornece um ambiente de validação mais realista.

Introdução

1. Construir sua carga de trabalho

Primeiro, crie sua carga de trabalho usando o kit inicial oficial:

  1. Clone o Kit de Ferramentas de Extensibilidade do Fabric (kit inicial).
  2. Siga a documentação do kit de ferramentas para criar sua carga de trabalho.

2. Instalar dependências

Navegue até o diretório do validador e instale as dependências:

cd fabric-extensibility-toolkit-validator/validator
npm install

3. Validação básica

Execute uma validação completa para sua carga de trabalho:

Comando básico de validação

node index.js --workload-name "YourPublisher.YourWorkload" --workload-stage "Preview"

Exemplo com carga de trabalho real

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "Preview"

Para cargas de trabalho de estágio de Disponibilidade Geral (GA)

node index.js --workload-name "Contoso.DataProcessor" --workload-stage "GA"

Observação

Verifique se você está conectado ao Microsoft Fabric em seu navegador antes de executar a validação e verifique se sua carga de trabalho está publicada e acessível no locatário de destino.

Opções de linha de comando

Opção Description Example
--workload-name Nome completo da carga de trabalho (Publicador.Produto) "Contoso.DataProcessor"
--workload-stage Estágio de validação "Preview" ou "GA"
--help Mostrar informações de ajuda (somente sinalizador)

Processo de validação

O validador passa por vários estágios:

  1. Download de Manifesto – baixa automaticamente o manifesto de carga de trabalho do Fabric Workload Hub.
  2. Descoberta de teste – identifica casos de teste aplicáveis com base no tipo de carga de trabalho.
  3. Execução de teste – executa testes de validação usando os validadores configurados (automatizados e manuais).
  4. Geração de Relatórios – Cria relatórios abrangentes em vários formatos.

Estrutura de saída

Após a validação, você encontrará resultados no Results diretório:

Results/
├── YourPublisher.YourWorkload/
│   └── Preview/
│       └── [ValidationID]/
│           ├── YourPublisher.YourWorkload_Metadata.json
│           ├── YourPublisher.YourWorkload_Manifest.json
│           ├── YourPublisher.YourWorkload_Workload_Tests.json
│           ├── YourPublisher.YourWorkload.Item_Item_Tests.json
│           └── Reports/
│               ├── ValidationReport.md
│               ├── ValidationReport.html
│               └── ValidationReport.pdf

Validadores

A ferramenta usa um conjunto de validadores especializados para verificar diferentes aspectos da carga de trabalho. Alguns validadores são automatizados, enquanto outros exigem interação manual.

Resolução de problemas

Problemas do navegador

  • Verifique se o Chrome/Chromium está instalado e acessível.
  • Verifique se você está conectado ao Microsoft Fabric em seu navegador.
  • Verifique a conectividade de rede com os serviços do Fabric.

Problemas com o download do manifesto

  • Verifique se o nome da carga de trabalho corresponde exatamente (sendo sensível a maiúsculas e minúsculas).
  • Verifique se a carga de trabalho está implantada e acessível no Fabric Workload Hub.
  • Verifique a autenticação e as permissões.

Problemas de execução de teste

  • Examine os logs de validação no diretório Resultados.
  • Verifique a documentação específica do caso de teste em validator/validators/.
  • Verifique se todos os ativos de carga de trabalho necessários estão acessíveis.

Conteúdo relacionado

  • Last updated on