Partilhar via

Validador do Kit de Ferramentas de Extensibilidade do Microsoft Fabric

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

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

Visão geral

A ferramenta de validação permite que os criadores de cargas de trabalho validem automaticamente as suas cargas de trabalho no Microsoft Fabric. Foi concebido para ajudar a identificar potenciais problemas logo no início do processo de desenvolvimento, tornando o processo oficial de validação mais provável de sucesso.

Importante

A auto-validação bem-sucedida não garante a aprovação oficial, mas aumenta significativamente a probabilidade de sucesso ao detetar problemas comuns precocemente.

Pré-requisitos

  • Node.js (versão 14 ou superior)
  • Conta Microsoft Fabric com acesso ao Fabric Workload Hub
  • Chrome/Chromium Browser (para download automático de manifestos)
  • Pacote de Carga de Trabalho construído usando o Microsoft Fabric Extensibility Toolkit
  • Carga de Trabalho Publicada - A sua carga de trabalho deve ser publicada a um inquilino antes de a validação poder começar.

Sugestão

Use um tenant diferente para validação daquele usado para publicação. Isto permite-lhe experienciar o que os utilizadores finais vão ver e proporciona um ambiente de validação mais realista.

Introdução

1. Aumenta a tua carga de trabalho

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

  1. Clone o Fabric Extensibility Toolkit (kit-inicial).
  2. Siga a documentação do toolkit para aumentar a sua carga de trabalho.

2. Instalar dependências

Navegue até ao 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 a 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 em fase de disponibilidade geral (GA)

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

Observação

Certifique-se de que está com sessão iniciada no Microsoft Fabric no browser antes de executar a validação, e certifique-se de que a sua carga de trabalho está publicada e acessível no tenant alvo.

Opções da linha de comandos

Opção Description Example
--workload-name Nome da carga de trabalho completa (Publisher.Product) "Contoso.DataProcessor"
--workload-stage Fase de validação "Preview" ou "GA"
--help Mostrar informação de ajuda (apenas bandeira)

Processo de validação

O validador passa por várias fases:

  1. Manifest Download - Efetua automaticamente o download do Manifest da carga de trabalho a partir do Fabric Workload Hub.
  2. Descoberta de Testes - Identifica casos de teste aplicáveis com base no tipo de carga de trabalho.
  3. Execução de Testes - Executa testes de validação usando os validadores configurados (tanto automáticos como manuais).
  4. Geração de Relatórios - Cria relatórios abrangentes em múltiplos formatos.

Estrutura de saída

Após a validação, 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 utiliza um conjunto de validadores especializados para verificar diferentes aspetos da sua carga de trabalho. Alguns validadores são automatizados, enquanto outros requerem interação manual.

Solução de problemas

Problemas com navegadores

  • Garante que o Chrome/Chromium está instalado e acessível.
  • Certifica-te de que tens sessão iniciada no Microsoft Fabric no teu browser.
  • Verifique a conectividade da rede aos serviços Fabric.

Problemas ao descarregar o manifesto

  • Verifica se o nome da carga de trabalho corresponde exatamente (distinto de maiúsculas e minúsculas).
  • Assegurar que a carga de trabalho seja implementada e acessível no Fabric Workload Hub.
  • Verifique autenticação e permissões.

Problemas de execução de testes

  • Consulte os registos de validação no diretório Resultados.
  • Verifique a documentação individual do caso de teste em validator/validators/.
  • Verifique se todos os recursos necessários de carga de trabalho estão acessíveis.

Conteúdo relacionado

  • Last updated on