重要事項
僅淘汰 Microsoft Purview 資料控管功能
Microsoft Purview 統一目錄和傳統 Microsoft Purview 資料控管功能 (先前的 Azure Purview) 即將淘汰。 整個 Microsoft Purview 並未淘汰。 Microsoft Purview 資料安全性與合規性功能不受此公告影響,且 Microsoft 會繼續投資於此功能。
Microsoft 正在 Microsoft Fabric 中合併 其資料控管 功能。 無法再建立新的 Microsoft Purview 資料控管帳戶,而且現有的資料控管功能將維持在維護模式,直到 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.comAzure 政府: *.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 版本資訊中找到。
下載工具之後:
解壓縮並開啟工具資料夾。
將其移至電腦上可從命令列存取的位置。
開啟命令列並導覽至 IRCTL 應用程式所在的資料夾。
使用下列命令與 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 | 下載說明。 |