共用方式為

适用于 Kubernetes 的 IRCTL 支持的自承载集成运行时

若要在本地管理 Microsoft Purview Kubernetes SHIR，需要一个名为 IRCTL 的命令行工具。 可以在 SHIR 创建过程中下载此工具。 IRCTL 是用于管理 Microsoft Purview SHIR 的命令行工具。

先决条件

IRCTL 的系统要求是：

  • 运行 IRCTL 的计算机 - OS 是支持 TLS 1.2 的 Linux 或 Windows
  • 运行 IRCTL 的计算机应能够连接到以下终结点：
域名 出站端口 DESCRIPTION
中国：*.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 上下文的配置文件后，请将其合并到要运行 IRCTL 命令的计算机上的配置文件（即 $HOME/.kube/config）。 或者，也可以在名为 KUBECONFIG 的环境变量中设置 Kubernetes 上下文的配置文件。 有关 Kubernetes 上下文的详细信息，请参阅 配置对多个群集的访问。

安装和运行 IRCTL

若要控制和管理 Kubernetes 支持的自承载集成运行时，用户可以下载名为 IRCTL 的命令行工具。 用户还可以通过 IRCTL 和 kubectl 命令行监视门户中的状态。 下面是 Kubernetes 支持的自承载集成运行时的步骤。

下载适用于 Windows 的最新 IRCTL

特定版本

若要下载特定版本的 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]...
  • 命令 指定要执行的作
  • 标志 指定作的参数
指令 DESCRIPTION
配置 管理 IRCTL 配置
创造 创建新的 SHIR 资源
删除 删除 SHIR 资源
描述 介绍在 Kubernetes 群集上运行的 SHIR
help 提供有关任何命令的帮助
存储 管理为 SHIR 保留的本地存储
日志 管理 SHIR 的日志
升级 使用 IRCTL 将 SHIR 升级到同一版本

配置

管理 IRCTL 配置。

./irctl config [flags]
./irctl config [command]
指令 DESCRIPTION
集 修改一个 SHIR 配置。
视图 查看所有 SHIR 配置。
旗帜 参数类型 DESCRIPTION
-h,--帮助 配置帮助

配置集

修改一个自承载集成运行时配置。

./irctl config set <config-name> <config-value> [flags]
旗帜 参数类型 DESCRIPTION
-c、--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文。
-h,--帮助 配置帮助

配置视图

查看所有 SHIR 配置。

./irctl
旗帜 参数类型 DESCRIPTION
-c、--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文。
-h,--帮助 配置帮助

允许的 SHIR 配置

配置名称 配置类型 有效值 默认值 (值取消设置) DESCRIPTION 通过重新安装保留
自动更新.enabled 布尔 真/假 是 控制是否应自动更新当前 SHIR。 是的

创建

创建新的 SHIR 资源。

./irctl create [flags]
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文
-h,--帮助 创建帮助
-r,--registration-key（注册密钥） 字符串 注册 SHIR 的密钥
-s,--selector 选择器 字符串 节点选择器 (标签查询) 筛选，支持“=”。 例如 (,--elector key1=value1，key2=value2) 按给定的标签选择要运行 SHIR 的节点。 默认值为空，这意味着 SHIR 在所有节点上运行。

示例：

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

升级

使用 IRCTL 将 SHIR 升级到同一版本。

./irctl upgrade [flags]
./irctl upgrade [command]
指令 DESCRIPTION
状态 监视最新 SHIR 升级的状态。
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文
-h,--帮助 有关升级的帮助

删除

删除 SHIR 资源。

./irctl delete [flags]
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文
-h,--帮助 删除帮助

描述

描述在 Kubernetes 群集上运行的 SHIR。

./irctl describe [flags]
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文
-h,--帮助 描述帮助

存储

管理 SHIR 共享存储中的文件。

./irctl storage [flags]
./irctl storage [command]
指令 DESCRIPTION
上传 将文件上传到 SHIR 共享存储。
列表 列出 SHIR 共享存储中的文件。
删除 删除 SHIR 共享存储中的文件。
旗帜 参数类型 DESCRIPTION
-h,--帮助 存储帮助

存储上传

将文件上传到 SHIR 共享存储。

./irctl storage upload -s <source> -d <destination> [flags]
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文。
-d,--destination 字符串 字符串 用于存储 SHIR 共享存储中上传的文件/文件夹的路径。
-h,--帮助 删除帮助
-s,--source 字符串 要上传的文件/文件夹的路径。

存储列表

列出 SHIR 共享存储中的文件。

./irctl storage list <path> [flags]
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文。
-h,--帮助 列表帮助。

存储删除

删除 SHIR 共享存储中的文件。

./irctl storage delete <path> [flags]
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文。
-h,--帮助 删除帮助。

日志

记录 SHIR 中的作。

./irctl log [flags]
./irctl log [command]
指令 DESCRIPTION
上传 从 SHIR 上传日志。
下载 从 SHIR 下载日志。
旗帜 参数类型 DESCRIPTION
-h,--帮助 日志帮助。

日志上传

从 SHIR 上传日志。

./irctl log upload [flags]
./irctl log upload [command]
指令 DESCRIPTION
状态 监视 SHIR 日志上传的状态。
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文。
-h,--帮助 有关上传的帮助。
-t,--timeout（超时设置） 整数 (int) 日志上传作的超时时间（以秒为单位）：[900， 3600]。 默认值为 900 秒。 (默认值 900)

日志下载

从 SHIR 上传日志。

./irctl log download [flags]
旗帜 参数类型 DESCRIPTION
-c,--context 字符串 要使用的 Kubernetes 上下文的名称（如果未指定），则使用 Kube 配置的当前上下文。
-d,--destination 字符串 用于存储从 SHIR 下载的日志的本地路径。
-h,--帮助 有关下载的帮助。

后续步骤