この記事では、Fabric Extensibility Toolkit Validator を使用して、発行要求フォームを送信する前にワークロードがすべての発行要件を満たしていることを確認する方法について説明します。 検証コントロールは、開発プロセスの早い段階でコンプライアンスの問題を特定し、レビュー時間を短縮し、承認の成功率を向上させるのに役立ちます。
概要
Fabric Extensibility Toolkit Validator は、パートナーが Microsoft Fabric の発行要件に照らしてワークロードを検証できるように設計されたコマンドライン ツールです。 このツールは、自動テストと手動ガイド付きテストを組み合わせて、包括的な検証範囲を提供します。
検証の種類
検証コントロールには、次の 2 種類の検証が用意されています。
- 自動テスト: ワークロードでコンプライアンスの問題を自動的にスキャンするプログラムによるチェック
- 手動ガイド付きテスト: 人間による検証を必要とする検証タスクの手順
[前提条件]
検証ツールを使用する前に、次のことを確認してください。
- 完了したワークロードは検証の準備ができている
- Fabric Extensibility Toolkit Validator リポジトリへのアクセス
- 開発用コンピューターでのコマンド ライン インターフェイス アクセス
- ワークロードが適切に構成され、デプロイ可能である
バリデーターへのアクセス
Fabric Extensibility Toolkit Validator は、GitHub から入手できます。
🔗 リポジトリ: https://github.com/microsoft/fabric-extensibility-toolkit-validator
インストールと使用方法の詳細については、「 Microsoft Fabric Extensibility Toolkit Validator」を参照してください。
リポジトリにアクセスして、次の手順を実行します。
- 最新バージョンのバリデーターをダウンロードする
- 使用可能なコマンド ライン パラメーターを確認する
- ツールの使用に関するドキュメントにアクセスする
- システム要件とセットアップ手順を確認する
バリデーターの使用
Command-Line インターフェイス
検証コントロールは、ワークロードに対して実行するコマンド ライン ツールとして動作します。 特定のパラメーターと使用手順は、バリデーター リポジトリで入手できます。
以下については、リポジトリのドキュメントを参照してください。
- 完全なパラメータリファレンス
- コマンド ライン構文
- 構成オプション
- 出力形式の詳細
検証ワークフロー
バリデーターを使用する場合は、次の一般的なワークフローに従います。
- ワークロードの準備: ワークロードがビルドされ、テストの準備ができていることを確認する
- 自動テストの実行: 検証コントロールの自動コンプライアンス チェックを実行する
- 手動テストの完了: 手動検証タスクのガイド付き手順に従う
- 結果の確認: 検証レポートを分析し、問題を特定する
- アドレスの結果: 検証コントロールによって識別されるコンプライアンスギャップを修正する
- 再検証: バリデーターをもう一度実行して、すべての問題が解決されたことを確認します
- 発行用に送信する: 検証に合格したら、発行要求を続行します
検証対象範囲
バリデーターはワークロードを次の基準に対してチェックします。
- ワークロードの公開要件: インフラストラクチャ、セキュリティ、コンプライアンスの標準
- アイテムの公開要件: ユーザー エクスペリエンスと機能の要件
- マニフェストのコンプライアンス: 適切な構成と必要なプロパティ
- プラットフォーム統合: Fabric プラットフォーム機能の正しい実装
結果の解釈
自動テスト結果
検証コントロールには、次のような自動テスト結果に関する詳細なレポートが用意されています。
- 合格/失敗状態: テスト結果の明確な表示
- 問題の説明: コンプライアンスのギャップに関する具体的な説明
- 修復ガイダンス: 特定された問題を修正するための提案
- 重大度レベル: さまざまな種類の問題に対処するための優先度インジケーター
手動テスト ガイダンス
手動検証タスクの場合、ツールには次のものが用意されています。
- ステップ バイ ステップの手順: 手動検証プロセスに関する明確なガイダンス
- 検証基準: チェック対象の特定の基準
- ドキュメントの要件: コンプライアンスを実証するために必要な証拠
- ベスト プラクティス: 最適な実装に関する推奨事項
ベスト プラクティス
検証前の準備
- 完全な開発: 検証の前にワークロードが機能を完了していることを確認する
- 十分にテストする:バリデーターを実行する前に独自のテストを実施する
- 要件を確認する: 公開要件について事前に理解しておく
- ドキュメントを準備する: 必要なすべてのドキュメントの準備が整い、アクセス可能であることを確認する
検証の実行
- 定期的に実行する: 最後だけでなく、開発全体で検証コントロールを使用する
- 問題に迅速に対処する: 特定された問題をできるだけ早く修正する
- ドキュメントの変更: 検証フィードバックに基づいて行われた変更を追跡する
- 修正の確認: 変更を加えて解決を確認した後に検証を再実行する
トラブルシューティング
一般的な問題
- ツールのセットアップに関する問題: インストール ガイダンスについては、リポジトリのドキュメントを参照してください
- アクセス許可の問題: バリデーターを実行するための適切なアクセス権があることを確認する
- 構成エラー: ワークロード構成が想定される形式と一致するかどうかを確認する
- 環境の問題: 開発環境がツールの要件を満たしていることを確認する
ヘルプの取得
- リポジトリのドキュメント: 詳細なガイダンスについては、バリデーター リポジトリを確認してください
- 問題レポート: リポジトリの問題トラッカーを使用して問題を報告したり、質問したりします
- コミュニティ サポート: バリデーターを使用して他の開発者と交流する
- Microsoft サポート: 追加のサポートについては、Microsoft パートナーの担当者にお問い合わせください
関連コンテンツ
- 発行要件 - 一般的な要件の概要
- テナント間の発行要件
- ワークロード発行の要件 - ワークロードに特化した基準
- アイテムの公開要件 - アイテム特定の要件
- 発行の概要 - 高水準の発行プロセス
- マニフェストの概要 - ワークロード マニフェストの構成