Documentação do Oracle Cloud Infrastructure

Observações sobre o OCI Native Ingress Controller Versão 1.4.0

Saiba mais sobre as alterações na versão 1.4.0 do controlador de entrada nativo do OCI e as etapas preparatórias que talvez você precise executar antes de fazer upgrade para a versão 1.4.0.

O controlador de entrada nativo da OCI versão 1.4.0 apresenta os seguintes novos recursos:

  • Suporte para a preservação de um balanceador de carga para um IngressClass, quando o próprio IngressClass é excluído.
  • Suporte para grupos de segurança de rede.
  • Suporte a tags definidas e de formato livre.

Se você estiver usando versões anteriores do controlador de entrada nativo do OCI, talvez precise executar algumas etapas preparatórias antes de fazer upgrade para a versão 1.4.0 para manter associações existentes de grupo de segurança de rede e tag. Para obter mais informações, consulte:

Como talvez você precise executar algumas etapas preparatórias, a Oracle não atualiza automaticamente o complemento de cluster do controlador de entrada nativo do OCI para a versão 1.4.0, mesmo que você tenha selecionado a opção Atualizações automáticas. Para obter mais informações, consulte Observações sobre a atualização automática do Complemento do Controlador OCI Native Ingress

Observações sobre balanceadores de carga existentes que já foram adicionados a grupos de segurança de rede

A versão 1.4.0 do controlador de entrada nativo do OCI introduz suporte para adicionar balanceadores de carga a grupos de segurança de rede.

Se você tiver adicionado manualmente balanceadores de carga que foram criados por (ou gerenciados por) uma versão do controlador de entrada nativo do OCI anterior à versão 1.4.0 para grupos de segurança de rede, observe que essas associações não serão mantidas quando você fizer upgrade para a versão 1.4.0 ou posterior do controlador de entrada nativo do OCI.

Portanto, antes de fazer upgrade de uma versão anterior do controlador de entrada nativo do OCI, use a anotação oci-native-ingress.oraclecloud.com/network-security-group-ids para especificar os grupos de segurança de rede aos quais você deseja adicionar o balanceador de carga.

Observações sobre balanceadores de carga existentes aos quais as tags já foram aplicadas

A versão 1.4.0 do controlador de entrada nativo do OCI introduz suporte para tags definidas e tags de formato livre em balanceadores de carga.

Se tags definidas ou tags de formato livre já tiverem sido aplicadas a um balanceador de carga criado por (ou gerenciado por) uma versão do controlador de entrada nativo do OCI anterior à versão 1.4.0, observe que essas tags existentes não serão mantidas quando você fizer upgrade para a versão 1.4.0 ou posterior do controlador de entrada nativo do OCI.

Portanto, antes de fazer upgrade de uma versão anterior do controlador de entrada nativo do OCI, use as anotações oci-native-ingress.oraclecloud.com/defined-tags e oci-native-ingress.oraclecloud.com/freeform-tags para especificar valores para tags definidas existentes ou tags de formato livre.

Quando você faz upgrade para a versão 1.4.0, o controlador de entrada nativo do OCI aplica as tags definidas e as tags de formato livre especificadas pelas anotações ao balanceador de carga.

Observe que, para permitir que o controlador de entrada nativo do OCI aplique tags definidas a um balanceador de carga, deve existir uma política de IAM adequada para permitir que o controlador de entrada nativo do OCI use o namespace de tag apropriado.

Para obter mais informações, consulte Aplicando Tags ao Balanceador de Carga.

Observações sobre a atualização automática do Complemento do OCI Native Ingress Controller

A Oracle não atualiza automaticamente o complemento do cluster do controlador de entrada nativo do OCI para a versão 1.4.0, mesmo que você tenha selecionado a opção Atualizações automáticas, porque talvez seja necessário executar algumas etapas preparatórias para manter o grupo de segurança de rede existente e as associações de tags. Para obter mais informações sobre as etapas preparatórias, consulte:

Após executar qualquer etapa preparatória, você deverá atualizar manualmente o complemento de cluster do controlador de entrada nativo do OCI para a versão 1.4.0 usando a Console, a CLI ou a API (consulte Atualizando um Complemento de Cluster). Depois de atualizar manualmente o complemento para a versão 1.4.0, você poderá selecionar a opção Atualizações automáticas se quiser que a Oracle atualize automaticamente o complemento do cluster do controlador de entrada nativo do OCI no futuro.