通过

Microsoft Fabric 扩展性工具包验证程序

Microsoft Fabric 扩展性工具包验证器是Microsoft Fabric 工作负载的综合验证工具。 在提交正式认证之前，它可帮助发布者根据 Microsoft Fabric 要求验证其工作负载。

此工具是面向外部合作伙伴和开发 Fabric 工作负载的客户 的公共验证工具 。

概述

验证工具允许工作负荷创建者自行验证其Microsoft Fabric 工作负载。 它旨在帮助在开发过程中早期识别潜在问题，使正式验证过程更有可能成功。

重要

成功的自我验证不能保证通过官方验证，但它通过提前捕获常见问题显著增加成功的可能性。

先决条件

  • Node.js （版本 14 或更高版本）
  • 具有访问 Fabric 负载中心权限的 Microsoft Fabric 帐户
  • Chrome/Chromium Browser （用于自动清单下载）
  • 使用 Microsoft Fabric 扩展性工具包生成的工作负荷包
  • 已发布的工作负荷 - 必须在验证开始之前将工作负荷发布到租户。

小窍门

使用不同于用于发布的租户进行验证。 这样，你可以体验最终用户将看到的内容，并提供更真实的验证环境。

开始

1.生成工作负荷

首先，使用官方初学者工具包创建工作负荷：

  1. 克隆 Fabric 扩展性工具包（初学者工具包）。
  2. 按照工具包文档生成工作负荷。

2.安装依赖项

导航到验证程序目录并安装依赖项：

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

3. 基本验证

为您的负载运行完整的验证：

基本验证命令

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

实际工作负荷的示例

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

对于 GA 阶段工作负荷

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

注释

在运行验证之前，请确保已在浏览器中登录到 Microsoft Fabric，并确保工作负荷在目标租户中已发布并可访问。

命令行选项

选项 Description Example
--workload-name 完整工作负荷名称 （Publisher.Product） "Contoso.DataProcessor"
--workload-stage 验证阶段 "Preview" 或 "GA"
--help 显示帮助信息 （仅标志）

验证过程

验证程序通过几个阶段运行：

  1. 清单下载 - 从 Fabric 工作负荷中心自动下载工作负荷清单。
  2. 测试发现 - 根据工作负荷类型标识适用的测试用例。
  3. 测试执行 - 使用配置的验证程序（自动化和手动）运行验证测试。
  4. 报表生成 - 以多种格式创建综合报表。

输出结构

验证后，你将在 Results 目录中找到结果：

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

验证程序

该工具使用一组专用验证程序来检查工作负荷的不同方面。 某些验证程序是自动化的，而另一些验证程序则需要手动交互。

Troubleshooting

浏览器问题

  • 确保已安装并可访问 Chrome/Chromium。
  • 请确保已在浏览器中登录到 Microsoft Fabric。
  • 检查与 Fabric 服务的网络连接。

清单下载问题

  • 验证工作负荷名称是否完全匹配（区分大小写）。
  • 确保工作负荷在 Fabric 工作负荷中心被部署并可访问。
  • 检查身份验证和权限。

测试执行问题

  • 查看结果目录中的验证日志。
  • 在validator/validators/中检查单个测试用例文档。
  • 验证所有必需的工作负荷资产是否可访问。

相关内容

  • Last updated on