Configuração da pós-instalação do FQDN

Referência para atualizar a pós-instalação do FQDN do Automation Suite por meio do cluster_config.json e uipathctl.

Para atualizar o FQDN do Automation Suite, você deve atualizar o arquivo cluster_config.json e executar o instalador uipathctl .

O processo de atualização do FQDN é aplicável ao modo de avaliação de nó único e ao modo de produção pronto para alta disponibilidade de vários nós.

Observação:

A alteração do FQDN requer novos certificados de servidor. Se um novo certificado não estiver disponível, você tem duas opções: continuar com o novo certificado autoassinado configurado automaticamente pelo instalador, ou parar a instalação e trazer um novo certificado emitido por CA.

Você pode configurar o certificado usando o campo server_certificate no arquivo cluster_config.json .

Atualização do arquivo de configuração com o novo valor do FQDN

Observação:

Somente letras minúsculas são compatíveis com FQDNs. Não use caracteres maiúsculos em seu FQDN.

Você deve atualizar os seguintes parâmetros no arquivo input.json.Qualquer combinação desses valores é permitida, dependendo de seus requisitos.

• fqdn — atualize esse campo com o novo FQDN de que você precisa para acessar o cluster.
• fixed_rke_address - se esse valor for idêntico ao campo fqdn em cluster_config.json, você deve garantir que os dois valores correspondam para refletir o novo FQDN. No caso de configuração Ativa/Passiva ou Ativa/Ativa, esse valor deve corresponder a cluster_fqdn.
• cluster_fqdn - atualize esse campo para o cluster Ativo/Passivo ou Ativo/Ativo.
  Observação:

  A atualização do cluster_fqdn é necessária quando você altera as configurações de DNS no nível do balanceador de carga para qualquer um dos clusters

O seguinte exemplo mostra a configuração cluster_config.json necessária para atualizar o FQDN.

{
  "fqdn": "new-automationsuite.mycompany.com" //this is the fqdn for accessing the automation suite cluster
  "fixed_rke2_address": "new-automationsuite.mycompany.com,"//this is only required for the node joining, if customer wish to change "cluster_fqdn": "new-primary-automationsuite.mycompany.com" //this is only required for the a/p or a/a cluster
}

Etapa 1: atualizar o FQDN no nível da infraestrutura

Para atualizar o FQDN na camada de infraestrutura, execute o instalador apenas na primeira máquina de servidor. Isso atualizará todos os outros nós no cluster, incluindo os restantes nós de servidor, nós de agentes e nós de agente especializados.

Para atualizar o FQDN, execute o seguinte comando:

./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions/helm-charts.json

Observação:

Se você executar o comando com o sinalizador --force , ele substituirá os prompts de aviso e executará as alterações do FQDN diretamente.

O instalador adverte você sobre as consequências de atualizar o FQDN. Ele pede confirmação antes de prosseguir.

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        
        If you wish to continue type 'yes' and hit enter to continue.

Etapa 2: habilitar o modo de manutenção

Antes de disparar a atualização do FQDN no nível de componentes e serviços, você deve habilitar o modo de manutenção. Isso encerra o controlador de ingresso e todos os serviços da UiPath®, bloqueando todo o tráfego de entrada para o cluster do Automation Suite.

Para colocar o cluster no modo de manutenção, execute:

./bin/uipathctl cluster maintenance enable

Para verificar se o cluster está no modo de manutenção, execute:

./bin/uipathctl cluster maintenance is-enabled

Etapa 3: atualizar o FQDN no nível de componentes e serviços

Para atualizar o FQDN, execute o seguinte comando:

./bin/uipathctl manifest apply /path/to/cluster_config.json --versions versions/helm-charts.json

Observação:

Se você executar o comando com o sinalizador --force , ele substituirá os prompts de aviso e executará as alterações do FQDN diretamente.

O instalador adverte você sobre as consequências de atualizar o FQDN. Ele pede confirmação antes de prosseguir.

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        If you wish to continue type 'yes' and hit enter to continue.

O instalador também adverte você se não houver um novo certificado válido relacionado ao FQDN. Se a validação de certificado falhar, o instalador requer que você forneça o novo certificado emitido por CA ou continue com o novo certificado autoassinado.

************************************************************************************
[ERROR] Validating certificate... Failed
[ERROR] Certificate doesn't have new-automationsuite.mycompany.com in the SAN
************************************************************************************

Certificate provided is invalid for the new fqdn, would you like us to configure the new self signed certificate?
If you wish to continue type `yes` and hit enter to continue.

Observação:

Certifique-se de limpar todos os dados do seu banco de dados do Redis. Você pode fazer isso executando o comando FLUSHALL.

Etapa 4: desabilitar o modo de manutenção

Após atualizar o FQDN, desabilite o modo de manutenção para restaurar o tráfego para o cluster do Automation Suite.

Para desabilitar o modo de manutenção, execute:

./bin/uipathctl cluster maintenance disable

Para obter detalhes, consulte uipathctl cluster disable.

Atualizando o FQDN em uma implantação Ativo/Ativo

Se você alterar o FQDN do cluster primário em uma configuração Ativo/Ativo, será necessário seguir as seguintes etapas adicionais:

1. Habilite o modo de manutenção no cluster primário:

   ./bin/uipathctl cluster maintenance enable
   

2. Gere um novo kubeconfig para o cluster primário.

3. Adicione o novo kubeconfig no cluster_config.json do cluster secundário, em other_kube_config.

4. No cluster secundário, execute o seguinte comando:

   uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
   

5. Desabilite o modo de manutenção no cluster primário:

   ./bin/uipathctl cluster maintenance disable
   

   Para obter detalhes, consulte uipathctl cluster disable.