Configuração do High Availability Add-on

Referência para opções de configuração do High Availability Add-on no Automation Suite para implantações no mesmo cluster e em máquinas externas.

O Automation Suite é compatível com o High Availability Add-on (HAA) instalado no mesmo cluster ou em máquinas externas.

Observação:

Você deve configurar o HAA para habilitar a configuração real do HA para a configuração de vários nós. Para fazer isso, você pode fornecer a licença do HAA ao instalador ou instalar o HAA nas máquinas externas e fornecer as configurações do HAA ao instalador.

Configuração do High Availability Add-on do Redis no cluster

Em uma configuração de produção pronta para HA de vários nós, a Alta Disponibilidade (HA) é habilitada por padrão. No entanto, o cache na memória baseado em Redis usado pelos serviços de cluster é executado em um único nó e representa um único ponto de falha. Portanto, se você não tiver comprado uma licença do High Availability Add-on (HAA), uma falha ou reinicialização do nó de cache resultará em tempo de inatividade para todo o cluster.

Para evitar esse incidente, você pode comprar o HAA, que permite a implantação de produção redundante e pronta para alta disponibilidade de vários nós do cache.

Observação:

Todas as instalações incluem o software HAA com licença de nó único. Essa licença é gratuita, sem necessidade de compra.

Se você deseja habilitar o HAA em vários nós, é necessário adquirir uma licença do HAA. Isso implementará alta disponibilidade total para o cluster em uma configuração de produção pronta para alta disponibilidade de vários nós.

O HAA é baseado na tecnologia Redis.

Para isso, siga as seguintes etapas:

1. Compre uma licença do HAA. Entre em contato com a UiPath® para obter detalhes.
2. Atualize os seguintes campos no arquivo cluster_config.json:
   • fabric.redis.license – insira a licença do HAA convertida em uma única string base64. Você precisa codificar toda a chave de licença para base64, incluindo o texto -----LICENSE START----- and -----LICENSE END-----. No bash, você pode fazer isso usando o seguinte comando:

     echo '-----LICENSE START-----<license_key_here>-----LICENSE END-----' | base64 -w0
     

   • fabric.redis.ha – use true para habilitar o HAA e lembre-se de configurar o parâmetro fabric.redis.license. Isso permite a replicação do banco de dados do HAA e aumenta a quantidade de pods do HAA para três. Por padrão, fabric.redis.ha é definido como false.
     Observação:

     Se redis.ha estiver habilitado, redis.license precisa ser definido para uma licença que aceite mais de dois shards.

     "fabric": {
         "redis": { 
             "ha": "true",
             "license": "Base64String" // Replace Base64String with the encoded full license string.
         }
     }
     

3. Execute novamente o instalador de malha:

   ./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement
   

Atualizando a licença do Redis

Para atualizar a licença do Redis, execute as seguintes etapas:

1. Configure o acesso kubectl e ArgoCD:

   1. Habilite o acesso do kubectl no nó primário. Consulte Habilitação do kubectl para obter instruções.
   2. Habilite o acesso ao ArgoCD. Consulte Acesso ao ArgoCD para obter instruções.

2. Verifique o status atual da licença:

   Para verificar o status da licença atual, execute o seguinte comando do Shell:

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
   

   • Os clusters implantados após a data de expiração da licença incluída no instalador mostrarão a licença de teste de 4 estilhaços que expira em 30 dias, conforme o exemplo a seguir:

   

   • Os clusters que já estavam em execução quando a licença expirou mostrarão o seguinte status:

   

3. Atualize a licença existente:

   1. Para atualizar a licença existente, execute o seguinte comando do Shell:

      kubectl patch application fabric-installer -n argocd \
      --type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]'
      

      

   2. Para verificar se a alteração foi aplicada, acesse o ArgoCD. Consulte Acesso ao ArgoCD para obter instruções.

   3. Se o instalador do Fabric for exibido fora de sincronia e o processo não foi acionado automaticamente, selecione o botão Sincronizar por conta própria. Isso pode acontecer se você estiver usando uma versão mais antiga do Automation Suite.

      

      

      

      Observação:

      Há um pequeno atraso entre o momento em que a interface gráfica do ArgoCD mostra o aplicativo sincronizado e quando o operador Redis aplica com êxito a nova licença.

   4. Para ver os logs do operador Redis ao tentar aplicar a licença, execute o seguinte comando:

      kubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep license
      

      

   5. Se você tentar aplicar uma licença expirada ou executar o instalador que vem com uma licença expirada, obterá o seguinte resultado:

      

   6. Para atualizar a licença do Redis usada por instaladores mais antigos antes de executá-los, atualize a chave fabric.redis.license no <installer_folder>/defaults.json:

      

4. Verifique se a nova licença foi aplicada:

   Para verificar se a nova licença foi aplicada, execute o seguinte comando do Shell:

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq
   

   Na imagem a seguir, você pode verificar que o cluster Redis alterou a licença de avaliação de 30 dias para uma licença de 10 anos de shard único.

   

Configuração do High Availability Add-on externo

Ao optar por uma configuração Ativo/Ativo do Automation Suite, um High Availability Add-on hospedado em cluster externo é obrigatório. Em todas as outras situações, é meramente opcional.

Para configurar o High Availability Add-on, você deve atualizar os seguintes parâmetros no arquivo cluster_config.json :

Parâmetro	Description
fabric.redis.hostname	Forneça o FQDN do servidor do High Availability Add-on (HAA).
fabric.redis.password	Forneça a senha para conectar-se ao servidor HAA.
fabric.redis.port	Forneça a porta para o servidor do HAA.
fabric.redis.tls	Habilite o protocolo TLS. Por padrão, o TLS está habilitado. Se um certificado for necessário quando o TLS estiver habilitado, certifique-se de fornecê-lo por meio do additional_ca_certs sinalizador. Para obter detalhes, consulte Configuração do certificado.

"fabric": {
  "redis": {
    "hostname": "redis_fqdn",
    "password": "credential_to_connect_redis",
    "port": 6380,
    "tls": true,
  }
}