Container Service for Kubernetes:Upgrade the NGINX Ingress Controller

Processo de atualização

O NGINX Ingress Controller é um add-on crítico no plano de dados e possui altos requisitos de estabilidade.

A nova versão pode conter diversas alterações personalizadas no NGINX Ingress Controller, e uma grande diferença entre versões pode causar incompatibilidades de configuração. Essas incompatibilidades podem não aparecer imediatamente após a atualização. Portanto, atualizar o add-on para a versão mais recente em uma única etapa é arriscado.

Para garantir que o add-on e sua carga de trabalho funcionem conforme o esperado após a atualização do NGINX Ingress Controller, o processo ocorre em fases. Durante a atualização, verifique o status da carga de trabalho e faça rollback se ocorrer algum problema.

Part 1: Precheck

The precheck runs automatically before the add-on upgrade starts to verify that the current add-on status meets the upgrade requirements. If the add-on has settings that do not meet the requirements or is unhealthy, it cannot pass the precheck. You cannot continue the upgrade until you manually resolve the issues.

Part 2: Verification phase

The verification phase scales out one Pod that runs the new add-on version to verify the status of the new version and confirm that the Ingress rules work as expected. After the Pod scales out successfully, some traffic is sent to it. Then check for traffic anomalies by using container logs, Simple Log Service (SLS), or Managed Service for Prometheus monitoring.

After the verification Pod scales out successfully, the upgrade pauses. After you confirm that the add-on and your workload have no issues, manually confirm that the upgrade can continue to the next phase. If an issue occurs, you can roll back to delete the new-version Pod and terminate the upgrade.

This step is implemented by modifying the spec.minReadySeconds and spec.strategy fields in the Deployment.

Part 3: Release phase

The release phase runs a complete rolling upgrade that replaces the old add-on version with the new version. After all Pods are updated, the upgrade pauses so that you can perform a final check on the add-on and your workload. After you confirm that there are no issues, the upgrade ends. If an issue occurs, you can roll back to reset all Pods to the old version and end the upgrade.

Part 4: Rollback (optional)

If the add-on or your workload becomes abnormal while the upgrade is paused after the verification phase or the release phase, you can roll back. Rollback restores the add-on to its initial pre-upgrade state.

Antes de começar

• O NGINX Ingress Controller não mantém mais as versões v1.2 e anteriores. Para obter mais informações, consulte . Versões desatualizadas do add-on não conseguem usar os recursos e correções suportados pelas versões mais recentes, não recebem suporte técnico oportuno e enfrentam o risco de vulnerabilidades de segurança sem correção. .

• Antes de atualizar o add-on, certifique-se de ter uma forma de monitorar o tráfego de service para identificar problemas precocemente. Use o Simple Log Service (SLS) ou o Managed Service for Prometheus para verificar o tráfego de service. Para instruções de configuração desses dois métodos de observação, consulte e .

  [Product Announcement] Announcement on End of Maintenance for Nginx Ingress Controller v1.2 and EarlierUpgrade the add-onAnalyze and monitor the access log of nginx-ingress-controllerConfigure Managed Service for PrometheusPrecheck detailsPath matching logic changes--/@li-->

• Confirme se o add-on está íntegro, se todos os Pods estão Ready e se não existem logs de erro.

• Verifique se nenhuma regra de dimensionamento automático, como Horizontal Pod Autoscaler (HPA), está em uso. Caso exista alguma, exclua-a antes da atualização e restaure-a após a conclusão do processo. Para entender o impacto de excluir um resource HPA, consulte .

• Confirme se o Service LoadBalancer do NGINX Ingress Controller está íntegro (o nome padrão é nginx-ingress-lb) e se nenhum evento anormal foi relatado.

  NGINX Ingress controller

• Não modifique o add-on nem as regras de Ingress durante a atualização.