Configurar a ferramenta DIRCTL para runtime de integração auto-hospedada (versão prévia)

A DIRCTL (linha de comando do runtime de integração de dados) é uma extensão . Ferramenta de interface de linha de comando (CLI) baseada em NET que automatiza o gerenciamento de tempo de execução de integração de dados em clusters Kubernetes. Ele simplifica operações complexas do Kubernetes com comandos simples e garante a comunicação segura com o Microsoft Purview para registro e gerenciamento do ciclo de vida do token.

Para gerenciar localmente o runtime de integração de dados auto-hospedada do Microsoft Purview Kubernetes, você precisa da ferramenta de linha de comando DIRCTL. Você pode baixar essa ferramenta durante o processo de criação do runtime de integração de dados. Consulte as instruções de configuração abaixo para sistemas operacionais Windows e Linux.

Instalação do Windows para DIRCTL CLI

  1. Baixe e instale a ferramenta CLI Kubectl.
  2. Coloque o arquivo de configuração do kube gerado na pasta específica do usuário de acordo com este caminho: C:/Users/<user-folder>/.kube/. Copie o arquivo e nomeie-o como config.

    Observação

    Esse arquivo de configuração é necessário para autenticação DIRCTL em clusters Kubernetes.

  3. Baixe o pacote CLI DIRCTL .zip para Windows.
  4. Extraia o conteúdo para um diretório preferencial no computador local.
  5. Abra um terminal no Windows.
  6. Navegue até o diretório DIRCTL extraído.
  7. Use o comando <path-to-dirctl> cd para mover para a pasta.
  8. Executar comandos usando ./DIRCTL'''.

Configuração do Linux para CLI DIRCTL

  1. Baixe e instale a CLI kubectl para sua distribuição do Linux.
  2. Coloque o arquivo kubeconfig, para autenticação no Kubernetes, na pasta kube padrão: ~/.kube/.
  3. Copie o arquivo kubeconfig gerado para o diretório específico do usuário. Verifique se o arquivo é chamado config: mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config

    Observação

    Esse arquivo de configuração é necessário para autenticação DIRCTL em clusters Kubernetes.

  4. Baixe o pacote DIRCTL CLI para Windows ou Linux.
  5. Abra um terminal e navegue até o diretório DIRCTL: cd /your/target/directory/DIRCTL
  6. Execute comandos usando: ./DIRCTL .

Comandos DIRCTL

  1. Ajuda DIRCTL: O comando Ajuda fornece uma visão geral abrangente de todos os comandos e funcionalidades disponíveis na ferramenta DIRCTL. Isso garante que você possa usar a ferramenta com eficiência, fornecendo orientação e contexto para suas tarefas de integração de dados.

  2. DIRCTL Registrar novamente: ./DIRCTL re-register –registration-key <re-registration-key-value> use o comando Registrar novamente para registrar novamente um recurso de runtime de integração de dados existente, se ele estiver inativo por um longo tempo, usando uma nova chave de registro.

  3. Exclusão de DIRCTL: ./DIRCTL delete quando você deseja cancelar o registro de um runtime de integração de dados do sistema e liberar todos os pods do Kubernetes de aplicativos associados, o comando Delete fornece uma solução simplificada. Esse comando remove completamente o DIR do DQS (Data Quality Services) do SQL Server, garantindo que nenhum resquício do tempo de execução ou de seus pods de aplicativo permaneça. O comando também lida com o encerramento de todos os pods do Kubernetes em execução associados ao aplicativo DIR, liberando recursos dentro do sistema.

  4. Atualização DIRCTL: ./DIRCTL upgrade –v <image version> o comando Upgrade permite que você atualize perfeitamente a versão de um runtime de integração de dados para a versão mais recente disponível especificada pelo usuário. Esse processo garante que o runtime de integração de dados opere com os recursos, aprimoramentos e patches de segurança mais atualizados, mantendo sua compatibilidade e eficiência dentro do sistema.

  5. DIRCTL Descrever: ./DIRCTL describe O comando Descrever fornece informações detalhadas sobre o status e o desempenho dos aplicativos DIR e DIRCTL em execução. Ele verifica a integridade dos pods de aplicativos, garantindo que quaisquer problemas ou anomalias sejam identificados imediatamente. Ao oferecer visibilidade do ambiente de tempo de execução, essa funcionalidade oferece suporte à solução de problemas e à manutenção proativa do sistema.

  6. Log DIRCTL: ./DIRCTL log download –d <relative-destination-folder-path> use o comando Log para baixar logs de todos os pods de aplicativo de runtime de integração de dados ativos em um caminho de pasta de destino especificado. Essa funcionalidade é especialmente vital para depuração, monitoramento de desempenho ou atividades de auditoria, pois garante que você tenha acesso a registros de tempo de execução detalhados. Ao reter logs abrangentes, você pode identificar efetivamente padrões, anomalias e possíveis problemas, tornando-se uma ferramenta fundamental na manutenção e otimização do sistema.

  7. Configuração DIRCTL: ./DIRCTL config auto-update-enable <true/false> atualize a configuração para auto-update-enable para false ou true.