Agentes PlaidLink
Descrição
Seção intitulada “Descrição”Às vezes é necessário e desejável acessar dados ou executar processos de um sistema remoto que não permite acesso externo. Isso é comum em ambientes corporativos protegidos por firewalls. O PlaidCloud oferece essa capacidade por meio do PlaidLink, que permite o acesso a sistemas remotos atrás de um firewall ou nos casos em que o acesso direto do PlaidCloud não é desejado.
O PlaidLink usa um sistema baseado em agentes. Isso significa que um agente, o usuário remoto, é instalado em um sistema dentro do firewall ou de outra área restrita. O agente pode então se conectar ao PlaidCloud por meio de um processo de inicialização de saída, usando uma conexão websocket HTTPS segura. Ela é tão segura quanto qualquer outra conexão web criptografada e normalmente não exige que você abra portas fora do padrão. Antes de obter acesso, o agente deve se identificar enviando seu identificador de agente. A partir disso, se o agente concluir o processo de autenticação com êxito, ele recebe acesso às operações aprovadas.
O PlaidLink pode ser instalado em sistemas Windows, Unix e Linux e pode ser executado com usuários de baixo privilégio. Em sistemas Windows, o PlaidLink pode operar como um serviço do Windows, com controle total pelo painel de Serviços. Em sistemas Linux ou Unix, ele pode ser executado como um processo daemon.
O PlaidLink também pode ser executado como um contêiner Docker independente ou como um pod do Kubernetes.
Gerenciar agentes
Seção intitulada “Gerenciar agentes”Para gerenciar agentes:
- Abra o Analyze
- Selecione “Ferramentas”
- Clique em “Agentes PlaidLink”
Isso leva você à tabela de agentes PlaidLink, na qual você pode ver, modificar e obter credenciais da lista de agentes disponíveis.
Criar um agente
Seção intitulada “Criar um agente”Para criar um agente:
- Abra o Analyze
- Selecione “Ferramentas”
- Clique em “Agentes PlaidLink”
- Clique em “Adicionar agente PlaidLink”
- Preencha os campos obrigatórios
- Clique em “Criar”
- Atribua o agente aos grupos de segurança necessários para acessar os recursos de que ele precisa para realizar seu trabalho
- Atribua o agente às contas de documentos necessárias para acessar os documentos de que ele precisa para realizar seu trabalho
Obter as credenciais do agente
Seção intitulada “Obter as credenciais do agente”Para configurar agentes PlaidLink no sistema remoto, primeiro você deve obter as informações de identificação do agente a fim de manter a segurança. Essas informações incluem uma chave pública e uma chave privada.
Para obter essas chaves:
- Abra o Analyze
- Selecione “Ferramentas”
- Clique em “Agentes PlaidLink”
- Clique no ícone de edição
Isso abre um formulário no qual você pode ver os valores das chaves pública e privada.
A chave privada e o botão Ver configuração de RPC aparecem apenas para membros que podem editar agentes; os demais membros veem somente a chave pública.
Regenerar as credenciais do agente
Seção intitulada “Regenerar as credenciais do agente”É uma boa prática regenerar periodicamente as chaves pública e privada e atualizar a configuração dos sistemas remotos para manter a segurança.
Para regenerar as credenciais:
- Abra o Analyze
- Selecione “Ferramentas”
- Clique em “Agentes PlaidLink”
- Clique no ícone de regeneração
Depois que as credenciais forem regeneradas, elas podem ser obtidas da mesma forma que as credenciais de um novo agente (descrita acima).
Ativar e desativar um agente
Seção intitulada “Ativar e desativar um agente”Para desativar um agente:
- Abra o Analyze
- Selecione “Ferramentas”
- Clique em “Agentes PlaidLink”
- Desmarque a caixa de seleção “Ativo”
Ambientes do agente
Seção intitulada “Ambientes do agente”Uma conexão pode ter uma configuração diferente por ambiente, de modo que alternar o ambiente de um projeto redireciona de uma só vez todas as conexões que ele usa. Os agentes podem acompanhar a mesma alternância.
Cada agente tem duas configurações:
- Grupo de agentes — um nome compartilhado pelos agentes que substituem uns aos outros. Os agentes de um grupo são alternativas para o mesmo trabalho, um por ambiente.
- Ambiente atendido por este agente — o ambiente de conexão que este agente atende. Ele deve corresponder ao ambiente na configuração do PlaidLink do agente.
Uma etapa ainda nomeia um agente específico. Quando o fluxo de trabalho é executado, o PlaidCloud examina o grupo ao qual esse agente pertence e escolhe o membro que atende ao ambiente atual do projeto. Assim, um projeto movido do ambiente padrão para o de QA executa suas etapas remotas na máquina de QA, sem que nenhuma etapa seja editada.
Para um grupo chamado Finance com um agente atendendo ao ambiente padrão e outro atendendo ao de QA, uma etapa que nomeia qualquer um dos dois é executada no que corresponde ao projeto — e um projeto que volta ao ambiente padrão é executado no agente do ambiente padrão, mesmo quando a etapa nomeia o de QA.
Para atribuir um agente a um ambiente:
- Abra o Analyze
- Selecione “Ferramentas”
- Clique em “Agentes PlaidLink”
- Abra o agente
- Defina “Grupo de agentes” com um nome compartilhado com as alternativas do agente e defina “Ambiente atendido por este agente” como o ambiente cujo trabalho ele executa, como QA
- Na máquina que executa esse agente, defina o nome de ambiente correspondente no arquivo de configuração do PlaidLink — consulte Correspondência com a máquina do agente abaixo
Retirar um agente de um grupo reduz o que o grupo cobre, portanto tem tanta consequência quanto adicionar um. Limpar o grupo no agente que atendia ao seu ambiente padrão deixa os projetos executados nele sem destino para resolver, e eles falham na próxima execução. Mova o ambiente para outro membro do grupo antes de remover um. Cada salvamento que altera o que um grupo cobre informa a você a nova cobertura.
Os ambientes são compartilhados com as conexões, portanto os nomes de ambiente oferecidos aqui são os mesmos sob os quais você configura uma conexão. Consulte Criar e gerenciar uma conexão.
Correspondência com a máquina do agente
Seção intitulada “Correspondência com a máquina do agente”O ambiente que você define aqui precisa corresponder ao ambiente para o qual o serviço PlaidLink naquela máquina está configurado. O PlaidLink se inscreve em uma fila exata para o ambiente nomeado no arquivo de configuração, portanto um agente cujo registro indica QA, mas cuja máquina ainda está configurada para o ambiente padrão, está escutando uma fila diferente daquela para a qual o trabalho é enviado. A etapa aguarda e depois falha informando que o agente não está assumindo o trabalho.
Defina-o no bloco environments do arquivo de configuração do PlaidLink, na entrada desse agente:
environments: - name: QA agent_id: <agent identifier>O name é o nome do ambiente como aparece no PlaidCloud. Quando ele é omitido, o agente atende ao ambiente padrão. Reinicie o serviço PlaidLink depois de alterá-lo.
Executar vários agentes
Seção intitulada “Executar vários agentes”O PlaidLink foi projetado para permitir a operação de vários agentes usando uma única instalação do serviço. Esse sistema de instalação simplificado permite que uma instalação gerencie agentes de vários espaços de trabalho e/ou agentes com diferentes níveis de permissão para a execução de tarefas.
Para habilitar vários agentes, basta adicionar as credenciais dos agentes ao arquivo de configuração do PlaidLink.
Executar vários serviços PlaidLink
Seção intitulada “Executar vários serviços PlaidLink”Assim como é possível executar vários agentes em um único serviço PlaidLink, também é possível executar vários serviços PlaidLink.
Isso às vezes é necessário, dependendo do uso de segurança baseada no sistema ou de restrições de acesso à rede que impedem a comunicação entre limites de rede.
Requisitos de computação, memória e disco
Seção intitulada “Requisitos de computação, memória e disco”O serviço PlaidLink é extremamente leve e precisa apenas de computação e memória mínimas para operar. Ao processar volumes de dados significativos, pode ser necessário aumentar os recursos de computação e, especialmente, a memória.
Normalmente, o agente funciona bem com 5% de CPU e 200 MB de memória. Para operações de dados intensas, recomenda-se alocar uma CPU inteira e pelo menos 4 GB de RAM. Em sistemas de alocação dinâmica de recursos, como o Kubernetes, não há problema se o agente tiver acesso a recursos expansíveis em vez de recursos reservados.
O espaço em disco do agente também é mínimo. As operações do agente usam espaço em disco como buffer de dados ao transferir grandes quantidades de dados. Normalmente, 8 GB de espaço são suficientes para as operações normais. Para operações de dados intensas, recomenda-se aumentar o disco de acordo com os volumes de dados esperados. Não há um valor definido porque ele depende de vários fatores, incluindo velocidade da CPU, velocidade da rede, quantidade de dados etc… No entanto, um bom ponto de partida é 20 GB, ajustando a partir daí.
Requisitos de rede
Seção intitulada “Requisitos de rede”O agente PlaidLink foi projetado para operar com o mínimo de configuração necessária. Ele não exige nenhuma VPN ou configuração de rede especial além de permitir o tráfego de rede HTTPS padrão. Os agentes se comunicam pelo mesmo protocolo do tráfego normal baseado em navegador web.
O serviço do agente sempre inicia a comunicação com o PlaidCloud, portanto não é necessário configurar acesso de entrada nos firewalls.