Documentação do Oracle Cloud Infrastructure

Reiniciando um Pool de Nós do OKE

No Private Cloud Appliance, quando você atualiza um pool de nós, somente os novos nós adicionados durante essa atualização ou adicionados posteriormente recebem as atualizações. Para substituir nós existentes por novos nós que usam definições atualizadas, ative a opção de ciclo de nós.

O ciclo de nós executa uma atualização no local de todos os nós existentes no pool de nós para a configuração especificada mais recente. Novos nós são criados, cargas de trabalho movidas para eles de nós existentes, atualizações atuais do pool de nós aplicadas e os nós originais encerrados.

Você pode definir o número máximo de nós que estão iniciando ou terminando a qualquer momento específico.

  • Crescimento máximo. O número máximo de novos nós que podem ser iniciados a qualquer momento durante esta operação de atualização. Defina esse valor para evitar a adição de muitos nós novos antes que os nós existentes sejam encerrados, o que pode gerar custo excessivo. O valor padrão é 1. O valor máximo é 5.

  • Máximo indisponível. O número máximo de nós existentes que podem ser encerrados a qualquer momento durante esta operação de atualização. Defina esse valor para garantir que permaneçam nós suficientes para lidar com a carga de trabalho. O valor padrão é 0. O valor máximo é 7.

Um desses valores deve ser maior que 0.

Ambos os valores podem ser definidos como um número (de 0 para o número configurado de nós no pool de nós, mas não maior que o máximo citado acima) ou uma porcentagem (de 0% para 100%, mas não uma porcentagem que resultaria em um número maior que o máximo citado acima). Esses valores podem ter no máximo quatro caracteres.

Ambos os valores devem ser um número de nós ou ambos devem ser uma porcentagem. Não é possível especificar um desses valores como um número de nós e o outro como uma porcentagem.

Se você definir uma dessas propriedades como um valor percentual que exceda o número máximo permitido de nós, a mensagem de erro informará o valor percentual máximo permitido para esse pool de nós.

Observação

Se a operação de ciclo do nó falhar (por exemplo, o tempo limite da operação), tente executar a operação novamente. Talvez seja necessário executar a operação de ciclo do nó várias vezes se o sistema estiver carregado e em execução em escala.

  • Siga o procedimento em Atualizando um Pool de Nós do OKE para atualizar a configuração do pool de nós.

    1. Na página de detalhes do pool de nós, selecione o botão Reiniciar Nós.

    2. Na caixa de diálogo Nós do Ciclo, informe valores para as propriedades Aumento Máximo e Indisponibilidade Máxima.

      Veja as regras no início deste tópico.

    3. Selecione o botão Reiniciar Nós na caixa de diálogo para iniciar a operação de atualização do pool de nós.

      Para monitorar o andamento da operação de atualização, exiba o status da solicitação de serviço associada.

  • Use a opção --node-pool-cycling-details do comando oci ce node-pool update para atualizar todos os nós existentes em um pool de nós.

    oci ce node-pool update [OPTIONS]

    Para obter uma lista completa de comandos, flags e opções da CLI, consulte a Referência de Linha de Comandos.

    Procedimento

    1. Construa um comando para atualizar a configuração do pool de nós conforme descrito em Atualizando um Pool de Nós do OKE na guia CLI.

    2. Nesse mesmo comando (não mais recente) inclua a opção --node-pool-cycling-details.

      Além de definir maximumUnavailable e maximumSurge, ative a reinicialização do nó definindo isNodeCyclingEnabled como true. Por padrão, isNodeCyclingEnabled é false e o ciclo do nó não será executado se você definir apenas maximumUnavailable ou maximumSurge e não definir isNodeCyclingEnabled como true.

      $ oci ce node-pool update --node-pool-id ocid1.nodepool.unique_ID \
new_configuration_settings \
--node-pool-cycling-details '{"isNodeCyclingEnabled":true,"maximumUnavailable":"value","maximumSurge":"value"}'

      Consulte o início deste tópico para obter os valores possíveis.

      No exemplo a seguir, a imagem é atualizada para todos os nós no pool de nós:

      $ oci ce node-pool update --node-pool-id ocid1.nodepool.unique_ID \
--node-source-details '{"imageId":"ocid1.image.unique_ID","sourceType":"IMAGE"}' \
--node-pool-cycling-details '{"isNodeCyclingEnabled":true,"maximumUnavailable":"5%","maximumSurge":"5%"}'

      Para monitorar o andamento da operação de atualização, exiba o status da solicitação de serviço associada.

      Localize o OCID da solicitação de serviço:

      oci ce work-request list --compartment-id ocid1.compartment.unique_ID \
--resource-id ocid1.nodepool.unique_ID

      Mostrar o estado atual da solicitação de serviço:

      oci ce work-request get --work-request-id ocid1.workrequest.unique_ID

  • Use a operação UpdateNodePool para atualizar um pool de nós. Para atualizar todos os nós existentes no pool de nós, use os atributos nodePoolCyclingDetails: isNodeCyclingEnabled, maximumSurge e maximumUnavailable.

    Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.