重要事項
先前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.comAzure 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 版本資訊中找到。
下載工具之後:
解壓縮並開啟工具資料夾。
將其移至電腦上可從命令列存取的位置。
開啟命令列並導覽至 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 | 下載說明。 |