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

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

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

Planejamento de atualizações

O comando de atualização do mecanismo do AKS automatiza totalmente o processo de atualização do cluster, ele cuida de VMs (máquinas virtuais), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.

Considerações sobre atualização

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

Usar o comando de atualização

Você precisará usar o comando de atualização do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um cluster do Kubernetes no Azure Stack Hub.

Interrupções de atualização

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

Tempo estimado de atualização

O tempo estimado é entre 12 e 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar aproximadamente cinco (5) horas para ser atualizado.

Instruções para usar o mecanismo do AKS 0.70.0 e superior

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 ao incluir a nova configuração resultará 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 dá suporte apenas a drivers CSI, não ao provedor de armazenamento na árvore herdado. Para atualizar, siga as instruções para atualizar ao usar volumes de armazenamento.

Baixar nova imagem e mecanismo do AKS

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

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

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

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

Atualizando clusters do Kubernetes criados com a distribuição do Ubuntu 16.04

Atualizando clusters do Kubernetes criados com a distribuição do Ubuntu 16.04 A partir do Mecanismo aks 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 da vida útil. Para atualizar um cluster, defina a distribuição aks-ubuntu-18.04 do sistema operacional como no modelo de API de entrada, aquele gerado por aks-engine deploy e passado como entrada para aks-engine upgrade.

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

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

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

Versão do Azure Stack Hub Versão do mecanismo do AKS
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0
2206 0.70.0, 0.71.0, 0.73.0

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

Encontre a versão atual e a versão de atualização na tabela do Azure Stack Hub a seguir. Não siga o comando o aks-engine get-versions, pois ele também inclui as versões com suporte no Azure global. A tabela de versão e atualização a seguir se aplica ao cluster do mecanismo do AKS 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 1.21.10
1.21.10 1.22.7
1.22.7 1.23.6
1.22.7, 1.22.15 1.23.13

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

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

Mecanismo do AKS e mapeamento de imagem correspondente

Mecanismo do AKS Imagem base do AKS Versões do Kubernetes Exemplos de modelo de API
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, 2019 de outubro (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, março de 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Aks Base Ubuntu 16.04-LTS Image Distro, May 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Aks Base Ubuntu 16.04-LTS Image Distro, August 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Aks Base Ubuntu 16.04-LTS Image Distro, september 2020 (2020.09.14), AKS Base Windows Image (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),
Aks Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Imagem de Windows base do AKS(17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 Aks Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), AKS Base Windows Image (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Exemplos de modelo de API (Linux, Windows)
v0.67.0 Aks Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 Exemplos de modelo de API (Linux, Windows)
v0.67.3 Aks Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27), AKS Base Windows Image (17763.2213.210927) 1.19.15, 1.20.11 Exemplos de modelo de API (Linux, Windows)
v0.70.0 Aks Base Ubuntu 18.04-LTS Image Distro, 2022 Q2 (2022.04.07), AKS Base Windows Image (17763.2565.220408) 1.21.10*, 1.22.7* Exemplos de modelo de API (Linux, Windows)
v0.71.0 Aks Base Ubuntu 18.04-LTS Image Distro, 2022 Q3 (2022.08.12), AKS Base Windows Image (17763.3232.220805) 1.22.7*, 1.23.6* Exemplos de modelo de API (Linux, Windows)
v0.73.0 Aks Base Ubuntu 18.04-LTS Image Distro, 2022 Q4 (2022.11.02), AKS Base Windows Image (17763.3532.221102) 1.22.15*, 1.23.13* Exemplos de modelo de API** (Linux, Windows)

Observação

**Há relatórios que sugerem que a atualização para a versão 5.4.0-1095-azure do kernel do Linux pode causar problemas com containerd. As imagens base do sistema operacional do Mecanismo do AKS não incluem essa versão do kernel. Instruções sobre como desabilitar atualizações automáticas até que uma correção esteja disponível podem ser encontradas aqui.

Observação

*A partir do Kubernetes v1.21, somente o Provedor de Nuvem para Azure tem suporte no Azure Stack Hub.

Novidades

Os novos recursos incluem:

  • Adicionado suporte para Kubernetes v1.22.15 e v1.23.13
  • Você pode encontrar recursos adicionais em v0.73.0.

Problemas conhecidos

  • Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço no momento.
  • Como a ferramenta aks-engine é um repositório de código-fonte de compartilhamento no Azure e no Azure Stack Hub. Examinar as muitas notas de versão e pull requests 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 acima, ignore-as e use a tabela de versão acima como o guia oficial para esta atualização.
  • O Mecanismo do AKS v0.67.0 usa a Imagem do Windows errada ao implantar clusters do Windows, os usuários devem usar v0.70.0 para resolver esse problema.

Referência

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

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

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

Atualizar o planejamento

O comando de atualização do mecanismo do AKS automatiza totalmente o processo de atualização do cluster, ele cuida de máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.

Considerações sobre atualização

  • Você está usando os itens corretos do marketplace, AKS Base Ubuntu 16.04-LTS ou 18.04 Image Distro ou AKS Base Windows Server para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção "Baixar novas imagens e mecanismo do AKS".
  • Você está usando a especificação de cluster (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. Confira os parâmetros de comando implantar Implantar um cluster do Kubernetes.
  • Você está usando um computador confiável para executar o mecanismo do AKS e do qual está executando operações de atualização?
  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
  • Verifique se sua assinatura tem cota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas planeje que mais algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas estão planejadas.
  • Configure uma atualização em estágios em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.

Usar o comando de atualização

Você precisará usar o comando de atualização do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um cluster do Kubernetes no Azure Stack Hub.

Interrupções de atualização

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

Tempo estimado de atualização

O tempo estimado é entre 12 e 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar aproximadamente cinco (5) horas para ser atualizado.

Baixar nova imagem e mecanismo do AKS

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

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

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

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

Atualizando clusters do Kubernetes criados com a distribuição do Ubuntu 16.04

Atualizando clusters do Kubernetes criados com a distribuição do Ubuntu 16.04 A partir do Mecanismo aks 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 da vida útil. Para atualizar um cluster, defina a distribuição aks-ubuntu-18.04 do sistema operacional como no modelo de API de entrada, aquele gerado por aks-engine deploy e passado como entrada para aks-engine upgrade.

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

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

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

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

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

Encontre a versão atual e a versão de atualização na tabela do Azure Stack Hub a seguir. Não siga o comando o aks-engine get-versions, pois ele também inclui as versões com suporte no Azure global. A tabela de versão e atualização a seguir se aplica ao cluster do mecanismo do AKS no Azure Stack Hub.

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

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

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

Mecanismo do AKS e mapeamento de imagem correspondente

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

Novidades

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

Os novos recursos incluem:

  • Suporte para Kubernetes 1.19.15 e 1.20.11

Problemas conhecidos

  • Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço no momento.
  • Como a ferramenta aks-engine é um repositório de código-fonte de compartilhamento no Azure e no Azure Stack Hub. Examinar as muitas notas de versão e pull requests 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 acima, ignore-as e use a tabela de versão acima como o guia oficial para esta atualização.

Referência

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

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

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

Atualizar o planejamento

O comando de atualização do mecanismo do AKS automatiza totalmente o processo de atualização do cluster, ele cuida de máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.

Considerações sobre atualização

  • Você está usando os itens corretos do marketplace, AKS Base Ubuntu 16.04-LTS ou 18.04 Image Distro ou AKS Base Windows Server para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção "Baixar novas imagens e mecanismo do AKS".
  • Você está usando a especificação de cluster (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. Confira os parâmetros de comando implantar Implantar um cluster do Kubernetes.
  • Você está usando um computador confiável para executar o mecanismo do AKS e do qual está executando operações de atualização?
  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.
  • Verifique se sua assinatura tem cota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas 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 que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.

Usar o comando de atualização

Você precisará usar o comando de atualização do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um cluster do Kubernetes no Azure Stack Hub.

Interrupções de atualização

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

Tempo estimado de atualização

O tempo estimado é entre 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar aproximadamente cinco (cinco) horas para ser atualizado.

Baixar nova imagem e mecanismo do AKS

Baixe as novas versões do mecanismo aks base Ubuntu Image e AKS.

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

  • O binário aks-engine (obrigatório)
  • Distribuição de imagem do AKS Base Ubuntu 16.04-LTS (obrigatório)
  • Distribuição de imagem do AKS Base Ubuntu 18.04-LTS (opcional)
  • Distribuição de imagens do Windows Server base do AKS (opcional)

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

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

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

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

Encontre a versão atual e a versão de atualização na tabela do Azure Stack Hub a seguir. Não siga o comando o aks-engine get-versions, pois ele também inclui as versões com suporte no Azure global. A tabela de versão e atualização a seguir se aplica ao cluster do mecanismo do AKS no Azure Stack Hub.

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

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

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

Mecanismo do AKS e mapeamento de imagem correspondente

Mecanismo do AKS Imagem base do AKS Versões do Kubernetes Exemplos de modelo de API
v0.43.1 AKS Base Ubuntu 16.04-LTS Image Distro, 2019 de outubro (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 AKS Base Ubuntu 16.04-LTS Image Distro, março de 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Aks Base Ubuntu 16.04-LTS Image Distro, May 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Aks Base Ubuntu 16.04-LTS Image Distro, August 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Aks Base Ubuntu 16.04-LTS Image Distro, september 2020 (2020.09.14), AKS Base Windows Image (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),
Aks Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Imagem de Windows base do AKS(17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Novidades

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

Os novos recursos incluem:

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

Problemas conhecidos

  • Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço no momento.
  • Como a ferramenta aks-engine é um repositório de código-fonte de compartilhamento no Azure e no Azure Stack Hub. Examinar as muitas notas de versão e pull requests 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 acima, ignore-as e use a tabela de versão acima como o guia oficial para esta atualização.

Referência

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

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

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

Atualizar o planejamento

O comando de atualização do mecanismo do AKS automatiza totalmente o processo de atualização do cluster, ele cuida de máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações da nota de versão.

Considerações sobre atualização

  • Você está usando o item correto do marketplace, a Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção "Baixar 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. Confira os parâmetros de deploy comando Implantar um cluster do Kubernetes.

  • Você está usando um computador confiável para executar o mecanismo do AKS e do qual está executando operações de atualização?

  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja a necessidade de redirecionar os usuários para ele. Um cluster de backup é altamente recomendado.

  • Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.

  • Verifique se sua assinatura tem cota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas 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 que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.

Usar o comando de atualização

Você precisará usar o comando do mecanismo upgrade do AKS, conforme descrito no artigo a seguir Atualizar um cluster do Kubernetes no Azure Stack Hub.

Interrupções de atualização

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

Tempo estimado de atualização

O tempo estimado é entre 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar aproximadamente cinco (cinco) horas para ser atualizado.

Baixar nova imagem e mecanismo do AKS

Baixe as novas versões do mecanismo aks base Ubuntu Image e AKS.

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

  • O binário aks-engine

  • Distribuição de imagem do AKS Base Ubuntu 16.04-LTS

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

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

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

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

Encontre a versão atual e a versão de atualização na tabela do Azure Stack Hub a seguir. Não siga o comando o aks-engine get-versions, pois ele também inclui as versões com suporte no Azure global. A tabela de versão e atualização a seguir se aplica ao cluster do mecanismo do AKS no Azure Stack Hub.

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

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

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

Mecanismo do AKS e mapeamento de imagem correspondente

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

Novidades

  • Atualizar o VHD linux do Azure Stack para 2020.09.14 #3828
  • Adiciona suporte para K8s v1.17.11 no Azure Stack #3702
  • Adiciona suporte para K8s v1.16.14 no Azure Stack #3704
  • Atualização do VHD do Linux para 2020.09.14 #3750
  • Atualização do VHD do Windows para agosto de 3730
  • Atualiza o servidor de métricas do Kubernetes para v0.3.7 #3669
  • Atualiza a versão do Docker para corrigir o problema de rotação de log #3693
  • Atualiza o CoreDNS para v1.7.0 #3608
  • Usar pacotes moby 19.03.x #3549
  • Correções na estratégia de atualização do azure-cni nº 3571

Problemas conhecidos

  • Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. Implantando um serviço no momento, se possível.
  • A execução de versões get do aks-engine produzirá 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 descobrir quais versões estão disponíveis para atualização. Use a tabela de referência de atualização descrita acima.
  • Como a ferramenta aks-engine é um repositório de código-fonte de compartilhamento no Azure e no Azure Stack Hub. Examinar as muitas notas de versão e pull requests 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 acima, ignore-as e use a tabela de versão acima como o guia oficial para esta atualização.

Referência

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

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

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

Atualizar o planejamento

O comando de atualização do mecanismo do AKS automatiza totalmente o processo de atualização do cluster, ele cuida de máquinas virtuais (VMs), rede, armazenamento, Kubernetes e tarefas de orquestração. Antes de aplicar a atualização, examine as informações neste artigo.

Considerações sobre atualização

  • Você está usando o item correto do marketplace, a Distribuição de Imagens do AKS Base Ubuntu 16.04-LTS para sua versão do mecanismo do AKS? Você pode encontrar as versões na seção Baixar as novas versões base do mecanismo Ubuntu Image e AKS do AKS.

  • Você está usando a especificação de cluster correta (apimodel.json) e o grupo de recursos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Confira os parâmetros de comando "implantar" Implantar um cluster do Kubernetes.

  • Você está usando um computador confiável para executar o mecanismo do AKS e do qual está executando operações de atualização?

  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster esteja sob carga normal. No entanto, você deve ter um cluster de backup caso haja a necessidade de redirecionar os usuários para ele.

  • Se possível, execute o comando de uma VM dentro do ambiente do Azure Stack Hub para diminuir os saltos de rede e possíveis falhas de conectividade.

  • Verifique se sua assinatura tem cota suficiente para todo o processo. O processo aloca novas VMs durante o processo. O número resultante de VMs seria o mesmo que o original, mas planeje que mais algumas VMs sejam criadas durante o processo.

  • Nenhuma atualização do sistema ou tarefas agendadas são planejadas.

  • Configure uma atualização em etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização lá antes de fazer isso no cluster de produção.

Usar o comando de atualização

Você precisará usar o comando "upgrade" do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um cluster do Kubernetes no Azure Stack Hub.

Interrupções de atualização

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

Tempo estimado de atualização

O tempo estimado é entre 12 a 15 minutos por VM no cluster. Por exemplo, um cluster de 20 nós pode levar aproximadamente cinco (cinco) horas para ser atualizado.

Baixar nova imagem e mecanismo do AKS

Baixe as novas versões do mecanismo aks base Ubuntu Image e AKS.

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

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

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

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

Encontre a versão atual e a versão de atualização na tabela do Azure Stack Hub a seguir. Não siga o comando aks-engine get-versions , pois o comando um também inclui as versões com suporte no Azure global. A tabela de versão e atualização a seguir se aplica ao cluster do mecanismo do AKS no Azure Stack Hub.

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

Novidades

  • Suporte para Kubernetes versão 1.15.10 (#2834). Ao implantar um novo cluster, especifique no arquivo json do modelo de api (também conhecido como arquivo de definição de cluster) o número da versão de versão, bem como o número de versão secundária. Você pode encontrar um exemplo: kubernetes-azurestack.json:

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Observação

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

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

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

  • Com um novo check-in de verificação, o aks-engine validará a disponibilidade da versão da imagem base do AKS necessária para a versão do aks-engine em execução (#2342). Isso ocorrerá depois de analisar o arquivo de modelo de API 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 o mestre Máquinas Virtuais (#2635).

  • Atualizações para o Kernel do Linux versão 4.15.0-1071-azure para Ubuntu 16.04-LTS. Confira "Pacote: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [segurança]" para obter detalhes.

  • Novas atualizações de hiperkube para dar suporte às versões do Kubernetes 1.14.8 e 1.15.10.

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

  • Atualizações para o complemento do Azure Container Monitor com a última versão de fevereiro de 2020 (nº 2850).

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

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

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

  • Com esta versão, o Mecanismo do AKS corta a dependência de k8s.gcr.io para agora usar o oficial Kubernetes MCR registry @ mcr.microsoft.com ao criar suas imagens (nº 2722).

Problemas conhecidos

  • Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. Implantando um serviço no momento, se possível.

  • A execução de versões get do aks-engine produzirá 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 descobrir qual área de versões está disponível para atualização. Use a tabela de referência de atualização descrita acima.

  • Como a ferramenta aks-engine é um repositório de código-fonte de compartilhamento no Azure e no Azure Stack Hub. Examinar as muitas notas de versão e pull requests levará você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além da listada acima, ignore-as e use a tabela de versão acima como o guia oficial para esta atualização.

Referência

A seguir está uma lista de alguns dos bugs corrigidos, bem como o conjunto completo de notas sobre a versão de 0.44.0 a 0.48.0, observe que a última lista incluirá itens do Azure e do Azure Stack Hub

Correções de bug

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

  • Addons update config é somente atualização (#2282)

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

  • Adicionar o arquivo zip do CNI do Azure 1.0.28 ao VHD do Windows (nº 2268)

  • Ordem padrão correta para definir IPAddressCount (#2358)

  • Atualizar para usar o yaml omsagent único para todas as versões k8s para evitar erros manuais e facilidade de manutenção (#2692)

Notas de versão

Esse é o conjunto completo de notas sobre a versão do Azure e do Azure Stack Hub combinadas

Próximas etapas