Compartilhar via

IRCTL para o Runtime de integração autoalojado suportado pelo Kubernetes

  • Artigo

Para gerir o Seu Microsoft Purview Kubernetes SHIR localmente, precisa de uma ferramenta de linha de comandos chamada IRCTL. Pode transferir esta ferramenta durante o processo de criação do SHIR. IRCTL é uma ferramenta de linha de comandos para gerir o seu SHIR do Microsoft Purview.

Pré-requisitos

Os requisitos de sistema para IRCTL são:

  • Máquina virtual com IRCTL – O SO é Linux ou Windows que suporta o TLS 1.2
  • O computador a executar IRCTL deve conseguir ligar-se aos seguintes pontos finais:
Nome de domínio Portas de saída Descrição
Cloud pública: *.compute.governance.azure.com
Azure Governamental:*.compute.governance.azure.us
China: *.compute.governance.azure.cn		 443 Necessário para ligar ao serviço Microsoft Purview. Se utilizar os Pontos Finais Privados do Microsoft Purview, este ponto final é abrangido pelo ponto final privado da conta.
  • Contexto do Kubernetes: o contexto do Kubernetes, que contém informações do cluster do Kubernetes e as permissões e credenciais do utilizador para este cluster, é necessário para comunicar com o cluster do Kubernetes. Para facilitar a configuração das permissões do utilizador para a gestão do SHIR, pode começar com o Kubernetes Administração função. Este contexto é gerado com a configuração do cluster do Kubernetes e guardado num ficheiro de configuração. Onde e como pode obter este ficheiro depende da configuração do cluster do Kubernetes.
    • Se utilizar kubeadm init para configurar o cluster do Kubernetes, pode encontrar o ficheiro /etc/Kubernetes/admin.confde configuração em .
    • Se utilizar o AKS, pode seguir a documentação de orientação do AKS para utilizar o comando do módulo Az PowerShell para obter as credenciais deste cluster para o seu computador local. O contexto pode ser intercalado com o ficheiro $HOME/.kube/config de configuração em diretamente.
    • Se estiver a utilizar outras ferramentas para configurar um cluster do Kubernetes, veja a documentação do Kubernetes.
    • Como tem o ficheiro de configuração do contexto do Kubernetes, intercale-o no ficheiro de configuração, que é $HOME/.kube/config, no computador que pretende executar o comando IRCTL. Em alternativa, também pode definir o ficheiro de configuração do contexto do Kubernetes numa variável de ambiente denominada KUBECONFIG. Para obter mais informações sobre o contexto do Kubernetes, veja Configurar o Acesso a Múltiplos Clusters.

Instalar e executar IRCTL

Para controlar e gerir um runtime de integração autoalojado suportado pelo Kubernetes, os utilizadores podem transferir uma ferramenta de linha de comandos denominada IRCTL. Os utilizadores também podem monitorizar o status no Portal por IRCTL e linha de comandos kubectl. Seguem-se os passos para o runtime de integração autoalojado suportado pelo Kubernetes.

Transferir IRCTL Mais Recente para Windows

Versão específica

Para transferir uma versão específica da IRCTL, altere o segmento de versão no 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 transferir a ferramenta:

  1. Deszipe e abra a pasta de ferramentas.

  2. Mova-a para uma localização no seu computador onde possa aceder à mesma a partir da linha de comandos.

  3. Abra a linha de comandos e navegue para a pasta onde a aplicação IRCTL está alojada.

  4. Utilize os comandos abaixo para interagir com IRCTL e siga estes passos para instalar um runtime de integração suportado pelo Kubernetes.

Detalhes do comando IRCTL

Pode transferir a ferramenta de linha de comandos IRCTL a partir das definições do runtime de integração no Microsoft Purview. Selecione o runtime de integração e, em Definições , pode ver a ligação Transferir IRCTL e instalar o runtime de integração . Selecione-a para transferir a ferramenta.

Pode utilizar a linha de comandos IRCTL para configurar ou gerir um runtime de integração autoalojado suportado pelo Kubernetes. Utilize esta sintaxe para executar comandos IRCTL a partir da janela do terminal:

./irctl [command][flags]...
  • O comando especifica a operação que pretende executar
  • Sinalizadores especifica parâmetros para a operação
Comando Descrição
configuração Gere as configurações de IRCTL
criar Criar um novo recurso SHIR
eliminar Eliminar um recurso SHIR
descrever Descreve o SHIR em execução no cluster do Kubernetes
Ajuda Fornece ajuda sobre qualquer comando
armazenamento Gerir o armazenamento local reservado para o SHIR
registo Gerir registos do SHIR
atualização Atualizar um SHIR para a mesma versão com IRCTL

Configuração

Gerir configurações IRCTL.

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

Conjunto de configuração

Modificar uma configuração do runtime de integração autoalojado.

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

Vista de configuração

Ver todas as configurações do SHIR.

./irctl
Flag Tipo de parâmetro Descrição
-c, --context cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube.
-h,--ajuda Ajuda para configuração

Configurações SHIR Permitidas

Nome da configuração Tipo de configuração Valores válidos Valor predefinido (valor não definido) Descrição Persiste através da 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 cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube
-h,--ajuda Ajuda para criar
-r,--registration-key cadeia de caracteres Chave para registar o SHIR
-s,--elector cadeia de caracteres O seletor de nós (consulta de etiqueta) para filtrar suporta "=". (por exemplo,--selector key1=value1,key2=value2) Selecione nós com etiquetas especificadas para o SHIR ser executado. A predefinição está vazia, o que significa que o SHIR será executado em todos os nós.

Exemplo:

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

Atualizar

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

./irctl upgrade [flags]
./irctl upgrade [command]
Comando Descrição
status Monitoriza a status a atualização mais recente do SHIR.
Flag Tipo de parâmetro Descrição
-c,--context cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube
-h,--ajuda Ajuda para a atualização

Excluir

Eliminar um recurso SHIR.

./irctl delete [flags]
Flag Tipo de parâmetro Descrição
-c,--context cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube
-h,--ajuda Ajuda para eliminar

Descrever

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

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

Armazenamento

Gerir ficheiros no armazenamento partilhado do SHIR.

./irctl storage [flags]
./irctl storage [command]
Comando Descrição
upload Carregue ficheiros para o armazenamento partilhado do SHIR.
list Listar ficheiros no armazenamento partilhado do SHIR.
eliminar Eliminar ficheiros no armazenamento partilhado do SHIR.
Flag Tipo de parâmetro Descrição
-h,--ajuda Ajuda para o armazenamento

Carregamento de armazenamento

Carregue ficheiros para o armazenamento partilhado do SHIR.

./irctl storage upload -s <source> -d <destination> [flags]
Flag Tipo de parâmetro Descrição
-c,--context cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube.
-d,-- cadeia de dados cadeia de caracteres Caminho para armazenar ficheiros/pastas carregados no armazenamento partilhado do SHIR.
-h,--ajuda Ajuda para eliminar
-s,--source cadeia de caracteres Caminho para o ficheiro/pasta a carregar.

Lista de armazenamento

Listar ficheiros no armazenamento partilhado do SHIR.

./irctl storage list <path> [flags]
Flag Tipo de parâmetro Descrição
-c,--context cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube.
-h,--ajuda Ajuda para a lista.

Eliminação de armazenamento

Eliminar ficheiros no armazenamento partilhado do SHIR.

./irctl storage delete <path> [flags]
Flag Tipo de parâmetro Descrição
-c,--context cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube.
-h,--ajuda Ajuda para eliminar.

Log

Operações de registo do SHIR.

./irctl log [flags]
./irctl log [command]
Comando Descrição
upload Carregue registos do SHIR.
transferir Transfira registos do SHIR.
Flag Tipo de parâmetro Descrição
-h,--ajuda Ajuda para o registo.

Carregamento de registos

Carregue registos do SHIR.

./irctl log upload [flags]
./irctl log upload [command]
Comando Descrição
Status Monitoriza a status do carregamento de registos do SHIR.
Flag Tipo de parâmetro Descrição
-c,--context string O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube.
-h,--ajuda Ajuda para carregar.
-t,--timeout int Tempo limite para a operação de carregamento do registo em segundos: [900, 3600]. A predefinição é 900 segundos. (Predefinição 900)

Transferência de registos

Carregue registos do SHIR.

./irctl log download [flags]
Flag Tipo de parâmetro Descrição
-c,--context cadeia de caracteres O nome do contexto do Kubernetes a utilizar, se não for especificado, será utilizado o contexto atual da configuração do Kube.
-d,--destination cadeia de caracteres Caminho local para armazenar registos transferidos do SHIR.
-h,--ajuda Ajuda para transferência.

Próximas etapas