Agentes PlaidLink

Descrição

Por vezes é necessário e desejável aceder a dados ou executar processos a partir de um sistema remoto que não permite acesso externo. Isto é comum em ambientes empresariais protegidos por firewalls. O PlaidCloud oferece esta capacidade através do PlaidLink, que permite o acesso a sistemas remotos atrás de uma firewall ou em situações em que o acesso direto a partir do PlaidCloud não é pretendido.

O PlaidLink utiliza um sistema baseado em agentes. Isto significa que um agente, o utilizador remoto, é instalado num sistema dentro da firewall ou de outra área restrita. O agente pode então ligar-se ao PlaidCloud através de um processo de iniciação de saída, numa ligação websocket HTTPS segura. É tão seguro como qualquer outra ligação web cifrada e, normalmente, não exige a abertura de portas fora do padrão. Antes de obter acesso, o agente tem de se identificar enviando o respetivo identificador de agente. A partir daí, se o agente concluir com êxito o processo de autenticação, é-lhe concedido acesso às operações aprovadas.

O PlaidLink pode ser instalado em sistemas Windows, Unix e Linux e pode ser executado com utilizadores de privilégios reduzidos. Em sistemas Windows, o PlaidLink pode funcionar como um serviço do Windows, com controlo total a partir do painel de Serviços. Em sistemas Linux ou Unix, pode ser executado como um processo daemon.

O PlaidLink também pode ser executado como um contentor Docker autónomo ou como um pod do Kubernetes.

Gerir agentes

Para gerir agentes:

1. Abra o Analyze
2. Selecione “Tools”
3. Clique em “Agentes PlaidLink”

Isto leva-o à tabela de agentes PlaidLink, onde pode ver e modificar a lista de agentes disponíveis e obter as respetivas credenciais.

Criar um agente

Para criar um agente:

1. Abra o Analyze
2. Selecione “Tools”
3. Clique em “Agentes PlaidLink”
4. Clique em “Add PlaidLink Agent”
5. Preencha os campos obrigatórios
6. Clique em “Create”
7. Atribua o agente aos grupos de segurança necessários para aceder aos recursos de que precisa para realizar o seu trabalho
8. Atribua o agente às contas de documentos necessárias para aceder aos documentos de que precisa para realizar o seu trabalho

Perigo

Nos passos 7 e 8 acima, o agente PlaidLink tem de ser atribuído aos grupos de segurança e às contas de documentos necessários para realizar as tarefas que espera que o agente execute. Caso contrário, ser-lhe-á negado o acesso.

Nota

Qualquer informação que não conste do formulário do novo agente será gerada automaticamente.

Obter as credenciais do agente

Para configurar agentes PlaidLink no sistema remoto, tem primeiro de obter as informações de identificação do agente, de modo a manter a segurança. Estas informações incluem uma chave pública e uma chave privada.

Para obter estas chaves:

1. Abra o Analyze
2. Selecione “Tools”
3. Clique em “Agentes PlaidLink”
4. Clique no ícone de edição

Isto abre um formulário onde pode ver os valores das chaves pública e privada.

Regenerar as credenciais do agente

É boa prática regenerar periodicamente as chaves pública e privada e atualizar a configuração dos sistemas remotos, de modo a manter a segurança.

Para regenerar as credenciais:

1. Abra o Analyze
2. Selecione “Tools”
3. Clique em “Agentes PlaidLink”
4. Clique no ícone de regeneração

Depois de as credenciais serem regeneradas, podem ser obtidas da mesma forma que as credenciais de um novo agente (descrito acima).

Ativar e desativar um agente

Para desativar um agente:

1. Abra o Analyze
2. Selecione “Tools”
3. Clique em “Agentes PlaidLink”
4. Desmarque a caixa de verificação “Active”

Nota

Quando um agente não está marcado como ativo, os sistemas remotos não conseguem ligar-se com as credenciais desse agente

Ambientes dos agentes

Uma ligação pode ter uma configuração diferente por ambiente, pelo que mudar o ambiente de um projeto reaponta de uma só vez todas as ligações que este utiliza. Os agentes podem acompanhar essa mesma mudança.

Cada agente tem duas definições:

• Agent Group: um nome partilhado pelos agentes que se substituem uns aos outros. Os agentes de um grupo são alternativas para o mesmo trabalho, um por ambiente.
• Ambiente: o ambiente de ligação que este agente serve.

Um passo continua a indicar um agente específico. Quando o fluxo de trabalho é executado, o PlaidCloud consulta o grupo a que esse agente pertence e escolhe o membro que serve o ambiente atual do projeto. Assim, um projeto que passe do ambiente predefinido para o QA executa os respetivos passos remotos na máquina de QA, sem editar nenhum passo.

Para um grupo com o nome Finance, com um agente a servir o ambiente Default e outro a servir o QA, um passo que indique qualquer um deles é executado no que corresponder ao projeto. E um projeto que volte ao ambiente Default é executado no agente Default, mesmo que o passo indique o agente de QA.

Para atribuir um agente a um ambiente:

1. Abra o Analyze
2. Selecione “Tools”
3. Clique em “Agentes PlaidLink”
4. Abra o agente
5. Defina “Agent Group” com um nome partilhado com as alternativas do agente e defina “Ambiente” com o ambiente que este agente serve
6. Na máquina que executa esse agente, defina o nome de ambiente correspondente no ficheiro de configuração do PlaidLink; consulte Fazer corresponder a máquina do agente abaixo

Nota

Um agente sem grupo definido serve todos os ambientes, o que se aplica a todos os agentes até definir um. Nada muda numa área de trabalho que execute um único agente.

Cuidado

Definir um grupo torna a correspondência exata para todos os agentes que o integram, incluindo um grupo de um só agente. Um projeto executado num ambiente que nenhum agente do grupo serve falha com uma mensagem que indica o grupo e o ambiente, em vez de recorrer ao agente que o passo indicava. Isto é deliberado: a alternativa seria trabalho de produção a ser executado discretamente numa máquina de teste. Adicione um agente por cada ambiente em que os seus projetos são executados e deixe o grupo em branco num agente que deva continuar a servir tudo.

Retirar um agente de um grupo reduz o que o grupo abrange, pelo que tem tantas consequências como adicionar um. Se limpar o Group no agente que servia o ambiente predefinido, os projetos executados nesse ambiente ficam sem agente a que recorrer e falham na execução seguinte. Mude o ambiente para outro membro do grupo antes de remover um. Cada gravação que altere o que um grupo abrange comunica-lhe a nova cobertura.

Os ambientes são partilhados com as ligações, pelo que os nomes de ambiente aqui oferecidos são os mesmos sob os quais configura uma ligação. Consulte Criar e gerir uma ligação.

Fazer corresponder a máquina do agente

O ambiente que aqui define tem de corresponder ao ambiente para o qual o serviço PlaidLink dessa máquina está configurado. O PlaidLink subscreve uma fila exata para o ambiente indicado no respetivo ficheiro de configuração, pelo que um agente cujo registo indica QA, mas cuja máquina continua configurada para o ambiente predefinido, está a escutar numa fila diferente daquela para a qual o trabalho é enviado. O passo fica à espera e depois falha, indicando que o agente não está a recolher a tarefa.

Defina-o no bloco environments do ficheiro de configuração do PlaidLink, na entrada desse agente:

environments:
  - name: QA
    agent_id: <agent identifier>

O name é o nome do ambiente tal como aparece no PlaidCloud. Quando é omitido, o agente serve o ambiente predefinido. Reinicie o serviço PlaidLink depois de o alterar.

Nota

Um único serviço PlaidLink pode ter várias entradas neste bloco, pelo que uma máquina pode servir mais do que um agente, ou o mesmo agente em mais do que um ambiente. Consulte Executar vários agentes.

Executar vários agentes

O PlaidLink foi concebido para permitir o funcionamento de vários agentes com uma única instalação do serviço. Este sistema de instalação simplificado permite que uma instalação trate agentes de várias áreas de trabalho e/ou agentes com diferentes níveis de permissões para a execução de tarefas.

Para ativar vários agentes, basta adicionar as credenciais dos agentes ao ficheiro de configuração do PlaidLink.

Executar vários serviços PlaidLink

Tal como é possível executar vários agentes num único serviço PlaidLink, também é possível executar vários serviços PlaidLink.

Isto é por vezes necessário, consoante a utilização de segurança baseada no sistema ou de restrições de acesso à rede que impedem a comunicação entre limites de rede.

Nota

Normalmente, é melhor executar vários agentes num único serviço do que vários serviços numa única máquina. No entanto, consoante o caso de utilização, pode ser necessário executar vários serviços distintos.

Requisitos de computação, memória e disco

O serviço PlaidLink é extremamente leve e precisa apenas de um mínimo de computação e memória para funcionar. Ao processar volumes de dados significativos, pode ser necessário aumentar os recursos de computação e, sobretudo, a memória.

Normalmente, o agente funciona sem problemas com 5% de CPU e 200 MB de memória. Para operações de dados intensivas, recomenda-se a atribuição de um CPU completo e de, pelo menos, 4 GB de RAM. Em sistemas de atribuição dinâmica de recursos, como o Kubernetes, não há problema em o agente ter 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 utilizam espaço em disco como memória intermédia de dados na transferência de grandes quantidades de dados. Normalmente, 8 GB de espaço são suficientes para operações normais. Para operações de dados intensivas, recomenda-se que aumente o disco de acordo com os volumes de dados previstos. Não existe um valor fixo, porque depende de vários fatores, incluindo a velocidade do CPU, a velocidade da rede, a quantidade de dados, etc. No entanto, um bom ponto de partida são 20 GB, ajustando a partir daí.

Requisitos de rede

O agente PlaidLink foi concebido para funcionar com o mínimo de configuração necessária. Não requer nenhuma VPN nem configuração de rede especial, para além de permitir tráfego de rede HTTPS padrão. Os agentes comunicam através do mesmo protocolo do tráfego normal baseado em navegador web.

O serviço do agente inicia sempre a comunicação com o PlaidCloud, pelo que não é necessário configurar acesso de entrada nas firewalls.

Nota

Por vezes, as regras da firewall bloqueiam todo o acesso, mesmo o tráfego HTTPS padrão. Se o agente indicar que não consegue contactar o PlaidCloud no arranque, terá de trabalhar com a sua equipa de redes para abrir a porta 443 ao tráfego.