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

Aplica-se à versão v 0.67.0 do mecanismo AKS.

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

Planejamento de atualização

O comando de atualização do mecanismo 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, certifique-se de examinar as informações da nota de versão.

Considerações de atualização

  • você está usando os itens corretos do marketplace, AKS base Ubuntu 16, 4-LTS ou 18, 4 Image distribuição ou AKS Base Windows Server para sua versão do mecanismo AKS? Você pode encontrar as versões na seção "baixar novas imagens e o mecanismo de 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 implantar implantar um cluster kubernetes.
  • Você está usando uma máquina confiável para executar o mecanismo AKS e da 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 de Hub de Azure Stack 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 algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas estão planejadas.
  • Configure uma atualização em etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização ali antes de fazer isso em seu cluster de produção.

Usar o comando de atualização

Você será solicitado a usar o comando de atualização do mecanismo AKS conforme descrito no seguinte artigo atualizar um cluster kubernetes no Hub Azure Stack.

Atualizar interrupções

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo AKS relata um erro ou algo acontece com o processo de execução do mecanismo AKS. Examine a causa da interrupção, resolva-a e 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 reenviado o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar a conclusão dela.

Tempo de atualização estimado

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

Baixar nova imagem e mecanismo de AKS

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

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

  • O binário AKs-Engine (obrigatório)
  • AKS base Ubuntu 16, 4-LTS Image distribuição (preterida – não usa mais, alteração no modelo de API para usar 18, 4 em vez disso)
  • AKS base Ubuntu 18, 4-LTS Image distribuição (obrigatório para agentes do Linux)
  • AKS Base Windows Server Image distribuição (necessário para agentes de Windows)

As novas versões deles estão disponíveis com esta atualização:

Atualizando clusters kubernetes criados com o Ubuntu 16, 4 distribuição

Atualizando clusters kubernetes criados com o distribuição do Ubuntu 16, 4 a partir do AKS Engine v 0.67.0, o Ubuntu 16, 4 distribuição não é mais uma opção com suporte, pois o sistema operacional atingiu o fim da vida útil. Para atualizar um cluster, certifique-se de definir o distribuição do sistema operacional como aks-ubuntu-18.04 em seu 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"
    }]

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

Versão do hub de Azure Stack 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 de versão do kubernetes no AKS Engine v 0.67.0

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

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 liberaçã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 de AKS e mapeamento de imagem correspondente

Mecanismo do AKS Imagem base do AKS Versões do Kubernetes Exemplos de modelo de API
v 0.43.1 AKS base Ubuntu 16, 4-LTS Image distribuição, outubro 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v 0.48.0 AKS base Ubuntu 16, 4-LTS Image distribuição, março 2020 (2020.03.19) 1.15.10, 1.14.7
v 0.51.0 AKS base Ubuntu 16, 4-LTS image distribuição, maio 2020 (2020.05.13), AKS Base Windows Image (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v 0.55.0 AKS base Ubuntu 16, 4-LTS image distribuição, agosto 2020 (2020.08.24), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v 0.55.4 AKS base Ubuntu 16, 4-LTS image distribuição, setembro 2020 (2020.09.14), AKS Base Windows Image (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V 0.60.1 AKS base Ubuntu 16, 4-LTS Image distribuição, janeiro 2021 (2021.01.28),
AKS base Ubuntu 18, 4-LTS Image distribuição, 2021 Q1 (2021.01.28),
imagem de Windows Base AKS (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v 0.63.0 AKS base Ubuntu 18, 4-LTS image distribuição, 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)
v 0.67.0 AKS base Ubuntu 18, 4-LTS image distribuição, 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 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 Hub Azure Stack. Examinar as muitas notas de versão e solicitações de pull levará você a acreditar que a ferramenta dá suporte a outras versões do kubernetes e da plataforma de so além das listadas acima, ignorá-las e usar a tabela de versões acima como o guia oficial para essa atualização.

Referência

Este é o conjunto completo de notas de versão para o Azure e o Hub Azure Stack combinado:

Aplica-se à versão v 0.60.1 do mecanismo AKS.

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

Planejamento de atualização

O comando de atualização do mecanismo 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, certifique-se de examinar as informações da nota de versão.

Considerações de atualização

  • você está usando os itens corretos do marketplace, AKS base Ubuntu 16, 4-LTS ou 18, 4 Image distribuição ou AKS Base Windows Server para sua versão do mecanismo AKS? Você pode encontrar as versões na seção "baixar novas imagens e o mecanismo de 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 implantar implantar um cluster kubernetes.
  • Você está usando uma máquina confiável para executar o mecanismo AKS e da 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 de Hub de Azure Stack 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 algumas VMs sejam criadas durante o processo.
  • Nenhuma atualização do sistema ou tarefas agendadas estão planejadas.
  • Configure uma atualização em etapas em um cluster configurado com os mesmos valores que o cluster de produção e teste a atualização ali antes de fazer isso em seu cluster de produção.

Usar o comando de atualização

Você será solicitado a usar o comando de atualização do mecanismo AKS conforme descrito no seguinte artigo atualizar um cluster kubernetes no Hub Azure Stack.

Atualizar interrupções

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo AKS relata um erro ou algo acontece com o processo de execução do mecanismo AKS. Examine a causa da interrupção, resolva-a e 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 reenviado o comando. Normalmente, as interrupções aumentam o tempo para concluir a atualização, mas não devem afetar a conclusão dela.

Tempo de atualização estimado

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

Baixar nova imagem e mecanismo de AKS

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

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

  • O binário AKs-Engine (obrigatório)
  • AKS base Ubuntu 16, 4-LTS Image distribuição (obrigatório)
  • AKS base Ubuntu 18, 4-LTS Image distribuição (opcional)
  • AKS Base da imagem do servidor do Windows distribuição (opcional)

As novas versões deles estão disponíveis com esta atualização:

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

Versão do hub de Azure Stack 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 de versão do Kubernetes no mecanismo do AKS v0.60.1

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

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

No arquivo json do Modelo de API, especifique os valores de versão e versão na 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, outubro de 2019 (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, maio de 2020 (2020.05.13), Imagem de Windows base do AKS (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, agosto de 2020 (2020.08.24), Imagem de Windows base do AKS (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, setembro de 2020 (2020.09.14), Imagem de Windows base do AKS (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image Distro, janeiro de 2021 (2021.01.28),
AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),
Imagem de Windows base do AKS (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Novidades

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

Os novos recursos incluem:

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

Problemas conhecidos

  • Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço no momento.
  • Como a ferramenta aks-engine é um repositório de código-fonte de compartilhamento no Azure e Azure Stack Hub. Examinar as várias notas de versão e solicitações de pull levará você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além da lista acima, ignore-as e use a tabela de versão acima como o guia oficial para essa atualização.

Referência

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

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

Este artigo descreve o conteúdo do mecanismo Serviço de Kubernetes do Azure (AKS) na Azure Stack Hub atualização. A atualização inclui melhorias e correções para a versão mais recente do mecanismo do AKS direcionado para a Azure Stack Hub plataforma. 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, 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 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. Consulte os deploy parâmetros de comando deploy.

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

  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster está 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 no ambiente 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 está planejada.

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

Usar o comando de atualização

Você será obrigado a usar o comando do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um upgradeupgrade.

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, endereço-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 reaubmitir 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 está 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 da Imagem base do Ubuntu do AKS e do mecanismo do AKS.

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

  • O binário aks-engine

  • Distro de imagem do AKS Base Ubuntu 16.04-LTS

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

  • O Azure Stack Hub operador do AKS precisará baixar uma nova imagem base do Ubuntu do AKS no marketplace de selos:

    • Nome: Distro de Imagem do AKS Base Ubuntu 16.04-LTS, setembro de 2020 (2020.09.14)

    • Versão: 2020.09.14

    • Siga as instruções no artigo a seguir 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 precisará baixar a nova versão do mecanismo aks 0.51.0. Consulte as instruções no artigo a seguir, Instalar o mecanismo do AKS no Linux no Azure Stack Hub. Você pode seguir o mesmo processo usado para instalar o cluster pela primeira vez. A atualização substituirá o binário anterior. Por exemplo, se você usou o script get-akse.sh, siga as mesmas etapas descritas nesta seção Instalar em um ambiente conectado. O mesmo processo se aplica se você estiver instalando o em um sistema Windows, artigo Instalar o mecanismo do AKSno Windows no Azure Stack Hub .

Mecanismo do AKS e mapeamento Azure Stack versão

Azure Stack Hub versão 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 de versão do Kubernetes no mecanismo do AKS v0.55.4

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

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

No arquivo json do Modelo de API, especifique os valores de versão e versão na seção , por exemplo, se você estiver planejando implantar o Kubernetes 1.16.14, os dois valores a seguir devem ser definidos, (consulte o exemplo orchestratorProfileorchestratorProfile):

    -   "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 Azure Stack VHD do Linux para 2020.09.14nº 3828
  • Adiciona suporte para K8s v1.17.11 Azure Stack #3702
  • Adiciona suporte para K8s v1.16.14 Azure Stack #3704
  • Atualização do VHD do Linux para 2020.09.14 #3750
  • Windows Atualização do VHD 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 nº 3693
  • Atualiza o CoreDNS para v1.7.0 #3608
  • Usar pacotes moby 19.03.x #3549
  • Correções da estratégia de atualização azure-cni #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 get-versions do aks-engine produzirá informações aplicáveis ao Azure e Azure Stack Hub, no entanto, não há uma maneira explícita de distinguir 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 Azure Stack Hub. Examinar as várias notas de versão e solicitações de pull levará você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além da lista acima, ignore-as e use a tabela de versão acima como o guia oficial para essa atualização.

Referência

Este é o conjunto completo de notas de versão para o Azure e 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 Serviço de Kubernetes do Azure (AKS) na Azure Stack Hub atualização. A atualização inclui melhorias e correções para a versão mais recente do mecanismo do AKS direcionado para a Azure Stack Hub plataforma. 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, revise as informações neste artigo.

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 AKS Ubuntue as versões do mecanismo do AKS .

  • Você está usando a especificação de cluster correta (apimodel.json) e o grupo de recursos para o cluster de destino? Quando você implantou originalmente o cluster, esse arquivo foi gerado no diretório de saída. Consulte 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 você está executando operações de atualização?

  • Se você estiver atualizando um cluster operacional com cargas de trabalho ativas, poderá aplicar a atualização sem afetá-las, supondo que o cluster está 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 no ambiente 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 está planejada.

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

Usar o comando de atualização

Você será obrigado a usar o comando "upgrade" do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um cluster kubernetesno 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, endereço-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 reaubmitir 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 está 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 da Imagem base do Ubuntu do AKS e do mecanismo do AKS.

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

  • O binário aks-engine
  • Distro de imagem do AKS Base Ubuntu 16.04-LTS

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

  • O Azure Stack Hub operador do AKS precisará baixar uma nova imagem base do Ubuntu do AKS:

    • Nome: AKS Base Ubuntu 16.04-LTS Image Distro, March 2020
    • Versão: 2020.03.19
    • Siga as instruções no artigo a seguir 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 precisará baixar a nova versão do mecanismo aks 0.48.0. Confira as instruções neste artigo a seguir, Instalar o mecanismo do AKS no Linux no Azure Stack Hub. Você pode seguir o mesmo processo usado para instalar o cluster pela primeira vez. A atualização substituirá o binário anterior. Por exemplo, se você usou o get-akse.sh script, siga as mesmas etapas descritas no artigo get-akse.sh O mesmo processo se aplica se você estiver instalando o em um sistema Windows, artigo Instalar o mecanismo do AKSno Windows no Azure Stack Hub .

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

Você pode encontrar a versão atual e a versão de atualização na tabela a seguir para Azure Stack Hub. Não siga o comando aks-engine, pois o comando também inclui as versões com get-versions suporte no Azure global. A versão e a tabela de atualização a seguir se aplica ao cluster de mecanismo do AKS 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, certifique-se de especificar no arquivo json do modelo de API (também conhecido como arquivo de definição de cluster) o número de versão da 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 será usada 1.15 (1.15) e o orchestratorVersion padrão será , o que resultará em um erro durante a implantação do 1.15.11 cluster.

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

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

  • Com uma nova verificação de check-in, o mecanismo aks validará a disponibilidade da versão da imagem base do AKS necessária para a versão do mecanismo de aks 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 operações para direcionar somente 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 "Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]" para obter detalhes.

  • Novas atualizações do hyperkube para dar 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 mestres do cluster kubernetes, você pode executar por SSH em um mestre.

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

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

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

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

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

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 aks-engine get-versions produzirá informações aplicáveis ao Azure e Azure Stack Hub, no entanto, não há uma maneira explícita de distinguir 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 Azure Stack Hub. Examinar as várias notas de versão e solicitações de pull levará você a acreditar que a ferramenta dá suporte a outras versões do Kubernetes e da plataforma do sistema operacional além da lista acima, ignore-as e use a tabela de versão acima como o guia oficial para essa atualização.

Referência

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

Correções de bug

  • userAssignedIdentityId em azure.json aspas ausentes do Windows (userAssignedIdentityId)

  • Os update config complementos são somente atualização (update config)

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

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

  • Corrigir a ordem de padrões para definir IPAddressCount (#2358)

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

Notas de versão

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

Próximas etapas