Configurar a ferramenta DIRCTL para o runtime de integração autoalojado (pré-visualização)

A linha de comandos do runtime de integração de dados (DIRCTL) é um . Ferramenta de interface de linha de comandos (CLI) baseada em NET que automatiza a gestão do runtime de integração de dados em clusters do Kubernetes. Simplifica operações complexas do Kubernetes com comandos simples e garante uma comunicação segura com o Microsoft Purview para gestão do ciclo de vida de registos e tokens.

Para gerir o runtime de integração de dados autoalojado do Microsoft Purview Kubernetes localmente, precisa da ferramenta de linha de comandos DIRCTL. Pode transferir esta ferramenta durante o processo de criação do runtime de integração de dados. Veja as instruções de configuração abaixo para Sistemas operativos Windows e Linux.

Configuração do Windows para a CLI DIRCTL

  1. Transfira e instale a ferramenta da CLI do Kubectl.
  2. Coloque o ficheiro de configuração do kube gerado na pasta específica do utilizador de acordo com este caminho: C:/Users/<user-folder>/.kube/. Copie o ficheiro e dê-lhe o nome config.

    Observação

    Este ficheiro de configuração é necessário para a autenticação DIRCTL em clusters do Kubernetes.

  3. Transfira o pacote da CLI DIRCTL .zip para Windows.
  4. Extraia os conteúdos para um diretório preferencial no seu computador local.
  5. Abra um terminal no Windows.
  6. Navegue para o diretório DIRCTL extraído.
  7. Utilize o comando <path-to-dirctl> cd para se deslocar para a pasta .
  8. Execute comandos com ./DIRCTL'".

Linux configuração da CLI DIRCTL

  1. Transfira e instale a CLI kubectl para a sua distribuição de Linux.
  2. Coloque o ficheiro kubeconfig, para autenticação no Kubernetes, na pasta kube predefinida: ~/.kube/.
  3. Copie o ficheiro kubeconfig gerado para o diretório específico do utilizador. Certifique-se de que o ficheiro tem o nome config: mkdir -p ~/.kube cp /path/to/your/kubeconfig ~/.kube/config

    Observação

    Este ficheiro de configuração é necessário para a autenticação DIRCTL em clusters do Kubernetes.

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

Comandos DIRCTL

  1. Ajuda DIRCTL: o comando Ajuda fornece uma descrição geral abrangente de todos os comandos e funcionalidades disponíveis na ferramenta DIRCTL. Garante que pode utilizar a ferramenta de forma eficaz ao fornecer orientações e contexto para as suas tarefas de integração de dados.

  2. Voltar a registar DIRCTL: ./DIRCTL re-register –registration-key <re-registration-key-value> utilize o comando Voltar a registar para registar novamente um recurso de runtime de integração de dados existente, se estiver inativo durante muito tempo, utilizando uma nova chave de registo.

  3. Eliminação DIRCTL: ./DIRCTL delete quando pretender anular o registo de um runtime de integração de dados do sistema e libertar todos os pods do Kubernetes da aplicação associada, o comando Eliminar fornece uma solução simplificada. Este comando remove completamente o DIR do SQL Server Data Quality Services (DQS), garantindo que não restam restos do runtime ou dos pods da aplicação. O comando também processa a terminação de todos os pods do Kubernetes em execução associados à aplicação DIR, libertando recursos no sistema.

  4. Atualização DIRCTL: ./DIRCTL upgrade –v <image version> o comando Atualizar permite-lhe atualizar de forma totalmente integrada a versão de um runtime de integração de dados para a versão mais recente disponível especificada pelo utilizador. Este processo garante que o runtime de integração de dados funciona com as funcionalidades, melhorias e patches de segurança mais atualizados, mantendo a sua compatibilidade e eficiência no sistema.

  5. Descrição DIRCTL: ./DIRCTL describe O comando Descrever fornece informações detalhadas sobre o status e o desempenho das aplicações DIR e DIRCTL em execução. Verifica o estado de funcionamento dos pods da aplicação, garantindo que quaisquer problemas ou anomalias são imediatamente identificados. Ao oferecer visibilidade para o ambiente de runtime, esta funcionalidade suporta a resolução de problemas e a manutenção proativa do sistema.

  6. Registo DIRCTL: ./DIRCTL log download –d <relative-destination-folder-path> utilize o comando Registo para transferir registos de todos os pods de aplicações de runtime de integração de dados ativos para um caminho de pasta de destino especificado. Esta funcionalidade é especialmente vital para atividades de depuração, monitorização de desempenho ou auditoria, uma vez que garante que tem acesso a registos de runtime detalhados. Ao reter registos abrangentes, pode identificar de forma eficaz padrões, anomalias e potenciais problemas, tornando-o uma ferramenta chave na manutenção e otimização do sistema.

  7. Configuração DIRCTL: ./DIRCTL config auto-update-enable <true/false> atualize a configuração para ativar a atualização automática para falso ou verdadeiro.