Documentação do Oracle Cloud Infrastructure

Nó Ciclando um Pool de Nós do OKE

No Compute Cloud@Customer, quando você atualiza um pool de nós, somente 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 configuraçõ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 a partir 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 encerrando a qualquer momento específico.

  • Superfície máxima. 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 novos nós antes que os nós existentes sejam encerrados, o que pode incorrer em 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 restem 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 ao 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% a 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 de 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 Máximo de Aumento e Máximo Indisponível.

      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 o comando oci ce node-pool update e os parâmetros necessários para atualizar 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 Comando.

    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 tarde) inclua a opção --node-pool-cycling-details.

      Além de definir maximumUnavailable e maximumSurge, ative o ciclo do nó definindo isNodeCyclingEnabled como true. Por padrão, isNodeCyclingEnabled é false e o ciclo de nós não é executado, independentemente da definição de outras variáveis de ciclo de nós.

      $ 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 ver os valores possíveis.

      No exemplo a seguir, a imagem é atualizada para todos os nós do 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.

    Se você fizer alterações que adicionem novos nós de trabalho, considere suas próximas etapas:

    1. Configure os registros ou repositórios necessários aos nós de trabalho. Certifique-se de ter acesso a um registro de contêiner de intranet ou público autogerenciado para usar com o serviço OKE e as imagens do aplicativo.

    2. Crie um serviço para expor aplicativos conteinerizados fora do Compute Cloud@Customer. Consulte Exposição de Aplicativos Contêinerizados.

    3. Crie armazenamento persistente para os aplicativos usarem. Consulte Adicionando Armazenamento para Aplicativos Contêinerizados.

    Para alterar as propriedades dos nós existentes, você pode criar um novo pool de nós com as novas definições e mover o trabalho para os novos nós.

    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.