セルフホステッド統合ランタイム用に DIRCTL ツールを設定する (プレビュー)

データ統合ランタイム コマンド ライン (DIRCTL) は です。Kubernetes クラスター内のデータ統合ランタイム管理を自動化する NET ベースのコマンド ライン インターフェイス (CLI) ツール。 これにより、簡単なコマンドを使用して複雑な Kubernetes 操作が簡素化され、登録とトークンのライフサイクル管理のために Microsoft Purview との安全な通信が保証されます。

Microsoft Purview Kubernetes セルフホステッド データ統合ランタイムをローカルで管理するには、DIRCTL コマンド ライン ツールが必要です。 このツールは、データ統合ランタイムの作成プロセス中にダウンロードできます。 Windows および Linux オペレーティング システムについては、以下のセットアップ手順を参照してください。

DIRCTL CLI の Windows セットアップ

  1. Kubectl CLI ツールをダウンロードしてインストールします。
  2. 生成された kube 構成ファイルを、 C:/Users/<user-folder>/.kube/というパスに従ってユーザー固有のフォルダーに配置します。 ファイルをコピーし、config という名前を 付けます。

    注:

    この構成ファイルは、Kubernetes クラスターでの DIRCTL 認証に必要です。

  3. WINDOWS 用 DIRCTL CLI パッケージ .zip をダウンロードします。
  4. 内容をローカル コンピューター上の優先ディレクトリに抽出します。
  5. Windows でターミナルを開きます。
  6. 抽出された DIRCTL ディレクトリに移動します。
  7. フォルダーに移動するには、cd コマンド <path-to-dirctl> を使用します。
  8. ./DIRCTL' を使用してコマンドを実行します。

DIRCTL CLI のLinuxセットアップ

  1. Linuxディストリビューションの kubectl CLI をダウンロードしてインストールします。
  2. kubeconfig ファイルを Kubernetes への認証用に、既定の kube フォルダー ( ~/.kube/) に配置します。
  3. 生成された kubeconfig ファイルをユーザー固有のディレクトリにコピーします。 ファイルの名前が config であることを確認します。 mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config

    注:

    この構成ファイルは、Kubernetes クラスターでの DIRCTL 認証に必要です。

  4. Windows またはLinux用の DIRCTL CLI パッケージをダウンロードします。
  5. ターミナルを開き、DIRCTL ディレクトリに移動します。 cd /your/target/directory/DIRCTL
  6. ./DIRCTL を使用してコマンドを実行します。

DIRCTL コマンド

  1. DIRCTL ヘルプ: ヘルプ コマンドは、DIRCTL ツール内で使用可能なすべてのコマンドと機能の包括的な概要を提供します。 これにより、データ統合タスクのガイダンスとコンテキストを提供することで、ツールを効果的に使用できます。

  2. DIRCTL 再登録: ./DIRCTL re-register –registration-key <re-registration-key-value> 新しい登録キーを使用して、既存のデータ統合ランタイム リソースが長時間非アクティブな場合は、再登録コマンドを使用して、既存のデータ統合ランタイム リソースを再登録します。

  3. DIRCTL Delete: ./DIRCTL delete システムからデータ統合ランタイムを登録解除し、関連付けられているすべてのアプリケーション Kubernetes ポッドを解放する場合は、Delete コマンドを使用すると、合理化されたソリューションが提供されます。 このコマンドは、SQL Server Data Quality Services (DQS) から DIR を完全に削除し、ランタイムまたはそのアプリケーション ポッドの残りの部分が残っていることを確認します。 コマンドは、DIR アプリケーションに関連付けられている実行中のすべての Kubernetes ポッドの終了も処理し、システム内のリソースを解放します。

  4. DIRCTL アップグレード: ./DIRCTL upgrade –v <image version> Upgrade コマンドを使用すると、データ統合ランタイムのバージョンを、ユーザーが指定した最新の使用可能なバージョンにシームレスにアップグレードできます。 このプロセスにより、データ統合ランタイムが最新の機能、拡張機能、およびセキュリティ パッチで動作し、システム内での互換性と効率が維持されます。

  5. DIRCTL Describe: ./DIRCTL describe Describe コマンドは、実行中の DIR および DIRCTL アプリケーションの状態とパフォーマンスに関する詳細な分析情報を提供します。 アプリケーション ポッドの正常性を確認し、問題や異常が迅速に特定されるようにします。 ランタイム環境を可視化することで、この機能はトラブルシューティングとプロアクティブなシステム メンテナンスをサポートします。

  6. DIRCTL ログ: ./DIRCTL log download –d <relative-destination-folder-path> Log コマンドを使用して、すべてのアクティブ なデータ統合ランタイム アプリケーション ポッドのログを、指定された宛先フォルダー パスにダウンロードします。 この機能は、詳細なランタイム レコードに確実にアクセスできるように、デバッグ、パフォーマンス監視、または監査アクティビティに特に重要です。 包括的なログを保持することで、パターン、異常、潜在的な問題を効果的に特定できるため、システムのメンテナンスと最適化の重要なツールになります。

  7. DIRCTL 構成: ./DIRCTL config auto-update-enable <true/false> 自動更新を有効にする構成を false または true に更新します。

  • Last updated on