Como habilitar o High Availability Add-on do Redis para o 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 mais 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. Em bash, você pode fazer isso usando echo 'license_text_here' | 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
         }
     }
     

3. Execute novamente o instalador de malha:

   • Instalação online

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

   • Instalação offline

     ./install-uipath.sh -i cluster_config.json -f --install-type offline -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. Enable kubectl access on the primary node. See Enabling kubectl for instructions.
   2. Enable access to ArgoCD. See Accessing ArgoCD for instructions.

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. To see if the change was applied, access ArgoCD. See Accessing ArgoCD for instructions.

   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.