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"

命令行选项

验证过程

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

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/中检查单个测试用例文档。
• 验证所有必需的工作负荷资产是否可访问。

相关内容

• Microsoft Fabric 扩展性工具包 - 用于生成 Fabric 工作负载的官方初学者工具包