IRCTL for Kubernetes 支援的自我裝載整合執行階段

重要事項

先前Azure Purview) (Microsoft Purview 整合式目錄 和傳統 Microsoft Purview 資料控管功能即將淘汰。 Microsoft 正在 Microsoft Fabric 中合併其資料控管功能。 您無法再建立新帳戶,現有功能將維持在維護模式,直到 2027 年 11 月 12 日為止。 如需淘汰時間表、轉換指引,以及建議的後續步驟,請參閱 Microsoft Purview 資料控管淘汰公告。

若要在本機管理 Microsoft Purview Kubernetes SHIR,您需要名為 IRCTL 的命令列工具。 您可以在建立 SHIR 過程中下載此工具。 IRCTL 是管理 Microsoft Purview SHIR 的命令列工具。

必要條件

IRCTL 的系統需求如下:

  • 執行 IRCTL 的機器 - 作業系統是支援 TLS 1.2 的 Linux 或 Windows
  • 執行 IRCTL 的電腦應該能夠連線到下列端點:
網域名稱 輸出連接埠 描述
公有雲: *.compute.governance.azure.com
Azure Government:*.compute.governance.azure.us
中國: *.compute.governance.azure.cn
443 連線至 Microsoft Purview 服務的必要項目。 如果您使用 Microsoft Purview 私人端點,則帳戶私人端點會涵蓋此端點。
  • Kubernetes 脈絡:需要 Kubernetes 脈絡,其中包含 Kubernetes 叢集資訊,以及使用者對此叢集的權限和認證,才能與您的 Kubernetes 叢集交談。 若要簡化使用者 SHIR 管理權限的設定,您可以從 Kubernetes 管理員角色開始。 此內容是隨著 Kubernetes 叢集的設定產生,並儲存在設定檔中。 取得此檔案的位置和方式取決於您設定的 Kubernetes 叢集。
    • 如果您用於 kubeadm init 設定 Kubernetes 叢集,可以在 底下 /etc/Kubernetes/admin.conf找到設定檔。
    • 如果您使用 AKS,您可以遵循 AKS 的指導方針,使用 Az PowerShell 模組命令,將此叢集的認證取得到本機電腦。 上下文可以直接合併到下面的 $HOME/.kube/config 配置文件。
    • 如果您使用其他工具設定 Kubernetes 叢集,請參閱 Kubernetes 文件。
    • 當您擁有 Kubernetes 內容的設定檔時,請將其合併到設定檔,即 $HOME/.kube/config您要執行 IRCTL 命令的電腦上的設定檔。 或者,您也可以在名為 KUBECONFIG 的環境變數中設定 Kubernetes 內容的設定檔。 如需有關 Kubernetes 內容的詳細資訊,請參閱 設定對多個叢集的存取。

安裝和執行 IRCTL

若要控制和管理 Kubernetes 支援的自我裝載整合執行階段,使用者可以下載名為 IRCTL 的命令列工具。 使用者還可以透過 IRCTL 和 kubectl 命令列監視入口網站上的狀態。 以下是 Kubernetes 支援的自我裝載整合執行階段的步驟。

特定版本

若要下載特定版本的 IRCTL,請變更 URL 中的版本區段: https://aka.ms/purview-irctl/irctl-windows-<version>.tar.gz

例如,針對版本 1.0.0: https://aka.ms/purview-irctl/irctl-windows-1.0.0.tar.gz

可用的 IRCTL 版本可以在 IRCTL 版本資訊中找到。

下載工具之後:

  1. 解壓縮並開啟工具資料夾。

  2. 將其移至電腦上可從命令列存取的位置。

  3. 開啟命令列並導覽至 IRCTL 應用程式所在的資料夾。

  4. 使用下列命令與 IRCTL 互動, 並遵循下列步驟來安裝 Kubernetes 支援的整合執行階段。

IRCTL 命令詳細資料

您可以從 Microsoft Purview 中的整合執行階段設定下載 IRCTL 命令列工具。 選取您的整合執行階段,然後在 [設定] 底下,您可以看到下載 IRCTL 並安裝整合執行階段 連結。 選取它以下載工具。

您可以使用 IRCTL 命令列來設定或管理 Kubernetes 支援的自我裝載整合執行階段。 使用此語法從終端機視窗執行 IRCTL 命令:

./irctl [command][flags]...
  • 命令 會指定您想要執行的作業
  • 旗標 指定作業的參數
命令 描述
config 管理 IRCTL 設定
建立 建立新的 SHIR 資源
[刪除] 刪除 SHIR 資源
描述 描述在 Kubernetes 叢集上執行的 SHIR
說明 提供任何命令的說明
儲存空間 管理保留給 SHIR 的本機儲存空間
記錄 管理 SHIR 記錄檔
升級 使用 IRCTL 將 SHIR 升級至相同版本

Config

管理 IRCTL 設定。

./irctl config [flags]
./irctl config [command]
命令 描述
set 修改一個 SHIR 設定。
檢視 檢視所有 SHIR 組態。
標幟 參數類型 描述
-h,--help 設定說明

設定集

修改一個自我裝載整合執行階段設定。

./irctl config set <config-name> <config-value> [flags]
標幟 參數類型 描述
-c, --context 字串 要使用的 Kubernetes 內容的名稱 (如果未指定),則會使用 Kube 組態的目前內容。
-h,--help 設定說明

設定檢視

檢視所有 SHIR 組態。

./irctl 
標幟 參數類型 描述
-c, --context 字串 要使用的 Kubernetes 內容的名稱 (如果未指定),則會使用 Kube 組態的目前內容。
-h,--help 設定說明

允許的 SHIR 設定

設定名稱 設定類型 有效值 預設值 (未設定值) 描述 重新安裝後仍會持續存在
autoUpdate.enabled 布林值 true/false true 控制目前 SHIR 是否應該自動更新。 是

建立

建立新的 SHIR 資源。

./irctl create [flags]
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱,如果未指定,則使用 Kube 組態的目前內容
-h,--help 建立的說明
-r,--registration-key 字串 註冊 SHIR 的金鑰
-s,--selector 字串 要篩選 (標籤查詢) 節點選取器,支援 '='。 (例如,--selector key1=value1,key2=value2) 依指定的標籤選取節點,讓 SHIR 在其上執行。 預設值為空白,這表示 SHIR 在所有節點上執行。

例如:

./irctl create --registration-key 1234@keyvalue

升級

使用 IRCTL 將 SHIR 升級至相同版本。

./irctl upgrade [flags]
./irctl upgrade [command]
命令 描述
狀態 監控最新 SHIR 升級的狀態。
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱,如果未指定,則使用 Kube 組態的目前內容
-h,--help 升級說明

刪除

刪除 SHIR 資源。

./irctl delete [flags]
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱,如果未指定,則使用 Kube 組態的目前內容
-h,--help 刪除的說明

描述

描述在 Kubernetes 叢集上執行的 SHIR。

./irctl describe [flags]
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱,如果未指定,則使用 Kube 組態的目前內容
-h,--help 描述的說明

儲存體

管理 SHIR 共用儲存空間中的檔案。

./irctl storage [flags]
./irctl storage [command]
命令 描述
[上傳] 將檔案上傳至 SHIR 共用儲存空間。
清單 列出 SHIR 共用儲存空間中的檔案。
[刪除] 刪除 SHIR 共用儲存空間中的檔案。
標幟 參數類型 描述
-h,--help 儲存空間的說明

儲存空間上傳

將檔案上傳至 SHIR 共用儲存空間。

./irctl storage upload -s <source> -d <destination> [flags]
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱 (如果未指定),則會使用 Kube 組態的目前內容。
-d,--destination 字串 字串 儲存在 SHIR 共用儲存空間中上傳的檔案/資料夾的路徑。
-h,--help 刪除的說明
-s,--source 字串 要上傳的檔案/資料夾路徑。

儲存空間清單

列出 SHIR 共用儲存空間中的檔案。

./irctl storage list <path> [flags]
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱 (如果未指定),則會使用 Kube 組態的目前內容。
-h,--help 清單的說明。

儲存空間刪除

刪除 SHIR 共用儲存空間中的檔案。

./irctl storage delete <path> [flags]
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱 (如果未指定),則會使用 Kube 組態的目前內容。
-h,--help 刪除的說明。

記錄

來自 SHIR 的記錄作業。

./irctl log [flags]
./irctl log [command]
命令 描述
[上傳] 從 SHIR 上傳記錄檔。
[下載] 從 SHIR 下載記錄。
標幟 參數類型 描述
-h,--help 記錄說明。

記錄上傳

從 SHIR 上傳記錄檔。

./irctl log upload [flags]
./irctl log upload [command]
命令 描述
狀態 監視 SHIR 記錄上傳的狀態。
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱 (如果未指定),則會使用 Kube 組態的目前內容。
-h,--help 上傳的說明。
-t,--timeout int 記錄上傳作業逾時,以秒為單位:[900, 3600]。 預設值為 900 秒。 (預設 900)

記錄下載

從 SHIR 上傳記錄檔。

./irctl log download [flags]
標幟 參數類型 描述
-c,--context 字串 要使用的 Kubernetes 內容的名稱 (如果未指定),則會使用 Kube 組態的目前內容。
-d,--destination 字串 用來儲存從 SHIR 下載記錄的本機路徑。
-h,--help 下載說明。

後續步驟