Поделиться через

IRCTL для поддерживаемой локальной среды выполнения интеграции Kubernetes

Для локального управления SHIR Microsoft Purview Kubernetes требуется средство командной строки IRCTL. Это средство можно скачать во время создания SHIR. IRCTL — это средство командной строки для управления SHIR Microsoft Purview.

Предварительные условия

Системные требования для IRCTL:

  • Компьютер под управлением IRCTL — ОС Linux или Windows поддерживает TLS 1.2
  • Компьютер, на котором выполняется IRCTL, должен иметь возможность подключения к следующим конечным точкам:
Доменное имя Исходящие порты Описание
Общедоступное облако: *.compute.governance.azure.com
Azure для государственных организаций:*.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 module для получения учетных данных этого кластера на локальном компьютере. Контекст можно объединить с файлом конфигурации непосредственно в разделе $HOME/.kube/config .
    • Если вы используете другие средства для настройки кластера Kubernetes, обратитесь к документации по Kubernetes.
    • Так как у вас есть файл конфигурации контекста Kubernetes, объедините его с файлом конфигурации , который является $HOME/.kube/config, на компьютере, на котором вы хотите выполнить команду IRCTL. Можно также задать файл конфигурации контекста Kubernetes в переменной среды с именем KUBECONFIG. Дополнительные сведения о контексте Kubernetes см. в разделе Настройка доступа к нескольким кластерам.

Установка и запуск IRCTL

Чтобы управлять поддерживаемой kubernetes локальной средой выполнения интеграции и управлять ею, пользователи могут скачать программу командной строки С именем IRCTL. Пользователи также могут отслеживать состояние на портале с помощью IRCTL и командной строки kubectl. Ниже приведены шаги для локальной среды выполнения интеграции, поддерживаемой Kubernetes.

Скачать последнюю версию IRCTL для Windows

Кора́н

Чтобы скачать определенную версию 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

Вы можете скачать программу командной строки IRCTL из параметров среды выполнения интеграции в Microsoft Purview. Выберите среду выполнения интеграции и в разделе Параметры вы увидите ссылку Скачать IRCTL и установить среду выполнения интеграции . Выберите его, чтобы скачать средство.

Командную строку IRCTL можно использовать для настройки или управления поддерживаемой kubernetes локальной средой выполнения интеграции. Используйте следующий синтаксис для выполнения команд IRCTL из окна терминала:

./irctl [command][flags]...
  • Команда указывает операцию, которую вы хотите выполнить.
  • Флаги указывают параметры для операции.
Команда Описание
config Управляет конфигурациями IRCTL
создать Создание ресурса SHIR
удалить Удаление ресурса SHIR
описывать Описывает SHIR, работающий в кластере Kubernetes.
Справка Предоставляет справку по любой команде
хранение Управление локальным хранилищем, зарезервированным для SHIR
журнал Управление журналами SHIR
Обновление Обновление SHIR до той же версии с помощью IRCTL

Конфигурация

Управление конфигурациями IRCTL.

./irctl config [flags]
./irctl config [command]
Команда Описание
set Измените одну конфигурацию SHIR.
представление Просмотрите все конфигурации SHIR.
Flag Тип параметра Описание
-h,--help Справка по конфигурации

Набор конфигураций

Измените одну конфигурацию локальной среды выполнения интеграции.

./irctl config set <config-name> <config-value> [flags]
Flag Тип параметра Описание
-c, --context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по конфигурации

Представление конфигурации

Просмотрите все конфигурации SHIR.

./irctl
Flag Тип параметра Описание
-c, --context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по конфигурации

Допустимые конфигурации SHIR

Имя конфигурации Тип конфигурации Допустимые значения Значение по умолчанию (значение не задано) Описание Сохраняется путем переустановки
autoUpdate.enabled Логический значение true/false true Управляет автоматическим расширением текущего SHIR. Да

Create

Создайте ресурс SHIR.

./irctl create [flags]
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по созданию
-r,--registration-key string Ключ для регистрации SHIR
-s,--selector string Селектор узла (запрос меток) для фильтрации поддерживает "=". (например,--выбор key1=value1,key2=value2) Выберите узлы по заданным меткам для запуска SHIR. Значение по умолчанию пусто, что означает, что SHIR выполняется на всех узлах.

Пример:

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

Обновление

Обновите SHIR до той же версии с помощью IRCTL.

./irctl upgrade [flags]
./irctl upgrade [command]
Команда Описание
status Отслеживает состояние последнего обновления SHIR.
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по обновлению

Удалить

Удаление ресурса SHIR.

./irctl delete [flags]
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по удалению

Описывать

Описание SHIR, выполняемого в кластере Kubernetes.

./irctl describe [flags]
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по описанию

Хранилища

Управление файлами в общем хранилище SHIR.

./irctl storage [flags]
./irctl storage [command]
Команда Описание
отправить Отправка файлов в общее хранилище SHIR.
list Вывод списка файлов в общем хранилище SHIR.
удалить Удаление файлов в общем хранилище SHIR.
Flag Тип параметра Описание
-h,--help Справка по хранилищу

Отправка хранилища

Отправка файлов в общее хранилище SHIR.

./irctl storage upload -s <source> -d <destination> [flags]
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
Строка -d,--destination string Путь к хранилищу файлов или папок, отправленных в общее хранилище SHIR.
-h,--help Справка по удалению
-s,--source string Путь к файлу или папке для отправки.

Список хранилища

Вывод списка файлов в общем хранилище SHIR.

./irctl storage list <path> [flags]
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по списку.

Удаление хранилища

Удаление файлов в общем хранилище SHIR.

./irctl storage delete <path> [flags]
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по удалению.

Log

Операции журнала из SHIR.

./irctl log [flags]
./irctl log [command]
Команда Описание
отправить Отправка журналов из SHIR.
загружать Скачайте журналы из SHIR.
Flag Тип параметра Описание
-h,--help Справка по журналу.

Отправка журнала

Отправка журналов из SHIR.

./irctl log upload [flags]
./irctl log upload [command]
Команда Описание
Состояние Отслеживает состояние отправки журналов SHIR.
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-h,--help Справка по отправке.
-t,--timeout int Время ожидания для операции отправки журнала в секундах: [900, 3600]. Значение по умолчанию — 900 секунд. (по умолчанию 900)

Скачивание журнала

Отправка журналов из SHIR.

./irctl log download [flags]
Flag Тип параметра Описание
-c,--context string Имя используемого контекста Kubernetes, если оно не указано, используется текущий контекст конфигурации Kube.
-d,--destination string Локальный путь к хранению журналов, скачанных из SHIR.
-h,--help Справка по скачиванию.

Дальнейшие действия