IRCTL para tempo de execução de integração auto-hospedado com suporte do Kubernetes

Para gerenciar seu Microsoft Purview Kubernetes SHIR localmente, você precisa de uma ferramenta de linha de comando chamada IRCTL. Você pode baixar esta ferramenta durante o processo de criação do SHIR. O IRCTL é uma ferramenta de linha de comando para gerenciar seu SHIR do Microsoft Purview.

Pré-requisitos

Os requisitos do sistema para IRCTL são:

  • Computador executando IRCTL - O sistema operacional é Linux ou Windows compatível com TLS 1.2
  • O computador para executar o IRCTL deve ser capaz de se conectar aos seguintes pontos de extremidade:
Nome de domínio Portas de saída Descrição
Nuvem pública: *.compute.governance.azure.com
Azure Governamental:*.compute.governance.azure.us
China: *.compute.governance.azure.cn		 443 Necessário para se conectar ao serviço Microsoft Purview. Se você usar Pontos de Extremidade Privados do Microsoft Purview, esse ponto de extremidade será coberto pelo ponto de extremidade privado da conta.
  • Contexto do Kubernetes: O contexto do Kubernetes, que contém informações do cluster Kubernetes e permissões e credenciais do usuário para este cluster, é necessário para se comunicar com o cluster do Kubernetes. Para facilitar a configuração das permissões do usuário para gerenciamento SHIR, você pode começar com a função de Administração do Kubernetes. Esse contexto é gerado com a configuração do cluster Kubernetes e salvo em um arquivo de configuração. Onde e como você pode obter esse arquivo depende da configuração do cluster Kubernetes.
    • Se você usa kubeadm init para configurar o cluster do Kubernetes, pode encontrar o arquivo de configuração em /etc/Kubernetes/admin.conf.
    • Se você usar o AKS, poderá seguir as diretrizes do AKS para usar o comando do módulo Az PowerShell para obter credenciais desse cluster para seu computador local. O contexto pode ser mesclado ao arquivo $HOME/.kube/config de configuração diretamente.
    • Se você estiver usando outras ferramentas para configurar um cluster do Kubernetes, consulte a documentação do Kubernetes.
    • Como você tem o arquivo de configuração do contexto do Kubernetes, mescle-o ao arquivo de configuração, que é $HOME/.kube/config, na máquina em que você gostaria de executar o comando IRCTL. Ou você também pode definir o arquivo de configuração do contexto do Kubernetes em uma variável de ambiente chamada KUBECONFIG. Para obter mais informações sobre o contexto do Kubernetes, consulte Configurar o acesso a vários clusters.

Instalar e executar IRCTL

Para controlar e gerenciar um runtime de integração auto-hospedada com suporte do Kubernetes, os usuários podem fazer download de uma ferramenta de linha de comando chamada IRCTL. Os usuários também podem monitorar o status no Portal pela linha de comando IRCTL e kubectl. Veja a seguir as etapas para o runtime de integração auto-hospedada com suporte do Kubernetes.

Baixar o IRCTL mais recente para Windows

Versão específica

Para baixar uma versão específica do IRCTL, altere o segmento de versão na URL: https://aka.ms/purview-irctl/irctl-windows-<version>.tar.gz

Por exemplo, para a versão 1.0.0: https://aka.ms/purview-irctl/irctl-windows-1.0.0.tar.gz

As versões IRCTL disponíveis podem ser encontradas nas notas de versão IRCTL.

Depois de baixar a ferramenta:

  1. Descompacte e abra a pasta da ferramenta.

  2. Mova-o para um local em seu computador onde você possa acessá-lo a partir da linha de comando.

  3. Abra a linha de comando e navegue até a pasta onde o aplicativo IRCTL está hospedado.

  4. Use os comandos abaixo para interagir com o IRCTL e siga estas etapas para instalar um runtime de integração compatível com o Kubernetes.

Detalhes do comando IRCTL

Você pode baixar a ferramenta de linha de comando IRCTL nas configurações de runtime de integração no Microsoft Purview. Selecione seu runtime de integração e, em Configurações , você pode ver o link Baixar IRCTL e instalar runtime de integração . Selecione-a para baixar a ferramenta.

Você pode usar a linha de comando IRCTL para configurar ou gerenciar um runtime de integração auto-hospedada com suporte do Kubernetes. Use esta sintaxe para executar comandos IRCTL da janela do terminal:

./irctl [command][flags]...
  • O comando especifica a operação que você deseja realizar
  • Sinalizadores especifica parâmetros para a operação
Comando Descrição
de rede Gerencia as configurações de IRCTL
criar Criar um recurso SHIR
excluir Excluir um recurso SHIR
Descrever Descreve o SHIR em execução no cluster Kubernetes
Ajuda Fornece ajuda sobre qualquer comando
armazenamento Gerenciar o armazenamento local reservado para SHIR
de log Gerenciar logs de SHIR
atualização Atualizar um SHIR para a mesma versão com IRCTL

Configuração

Gerenciar configurações de IRCTL.

./irctl config [flags]
./irctl config [command]
Comando Descrição
set Modifique uma configuração SHIR.
modo de exibição Veja todas as configurações do SHIR.
Flag Tipo de parâmetro Descrição
-h,--help Ajuda para config

Conjunto de configurações

Modifique uma configuração de tempo de execução de integração auto-hospedada.

./irctl config set <config-name> <config-value> [flags]
Flag Tipo de parâmetro Descrição
-c, --context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado.
-h,--help Ajuda para config

Exibição de configuração

Veja todas as configurações do SHIR.

./irctl
Flag Tipo de parâmetro Descrição
-c, --context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado.
-h,--help Ajuda para config

Configurações SHIR permitidas

Nome da configuração Tipo de configuração Valores válidos Valor padrão (valor não definido) Descrição Persiste durante a reinstalação
autoUpdate.enabled Booliano verdadeiro/falso verdadeiro Controla se o SHIR atual deve ser atualizado automaticamente. Sim

Criar

Crie um novo recurso SHIR.

./irctl create [flags]
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado
-h,--help Ajuda para criar
-r,--chave de registro string Chave para registrar SHIR
-s,--selector string Seletor de nó (consulta de rótulo) para filtrar, dá suporte a '='. (por exemplo,--seletor key1=value1,key2=value2) Selecione os nós por rótulos fornecidos para o SHIR ser executado. O padrão é vazio, o que significa que o SHIR é executado em todos os nós.

Exemplo:

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

Atualizar

Atualize um SHIR para a mesma versão com o IRCTL.

./irctl upgrade [flags]
./irctl upgrade [command]
Comando Descrição
status Monitora o status da atualização SHIR mais recente.
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado
-h,--help Ajuda para atualização

Excluir

Exclua um recurso SHIR.

./irctl delete [flags]
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado
-h,--help Ajuda para exclusão

Descrever

Descreva o SHIR em execução no cluster do Kubernetes.

./irctl describe [flags]
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado
-h,--help Ajuda para descrever

Armazenamento

Gerenciar arquivos no armazenamento compartilhado SHIR.

./irctl storage [flags]
./irctl storage [command]
Comando Descrição
upload Carregue arquivos no armazenamento compartilhado SHIR.
list Listar arquivos no armazenamento compartilhado SHIR.
excluir Exclua arquivos no armazenamento compartilhado SHIR.
Flag Tipo de parâmetro Descrição
-h,--help Ajuda para armazenamento

Upload de armazenamento

Carregue arquivos no armazenamento compartilhado SHIR.

./irctl storage upload -s <source> -d <destination> [flags]
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado.
-d,--destination string string Caminho para armazenar o arquivo/pasta carregado no armazenamento compartilhado SHI.
-h,--help Ajuda para exclusão
-s,--source string Caminho para o arquivo/pasta a ser carregado.

Lista de armazenamento

Listar arquivos no armazenamento compartilhado SHIR.

./irctl storage list <path> [flags]
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado.
-h,--help Ajuda para lista.

Exclusão de armazenamento

Exclua arquivos no armazenamento compartilhado SHIR.

./irctl storage delete <path> [flags]
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado.
-h,--help Ajuda para excluir.

Log

Operações de log do SHIR.

./irctl log [flags]
./irctl log [command]
Comando Descrição
upload Carregue logs do SHIR.
Baixar Baixe logs do SHIR.
Flag Tipo de parâmetro Descrição
-h,--help Ajuda para log.

Upload de log

Carregue logs do SHIR.

./irctl log upload [flags]
./irctl log upload [command]
Comando Descrição
Status Monitora o status do carregamento do log SHIR.
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado.
-h,--help Ajuda para upload.
-t,--timeout int Tempo limite para a operação de carregamento de log em segundos: [900, 3600]. O padrão é 900 segundos. (Padrão 900)

Download de log

Carregue logs do SHIR.

./irctl log download [flags]
Flag Tipo de parâmetro Descrição
-c,--context string Nome do contexto do Kubernetes a ser usado, se não for especificado, o contexto atual da configuração do Kube será usado.
-d,--destino string Caminho local para armazenar logs baixados do SHIR.
-h,--help Ajuda para download.

Próximas etapas

  • Last updated on