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

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 Справка по скачиванию.

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