Notas sobre a versão do mecanismo do AKS no Azure Stack Hub
Aplica-se à versão v0.80.2 do mecanismo do AKS.
Este artigo descreve o conteúdo do mecanismo de Serviço de Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui aprimoramentos e correções para a versão mais recente do mecanismo do AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo do AKS para o Azure global.
Considerações sobre atualização
- Você está usando os itens corretos do marketplace, a Distribuição de Imagens do Ubuntu 20.04 Base do AKS ou o Windows Server Base do AKS para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção Baixar novas imagens e o mecanismo do 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 de comando deploy Deploy a Kubernetes cluster.
- Você está usando um computador confiável para executar o mecanismo do AKS e do qual 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 a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
- Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
- Verifique se sua assinatura tem cota 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 estão planejadas.
- Configure uma atualização em etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.
Usar o comando de atualização
Você deve usar o aks-engine upgrade
comando conforme descrito em Atualizar um cluster do 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 do AKS relata um erro ou algo acontece com o processo de execução do mecanismo do AKS. Examine a causa da interrupção, resolva-a e envie novamente o mesmo upgrade
comando para continuar o processo de atualização. O upgrade
comando é idempotente e deve retomar a atualização do cluster depois 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 para usar o mecanismo do AKS 0.70.0 e superior
Baixar nova imagem e mecanismo do AKS
Baixe as novas versões da imagem base do Ubuntu do AKS e do mecanismo do AKS.
Conforme explicado na documentação do mecanismo do AKS para o Azure Stack Hub, a implantação de um cluster do Kubernetes requer:
- O binário aks-engine (obrigatório).
- Distribuição de imagem do Ubuntu base do AKS 16.04-LTS (preterida – não é mais usada, altere no Modelo de API para usar a versão 20.04).
- Distribuição de imagem base do Ubuntu 18.04-LTS do AKS (preterida – não é mais usada, altere no Modelo de API para usar a versão 20.04).
- Distribuição de imagem base do Ubuntu 20.04-LTS do AKS (necessária para agentes do Linux).
- Imagem base do Windows Server do AKS (uma das seguintes imagens é necessária para agentes do Windows):
- Imagem base do Windows Server do AKS em contêineres.
- Docker de imagem base do Windows Server do AKS.
Novas versões dessas imagens estão disponíveis com esta atualização:
Verifique o mecanismo do AKS e a tabela de mapeamento de versão do Azure Stack para obter as imagens base do AKS necessárias.
Siga as instruções em Adicionar os pré-requisitos do mecanismo do AKS (Serviços de Kubernetes do Azure) ao Marketplace do Azure Stack Hub.
O administrador de cluster do Kubernetes (normalmente um usuário locatário do Azure Stack Hub) deve baixar o novo aks-engine. Confira as instruções em Instalar o mecanismo do AKS no Linux no Azure Stack Hub (ou no artigo equivalente do Windows). Você pode seguir o mesmo processo usado para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se você usou o script get-akse.sh , siga as mesmas etapas descritas em Instalar em um ambiente conectado. O mesmo processo se aplica se você estiver instalando em um sistema Windows: instalar o mecanismo do AKS no Windows no Azure Stack Hub.
Atualizando clusters do Kubernetes criados com a distribuição do Ubuntu 16.04
A partir do Mecanismo aks v0.63.0, a distribuição do Ubuntu 16.04 não é mais uma opção com suporte, pois o sistema operacional atingiu seu fim de vida útil. Para o Mecanismo aks v0.67.0 ou versões posteriores, a atualização do aks-engine substitui automaticamente o valor de distribuição sem suporte aks-ubuntu-16.04
por .aks-ubuntu-18.04
Para o Mecanismo aks 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 sem aks-ubuntu-16.04
suporte por aks-ubuntu-20.04
.
Atualizando clusters do Kubernetes criados com a distribuição do Ubuntu 18.04
A partir do Mecanismo aks v0.75.3, a distribuição do Ubuntu 18.04 não é mais uma opção com suporte, pois o sistema operacional atingiu seu fim de vida útil. Para o Mecanismo aks v0.75.3 ou versões posteriores, a atualização aks-engine-azurestack substitui automaticamente o valor de distribuição sem suporte aks-ubuntu-18.04
por aks-ubuntu-20.04
.
Atualizando clusters do Kubernetes criados com o runtime de contêiner do Docker
No Kubernetes v1.24, o componente dockershim foi removido do kubelet. Como resultado, o runtime do contêiner do Docker não é mais uma opção com suporte. Confira as notas sobre a versão do Kubernetes v1.24 para obter mais informações. Para o Mecanismo aks v0.75.3 ou versões posteriores, a atualização aks-engine-azurestack substitui automaticamente o valor sem suporte docker
containerRuntime
por containerd
.
Para a versão v0.75.3 do Mecanismo do AKS, os clusters com nós do Windows no Kubernetes v1.23 podem usar a imagem base do Windows com o runtime do Docker. Clusters com nós do Windows no Kubernetes v1.24 podem usar a imagem base do Windows com o runtime em contêiner.
Mapeamento de versão do mecanismo do AKS e do Azure Stack
Versão do Azure Stack Hub | Versão do mecanismo do 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* |
Observação
*Suportado. Consulte a política de Suporte à Versão do Mecanismo do AKS para obter mais informações.
Mecanismo do AKS e mapeamento de imagem correspondente
Você pode encontrar as versões do Kubernetes com suporte para o Mecanismo do AKS 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.
Mecanismo do AKS | Imagem base do AKS | Versões do Kubernetes | Exemplos de modelo de API |
---|---|---|---|
v0.43.1 | AKS Base Ubuntu 16.04-LTS Image Distro, 2019 de outubro (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
v0.48.0 | AKS Base Ubuntu 16.04-LTS Image Distro, março de 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
v0.51.0 | Distribuição de imagem base do AKS Ubuntu 16.04-LTS, maio de 2020 (2020.05.13), imagem base do Windows do AKS (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
v0.55.0 | Distribuição de imagem base do AKS Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), imagem base do Windows do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
v0.55.4 | Distribuição de imagens do AKS Base Ubuntu 16.04-LTS, setembro de 2020 (2020.09.14), imagem base do Windows do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
V0.60.1 | Distribuição de imagem do AKS Base Ubuntu 16.04-LTS, janeiro de 2021 (2021.01.28), Distribuição de imagem base do AKS Ubuntu 18.04-LTS, 2021 Q1 (2021.01.28), Imagem de Windows base do AKS(17763.1697.210129) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
v0.63.0 | Distribuição de imagem do AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), Imagem Base do Windows do AKS (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Exemplos de modelo de API (Linux, Windows) |
v0.67.0 | Distribuição de imagem do AKS Base Ubuntu 18.04-LTS, 2021 Q3 (2021.09.27), Imagem Base do Windows do AKS (17763.2213.210927) | 1.19.15, 1.20.11 | Exemplos de modelo de API (Linux, Windows) |
v0.67.3 | Distribuição de imagem do AKS Base Ubuntu 18.04-LTS, 2021 Q3 (2021.09.27), Imagem Base do Windows do AKS (17763.2213.210927) | 1.19.15, 1.20.11 | Exemplos de modelo de API (Linux, Windows) |
v0.70.0 | Distribuição de imagem do AKS Base Ubuntu 18.04-LTS, 2022 Q2 (2022.04.07), Imagem Base do Windows do AKS (17763.2565.220408) | 1.21.10*, 1.22.7* | Exemplos de modelo de API (Linux, Windows) |
v0.71.0 | Distribuição de imagem do AKS Base Ubuntu 18.04-LTS, 2022 Q3 (2022.08.12), Imagem Base do Windows do AKS (17763.3232.220805) | 1.22.7*, 1.23.6* | Exemplos de modelo de API (Linux, Windows) |
v0.73.0 | Distribuição de imagem base do AKS Ubuntu 18.04-LTS, 2022 Q4 (2022.11.02), imagem base do Windows do AKS (17763.3532.221102) | 1.22.15*, 1.23.13* | Exemplos de modelo de API (Linux, Windows) |
v0.75.3 | Distribuição de imagem do Ubuntu base do AKS 20.04-LTS (2023.032.2), Docker de imagem base do WINDOWS Server 2019 do AKS (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 | Distribuição de imagem base do AKS Ubuntu 20.04-LTS (2023.116.3), contêiner de imagem base do Windows Server 2019 do AKS (17763.4252.20231163) | 1.24.11**, 1.25.7** | Exemplos de modelo de API (Linux, Windows) |
v0.77.0 | Distribuição de imagem base do AKS Ubuntu 20.04-LTS (2023.206.1), Contêiner de imagem base do Windows Server 2019 do AKS (17763.4645.20232061) | 1.25.7**, 1.26.6** | Exemplos de modelo de API (Linux, Windows) |
v0.78.0 | Distribuição de imagem base do AKS Ubuntu 20.04-LTS (2023.242.3), contêiner de imagem base do Windows Server 2019 do AKS (17763.4737.20232423) | 1.25.13**, 1.26.8** | Exemplos de modelo de API (Linux, Windows) |
v0.79.0 | Distribuição de imagem base do AKS Ubuntu 20.04-LTS (2023.296.1), contêiner de imagem base do WINDOWS Server 2019 do AKS (17763.4974.20232961) | 1.26.9**, 1.27.6** | Exemplos de modelo de API (Linux, Windows) |
v0.80.2 | Distribuição de imagem base do AKS Ubuntu 20.04-LTS (2024.032.1), contêiner de imagem base do Windows Server 2019 do AKS (17763.5329.20240321) | 1.27.10**, 1.28.6** | Exemplos de modelo de API (Linux, Windows) |
Observação
*A partir do Kubernetes v1.21, somente o Provedor de Nuvem para Azure tem suporte no Azure Stack Hub.
Observação
** A partir do Kubernetes v1.24, há suporte apenas para o runtime do containerd
contêiner. Consulte a seção Atualizando clusters do Kubernetes criados com o runtime de contêiner do Docker para obter mais informações.
Planejamento de atualizações
O comando do mecanismo upgrade
do AKS automatiza totalmente o processo de atualização do cluster e lida com VMs (máquinas virtuais), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.
Novidades do 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.
Novidades do AKSe 0.75.3 e superior
A versão v0.75.3 do Mecanismo do AKS e todas as versões futuras do Mecanismo do AKS no Azure Stack Hub serão do novo repositório aks-engine-azurestack. Dessa forma, todos os aks-engine
comandos devem ser substituídos aks-engine-azurestack
por . Os comandos para obter a versão mais recente do Mecanismo do AKS 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 problemas.
A versão v0.75.3 do Mecanismo do AKS 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 tem mais suporte. Consulte Atualizando clusters do Kubernetes criados com a Distribuição do Ubuntu 18.04 para obter mais informações.
A partir do Kubernetes v1.24, há suporte apenas para o containerd
runtime. Consulte Atualizando clusters do Kubernetes criados com o docker runtime para obter mais informações. Para a versão v0.75.3 do Mecanismo do AKS, os clusters com nós do Windows no Kubernetes v1.23 podem usar a imagem base do Windows com o runtime do Docker. Clusters com nós do Windows no Kubernetes v1.24 podem usar a imagem base do Windows com runtime em contêineres.
Você pode encontrar mais recursos na página v0.75.3 do GitHub.
Instruções para usar o mecanismo do AKS 0.70.0 e superior
A Microsoft atualizou o Provedor de Nuvem do Azure na versão 0.70.0. O Provedor de Nuvem do Azure é um componente principal compartilhado entre o AKS Azure e o mecanismo do AKS no Azure Stack Hub.
Para usar o mecanismo do AKS 0.70.0 e superior:
Se você estiver tentando criar um novo cluster do Kubernetes pela primeira vez: use o modelo de API de exemplo fornecido para a versão apropriada no mecanismo do 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 você estiver usando volumes de armazenamento: verifique se está usando o driver AzureDiskCSI . A versão 0.70.0 e superior só dá suporte a drivers CSI, não ao provedor de armazenamento na árvore herdado. Para atualizar, siga as instruções em atualização ao usar volumes de armazenamento.
Problemas conhecidos
- Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço por 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 de pull pode levar você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além daquelas listadas anteriormente. Você pode ignorá-los e usar a tabela de versão acima como o guia oficial para esta atualização.
- O Mecanismo do AKS v0.67.0 usa a imagem errada do Windows ao implantar clusters do Windows. Use v0.70.0 para resolve esse problema.
Referência
A lista a seguir é o conjunto completo de notas sobre a versão do Azure e do Azure Stack Hub combinadas:
- https://github.com/Azure/aks-engine/releases/tag/v0.64.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.1
- https://github.com/Azure/aks-engine/releases/tag/v0.66.0
- https://github.com/Azure/aks-engine/releases/tag/v0.66.1
- https://github.com/Azure/aks-engine/releases/tag/v0.67.0
- https://github.com/Azure/aks-engine/releases/tag/v0.70.0
- https://github.com/Azure/aks-engine/releases/tag/v0.71.0
- https://github.com/Azure/aks-engine/releases/tag/v0.73.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.75.3
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.76.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.77.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.78.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.79.0
Aplica-se à versão v0.67.0 do mecanismo do AKS.
Este artigo descreve o conteúdo do mecanismo de Serviço de 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 do AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo do AKS para o Azure global.
Atualizar o planejamento
O comando do mecanismo upgrade
do AKS automatiza totalmente o processo de atualização do cluster. Ele lida com máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.
Considerações sobre atualização
- Você está usando os itens corretos do marketplace, AKS Base Ubuntu 16.04-LTS ou 18.04 Image Distro ou AKS Base Windows Server para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção "Baixar novas imagens e mecanismo do AKS".
- Você está usando a especificação de cluster correta (apimodel.json) e o grupo de recursos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Confira os parâmetros de comando implantar Implantar um cluster do Kubernetes.
- Você está usando um computador confiável para executar o mecanismo do AKS e do qual 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 a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
- Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
- Verifique se sua assinatura tem cota 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 planeja 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 etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.
Usar o comando de atualização
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 do AKS relata um erro ou algo acontece com o processo de execução do mecanismo do AKS. Examine a causa da interrupção, resolva-a e envie novamente 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.
Baixar nova imagem e mecanismo do AKS
Baixe as novas versões da imagem base do AKS Ubuntu e do mecanismo do AKS.
Conforme explicado na documentação do mecanismo do AKS para o Azure Stack Hub, a implantação de um cluster do Kubernetes requer:
- O binário aks-engine (obrigatório).
- Distribuição de imagem do AKS Base Ubuntu 16.04-LTS (preterido – não é mais usado, altere o modelo de API para usar o 18.04).
- Distribuição de imagem do AKS Base Ubuntu 18.04-LTS (necessária para agentes do Linux).
- Distribuição de imagens do Windows Server base do AKS (necessária para agentes do Windows).
Novas versões dessas imagens estão disponíveis com esta atualização:
Verifique o mecanismo do AKS e a tabela de mapeamento de versão do Azure Stack para obter as imagens base necessárias do AKS.
Siga as instruções em Adicionar os pré-requisitos do mecanismo do AKS (Serviços de Kubernetes do Azure) ao Azure Stack Hub Marketplace.
O administrador de cluster do Kubernetes (normalmente um usuário locatário do Azure Stack Hub) deve baixar o novo aks-engine. Confira as instruções em Instalar o mecanismo do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Você pode seguir o mesmo processo usado para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se você usou o script get-akse.sh , siga as mesmas etapas descritas em Instalar em um ambiente conectado. O mesmo processo se aplica se você estiver instalando em um sistema Windows: instale o mecanismo do AKS no Windows no Azure Stack Hub.
Atualizando clusters do Kubernetes criados com a distribuição do Ubuntu 16.04
A partir do Mecanismo do AKS v0.67.0, a distribuição do Ubuntu 16.04 não é mais uma opção com suporte, pois o sistema operacional atingiu seu fim de vida útil. Para atualizar um cluster, defina a distribuição do sistema operacional como aks-ubuntu-18.04
no modelo de API de entrada, aquele gerado por aks-engine deploy
e passado como entrada para aks-engine upgrade
:
"masterProfile": {
"distro": "aks-ubuntu-18.04"
},
"agentPoolProfiles": [{
"distro": "aks-ubuntu-18.04"
}]
Mapeamento de versão do mecanismo do AKS e do Azure Stack
Versão do Azure Stack Hub | Versão do mecanismo do 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 do 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 se aplica ao cluster do mecanismo do 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 deverão ser definidos (consulte o exemplo kubernetes-azurestack.json):
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
Mecanismo do AKS e mapeamento de imagem correspondente
Mecanismo do AKS | Imagem base do AKS | Versões do Kubernetes | Exemplos de modelo de API |
---|---|---|---|
v0.43.1 | AKS Base Ubuntu 16.04-LTS Image Distro, 2019 de outubro (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
v0.48.0 | AKS Base Ubuntu 16.04-LTS Image Distro, março de 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
v0.51.0 | Distribuição de imagem base do AKS Ubuntu 16.04-LTS, maio de 2020 (2020.05.13), imagem base do Windows do AKS (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
v0.55.0 | Distribuição de imagem base do AKS Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), imagem base do Windows do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
v0.55.4 | Distribuição de imagens do AKS Base Ubuntu 16.04-LTS, setembro de 2020 (2020.09.14), imagem base do Windows do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
V0.60.1 | Distribuição de imagem do AKS Base Ubuntu 16.04-LTS, janeiro de 2021 (2021.01.28), Distribuição de imagem base do AKS Ubuntu 18.04-LTS, 2021 Q1 (2021.01.28), Imagem de Windows base do AKS(17763.1697.210129) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
v0.63.0 | Distribuição de imagem do AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), Imagem Base do Windows do AKS (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Exemplos de modelo de API (Linux, Windows) |
v0.67.0 | Distribuição de imagem do AKS Base Ubuntu 18.04-LTS, 2021 Q3 (2021.09.27), Imagem Base do Windows do AKS (17763.2213.210927) | 1.19.15, 1.20.11 | Exemplos de modelo de API (Linux, Windows) |
Novidades
Se você estiver interessado em participar de uma versão prévia privada, poderá solicitar acesso de visualização.
Os novos recursos incluem:
- Suporte para Kubernetes 1.19.15 e 1.20.11
Problemas conhecidos
- Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço por 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 de pull pode levar você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além daquelas listadas anteriormente. Você pode ignorá-los e usar a tabela de versão acima como o guia oficial para esta atualização.
Referência
A lista a seguir é o conjunto completo de notas sobre a versão do Azure e do Azure Stack Hub combinadas:
- https://github.com/Azure/aks-engine/releases/tag/v0.64.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.1
- https://github.com/Azure/aks-engine/releases/tag/v0.66.0
- https://github.com/Azure/aks-engine/releases/tag/v0.66.1
- https://github.com/Azure/aks-engine/releases/tag/v0.67.0
Aplica-se à versão v0.60.1 do mecanismo do AKS.
Este artigo descreve o conteúdo do mecanismo de Serviço de Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui aprimoramentos e correções para a versão mais recente do mecanismo do AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo do AKS para o Azure global.
Planejamento de atualizações
O comando do mecanismo upgrade
do AKS automatiza totalmente o processo de atualização do cluster e lida com VMs (máquinas virtuais), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.
Considerações sobre atualização
- Você está usando os itens corretos do marketplace, 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 "Baixar novas imagens e o mecanismo do 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 de comando deploy Deploy a Kubernetes cluster.
- Você está usando um computador confiável para executar o mecanismo do AKS e do qual 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 a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
- Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
- Verifique se sua assinatura tem cota 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 estão planejadas.
- Configure uma atualização em etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.
Usar o comando de atualização
Você deve usar o aks-engine upgrade
comando conforme descrito em Atualizar um cluster do 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 do AKS relata um erro ou algo acontece com o processo de execução do mecanismo do AKS. Examine a causa da interrupção, resolva-a e envie novamente o mesmo upgrade
comando para continuar o processo de atualização. O upgrade
comando é idempotente e deve retomar a atualização do cluster depois 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.
Baixar nova imagem e mecanismo do AKS
Baixe as novas versões da imagem base do Ubuntu do AKS e do mecanismo do AKS.
Conforme explicado na documentação do mecanismo do AKS no Azure Stack Hub, a implantação de um cluster do Kubernetes requer:
- O binário aks-engine (obrigatório).
- Distribuição de imagem base do Ubuntu 16.04-LTS do AKS (preterida – não é mais usada, alteração no modelo de API para usar a versão 18.04).
- Distribuição de imagem base do Ubuntu 18.04-LTS do AKS (necessária para agentes do Linux).
- Distribuição de imagem base do Windows Server do AKS (necessária para agentes do Windows).
Novas versões delas estão disponíveis com esta atualização:
O operador do Azure Stack Hub deve baixar as novas imagens base do AKS no marketplace de selos:
AKS Base Ubuntu 16.04-LTS Image Distro, janeiro de 2021 (2021.01.28)
Distribuição de imagem base do AKS Ubuntu 18.04-LTS, 2021 Q1 (2021.01.28),
Imagem de Windows base do AKS(17763.1697.210129)
Siga as instruções em Adicionar os pré-requisitos do mecanismo do AKS (Serviços de Kubernetes do Azure) ao Marketplace do Azure Stack Hub.
O administrador de cluster do Kubernetes (normalmente um usuário locatário do Azure Stack Hub) deve baixar o novo aks-engine. Confira as instruções em Instalar o mecanismo do AKS no Linux no Azure Stack Hub (ou no artigo equivalente do Windows). Você pode seguir o mesmo processo usado para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se você usou o script get-akse.sh , siga as mesmas etapas descritas em Instalar em um ambiente conectado. O mesmo processo se aplica se você estiver instalando em um sistema Windows: instalar o mecanismo do AKS no Windows no Azure Stack Hub.
Mapeamento de versão do mecanismo do AKS e do Azure Stack
Versão do Azure Stack Hub | Versão do mecanismo do 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 do AKS v0.60.1
Você pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela a seguir. Esta tabela se aplica ao cluster do mecanismo do 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 deverão ser definidos (consulte o exemplo kubernetes-azurestack.json):
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
Mecanismo do AKS e mapeamento de imagem correspondente
Mecanismo do AKS | Imagem base do AKS | Versões do Kubernetes | Exemplos de modelo de API |
---|---|---|---|
v0.43.1 | AKS Base Ubuntu 16.04-LTS Image Distro, 2019 de outubro (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
v0.48.0 | AKS Base Ubuntu 16.04-LTS Image Distro, março de 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
v0.51.0 | Distribuição de imagem base do AKS Ubuntu 16.04-LTS, maio de 2020 (2020.05.13), imagem base do Windows do AKS (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
v0.55.0 | Distribuição de imagem base do AKS Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), imagem base do Windows do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
v0.55.4 | Distribuição de imagens do AKS Base Ubuntu 16.04-LTS, setembro de 2020 (2020.09.14), imagem base do Windows do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
V0.60.1 | Distribuição de imagem do AKS Base Ubuntu 16.04-LTS, janeiro de 2021 (2021.01.28), Distribuição de imagem base do AKS Ubuntu 18.04-LTS, 2021 Q1 (2021.01.28), Imagem de Windows base do AKS(17763.1697.210129) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
Novidades
Se você estiver interessado em participar de uma versão prévia privada, poderá solicitar acesso de visualização.
Os novos recursos incluem:
- Disponibilidade geral do Ubuntu 18.04.
- Visualização pública de rotação de certificado nº 4214.
- T4 Nvidia GPU Private Preview #4259.
- Versão prévia privada da integração do Azure Active Directory.
- Driver csi para a visualização privada de blobs do Azure nº 712.
- Csi Driver Azure Disks Public Preview #712.
- Csi Driver NFS Public Preview #712.
- Suporte para Kubernetes 1. 17.17 #4188 e 1.18.15 #4187.
Problemas conhecidos
- Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço por 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 de pull pode levar você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além daquelas listadas anteriormente. Você pode ignorá-los e usar a tabela de versão acima como o guia oficial para esta atualização.
Referência
A lista a seguir é o conjunto completo de notas sobre a versão do Azure e do Azure Stack Hub combinadas:
Aplica-se à versão v0.55.4 do mecanismo do AKS.
Este artigo descreve o conteúdo do mecanismo de Serviço de Kubernetes do Azure (AKS) na atualização do Azure Stack Hub. A atualização inclui aprimoramentos e correções para a versão mais recente do mecanismo do AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo do AKS para o Azure global.
Planejamento de atualizações
O comando do mecanismo upgrade
do AKS automatiza totalmente o processo de atualização do cluster e lida com VMs (máquinas virtuais), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.
Considerações sobre atualização
- Você está usando o item correto do marketplace, Distribuição de imagens do Ubuntu 16.04-LTS base do AKS para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção "Baixar nova imagem e mecanismo do 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 de comando deploy Deploy a Kubernetes cluster.
- Você está usando um computador confiável para executar o mecanismo do AKS e do qual 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 a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
- Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
- Verifique se sua assinatura tem cota 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 planeja 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 etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.
Usar o comando de atualização
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 do AKS relata um erro ou algo acontece com o processo de execução do mecanismo do AKS. Examine a causa da interrupção, resolva-a e envie novamente 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.
Baixar nova imagem e mecanismo do AKS
Baixe as novas versões do mecanismo aks base Ubuntu Image e AKS.
Conforme explicado na documentação do mecanismo do AKS no Azure Stack Hub, a implantação de um cluster do Kubernetes requer dois componentes main:
- O binário aks-engine (obrigatório).
- Distribuição de imagem do AKS Base Ubuntu 16.04-LTS
Novas versões dessas imagens estão disponíveis com esta atualização:
O operador do Azure Stack Hub deve baixar uma nova imagem base do Ubuntu do AKS no marketplace de selos:
Nome: Aks Base Ubuntu 16.04-LTS Image Distro, setembro de 2020 (2020.09.14)
Versão: 2020.09.14
Siga as instruções em Adicionar os pré-requisitos do mecanismo do AKS (Serviços de Kubernetes do Azure) ao Azure Stack Hub Marketplace.
O administrador de cluster do Kubernetes (normalmente um usuário locatário do Azure Stack Hub) deve baixar o novo aks-engine. Confira as instruções em Instalar o mecanismo do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Você pode seguir o mesmo processo usado para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se você usou o script get-akse.sh , siga as mesmas etapas descritas em Instalar em um ambiente conectado. O mesmo processo se aplica se você estiver instalando em um sistema Windows: instale o mecanismo do AKS no Windows no Azure Stack Hub.
Mapeamento de versão do mecanismo do AKS e do Azure Stack
Versão do Azure Stack Hub | Versão do mecanismo do 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 do 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 se aplica ao cluster do mecanismo do 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 deverão ser definidos (consulte o exemplo kubernetes-azurestack.json):
- "orchestratorRelease": "1.16",
- "orchestratorVersion": "1.16.14"
Mecanismo do AKS e mapeamento de imagem correspondente
Versões do Kubernetes | Observações |
---|---|
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
- Atualizar o VHD linux do Azure Stack para 2020.09.14 #3828
- Adiciona suporte para K8s v1.17.11 no Azure Stack #3702
- Adiciona suporte para K8s v1.16.14 no Azure Stack #3704
- Atualização do VHD do Linux para 2020.09.14 #3750
- Atualização do VHD do Windows para agosto de 3730
- Atualiza o servidor de métricas do Kubernetes para v0.3.7 #3669
- Atualiza a versão do Docker para corrigir o problema de rotação de log #3693
- Atualiza o CoreDNS para v1.7.0 #3608
- Usar pacotes moby 19.03.x #3549
- Correções na estratégia de atualização do azure-cni nº 3571
Problemas conhecidos
- Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço por 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á nenhuma 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 de pull pode levar você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além daquelas listadas anteriormente. Você pode ignorá-los e usar a tabela de versão acima como o guia oficial para esta atualização.
Referência
Este é o conjunto completo de notas sobre a versão do Azure e do Azure Stack Hub combinados:
- https://github.com/Azure/aks-engine/releases/tag/v0.51.1
- https://github.com/Azure/aks-engine/releases/tag/v0.52.1
- https://github.com/Azure/aks-engine/releases/tag/v0.53.1
- https://github.com/Azure/aks-engine/releases/tag/v0.54.1
- https://github.com/Azure/aks-engine/releases/tag/v0.55.0
- https://github.com/Azure/aks-engine/releases/tag/v0.55.4
Aplica-se à versão 0.48.0 ou anterior do mecanismo do AKS.
Este artigo descreve o conteúdo do mecanismo de Serviço de 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 do AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do mecanismo do AKS para o Azure global.
Atualizar o planejamento
O comando do mecanismo upgrade
do AKS automatiza totalmente o processo de atualização do cluster e manipula máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.
Considerações sobre atualização
- Você está usando o item correto do marketplace, a Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção Baixar as novas versões do mecanismo Ubuntu Image e AKS base do AKS.
- Você está usando a especificação de cluster correta (apimodel.json) e o grupo de recursos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Confira os parâmetros de comando implantar Implantar um cluster do Kubernetes.
- Você está usando um computador confiável para executar o mecanismo do AKS e do qual 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 a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
- Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
- Verifique se sua assinatura tem cota 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 planeja 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 etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.
Usar o comando de atualização
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 do AKS relata um erro ou algo acontece com o processo de execução do mecanismo do AKS. Examine a causa da interrupção, resolva-a e envie novamente 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.
Baixar nova imagem e mecanismo do AKS
Baixe as novas versões do mecanismo aks base Ubuntu Image e AKS.
Conforme explicado na documentação do mecanismo do AKS no Azure Stack Hub, a implantação de um cluster do Kubernetes requer dois componentes main:
- O binário aks-engine (obrigatório).
- Distribuição de imagem do AKS Base Ubuntu 16.04-LTS.
Novas versões destes estão disponíveis com esta atualização:
O operador do Azure Stack Hub deve baixar as novas imagens base do AKS no marketplace de selos:
Nome:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020
Versão:
2020.03.19
Siga as instruções em Adicionar os pré-requisitos do mecanismo do AKS (Serviços de Kubernetes do Azure) ao Azure Stack Hub Marketplace.
O administrador de cluster do Kubernetes (normalmente um usuário locatário do Azure Stack Hub) deve baixar o novo aks-engine. Confira as instruções em Instalar o mecanismo do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Você pode seguir o mesmo processo usado para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se você usou o script get-akse.sh , siga as mesmas etapas descritas em Instalar em um ambiente conectado. O mesmo processo se aplica se você estiver instalando em um sistema Windows: instale o mecanismo do AKS no Windows no Azure Stack Hub.
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 se aplica ao cluster do mecanismo do 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). Quando você implanta um novo cluster, no modelo de API .json arquivo (também conhecido como o arquivo de definição de cluster), especifique o número da versão de versão e o número de 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"
Observação
Se a versão do Kubernetes não for fornecida explicitamente no modelo de API .json arquivo, a versão 1.15 será usada (#2932) e o orchestratorVersion usará como padrão a 1.15.11, o que resultará em um erro durante a implantação do cluster.
Com o 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 o Azure Stack Hub Resource Manager limites de limite para solicitações de entrada. Essa atualização altera os padrões do Azure Stack Hub para reduzir a carga de repetição para o Azure Stack Hub Resource Manager (nº 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 compatíveis com o Azure Stack Hub (#2717).
Com uma nova marcar de verificação, o mecanismo aks 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 modelo de API .json arquivo e antes de chamar o Resource Manager do Azure Stack Hub.
A nova opção aks-engine "--control-plane-only" no
upgrade
comando permite que o usuário atualize as operações para direcionar apenas o master Máquinas Virtuais (#2635).Atualizações para o Kernel do Linux versão 4.15.0-1071-azure para Ubuntu 16.04-LTS. Confira "Pacote: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [segurança]" para obter detalhes.
Novas atualizações de hiperkube para dar suporte às versões do Kubernetes 1.14.8 e 1.15.10.
Atualize o kubectl para corresponder à versão do Kubernetes para o cluster. Esse componente está disponível nos nós do painel de controle de cluster do Kubernetes. Você pode executá-lo por SSH em um master.
Atualizações para o suplemento do Azure Container Monitor com a última versão de fevereiro de 2020 (nº 2850).
Atualização de
coredns
para a versão v1.6.6 (#2555).Atualizar
etcd
para a versão 3.3.18 (#2462).Atualizar
moby
para a versão 3.0.11 (#2887).Com esta versão, o Mecanismo do AKS corta a dependência de
k8s.gcr.io
para agora usar o oficialKubernetes MCR registry @ mcr.microsoft.com
ao criar suas imagens (nº 2722).
Problemas conhecidos
- Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço por 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á nenhuma 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 de pull pode levar você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além daquelas listadas anteriormente. Você pode ignorá-los e usar a tabela de versão acima como o guia oficial para esta atualização.
Referência
Veja a seguir uma lista de alguns dos bugs corrigidos e o conjunto completo de notas de versão da versão 0.44.0 para a versão 0.48.0. As notas sobre a versão incluem o Azure e o Azure Stack Hub.
Correções de bug
userAssignedIdentityId
no Windows azure.json aspas ausentes (#2327)Os suplementos
update config
são somente atualização (#2282)Tempo limite de aumento para obter IP de gerenciamento em nós do Windows (#2284)
Adicionar o arquivo de .zip de CNI do Azure 1.0.28 ao VHD do Windows (nº 2268)
Ordem padrão correta para configuração
IPAddressCount
(#2358)Atualize para usar o yaml omsagent único para todas as versões K8s para evitar erros manuais e facilidade de manutenção (nº 2692)
Notas de versão
Este é o conjunto completo de notas sobre a versão do Azure e do Azure Stack Hub combinados:
- https://github.com/Azure/aks-engine/releases/tag/v0.44.0
- https://github.com/Azure/aks-engine/releases/tag/v0.44.1
- https://github.com/Azure/aks-engine/releases/tag/v0.44.2
- https://github.com/Azure/aks-engine/releases/tag/v0.45.0
- https://github.com/Azure/aks-engine/releases/tag/v0.46.0
- https://github.com/Azure/aks-engine/releases/tag/v0.46.1
- https://github.com/Azure/aks-engine/releases/tag/v0.46.2
- https://github.com/Azure/aks-engine/releases/tag/v0.46.3
- https://github.com/Azure/aks-engine/releases/tag/v0.47.0
- https://github.com/Azure/aks-engine/releases/tag/v0.48.0
Próximas etapas
- Leia sobre o mecanismo do AKS no Azure Stack Hub
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de