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

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

Este artigo descreve o conteúdo do mecanismo do AKS (Serviço de Kubernetes do Azure) 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 direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações sobre lançamentos do mecanismo AKS para o Azure global.

Considerações sobre atualização

• Você está usando os itens corretos do marketplace, AKS Base Ubuntu 20.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 AKS.
• Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Implantar um cluster do Kubernetes.
• Você está usando um computador confiável para operar o mecanismo do AKS e a partir do qual está realizando operações de atualização?
• Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
• Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
• Certifique-se de que sua assinatura tenha 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 são planejadas.
• Configure uma atualização em etapas em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização 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 reenvie o mesmo upgrade comando para continuar o processo de atualização. O comando upgrade é idempotente e deverá retomar a atualização do cluster assim que o comando for reenviado. 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 AKS

Baixe as novas versões da imagem base do Ubuntu do AKS e do mecanismo AKS.

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

• O binário aks-engine (obrigatório).
• Distribuição de imagem do AKS Base Ubuntu 16.04-LTS (preterida – não usar mais, alterar no modelo de API para usar o 22.04).
• Distribuição de imagem do AKS Base Ubuntu 18.04-LTS (preterida – não usar mais, alterar no modelo de API para usar o 22.04).
• Distribuição de imagem do AKS Base Ubuntu 20.04-LTS (preterida – não usar mais, alterar no modelo de API para usar o 22.04).
• Distribuição de imagem do AKS Base Ubuntu 22.04-LTS (necessária para agentes do Linux).
• Imagem base do Windows Server do AKS (uma das seguintes imagens é necessária para agentes do Windows):
  • Imagem do AKS Base Windows Server em Contêiner.
  • Docker da Imagem do AKS Base Windows Server

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 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. Consulte 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 Ubuntu 16.04

A partir do AKS Engine v0.63.0, a distribuição do Ubuntu 16.04 não é mais uma opção com suporte, pois o sistema operacional atingiu o fim da vida útil. Para o mecanismo AKS v0.67.0 ou versões posteriores, a atualização do aks-engine substitui automaticamente o valor da distribuição sem suporte aks-ubuntu-16.04 por aks-ubuntu-18.04. Para o AKS Engine v0.75.3 ou versões posteriores, se você estiver utilizando o Kubernetes v1.24 ou superior, a atualização do aks-engine-azurestack substituirá automaticamente o valor de distribuição não suportado aks-ubuntu-16.04 por aks-ubuntu-20.04.

Atualizando clusters do Kubernetes criados com a distribuição Ubuntu 18.04 ou 20.04

A partir do AKS Engine v0.75.3, a distribuição do Ubuntu 18.04 não é mais uma opção com suporte, pois o sistema operacional atingiu o fim da vida útil. A partir do AKS Engine v0.82.2, a distribuição Ubuntu 20.04 não é mais uma opção com suporte. Para essas versões do mecanismo AKS, a atualização de aks-engine-azurestack substitui automaticamente o valor de distribuição sem suporte aks-ubuntu-18.04 ou aks-ubuntu-20.04 com aks-ubuntu-20.04 ou aks-ubuntu-22.04, respectivamente.

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 compatível. Consulte as notas de 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 do aks-engine-azurestack substitui automaticamente o valor da distribuição sem suporte dockercontainerRuntime por containerd.

Para a versão do mecanismo AKS v0.75.3, os clusters com nós do Windows no Kubernetes v1.23 podem usar a imagem base do Windows com o runtime do Docker. Os clusters com nós do Windows no Kubernetes v1.24 podem usar a imagem base do Windows com o runtime do Containerd.

Mapeamento de versão do AKS Engine e do Azure Stack

*Com suporte. Para obter mais informações, consulte a política de suporte de versão do AKS Engine.

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.

Planejamento de atualização

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, certifique-se de revisar as informações da nota de versão.

Novidades no AKSe 0.82.2

• Adicionado suporte para o Kubernetes 1.29.15 e 1.30.10.
• A versão v0.82.2 do Mecanismo do AKS no Azure Stack Hub oferece o Ubuntu 22.04 LTS como sua imagem base do Linux. A partir desta versão, o Ubuntu 20.04 não tem mais suporte.
• Você pode encontrar outros recursos na página do GitHub v0.82.2.

Novidades no 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. 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 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 algum problema.

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 é mais suportado. 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, somente o containerd runtime é compatível. Consulte Atualização de clusters do Kubernetes criados com o runtime do Docker para obter mais informações. Para a versão do mecanismo AKS v0.75.3, os clusters com nós do Windows no Kubernetes v1.23 podem usar a imagem base do Windows com o runtime do Docker. Os clusters com nós do Windows no Kubernetes v1.24 podem usar a imagem base do Windows com o ambiente de execução do Containerd.

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

Instruções para usar o mecanismo 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 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 em incluir a nova configuração resulta em um erro de implantação.

• Se você estiver usando volumes de armazenamento: verifique se você está usando o driver AzureDiskCSI . A versão 0.70.0 e superior oferece suporte apenas a drivers CSI, não ao provedor de armazenamento em árvore herdado. Para atualizar, siga as instruções em atualizar enquanto usa 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. Recomendamos 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 pull requests pode levar você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e às plataformas do sistema operacional além daquelas listadas anteriormente. Você pode ignorá-los e usar a tabela da versão anterior como o guia oficial para esta atualização.
• AKS Engine v0.67.0 usa a imagem errada do Windows ao implantar clusters Windows. Use a v0.70.0 para resolver esse problema.

Falha na reinicialização do daemon Chrony

O daemon chrony em um nó Linux pode falhar ao reiniciar com a mensagem de erro: "Could not open /dev/ptp_hyperv: No such file or directory".

A solução alternativa para esse problema é reinicializar manualmente os nós do Linux afetados. Essa operação regenera o symlink /dev/ptp_hyperv e permite que o daemon chrony seja reiniciado com êxito.

Referência

A lista a seguir é o conjunto combinado de notas de versão para o mecanismo do AKS no Azure e no Azure Stack Hub:

• 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
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.2
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.3
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.81.1
• (Versão do patch) https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.81.2
• https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.82.1
• (Versão do patch) https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.82.2
• https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.83.0
• (Versão do patch) https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.83.1
• https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.84.0

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

Este artigo descreve o conteúdo do mecanismo do AKS (Serviço de Kubernetes do Azure) 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 direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações sobre lançamentos do mecanismo AKS para o Azure global.

Planejamento de atualização

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, certifique-se de revisar 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 AKS".
• Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Implantar um cluster do Kubernetes.
• Você está usando um computador confiável para rodar o motor AKS e a partir do qual realiza operações de atualização?
• Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
• Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
• Certifique-se de que sua assinatura tenha 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 são planejadas.
• Configure uma atualização em etapas em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização 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 reenvie o mesmo upgrade comando para continuar o processo de atualização. O comando upgrade é idempotente e deverá retomar a atualização do cluster assim que o comando for reenviado. 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 AKS

Baixe as novas versões da imagem base do Ubuntu do AKS e do mecanismo AKS.

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

• O binário aks-engine (obrigatório).
• Imagem de distribuição do AKS Base Ubuntu 16.04-LTS (preterida – não é mais usada, altere o modelo de API para usar a versão 18.04).
• Distribuição de imagem do AKS Base Ubuntu 18.04-LTS (necessária para agentes do Linux).
• Distribuição de imagem do Windows Server do AKS base (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 do AKS necessárias.

  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. Consulte 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 Ubuntu 16.04

A partir do AKS Engine v0.67.0, a distribuição do Ubuntu 16.04 não é mais uma opção com suporte, pois o sistema operacional atingiu o fim de sua vida útil. Para atualizar um cluster, certifique-se de definir a distribuição do SO como aks-ubuntu-18.04 no seu modelo de API de entrada, 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 AKS Engine e do Azure Stack

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

Você pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela a seguir. Esta tabela se aplica ao cluster do mecanismo 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.

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

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

Mecanismo do AKS e mapeamento de imagem correspondente

Novidades

Se você estiver interessado em participar de uma visualização privada, poderá solicitar acesso à visualização.

Os novos recursos incluem:

• Suporte para Kubernetes 1.19.15 e 1.20.11

Problemas conhecidos

• A implantação de 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. Recomendamos 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 das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

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

• 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 do AKS (Serviço de Kubernetes do Azure) 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 direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações sobre lançamentos do mecanismo AKS para o Azure global.

Planejamento de atualização

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, certifique-se de revisar 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 AKS".
• Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Implantar um cluster do Kubernetes.
• Você está usando um computador confiável para rodar o motor AKS e a partir do qual realiza operações de atualização?
• Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
• Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
• Certifique-se de que sua assinatura tenha 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 são planejadas.
• Configure uma atualização em etapas em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização 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 reenvie o mesmo upgrade comando para continuar o processo de atualização. O comando upgrade é idempotente e deverá retomar a atualização do cluster assim que o comando for reenviado. 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 AKS

Baixe as novas versões da imagem base do Ubuntu do AKS e do mecanismo AKS.

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

• O binário aks-engine (obrigatório).
• Imagem de distribuição do AKS Base Ubuntu 16.04-LTS (preterida – não é mais usada, altere o modelo de API para usar a versão 18.04).
• Distribuição de imagem do AKS Base Ubuntu 18.04-LTS (necessária para agentes do Linux).
• Distribuição de imagem do Windows Server do AKS base (necessária para agentes do Windows).

Novas versões 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 do AKS Base Ubuntu 18.04-LTS, T1 de 2021 (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 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. Consulte 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 AKS Engine e do Azure Stack

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

Você pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela a seguir. Esta tabela se aplica ao cluster do mecanismo 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.

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

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

Mecanismo do AKS e mapeamento de imagem correspondente

Novidades

Se você estiver interessado em participar de uma visualização privada, poderá solicitar acesso à visualização.

Os novos recursos incluem:

• Disponibilidade geral do Ubuntu 18.04.
• Visualização pública de rotação de certificados #4214.
• T4 Nvidia GPU Private Preview nº 4259.
• Versão prévia privada da integração do Azure Active Directory.
• Driver CSI para visualização privada de Blobs do Azure #712.
• Visualização pública dos discos do Azure do driver CSI #712.
• Visualização pública do NFS do driver CSI #712.
• Suporte para Kubernetes 1. 17.17 #4188 e 1.18.15 #4187.

Problemas conhecidos

• A implantação de 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. Recomendamos 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 das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

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

• https://github.com/Azure/aks-engine/releases/tag/v0.56.0
• https://github.com/Azure/aks-engine/releases/tag/v0.56.1
• https://github.com/Azure/aks-engine/releases/tag/v0.60.0
• https://github.com/Azure/aks-engine/releases/tag/v0.60.1

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

Este artigo descreve o conteúdo do mecanismo do AKS (Serviço de Kubernetes do Azure) 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 direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações sobre lançamentos do mecanismo AKS para o Azure global.

Planejamento de atualização

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, certifique-se de revisar as informações da nota de versão.

Considerações sobre atualização

• Você está usando o item correto do marketplace, AKS Base Ubuntu 16.04-LTS Image Distro 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 do comando deploy Implantar um cluster do Kubernetes.
• Você está usando um computador confiável para operar o mecanismo do AKS e a partir do qual está realizando operações de atualização?
• Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
• Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
• Certifique-se de que sua assinatura tenha 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 são planejadas.
• Configure uma atualização em etapas em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização 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 reenvie o mesmo upgrade comando para continuar o processo de atualização. O comando upgrade é idempotente e deverá retomar a atualização do cluster assim que o comando for reenviado. 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 AKS

Baixe as novas versões da imagem base do Ubuntu do AKS e do mecanismo 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 principais:

• 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 carimbos:

• Nome: Distribuição de imagem do AKS Base Ubuntu 16.04-LTS, 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. Consulte 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 AKS Engine e do Azure Stack

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

Você pode encontrar a versão atual e a versão de atualização do Azure Stack Hub na tabela a seguir. Esta tabela se aplica ao cluster do mecanismo 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.

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

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

Mecanismo do AKS e mapeamento de imagem correspondente

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 VHD do Windows 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 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 #3571

Problemas conhecidos

• A implantação de 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. Recomendamos implantar um serviço por vez.
• Quando você executa aks-engine get-versions, a saída produz informações aplicáveis ao Azure e ao Azure Stack Hub; no entanto, não há uma maneira explícita de discernir o que corresponde ao Azure Stack Hub. Não use esse 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 das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

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

• 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 do AKS (Serviço de Kubernetes do Azure) 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 direcionada à plataforma Azure Stack Hub. Este artigo não se destina a documentar as informações sobre lançamentos do mecanismo AKS para o Azure global.

Planejamento de atualização

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, certifique-se de revisar as informações da nota de versão.

Considerações sobre atualização

• Você está usando o item correto do marketplace, AKS Base Ubuntu 16.04-LTS Image Distro para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção Baixar a nova imagem base do Ubuntu do AKS e as versões do mecanismo AKS.
• Você está usando a especificação de cluster (apimodel.json) e o grupo de recursos corretos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte os parâmetros do comando deploy Implantar um cluster do Kubernetes.
• Você está usando um computador confiável para rodar o motor AKS e a partir do qual realiza operações de atualização?
• Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
• Se possível, execute o comando de uma VM no ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
• Certifique-se de que sua assinatura tenha 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 são planejadas.
• Configure uma atualização em etapas em um cluster configurado com os mesmos valores do cluster de produção e teste a atualização 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 reenvie o mesmo upgrade comando para continuar o processo de atualização. O comando upgrade é idempotente e deverá retomar a atualização do cluster assim que o comando for reenviado. 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 AKS

Baixe as novas versões da imagem base do Ubuntu do AKS e do mecanismo 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 principais:

• O binário aks-engine (obrigatório).
• Distribuição de imagem do AKS Base Ubuntu 16.04-LTS.

Novas versões 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. Consulte 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 do Azure Stack Hub na tabela a seguir. Esta tabela se aplica ao cluster do mecanismo 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.

Novidades

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

  • "orchestratorRelease": "1.15,

  • "orchestratorVersion": "1.15.10"

  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 será padronizado para 1.15.11, o que resultará em um erro durante a implantação do cluster.

• Com aks-engine v0.43.1, as configurações de frequência padrão para o provedor de nuvem executar seu loop de controle e outras tarefas não funcionam bem com os limites de limite do Azure Stack Hub Resource Manager para solicitações de entrada. 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 (#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 sem suporte do Azure Stack Hub (#2717).

• Com um novo processo de verificação, o aks-engine validará a disponibilidade da versão da imagem base do AKS necessária para a versão em execução do aks-engine (#2342). Isso ocorrerá após a análise do modelo de API .json arquivo e antes de chamar o Azure Stack Hub Resource Manager.

• A nova opção aks-engine "--control-plane-only" no comando upgrade permite que o usuário atualize as operações para direcionar apenas as máquinas virtuais mestras (#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 oferecer suporte às versões 1.14.8 e 1.15.10 do Kubernetes.

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

• Atualizações para o complemento Monitor de Contêiner do Azure com a versão mais recente de fevereiro de 2020 (#2850).

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

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

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

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

Problemas conhecidos

• A implantação de 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. Recomendamos 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á uma maneira explícita de discernir o que corresponde ao Azure Stack Hub. Não use esse 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 das listadas anteriormente. Você pode ignorá-los e usar a tabela de versões acima como o guia oficial para esta atualização.

Referência

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

Correções de bug

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

• update config Os complementos estão apenas disponíveis para atualização (#2282)

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

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

• Ordem correta dos padrões para configuração IPAddressCount (# 2358)

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

Notas de versão

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

• 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