Partilhar via


Notas de versão do mecanismo AKS no Azure Stack Hub

Aplica-se à versão v0.80.2 do motor AKS.

Este artigo descreve o conteúdo do mecanismo do Serviço Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui melhorias e correções para a versão mais recente do mecanismo AKS direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo AKS para o Azure global.

Considerações sobre atualização

  • Você está usando os itens corretos do mercado, AKS Base Ubuntu 20.04 Image Distro ou AKS Base Windows Server para sua versão do mecanismo AKS? Você pode encontrar as versões na seção Download de novas imagens e motor AKS.
  • Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Deploy a Kubernetes cluster.
  • Você está usando uma máquina confiável para executar o mecanismo AKS e a partir do qual você está executando operações de atualização?
  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
  • Certifique-se de que a sua subscrição tem quota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas planeje que mais algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas são planejadas.
  • Configure uma atualização em estágios em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização antes de fazê-lo em seu cluster de produção.

Use o comando upgrade

Você deve usar o aks-engine upgrade comando conforme descrito em Atualizar um cluster Kubernetes no Azure Stack Hub.

Interrupções de atualização

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo AKS relata um erro ou algo acontece com o processo de execução do mecanismo AKS. Examine a causa da interrupção, resolva-a e reenvie o mesmo upgrade comando para continuar o processo de atualização. O upgrade comando é idempotente e deve retomar a atualização do cluster assim que você reenviar o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar sua conclusão.

Tempo estimado de atualização

O tempo estimado de atualização é de 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar cerca de 5 horas para ser atualizado.

Instruções de utilização do motor AKS 0.70.0 e superior

Download de nova imagem e motor AKS

Faça o download das novas versões da imagem base do AKS Ubuntu e do motor AKS.

Conforme explicado na documentação do mecanismo AKS para o Azure Stack Hub, a implantação de um cluster Kubernetes requer:

  • O binário aks-engine (obrigatório).
  • AKS Base Ubuntu 16.04-LTS Image Distro (preterido - não uso mais, mudança no modelo de API para usar 20.04 em vez disso).
  • AKS Base Ubuntu 18.04-LTS Image Distro (preterido - não uso mais, mudança no modelo de API para usar 20.04 em vez disso).
  • AKS Base Ubuntu 20.04-LTS Image Distro (necessário para agentes Linux).
  • AKS Base Windows Server Image (uma das seguintes imagens é necessária para agentes Windows):
    • AKS Base Windows Server Imagem em contêiner.
    • AKS Base Windows Server Image Docker.

Novas versões destas imagens estão disponíveis com esta atualização:

Atualizando clusters Kubernetes criados com a distro Ubuntu 16.04

Começando com AKS Engine v0.63.0, a distro Ubuntu 16.04 não é mais uma opção suportada, pois o sistema operacional chegou ao fim de sua vida útil. Para AKS Engine v0.67.0 ou versões posteriores, a atualização aks-engine substitui automaticamente o valor de distribuição não suportado aks-ubuntu-16.04 por com aks-ubuntu-18.04. Para AKS Engine v0.75.3 ou versões posteriores, se você estiver usando o Kubernetes v1.24 ou superior, a atualização aks-engine-azurestack substituirá automaticamente o valor de distribuição não suportado aks-ubuntu-16.04 pelo aks-ubuntu-20.04.

Atualizando clusters Kubernetes criados com a distro Ubuntu 18.04

Começando com AKS Engine v0.75.3, a distro Ubuntu 18.04 não é mais uma opção suportada, pois o sistema operacional chegou ao fim de sua vida útil. Para AKS Engine v0.75.3 ou versões posteriores, a atualização aks-engine-azurestack substitui automaticamente o valor de distribuição não suportado aks-ubuntu-18.04 por aks-ubuntu-20.04.

Atualizar clusters do Kubernetes criados com o runtime do contentor docker

No Kubernetes v1.24, o componente dockershim foi removido do kubelet. Como resultado, o tempo de execução do contêiner do docker não é mais uma opção suportada. Consulte as notas de versão do Kubernetes v1.24 para obter mais informações. Para AKS Engine v0.75.3 ou versões posteriores, a atualização aks-engine-azurestack substitui automaticamente o valor não suportado docker containerRuntime por containerd.

Para a versão v0.75.3 do AKS Engine, clusters com nós do Windows no Kubernetes v1.23 podem usar a imagem base do Windows com o tempo de execução do Docker. Clusters com nós do Windows no Kubernetes v1.24 podem usar a imagem base do Windows com o tempo de execução Containerd.

Mecanismo AKS e mapeamento de versão do Azure Stack

Versão do Azure Stack Hub Versão do motor AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0*, 0.80.2*
2311 0.80.2*

Nota

*Suportado. Consulte a política de Suporte à Versão do Motor AKS para obter mais informações.

Motor AKS e mapeamento de imagem correspondente

Você pode encontrar as versões do Kubernetes suportadas para o AKS Engine no Azure Stack Hub na tabela a seguir. Não use o comando aks-engine get-versions , que retorna versões com suporte no Azure global, bem como no Azure Stack Hub.

Motor AKS Imagem de base do AKS Versões do Kubernetes Exemplos de modelo de API
v0.43.1 Distribuição de Imagens de Base do AKS Ubuntu 16.04-LTS, outubro de 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Distribuição de Imagens de Base do AKS Ubuntu 16.04-LTS, março de 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maio de 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Janelas
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, agosto de 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Janelas
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, setembro de 2020 (2020.09.14), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Janelas
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, janeiro de 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Imagem de Base do AKS Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Janelas
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Exemplos de modelo de API (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 Exemplos de modelo de API (Linux, Windows)
v0.67.3 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 Exemplos de modelo de API (Linux, Windows)
v0.70.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q2 (2022.04.07), AKS Base Windows Image (17763.2565.220408) 1.21.10*, 1.22.7* Exemplos de modelo de API (Linux, Windows)
v0.71.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q3 (2022.08.12), AKS Base Windows Image (17763.3232.220805) 1.22.7*, 1.23.6* Exemplos de modelo de API (Linux, Windows)
v0.73.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q4 (2022.11.02), AKS Base Windows Image (17763.3532.221102) 1.22.15*, 1.23.13* Exemplos de modelo de API (Linux, Windows)
v0.75.3 AKS Base Ubuntu 20.04-LTS Image Distro (2023.032.2), AKS Base Windows Server 2019 Image Docker (17763.3887.20230332), AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) 1.23.15*, 1.24.9** Exemplos de modelo de API (Linux, Windows)
v0.76.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.116.3), AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) 1.24.11**, 1.25.7** Exemplos de modelo de API (Linux, Windows)
v0.77.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.206.1), AKS Base Windows Server 2019 Image Containerd (17763.4645.20232061) 1.25.7**, 1.26.6** Exemplos de modelo de API (Linux, Windows)
v0.78.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.242.3), AKS Base Windows Server 2019 Image Containerd (17763.4737.20232423) 1.25.13**, 1.26.8** Exemplos de modelo de API (Linux, Windows)
v0.79.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.296.1), AKS Base Windows Server 2019 Image Containerd (17763.4974.20232961) 1.26.9**, 1.27.6** Exemplos de modelo de API (Linux, Windows)
v0.80.2 AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1), AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321) 1.27.10**, 1.28.6** Exemplos de modelo de API (Linux, Windows)

Nota

*A partir do Kubernetes v1.21, apenas o Cloud Provider for Azure tem suporte no Azure Stack Hub.

Nota

** A partir do Kubernetes v1.24, apenas o tempo de execução do containerd contêiner é suportado. Consulte a seção Atualizando clusters Kubernetes criados com o tempo de execução do contêiner docker para obter mais informações.

Planejamento de atualizações

O comando AKS engine upgrade automatiza totalmente o processo de atualização do cluster e lida com máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de revisar as informações da nota de versão.

O que há de novo no AKSe 0.76.0

  • Adicionado suporte para Kubernetes v1.24.11 e v1.25.7.
  • Você pode encontrar outros recursos na página do GitHub v0.76.0.

O que há de novo no AKSe 0.75.3 e superior

A versão v0.75.3 do AKS Engine e todas as versões futuras do AKS Engine no Azure Stack Hub serão do novo repositório aks-engine-azurestack. Como tal, todos os aks-engine comandos devem ser substituídos por aks-engine-azurestack. Os comandos para obter a versão mais recente do AKS Engine no Azure Stack Hub também foram alterados. Você pode ver os novos comandos em Criar cliente Linux e Criar cliente Windows. Crie um problema no novo repositório se encontrar algum problema.

A versão v0.75.3 do AKS Engine no Azure Stack Hub oferece o Ubuntu 20.04 LTS como sua imagem base do Linux. A partir desta versão, o Ubuntu 18.04 não é mais suportado. Consulte Atualizando clusters Kubernetes criados com a Distro do Ubuntu 18.04 para obter mais informações.

A partir do Kubernetes v1.24, apenas o containerd tempo de execução é suportado. Consulte Atualizando clusters Kubernetes criados com o tempo de execução do docker para obter mais informações. Para a versão v0.75.3 do AKS Engine, clusters com nós do Windows no Kubernetes v1.23 podem usar a imagem base do Windows com o tempo de execução do Docker. Clusters com nós do Windows no Kubernetes v1.24 podem usar a imagem base do Windows com tempo de execução em contêiner.

Você pode encontrar mais recursos na página do GitHub v0.75.3.

Instruções de utilização do motor AKS 0.70.0 e superior

A Microsoft atualizou o Azure Cloud Provider na versão 0.70.0. O Provedor de Nuvem do Azure é um componente principal compartilhado entre o AKS Azure e o mecanismo AKS no Azure Stack Hub.

Para usar o motor AKS 0.70.0 e superior:

  • Se você estiver tentando criar um novo cluster Kubernetes pela primeira vez: use o modelo de API de exemplo fornecido para a versão apropriada no mecanismo AKS e na tabela de mapeamento de imagem correspondente.

  • Se você estiver criando um novo cluster, mas quiser usar seu modelo de API existente: modifique seu modelo de API seguindo as instruções do Provedor de Nuvem para Azure . A falha ao incluir a nova configuração resulta em um erro de implantação.

  • Se estiver a utilizar volumes de armazenamento: certifique-se de que está a utilizar o controlador AzureDiskCSI . A versão 0.70.0 e superior suportam apenas drivers CSI, não o provedor de armazenamento em árvore herdado. Para atualizar, siga as instruções em atualização ao usar volumes de armazenamento.

Problemas conhecidos

  • Implantar vários serviços Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos implantar um serviço de cada vez.
  • Como a ferramenta aks-engine é um repositório de código-fonte compartilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e solicitações pull pode levar você a acreditar que a ferramenta oferece suporte a outras versões do Kubernetes e da plataforma do sistema operacional além das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.
  • O AKS Engine v0.67.0 usa a imagem errada do Windows ao implantar clusters do Windows. Use v0.70.0 para resolver esse problema.

Referência

A lista a seguir é o conjunto completo de notas de versão do Azure e do Azure Stack Hub combinados:

Aplica-se à versão v0.67.0 do motor AKS.

Este artigo descreve o conteúdo do mecanismo do Serviço Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui melhorias e correções para a versão mais recente do mecanismo AKS direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo AKS para o Azure global.

Planejamento de atualizações

O comando AKS engine upgrade automatiza totalmente o processo de atualização do seu cluster. Ele lida com máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de revisar as informações da nota de versão.

Considerações sobre atualização

  • Você está usando os itens de mercado corretos, AKS Base Ubuntu 16.04-LTS ou 18.04 Image Distro ou AKS Base Windows Server para sua versão do mecanismo AKS? Você pode encontrar as versões na seção "Download de novas imagens e motor AKS".
  • Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Deploy a Kubernetes cluster.
  • Você está usando uma máquina confiável para executar o mecanismo AKS e a partir da qual você está executando operações de atualização?
  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
  • Certifique-se de que a sua subscrição tem quota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas planeje que mais algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas são planejadas.
  • Configure uma atualização em estágios em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização antes de fazê-lo em seu cluster de produção.

Use o comando upgrade

Você deve usar o aks-engine upgrade comando conforme descrito em Atualizar um cluster Kubernetes no Azure Stack Hub.

Interrupções de atualização

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo AKS relata um erro ou algo acontece com o processo de execução do mecanismo AKS. Examine a causa da interrupção, resolva-a e reenvie o mesmo upgrade comando para continuar o processo de atualização. O upgrade comando é idempotente e deve retomar a atualização do cluster assim que você reenviar o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar sua conclusão.

Tempo estimado de atualização

O tempo estimado de atualização é de 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar cerca de 5 horas para ser atualizado.

Download de nova imagem e motor AKS

Faça o download das novas versões da imagem base do AKS Ubuntu e do motor AKS.

Conforme explicado na documentação do mecanismo AKS para o Azure Stack Hub, a implantação de um cluster Kubernetes requer:

  • O binário aks-engine (obrigatório).
  • AKS Base Ubuntu 16.04-LTS Image Distro (preterido - não uso mais, mudança no modelo de API para usar 18.04 em vez disso).
  • AKS Base Ubuntu 18.04-LTS Image Distro (necessário para agentes Linux).
  • AKS Base Windows Server Image Distro (necessário para agentes Windows).

Novas versões destas imagens estão disponíveis com esta atualização:

Atualizando clusters Kubernetes criados com a distro Ubuntu 16.04

Começando com AKS Engine v0.67.0, a distro Ubuntu 16.04 não é mais uma opção suportada, pois o sistema operacional chegou ao fim de sua vida útil. Para atualizar um cluster, certifique-se de definir a distro do sistema operacional como aks-ubuntu-18.04 no seu modelo de API de entrada, aquela gerada e aks-engine deploy passada como entrada para aks-engine upgrade:

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

Mecanismo AKS e mapeamento de versão do Azure Stack

Versão do Azure Stack Hub Versão do motor AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0
2108 0.63.0, 0.67.0

Caminho de atualização da versão do Kubernetes no mecanismo AKS v0.67.0

Você pode encontrar a versão atual e a versão de atualização para o Azure Stack Hub na tabela a seguir. Esta tabela aplica-se ao cluster do motor AKS no Azure Stack Hub. Não use o comando aks-engine get-versions , que retorna versões com suporte no Azure global, bem como no Azure Stack Hub.

Versão atual Atualização disponível
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11, 1.17.17 1.18.18
1.18.15, 1.18.18 1.19.10
1.19.10 1.19.15, 1.20.11
1.20.6 1.20.11

No arquivo JSON do modelo de API, especifique os valores de versão e versão na orchestratorProfile seção . Por exemplo, se você estiver planejando implantar o Kubernetes 1.17.17, os dois valores a seguir devem ser definidos (consulte o exemplo kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Motor AKS e mapeamento de imagem correspondente

Motor AKS Imagem de base do AKS Versões do Kubernetes Exemplos de modelo de API
v0.43.1 Distribuição de Imagens de Base do AKS Ubuntu 16.04-LTS, outubro de 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Distribuição de Imagens de Base do AKS Ubuntu 16.04-LTS, março de 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maio de 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Janelas
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, agosto de 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Janelas
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, setembro de 2020 (2020.09.14), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Janelas
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, janeiro de 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Imagem de Base do AKS Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Janelas
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Exemplos de modelo de API (Linux, Windows)
v0.67.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 Exemplos de modelo de API (Linux, Windows)

Novidades

Se estiver interessado em participar numa pré-visualização privada, pode solicitar acesso à pré-visualização.

As novas funcionalidades incluem:

  • Suporte para Kubernetes 1.19.15 e 1.20.11

Problemas conhecidos

  • Implantar vários serviços Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos implantar um serviço de cada vez.
  • Como a ferramenta aks-engine é um repositório de código-fonte compartilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e solicitações pull pode levar você a acreditar que a ferramenta oferece suporte a outras versões do Kubernetes e da plataforma do sistema operacional além das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

A lista a seguir é o conjunto completo de notas de versão do Azure e do Azure Stack Hub combinados:

Aplica-se à versão v0.60.1 do motor AKS.

Este artigo descreve o conteúdo do mecanismo do Serviço Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui melhorias e correções para a versão mais recente do mecanismo AKS direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo AKS para o Azure global.

Planejamento de atualizações

O comando AKS engine upgrade automatiza totalmente o processo de atualização do cluster e lida com máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de revisar as informações da nota de versão.

Considerações sobre atualização

  • Você está usando os itens de mercado corretos, AKS Base Ubuntu 16.04-LTS ou 18.04 Image Distro ou AKS Base Windows Server para sua versão do mecanismo AKS? Você pode encontrar as versões na seção "Download de novas imagens e motor AKS".
  • Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Deploy a Kubernetes cluster.
  • Você está usando uma máquina confiável para executar o mecanismo AKS e a partir da qual você está executando operações de atualização?
  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
  • Certifique-se de que a sua subscrição tem quota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas planeje que mais algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas são planejadas.
  • Configure uma atualização em estágios em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização antes de fazê-lo em seu cluster de produção.

Use o comando upgrade

Você deve usar o aks-engine upgrade comando conforme descrito em Atualizar um cluster Kubernetes no Azure Stack Hub.

Interrupções de atualização

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo AKS relata um erro ou algo acontece com o processo de execução do mecanismo AKS. Examine a causa da interrupção, resolva-a e reenvie o mesmo upgrade comando para continuar o processo de atualização. O upgrade comando é idempotente e deve retomar a atualização do cluster assim que você reenviar o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar sua conclusão.

Tempo estimado de atualização

O tempo estimado de atualização é de 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar cerca de 5 horas para ser atualizado.

Download de nova imagem e motor AKS

Faça o download das novas versões da imagem base do AKS Ubuntu e do motor AKS.

Conforme explicado na documentação do mecanismo AKS no Azure Stack Hub, a implantação de um cluster Kubernetes requer:

  • O binário aks-engine (obrigatório).
  • AKS Base Ubuntu 16.04-LTS Image Distro (preterido - não uso mais, mudança no modelo de API para usar 18.04 em vez disso).
  • AKS Base Ubuntu 18.04-LTS Image Distro (necessário para agentes Linux).
  • AKS Base Windows Server Image Distro (necessário para agentes Windows).

Novas versões destes estão disponíveis com esta atualização:

Mecanismo AKS e mapeamento de versão do Azure Stack

Versão do Azure Stack Hub Versão do motor AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1

Caminho de atualização da versão do Kubernetes no mecanismo AKS v0.60.1

Você pode encontrar a versão atual e a versão de atualização para o Azure Stack Hub na tabela a seguir. Esta tabela aplica-se ao cluster do motor AKS no Azure Stack Hub. Não use o comando aks-engine get-versions , que retorna versões com suporte no Azure global, bem como no Azure Stack Hub.

Versão atual Atualização disponível
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11 1.17.17, 1.18.15
1.17.17 1.18.15

No arquivo JSON do modelo de API, especifique os valores de versão e versão na orchestratorProfile seção . Por exemplo, se você estiver planejando implantar o Kubernetes 1.17.17, os dois valores a seguir devem ser definidos (consulte o exemplo kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Motor AKS e mapeamento de imagem correspondente

Motor AKS Imagem de base do AKS Versões do Kubernetes Exemplos de modelo de API
v0.43.1 Distribuição de Imagens de Base do AKS Ubuntu 16.04-LTS, outubro de 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Distribuição de Imagens de Base do AKS Ubuntu 16.04-LTS, março de 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 AKS Base Ubuntu 16.04-LTS Image Distro, maio de 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Janelas
v0.55.0 AKS Base Ubuntu 16.04-LTS Image Distro, agosto de 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Janelas
v0.55.4 AKS Base Ubuntu 16.04-LTS Image Distro, setembro de 2020 (2020.09.14), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Janelas
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, janeiro de 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Imagem de Base do AKS Windows (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Janelas

Novidades

Se estiver interessado em participar numa pré-visualização privada, pode solicitar acesso à pré-visualização.

As novas funcionalidades incluem:

  • Disponibilidade geral do Ubuntu 18.04.
  • Visualização Pública de Rotação de Certificados #4214.
  • T4 GPU Nvidia Private Preview #4259.
  • Visualização privada da integração do Ative Directory do Azure.
  • Driver CSI para Azure Blobs Private Preview #712.
  • CSI Driver Azure Disks Public Preview #712.
  • CSI Driver NFS Visualização Pública #712.
  • Suporte para Kubernetes 1. 17.17 #4188 e 1.18.15 #4187.

Problemas conhecidos

  • Implantar vários serviços Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos implantar um serviço de cada vez.
  • Como a ferramenta aks-engine é um repositório de código-fonte compartilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e solicitações pull pode levar você a acreditar que a ferramenta oferece suporte a outras versões do Kubernetes e da plataforma do sistema operacional além das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

A lista a seguir é o conjunto completo de notas de versão do Azure e do Azure Stack Hub combinados:

Aplica-se à versão v0.55.4 do motor AKS.

Este artigo descreve o conteúdo do mecanismo do Serviço Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui melhorias e correções para a versão mais recente do mecanismo AKS direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo AKS para o Azure global.

Planejamento de atualizações

O comando AKS engine upgrade automatiza totalmente o processo de atualização do cluster e lida com máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de revisar as informações da nota de versão.

Considerações sobre atualização

  • Você está usando o item de mercado correto, AKS Base Ubuntu 16.04-LTS Image Distro para a sua versão do motor AKS? Você pode encontrar as versões na seção "Download de nova imagem e motor AKS".
  • Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Deploy a Kubernetes cluster.
  • Você está usando uma máquina confiável para executar o mecanismo AKS e a partir do qual você está executando operações de atualização?
  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
  • Certifique-se de que a sua subscrição tem quota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas planeje que mais algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas são planejadas.
  • Configure uma atualização em estágios em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização antes de fazê-lo em seu cluster de produção.

Use o comando upgrade

Você deve usar o aks-engine upgrade comando conforme descrito em Atualizar um cluster Kubernetes no Azure Stack Hub.

Interrupções de atualização

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo AKS relata um erro ou algo acontece com o processo de execução do mecanismo AKS. Examine a causa da interrupção, resolva-a e reenvie o mesmo upgrade comando para continuar o processo de atualização. O upgrade comando é idempotente e deve retomar a atualização do cluster assim que você reenviar o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar sua conclusão.

Tempo estimado de atualização

O tempo estimado de atualização é de 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar cerca de 5 horas para ser atualizado.

Download de nova imagem e motor AKS

Baixe as novas versões da base AKS Ubuntu Image e motor AKS.

Conforme explicado na documentação do mecanismo AKS no Azure Stack Hub, a implantação de um cluster Kubernetes requer dois componentes principais:

  • O binário aks-engine (obrigatório).
  • AKS Base Ubuntu 16.04-LTS Imagem Distro

Novas versões destas imagens estão disponíveis com esta atualização:

Mecanismo AKS e mapeamento de versão do Azure Stack

Versão do Azure Stack Hub Versão do motor AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4

Caminho de atualização da versão do Kubernetes no mecanismo AKS v0.55.4

Você pode encontrar a versão atual e a versão de atualização para o Azure Stack Hub na tabela a seguir. Esta tabela aplica-se ao cluster do motor AKS no Azure Stack Hub. Não use o comando aks-engine get-versions , que retorna versões com suporte no Azure global, bem como no Azure Stack Hub.

Versão atual Atualização disponível
1.15.10 1.15.12
1.15.12, 1.16.8, 1.16.9 1.16.14
1.16.8, 1.16.9, 1.16.14 1.17.11

No arquivo JSON do modelo de API, especifique os valores de versão e versão na orchestratorProfile seção . Por exemplo, se você estiver planejando implantar o Kubernetes 1.17.17, os dois valores a seguir devem ser definidos (consulte o exemplo kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

Motor AKS e mapeamento de imagem correspondente

Versões do Kubernetes Notas
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 Exemplos de modelo de API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Exemplos de modelo de API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Exemplos de modelo de API (Linux, Windows)

Novidades

Problemas conhecidos

  • Implantar vários serviços Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos implantar um serviço de cada vez.
  • Quando você executa o aks-engine get-versions, a saída produz informações aplicáveis ao Azure e ao Azure Stack Hub, no entanto, não há uma maneira explícita de discernir o que corresponde ao Azure Stack Hub. Não use este comando para determinar quais versões estão disponíveis para atualização. Use a tabela de referência de atualização descrita na seção anterior.
  • Como a ferramenta aks-engine é um repositório de código-fonte compartilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e solicitações pull pode levar você a acreditar que a ferramenta oferece suporte a outras versões do Kubernetes e da plataforma do sistema operacional além das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

Este é o conjunto completo de notas de versão do Azure e do Azure Stack Hub combinados:

Aplica-se à versão 0.48.0 ou anterior do motor AKS.

Este artigo descreve o conteúdo do mecanismo do Serviço Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui melhorias e correções para a versão mais recente do mecanismo AKS direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo AKS para o Azure global.

Planejamento de atualizações

O comando AKS engine upgrade automatiza totalmente o processo de atualização do cluster e lida com máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de revisar as informações da nota de versão.

Considerações sobre atualização

  • Você está usando o item de mercado correto, AKS Base Ubuntu 16.04-LTS Image Distro para a sua versão do motor AKS? Você pode encontrar as versões na seção Download da nova base AKS, Ubuntu Image e versões do motor AKS.
  • Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Deploy a Kubernetes cluster.
  • Você está usando uma máquina confiável para executar o mecanismo AKS e a partir da qual você está executando operações de atualização?
  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
  • Certifique-se de que a sua subscrição tem quota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas planeje que mais algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas são planejadas.
  • Configure uma atualização em estágios em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização antes de fazê-lo em seu cluster de produção.

Use o comando upgrade

Você deve usar o aks-engine upgrade comando conforme descrito em Atualizar um cluster Kubernetes no Azure Stack Hub.

Interrupções de atualização

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo AKS relata um erro ou algo acontece com o processo de execução do mecanismo AKS. Examine a causa da interrupção, resolva-a e reenvie o mesmo upgrade comando para continuar o processo de atualização. O upgrade comando é idempotente e deve retomar a atualização do cluster assim que você reenviar o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar sua conclusão.

Tempo estimado de atualização

O tempo estimado de atualização é de 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar cerca de 5 horas para ser atualizado.

Download de nova imagem e motor AKS

Baixe as novas versões da base AKS Ubuntu Image e motor AKS.

Conforme explicado na documentação do mecanismo AKS no Azure Stack Hub, a implantação de um cluster Kubernetes requer dois componentes principais:

  • O binário aks-engine (obrigatório).
  • AKS Base Ubuntu 16.04-LTS Image Distro.

Novas versões destes estão disponíveis com esta atualização:

Caminho de atualização da versão do Kubernetes

Você pode encontrar a versão atual e a versão de atualização para o Azure Stack Hub na tabela a seguir. Esta tabela aplica-se ao cluster do motor AKS no Azure Stack Hub. Não use o comando aks-engine get-versions , que retorna versões com suporte no Azure global, bem como no Azure Stack Hub.

Versão atual Atualização disponível
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Novidades

  • Suporte para Kubernetes versão 1.15.10 (#2834). Ao implantar um novo cluster, em seu arquivo de .json de modelo de API (também conhecido como arquivo de definição de cluster), especifique o número da versão de lançamento e o número da versão secundária no formato a seguir. Para obter um exemplo de arquivo de definição de cluster, consulte kubernetes-azurestack.json.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Nota

    Se a versão do Kubernetes não for fornecida explicitamente no arquivo de .json do modelo de API, a versão 1.15 será usada (#2932) e o orchestratorVersion assumirá como padrão 1.15.11, o que resultará em um erro durante a implantação do cluster.

  • Com aks-engine v0.43.1, as configurações de frequência padrão para o provedor de nuvem executar seu loop de controle e outras tarefas não funcionam bem com os limites de limite do Azure Stack Hub Resource Manager para solicitações de entrada. Esta atualização altera os padrões do Azure Stack Hub para reduzir a carga de repetição para o Azure Stack Hub Resource Manager (#2861).

  • A nova etapa de verificação no aks-engine resultará na interrupção da execução ou na exibição de avisos se o modelo de API .json arquivo contiver propriedades não suportadas pelo Azure Stack Hub (#2717).

  • Com um novo check-in de verificação, o aks-engine validará a disponibilidade da versão da imagem base do AKS necessária para a versão do aks-engine em execução (#2342). Isso ocorrerá depois de analisar o arquivo de .json do modelo de API e antes de chamar o Gerenciador de Recursos do Hub de Pilha do Azure.

  • A nova opção aks-engine "--control-plane-only" no upgrade comando permite que o usuário atualize as operações para direcionar apenas as Máquinas Virtuais mestras (#2635).

  • Atualizações para Linux Kernel versão 4.15.0-1071-azure para Ubuntu 16.04-LTS. Consulte "Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]" para obter detalhes.

  • Novas atualizações do hyperkube para suportar as versões 1.14.8 e 1.15.10 do Kubernetes.

  • Atualize o kubectl para corresponder à versão do Kubernetes para o cluster. Este componente está disponível nos nós do plano de controle de cluster do Kubernetes, você pode executá-lo por SSH em um mestre.

  • Atualizações para o suplemento Azure Container Monitor com a versão mais recente de fevereiro de 2020 (#2850).

  • Atualização para coredns a versão v1.6.6 (#2555).

  • Atualize etcd para a versão 3.3.18 (#2462).

  • Atualize moby para a versão 3.0.11 (#2887).

  • Com esta versão, o AKS Engine reduz a dependência de k8s.gcr.io agora usar o oficial Kubernetes MCR registry @ mcr.microsoft.com ao construir suas imagens (#2722).

Problemas conhecidos

  • Implantar vários serviços Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos implantar um serviço de cada vez.
  • A execução do aks-engine get-versions produz informações aplicáveis ao Azure e ao Azure Stack Hub, no entanto, não há uma maneira explícita de discernir o que corresponde ao Azure Stack Hub. Não use este comando para determinar quais versões estão disponíveis para atualização. Use a tabela de referência de atualização descrita na seção anterior.
  • Como a ferramenta aks-engine é um repositório de código-fonte compartilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e solicitações pull pode levar você a acreditar que a ferramenta oferece suporte a outras versões do Kubernetes e da plataforma do sistema operacional além das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

A seguir está uma lista de alguns dos bugs corrigidos e o conjunto completo de notas de lançamento da versão 0.44.0 para a versão 0.48.0. As notas de versão incluem o Azure e o Azure Stack Hub.

Correções de erros

  • userAssignedIdentityId no Windows azure.json aspas ausentes (#2327)

  • update config Os suplementos são somente atualização (#2282)

  • Aumento do tempo limite para obter IP de gerenciamento em nós do Windows (#2284)

  • Adicionar 1.0.28 arquivo de .zip CNI do Azure ao VHD do Windows (#2268)

  • Corrigir a ordem dos padrões para a configuração IPAddressCount (#2358)

  • Atualização para usar um único omsagent yaml para todas as versões do K8s para evitar erros manuais e fácil manutenção (#2692)

Notas de versão

Este é o conjunto completo de notas de versão do Azure e do Azure Stack Hub combinados:

Próximos passos