Notas de versão do motor do AKS no Azure Stack Hub
Aplica-se à versão v0.80.2 do motor do AKS.
Este artigo descreve o conteúdo do motor Azure Kubernetes Service (AKS) na atualização do Azure Stack Hub. A atualização inclui melhoramentos e correções para a versão mais recente do motor AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do motor do AKS para o Azure global.
Considerações sobre a atualização
- Está a utilizar os itens corretos do marketplace, o Ubuntu base do AKS 20.04 ou o Windows Server base do AKS para a sua versão do motor AKS? Pode encontrar as versões na secção Transferir novas imagens e motor do AKS.
- Está a utilizar a especificação correta do cluster (apimodel.json) e o grupo de recursos para o cluster de destino? Quando implementou originalmente o cluster, este ficheiro foi gerado no diretório de saída. Veja os parâmetros de comando implementar Implementar um cluster do Kubernetes.
- Está a utilizar um computador fiável para executar o motor AKS e a partir do qual está a realizar operações de atualização?
- Se estiver a atualizar um cluster operacional com cargas de trabalho ativas, pode aplicar a atualização sem as afetar, assumindo que o cluster está sob carga normal. No entanto, deve ter um cluster de cópias de segurança no caso de ser necessário redirecionar os utilizadores para o mesmo. É altamente recomendado um cluster de cópias de segurança.
- Se possível, execute o comando a partir de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e potenciais 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 planearia a criação de mais algumas VMs durante o processo.
- Não estão planeadas atualizações do sistema ou tarefas agendadas.
- Configure uma atualização faseada num cluster configurado com os mesmos valores que o cluster de produção e teste a atualização no mesmo antes de o fazer no cluster de produção.
Utilizar o comando de atualização
Tem de utilizar o aks-engine upgrade comando conforme descrito em Atualizar um cluster do Kubernetes no Azure Stack Hub.
Interrupções de atualização
Por vezes, fatores inesperados interrompem a atualização do cluster. Pode ocorrer uma interrupção quando o motor do AKS comunica um erro ou algo acontece ao processo de execução do motor AKS. Examine a causa da interrupção, resolva-a e submeta 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 submeter novamente o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar a conclusão.
Tempo de atualização estimado
O tempo estimado de atualização é de 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode demorar cerca de 5 horas a atualizar.
Instruções para utilizar o motor AKS 0.70.0 e superior
Transferir nova imagem e motor do AKS
Transfira as novas versões da imagem do Ubuntu base do AKS e do motor AKS.
Conforme explicado na documentação do motor do AKS para o Azure Stack Hub, a implementação de um cluster do Kubernetes requer:
- O binário aks-engine (obrigatório).
- AKS Base Ubuntu 16.04-LTS Image Distro (preterido – já não é utilizado, altere no Modelo de API para utilizar 20.04 em vez disso).
- AKS Base Ubuntu 18.04-LTS Image Distro (preterido – já não é utilizado, altere no Modelo de API para utilizar 20.04 em vez disso).
- Distro de Imagem do AKS Base Ubuntu 20.04-LTS (necessária para agentes linux).
- Imagem do Windows Server Base do AKS (é necessária uma das seguintes imagens para agentes do Windows):
- AKS Base Windows Server Image Containerd.
- Docker de Imagem do Windows Server Base do AKS.
Estão disponíveis novas versões destas imagens com esta atualização:
Verifique o motor do AKS e a tabela de mapeamento de versões do Azure Stack para obter as imagens de base do AKS necessárias.
Siga as instruções em Adicionar os pré-requisitos do motor do Azure Kubernetes Services (AKS) ao Marketplace do Azure Stack Hub.
O administrador do cluster do Kubernetes (normalmente um utilizador inquilino do Azure Stack Hub) tem de transferir o novo motor aks. Veja as instruções em Instalar o motor do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Pode seguir o mesmo processo que utilizou para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se utilizou o script get-akse.sh , siga os mesmos passos descritos em Instalar num ambiente ligado. O mesmo processo aplica-se se estiver a instalar num sistema Windows: instale o motor do AKS no Windows no Azure Stack Hub.
Atualizar clusters do Kubernetes criados com a distribuição Ubuntu 16.04
A partir do Motor AKS v0.63.0, a distribuição Ubuntu 16.04 já não é uma opção suportada, uma vez que o SO atingiu o seu fim de vida. Para o Motor AKS v0.67.0 ou versões posteriores, a atualização do motor aks substitui automaticamente o valor de distribuição não suportado aks-ubuntu-16.04 com aks-ubuntu-18.04. Para o Motor AKS v0.75.3 ou versões posteriores, se estiver a utilizar o Kubernetes v1.24 ou superior, a atualização aks-engine-azurestack substitui automaticamente o valor de distribuição não suportado aks-ubuntu-16.04 pelo aks-ubuntu-20.04.
Atualizar clusters do Kubernetes criados com a distribuição Ubuntu 18.04
A partir do Motor AKS v0.75.3, a distribuição Ubuntu 18.04 já não é uma opção suportada, uma vez que o SO atingiu o seu fim de vida. Para o Motor AKS 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 docker container runtime
No Kubernetes v1.24, o componente dockershim foi removido do kubelet. Como resultado, o docker container runtime já não é uma opção suportada. Consulte as notas de versão do Kubernetes v1.24 para obter mais informações. Para o Motor AKS v0.75.3 ou versões posteriores, a atualização aks-engine-azurestack substitui automaticamente o valor não suportado dockercontainerRuntime por containerd.
Para a versão v0.75.3 do Motor AKS, os clusters com nós do Windows no Kubernetes v1.23 podem utilizar a imagem base do Windows com o runtime do Docker. Os clusters com nós do Windows no Kubernetes v1.24 podem utilizar a imagem base do Windows com o runtime Containerd.
Mapeamento de versões do motor AKS e 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. Veja a política de Suporte de Versões do Motor do AKS para obter mais informações.
Motor AKS e mapeamento de imagem correspondente
Pode encontrar as versões suportadas do Kubernetes para o Motor AKS no Azure Stack Hub na tabela seguinte. Não utilize o comando aks-engine get-versions , que devolve versões suportadas no Azure global, bem como no Azure Stack Hub.
| Motor AKS | Imagem de base do AKS | Versões do Kubernetes | Exemplos de modelos 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 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, maio de 2020 (2020.05.13), Imagem do Windows base do AKS (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), Imagem de 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 do Windows base do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, janeiro de 2021 (2021.01.28), Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 1.º Trimestre de 2021 (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, Windows |
| v0.63.0 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), Imagem do Windows Base do AKS (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Exemplos de Modelos de API (Linux, Windows) |
| v0.67.0 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 3.º Trimestre de 2021 (2021.09.27), Imagem do Windows Base do AKS (17763.2213.210927) | 1.19.15, 1.20.11 | Exemplos de Modelos de API (Linux, Windows) |
| v0.67.3 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 3.º Trimestre de 2021 (2021.09.27), Imagem do Windows Base do AKS (17763.2213.210927) | 1.19.15, 1.20.11 | Exemplos de Modelos de API (Linux, Windows) |
| v0.70.0 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 2022 T2 (2022.04.07), Imagem do Windows base do AKS (17763.2565.220408) | 1.21.10*, 1.22.7* | Exemplos de Modelos de API (Linux, Windows) |
| v0.71.0 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 3.º Trimestre de 2022 (2022.08.12), Imagem do Windows Base do AKS (17763.3232.220805) | 1.22.7*, 1.23.6* | Exemplos de Modelos de API (Linux, Windows) |
| v0.73.0 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 4.º Trimestre de 2022 (2022.11.02), Imagem do Windows Base do AKS (17763.3532.221102) | 1.22.15*, 1.23.13* | Exemplos de Modelos de API (Linux, Windows) |
| v0.75.3 | Distribuição de Imagens do AKS Base Ubuntu 20.04-LTS (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 Modelos de API (Linux, Windows) |
| v0.76.0 | Distribuição de Imagens do AKS Base Ubuntu 20.04-LTS (2023.116.3), Contentor de Imagens do Windows Server 2019 Base do AKS (17763.4252.20231163) | 1.24.11**, 1.25.7** | Exemplos de Modelos de API (Linux, Windows) |
| v0.77.0 | Distribuição de Imagens do AKS Base Ubuntu 20.04-LTS (2023.206.1), Contentor de Imagens do Windows Server 2019 Base do AKS (17763.4645.20232061) | 1.25.7**, 1.26.6** | Exemplos de Modelos de API (Linux, Windows) |
| v0.78.0 | Distribuição de Imagens do AKS Base Ubuntu 20.04-LTS (2023.242.3), Contentor de Imagens do Windows Server 2019 Base do AKS (17763.4737.20232423) | 1.25.13**, 1.26.8** | Exemplos de Modelos de API (Linux, Windows) |
| v0.79.0 | Distribuição de Imagens do AKS Base Ubuntu 20.04-LTS (2023.296.1), Contentor de Imagens do Windows Server 2019 Base do AKS (17763.4974.20232961) | 1.26.9**, 1.27.6** | Exemplos de Modelos de API (Linux, Windows) |
| v0.80.2 | Distribuição de Imagens do AKS Base Ubuntu 20.04-LTS (2024.032.1), Contentor de Imagens do Windows Server 2019 Base do AKS (17763.5329.20240321) | 1.27.10**, 1.28.6** | Exemplos de Modelos de API (Linux, Windows) |
Nota
*A partir do Kubernetes v1.21, apenas o Fornecedor de Cloud para o Azure é suportado no Azure Stack Hub.
Nota
** A partir do Kubernetes v1.24, apenas o runtime do containerd contentor é suportado. Veja a secção Atualizar clusters do Kubernetes criados com o runtime de contentor do Docker para obter mais informações.
Planeamento de atualizações
O comando do motor upgrade do AKS automatiza totalmente o processo de atualização do cluster e processa máquinas virtuais (VMs), redes, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de que revê as informações da nota de versão.
Novidades do AKSe 0.76.0
- Foi adicionado suporte para o Kubernetes v1.24.11 e v1.25.7.
- Pode encontrar outras funcionalidades na página do GitHub v0.76.0.
Novidades do AKSe 0.75.3 e superior
A versão v0.75.3 do Motor AKS e todas as versões futuras do Motor AKS no Azure Stack Hub serão provenientes 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 Motor AKS no Azure Stack Hub também foram alterados. 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 Motor AKS no Azure Stack Hub oferece o Ubuntu 20.04 LTS como imagem de base do Linux. A partir desta versão, o Ubuntu 18.04 já não é suportado. Veja Atualizar clusters do Kubernetes criados com a Distribuição do Ubuntu 18.04 para obter mais informações.
A partir do Kubernetes v1.24, apenas o containerd runtime é suportado. Veja Atualizar clusters do Kubernetes criados com o docker runtime para obter mais informações. Para a versão v0.75.3 do Motor AKS, os clusters com nós do Windows no Kubernetes v1.23 podem utilizar a imagem base do Windows com o runtime do Docker. Os clusters com nós do Windows no Kubernetes v1.24 podem utilizar a imagem base do Windows com o Runtime contentor.
Pode encontrar mais funcionalidades na página do GitHub v0.75.3.
Instruções para utilizar o motor AKS 0.70.0 e superior
A Microsoft atualizou o Fornecedor de Cloud do Azure na versão 0.70.0. O Fornecedor de Cloud do Azure é um componente principal partilhado entre o Azure do AKS e o motor do AKS no Azure Stack Hub.
Para utilizar o motor AKS 0.70.0 e superior:
Se estiver a tentar criar um novo cluster do Kubernetes pela primeira vez: utilize o modelo de API de exemplo fornecido para a versão adequada no motor do AKS e a tabela de mapeamento de imagens correspondente.
Se estiver a criar um novo cluster, mas quiser utilizar o modelo de API existente: Modifique o modelo de API ao seguir as instruções do Fornecedor de Cloud para o Azure . A não inclusão da nova definição resulta num erro de implementaçã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 só suporta controladores CSI, não o fornecedor de armazenamento em árvore legado. Para atualizar, siga as instruções em atualizar ao utilizar volumes de armazenamento.
Problemas conhecidos
- A implementação de vários serviços do Kubernetes em paralelo num único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos que implemente um serviço de cada vez.
- Uma vez que a ferramenta aks-engine é um repositório de código fonte partilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e pedidos Pull pode levá-lo a acreditar que a ferramenta suporta outras versões do Kubernetes e da plataforma de SO para além das listadas anteriormente. Pode ignorá-los e utilizar a tabela de versões acima como o guia oficial para esta atualização.
- O Motor AKS v0.67.0 utiliza a imagem do Windows errada ao implementar clusters do Windows. Utilize v0.70.0 para resolver este problema.
Referência
A lista seguinte é o conjunto completo de notas de versão para o Azure e o Azure Stack Hub combinados:
- 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 motor AKS.
Este artigo descreve os conteúdos do motor Azure Kubernetes Service (AKS) na atualização do Azure Stack Hub. A atualização inclui melhoramentos e correções para a versão mais recente do motor AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do motor do AKS para o Azure global.
Planeamento de atualizações
O comando do motor upgrade do AKS automatiza totalmente o processo de atualização do cluster. Processa máquinas virtuais (VMs), redes, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de que revê as informações da nota de versão.
Considerações sobre a atualização
- Está a utilizar os itens corretos do marketplace, o AKS Base Ubuntu 16.04-LTS ou a Distribuição de Imagens 18.04 ou o Windows Server Base do AKS para a sua versão do motor AKS? Pode encontrar as versões na secção "Transferir novas imagens e motor do AKS".
- Está a utilizar a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando implementou originalmente o cluster, este ficheiro foi gerado no diretório de saída. Veja os parâmetros de comando implementar Implementar um cluster do Kubernetes.
- Está a utilizar um computador fiável para executar o motor AKS e a partir do qual está a realizar operações de atualização?
- Se estiver a atualizar um cluster operacional com cargas de trabalho ativas, pode aplicar a atualização sem as afetar, partindo do princípio de que o cluster está sob carga normal. No entanto, deve ter um cluster de cópias de segurança caso seja necessário redirecionar os utilizadores para o mesmo. É altamente recomendado um cluster de cópias de segurança.
- Se possível, execute o comando a partir de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e potenciais 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 planearia a criação de mais algumas VMs durante o processo.
- Não estão planeadas atualizações do sistema ou tarefas agendadas.
- Configure uma atualização faseada num cluster configurado com os mesmos valores que o cluster de produção e teste a atualização no cluster de produção antes de o fazer no cluster de produção.
Utilizar o comando de atualização
Tem de utilizar o aks-engine upgrade comando conforme descrito em Atualizar um cluster do Kubernetes no Azure Stack Hub.
Interrupções de atualização
Por vezes, fatores inesperados interrompem a atualização do cluster. Pode ocorrer uma interrupção quando o motor do AKS comunica um erro ou algo acontece ao processo de execução do motor AKS. Examine a causa da interrupção, resolva-a e submeta 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 submeter novamente o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar a 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 demorar cerca de 5 horas a atualizar.
Transferir nova imagem e motor do AKS
Transfira as novas versões da imagem do Ubuntu base do AKS e do motor AKS.
Conforme explicado na documentação do motor do AKS para o Azure Stack Hub, a implementação de um cluster do Kubernetes requer:
- O binário aks-engine (obrigatório).
- Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS (preterida – já não é utilizada, altere o modelo de API para utilizar 18.04 em vez disso).
- Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS (necessária para agentes linux).
- Distribuição de Imagens do Windows Server Base do AKS (necessária para agentes do Windows).
Estão disponíveis novas versões destas imagens com esta atualização:
Verifique o motor do AKS e a tabela de mapeamento de versões do Azure Stack para obter as imagens de base do AKS necessárias.
Siga as instruções em Adicionar os pré-requisitos do motor do Azure Kubernetes Services (AKS) ao Marketplace do Azure Stack Hub.
O administrador do cluster do Kubernetes (normalmente um utilizador inquilino do Azure Stack Hub) tem de transferir o novo motor aks. Veja as instruções em Instalar o motor do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Pode seguir o mesmo processo que utilizou para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se utilizou o script get-akse.sh , siga os mesmos passos descritos em Instalar num ambiente ligado. O mesmo processo aplica-se se estiver a instalar num sistema Windows: instalar o motor do AKS no Windows no Azure Stack Hub.
Atualizar clusters do Kubernetes criados com a distribuição Ubuntu 16.04
A partir do Motor AKS v0.67.0, a distribuição Ubuntu 16.04 já não é uma opção suportada, uma vez que o SO atingiu o seu fim de vida. Para atualizar um cluster, certifique-se de que define a distribuição do SO como aks-ubuntu-18.04 no modelo de API de entrada, a gerada por aks-engine deploy e transmitida como entrada para aks-engine upgrade:
"masterProfile": {
"distro": "aks-ubuntu-18.04"
},
"agentPoolProfiles": [{
"distro": "aks-ubuntu-18.04"
}]
Motor AKS e mapeamento de versões 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 motor AKS v0.67.0
Pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela seguinte. Esta tabela aplica-se ao cluster do motor do AKS no Azure Stack Hub. Não utilize o comando aks-engine get-versions , que devolve versões suportadas 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 ficheiro JSON do modelo de API, especifique os valores de versão e versão na orchestratorProfile secção . Por exemplo, se estiver a planear implementar o Kubernetes 1.17.17, os dois valores seguintes têm de ser definidos (veja o exemplo kubernetes-azurestack.json):
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
Motor AKS e mapeamento de imagens correspondente
| Motor AKS | Imagem de base do AKS | Versões do Kubernetes | Exemplos de modelos 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 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, maio de 2020 (2020.05.13), Imagem do Windows base do AKS (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), Imagem de 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 do Windows base do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, janeiro de 2021 (2021.01.28), Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 1.º Trimestre de 2021 (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, Windows |
| v0.63.0 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), Imagem do Windows Base do AKS (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Exemplos de Modelos de API (Linux, Windows) |
| v0.67.0 | Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 3.º Trimestre de 2021 (2021.09.27), Imagem do Windows Base do AKS (17763.2213.210927) | 1.19.15, 1.20.11 | Exemplos de Modelos de API (Linux, Windows) |
Novidades
Se estiver interessado em participar numa pré-visualização privada, pode pedir acesso de pré-visualização.
As novas funcionalidades incluem:
- Suporte para o Kubernetes 1.19.15 e 1.20.11
Problemas conhecidos
- A implementação de vários serviços do Kubernetes em paralelo num único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos que implemente um serviço de cada vez.
- Uma vez que a ferramenta aks-engine é um repositório de código fonte partilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e pedidos Pull pode levá-lo a acreditar que a ferramenta suporta outras versões do Kubernetes e da plataforma de SO para além das listadas anteriormente. Pode ignorá-los e utilizar a tabela de versões acima como o guia oficial para esta atualização.
Referência
A lista seguinte é o conjunto completo de notas de versão para o Azure e o Azure Stack Hub combinados:
- 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 motor AKS.
Este artigo descreve os conteúdos do motor Azure Kubernetes Service (AKS) na atualização do Azure Stack Hub. A atualização inclui melhoramentos e correções para a versão mais recente do motor AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do motor do AKS para o Azure global.
Planeamento de atualizações
O comando do motor upgrade do AKS automatiza totalmente o processo de atualização do cluster e processa máquinas virtuais (VMs), redes, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de que revê as informações da nota de versão.
Considerações sobre a atualização
- Está a utilizar os itens corretos do marketplace, o AKS Base Ubuntu 16.04-LTS ou a Distribuição de Imagens 18.04 ou o Windows Server Base do AKS para a sua versão do motor AKS? Pode encontrar as versões na secção "Transferir novas imagens e motor do AKS".
- Está a utilizar a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando implementou originalmente o cluster, este ficheiro foi gerado no diretório de saída. Veja os parâmetros de comando implementar Implementar um cluster do Kubernetes.
- Está a utilizar um computador fiável para executar o motor AKS e a partir do qual está a realizar operações de atualização?
- Se estiver a atualizar um cluster operacional com cargas de trabalho ativas, pode aplicar a atualização sem as afetar, partindo do princípio de que o cluster está sob carga normal. No entanto, deve ter um cluster de cópias de segurança caso seja necessário redirecionar os utilizadores para o mesmo. É altamente recomendado um cluster de cópias de segurança.
- Se possível, execute o comando a partir de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e potenciais 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 planearia a criação de mais algumas VMs durante o processo.
- Não estão planeadas atualizações do sistema ou tarefas agendadas.
- Configure uma atualização faseada num cluster configurado com os mesmos valores que o cluster de produção e teste a atualização no cluster de produção antes de o fazer no cluster de produção.
Utilizar o comando de atualização
Tem de utilizar o aks-engine upgrade comando conforme descrito em Atualizar um cluster do Kubernetes no Azure Stack Hub.
Interrupções de atualização
Por vezes, fatores inesperados interrompem a atualização do cluster. Pode ocorrer uma interrupção quando o motor do AKS comunica um erro ou algo acontece ao processo de execução do motor AKS. Examine a causa da interrupção, resolva-a e submeta 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 submeter novamente o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar a 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 demorar cerca de 5 horas a atualizar.
Transferir nova imagem e motor do AKS
Transfira as novas versões da imagem do Ubuntu base do AKS e do motor AKS.
Conforme explicado na documentação do motor do AKS no Azure Stack Hub, a implementação de um cluster do Kubernetes requer:
- O binário aks-engine (obrigatório).
- Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS (preterida – já não é utilizada, altere o modelo de API para utilizar 18.04 em vez disso).
- Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS (necessária para agentes linux).
- Distribuição de Imagens do Windows Server Base do AKS (necessária para agentes do Windows).
Estão disponíveis novas versões com esta atualização:
O operador do Azure Stack Hub tem de transferir as novas imagens base do AKS para o marketplace de selos:
Distribuição de Imagens de Base do AKS Ubuntu 16.04-LTS, janeiro de 2021 (2021.01.28)
Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 1.º Trimestre de 2021 (2021.01.28),
Imagem de Base do AKS Windows (17763.1697.210129)
Siga as instruções em Adicionar os pré-requisitos do motor do Azure Kubernetes Services (AKS) ao Marketplace do Azure Stack Hub.
O administrador do cluster do Kubernetes (normalmente um utilizador inquilino do Azure Stack Hub) tem de transferir o novo motor aks. Veja as instruções em Instalar o motor do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Pode seguir o mesmo processo que utilizou para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se utilizou o script get-akse.sh , siga os mesmos passos descritos em Instalar num ambiente ligado. O mesmo processo aplica-se se estiver a instalar num sistema Windows: instalar o motor do AKS no Windows no Azure Stack Hub.
Motor AKS e mapeamento de versões 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 motor AKS v0.60.1
Pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela seguinte. Esta tabela aplica-se ao cluster do motor do AKS no Azure Stack Hub. Não utilize o comando aks-engine get-versions , que devolve versões suportadas 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 ficheiro JSON do modelo de API, especifique os valores de versão e versão na orchestratorProfile secção . Por exemplo, se estiver a planear implementar o Kubernetes 1.17.17, os dois valores seguintes têm de ser definidos (veja o exemplo kubernetes-azurestack.json):
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
Motor AKS e mapeamento de imagens correspondente
| Motor AKS | Imagem de base do AKS | Versões do Kubernetes | Exemplos de modelos 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 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, maio de 2020 (2020.05.13), Imagem do Windows base do AKS (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), Imagem de 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 do Windows base do AKS (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS, janeiro de 2021 (2021.01.28), Distribuição de Imagens do AKS Base Ubuntu 18.04-LTS, 1.º Trimestre de 2021 (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, Windows |
Novidades
Se estiver interessado em participar numa pré-visualização privada, pode pedir acesso de pré-visualização.
As novas funcionalidades incluem:
- Disponibilidade Geral do Ubuntu 18.04.
- Pré-visualização Pública da Rotação de Certificados #4214.
- T4 Nvidia GPU Private Preview #4259.
- Pré-visualização privada da integração do Azure Active Directory.
- Controlador CSI para Pré-visualização Privada de Blobs do Azure #712.
- Csi Driver Azure Disks Public Preview #712.
- Pré-visualização Pública do Controlador CSI NFS #712.
- Suporte para o Kubernetes 1. 17.17 #4188 e 1.18.15 #4187.
Problemas conhecidos
- A implementação de vários serviços do Kubernetes em paralelo num único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos que implemente um serviço de cada vez.
- Uma vez que a ferramenta aks-engine é um repositório de código fonte partilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e pedidos Pull pode levá-lo a acreditar que a ferramenta suporta outras versões do Kubernetes e da plataforma de SO para além das listadas anteriormente. Pode ignorá-los e utilizar a tabela de versões acima como o guia oficial para esta atualização.
Referência
A lista seguinte é o conjunto completo de notas de versão para o Azure e o Azure Stack Hub combinados:
Aplica-se à versão v0.55.4 do motor AKS.
Este artigo descreve os conteúdos do motor Azure Kubernetes Service (AKS) na atualização do Azure Stack Hub. A atualização inclui melhoramentos e correções para a versão mais recente do motor AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do motor do AKS para o Azure global.
Planeamento de atualizações
O comando do motor upgrade do AKS automatiza totalmente o processo de atualização do cluster e processa máquinas virtuais (VMs), redes, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de que revê as informações da nota de versão.
Considerações sobre a atualização
- Está a utilizar o item de marketplace correto, Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS para a sua versão do motor AKS? Pode encontrar as versões na secção "Transferir nova imagem e motor AKS".
- Está a utilizar a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando implementou originalmente o cluster, este ficheiro foi gerado no diretório de saída. Veja os parâmetros de comando implementar Implementar um cluster do Kubernetes.
- Está a utilizar um computador fiável para executar o motor do AKS e a partir do qual está a realizar operações de atualização?
- Se estiver a atualizar um cluster operacional com cargas de trabalho ativas, pode aplicar a atualização sem as afetar, partindo do princípio de que o cluster está sob carga normal. No entanto, deve ter um cluster de cópias de segurança caso seja necessário redirecionar os utilizadores para o mesmo. É altamente recomendado um cluster de cópias de segurança.
- Se possível, execute o comando a partir de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e potenciais 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 planearia a criação de mais algumas VMs durante o processo.
- Não estão planeadas atualizações do sistema ou tarefas agendadas.
- Configure uma atualização faseada num cluster configurado com os mesmos valores que o cluster de produção e teste a atualização no cluster de produção antes de o fazer no cluster de produção.
Utilizar o comando de atualização
Tem de utilizar o aks-engine upgrade comando conforme descrito em Atualizar um cluster do Kubernetes no Azure Stack Hub.
Interrupções de atualização
Por vezes, fatores inesperados interrompem a atualização do cluster. Pode ocorrer uma interrupção quando o motor do AKS comunica um erro ou algo acontece ao processo de execução do motor AKS. Examine a causa da interrupção, resolva-a e submeta 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 submeter novamente o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar a 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 demorar cerca de 5 horas a atualizar.
Transferir nova imagem e motor do AKS
Transfira as novas versões da Imagem do Ubuntu base do AKS e do motor AKS.
Conforme explicado na documentação do motor do AKS no Azure Stack Hub, a implementação de um cluster do Kubernetes requer dois componentes principais:
- O binário aks-engine (obrigatório).
- Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS
Estão disponíveis novas versões destas imagens com esta atualização:
O operador do Azure Stack Hub tem de transferir uma nova imagem do Ubuntu base do AKS para o marketplace de selos:
Nome: Distribuição de Imagens do Ubuntu Base do AKS 16.04-LTS, setembro de 2020 (2020.09.14)
Versão: 2020.09.14
Siga as instruções em Adicionar os pré-requisitos do motor do Azure Kubernetes Services (AKS) ao Marketplace do Azure Stack Hub.
O administrador do cluster do Kubernetes (normalmente um utilizador inquilino do Azure Stack Hub) tem de transferir o novo motor aks. Veja as instruções em Instalar o motor do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Pode seguir o mesmo processo que utilizou para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se utilizou o script get-akse.sh , siga os mesmos passos descritos em Instalar num ambiente ligado. O mesmo processo aplica-se se estiver a instalar num sistema Windows: instalar o motor do AKS no Windows no Azure Stack Hub.
Motor AKS e mapeamento de versões 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 motor AKS v0.55.4
Pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela seguinte. Esta tabela aplica-se ao cluster do motor do AKS no Azure Stack Hub. Não utilize o comando aks-engine get-versions , que devolve versões suportadas 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 ficheiro JSON do modelo de API, especifique os valores de versão e versão na orchestratorProfile secção . Por exemplo, se estiver a planear implementar o Kubernetes 1.17.17, os dois valores seguintes têm de ser definidos (veja o exemplo kubernetes-azurestack.json):
- "orchestratorRelease": "1.16",
- "orchestratorVersion": "1.16.14"
Motor AKS e mapeamento de imagens 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 modelos de API (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Exemplos de modelos de API (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Exemplos de modelos de API (Linux, Windows) |
Novidades
- Atualizar o VHD do 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 Windows VHD para agosto #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 do registo #3693
- Atualiza o CoreDNS para v1.7.0 #3608
- Utilizar pacotes moby 19.03.x #3549
- Correções para a estratégia de atualização azure-cni #3571
Problemas conhecidos
- A implementação de vários serviços do Kubernetes em paralelo num único cluster pode levar a um erro na configuração básica do balanceador de carga. Recomendamos que implemente um serviço de cada vez.
- Quando executa aks-engine
get-versions, a saída produz informações aplicáveis ao Azure e ao Azure Stack Hub. No entanto, não existe uma forma explícita de discernir o que corresponde ao Azure Stack Hub. Não utilize este comando para determinar que versões estão disponíveis para atualização. Utilize a tabela de referência de atualização descrita na secção anterior. - Uma vez que a ferramenta aks-engine é um repositório de código fonte partilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e pedidos Pull pode levá-lo a acreditar que a ferramenta suporta outras versões do Kubernetes e da plataforma de SO para além das listadas anteriormente. Pode ignorá-los e utilizar 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 para o Azure e o Azure Stack Hub combinado:
- 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 motor AKS.
Este artigo descreve os conteúdos do motor Azure Kubernetes Service (AKS) na atualização do Azure Stack Hub. A atualização inclui melhoramentos e correções para a versão mais recente do motor AKS direcionado para a plataforma do Azure Stack Hub. Este artigo não se destina a documentar as informações de versão do motor do AKS para o Azure global.
Planeamento de atualizações
O comando do motor upgrade do AKS automatiza totalmente o processo de atualização do cluster e processa máquinas virtuais (VMs), redes, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, certifique-se de que revê as informações da nota de versão.
Considerações sobre a atualização
- Está a utilizar o item de marketplace correto, Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS para a sua versão do motor AKS? Pode encontrar as versões na secção Transferir as novas versões da Imagem do Ubuntu base do AKS e do motor AKS.
- Está a utilizar a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando implementou originalmente o cluster, este ficheiro foi gerado no diretório de saída. Veja os parâmetros de comando implementar Implementar um cluster do Kubernetes.
- Está a utilizar um computador fiável para executar o motor AKS e a partir do qual está a realizar operações de atualização?
- Se estiver a atualizar um cluster operacional com cargas de trabalho ativas, pode aplicar a atualização sem as afetar, assumindo que o cluster está sob carga normal. No entanto, deve ter um cluster de cópias de segurança no caso de ser necessário redirecionar os utilizadores para o mesmo. É altamente recomendado um cluster de cópias de segurança.
- Se possível, execute o comando a partir de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e potenciais 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 planearia a criação de mais algumas VMs durante o processo.
- Não estão planeadas atualizações do sistema ou tarefas agendadas.
- Configure uma atualização faseada num cluster configurado com os mesmos valores que o cluster de produção e teste a atualização no mesmo antes de o fazer no cluster de produção.
Utilizar o comando de atualização
Tem de utilizar o aks-engine upgrade comando conforme descrito em Atualizar um cluster do Kubernetes no Azure Stack Hub.
Interrupções de atualização
Por vezes, fatores inesperados interrompem a atualização do cluster. Pode ocorrer uma interrupção quando o motor do AKS comunica um erro ou algo acontece ao processo de execução do motor AKS. Examine a causa da interrupção, resolva-a e submeta 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 submeter novamente o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar a conclusão.
Tempo de atualização estimado
O tempo estimado de atualização é de 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode demorar cerca de 5 horas a atualizar.
Transferir nova imagem e motor do AKS
Transfira as novas versões da Imagem do Ubuntu base do AKS e do motor AKS.
Conforme explicado na documentação do motor do AKS no Azure Stack Hub, a implementação de um cluster do Kubernetes requer dois componentes principais:
- O binário aks-engine (obrigatório).
- Distribuição de imagens do Ubuntu Base do AKS 16.04-LTS.
Estão disponíveis novas versões com esta atualização:
O operador do Azure Stack Hub tem de transferir as novas imagens base do AKS para o marketplace de selos:
Nome:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020Versão:
2020.03.19Siga as instruções em Adicionar os pré-requisitos do motor do Azure Kubernetes Services (AKS) ao Marketplace do Azure Stack Hub.
O administrador do cluster do Kubernetes (normalmente um utilizador inquilino do Azure Stack Hub) tem de transferir o novo motor aks. Veja as instruções em Instalar o motor do AKS no Linux no Azure Stack Hub (ou artigo equivalente do Windows). Pode seguir o mesmo processo que utilizou para instalar o cluster pela primeira vez. A atualização substitui o binário anterior. Por exemplo, se utilizou o script get-akse.sh , siga os mesmos passos descritos em Instalar num ambiente ligado. O mesmo processo aplica-se se estiver a instalar num sistema Windows: instale o motor do AKS no Windows no Azure Stack Hub.
Caminho de atualização da versão do Kubernetes
Pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela seguinte. Esta tabela aplica-se ao cluster de motores do AKS no Azure Stack Hub. Não utilize o comando aks-engine get-versions , que devolve versões suportadas 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 a versão 1.15.10 do Kubernetes (#2834). Quando implementa um novo cluster, no modelo de API .json ficheiro (também conhecido como ficheiro 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 seguinte formato. Para obter um ficheiro de definição de cluster de exemplo, veja kubernetes-azurestack.json.
"orchestratorRelease": "1.15,"orchestratorVersion": "1.15.10"
Nota
Se a versão do Kubernetes não for explicitamente fornecida no modelo de API .json ficheiro, será utilizada a versão 1.15 (#2932) e o orchestratorVersion será predefinido para 1.15.11, o que resultará num erro durante a implementação do cluster.
Com o aks-engine v0.43.1, as definições de frequência predefinidas para o fornecedor de cloud efetuar o ciclo de controlo e outras tarefas não funcionam bem com o Azure Stack Hub Resource Manager limites de limiar para pedidos recebidos. Esta atualização altera as predefinições do Azure Stack Hub para reduzir a carga de repetição para o Azure Stack Hub Resource Manager (#2861).
O novo passo de verificação no aks-engine resultará na paragem da execução ou na apresentação de avisos se o modelo de API .json ficheiro contiver propriedades não suportadas pelo Azure Stack Hub (#2717).
Com uma nova entrada de verificação, o motor aks validará a disponibilidade da versão da imagem base do AKS necessária para a versão da execução do motor aks (#2342). Isto ocorrerá depois de analisar o modelo de API .json ficheiro e antes de chamar o Resource Manager do Azure Stack Hub.
A nova opção aks-engine "--control-plane-only" no
upgradecomando permite ao utilizador atualizar as operações para direcionar apenas o Máquinas Virtuais principal (#2635).Atualizações para o Kernel do Linux versão 4.15.0-1071-azure para Ubuntu 16.04-LTS. Consulte "Pacote: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [segurança]" 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 controlo do cluster do Kubernetes. Pode executá-lo por SSH num modelo global.
Atualizações para o suplemento Azure Container Monitor com a versão mais recente de fevereiro de 2020 (#2850).
Atualização da
corednsversão v1.6.6 (#2555).Atualize
etcdpara a versão 3.3.18 (#2462).Atualize
mobypara a versão 3.0.11 (#2887).Com esta versão, o Motor AKS corta a dependência de
k8s.gcr.ioaté agora utilizar o oficialKubernetes MCR registry @ mcr.microsoft.comao criar as respetivas imagens (#2722).
Problemas conhecidos
- A implementação de vários serviços do Kubernetes em paralelo dentro de um único cluster pode originar um erro na configuração básica do balanceador de carga. Recomendamos a implementação de um serviço de cada vez.
- A execução do motor
get-versionsaks produz informações aplicáveis ao Azure e ao Azure Stack Hub. No entanto, não existe uma forma explícita de discernir o que corresponde ao Azure Stack Hub. Não utilize este comando para determinar que versões estão disponíveis para atualização. Utilize a tabela de referência de atualização descrita na secção anterior. - Uma vez que a ferramenta aks-engine é um repositório de código fonte partilhado no Azure e no Azure Stack Hub, examinar as muitas notas de versão e pedidos Pull pode levá-lo a acreditar que a ferramenta suporta outras versões do Kubernetes e da plataforma do SO para além das listadas anteriormente. Pode ignorá-los e utilizar a tabela de versões acima como o guia oficial para esta atualização.
Referência
Segue-se uma lista de alguns dos erros 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 de versão incluem o Azure e o Azure Stack Hub.
Correções de erros
userAssignedIdentityIdno Windows azure.json aspas em falta (#2327)Os suplementos
update configsão apenas de atualização (#2282)Tempo limite de aumento para obter o IP de gestão nos nós do Windows (#2284)
Adicionar 1.0.28 ficheiro de .zip da CNI do Azure ao VHD do Windows (#2268)
Ordem de predefinição correta para a definição
IPAddressCount(#2358)Atualizar para utilizar o yaml omsagent único para todas as versões 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 combinado:
- 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
Passos seguintes
- Leia mais sobre o motor do AKS no Azure Stack Hub
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários