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

Aplica-se à versão v0.67.0 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 os itens corretos do marketplace, o AKS Base Ubuntu 16.04-LTS ou a 18.04 Image Distro ou o 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 o 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 de implantação 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. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM dentro do 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 de atualização do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um cluster kubernetes no Azure Stack Hub.

Interrupções de atualização

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo do AKS relata um erro ou algo acontece com o processo de execução do mecanismo do AKS. Examine a causa da interrupção, 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:

  • O binário aks-engine (obrigatório)
  • AKS Base Ubuntu 16.04-LTS Image Distro (preterido – não mais usar, altere no Modelo de API para usar 18.04 em vez disso)
  • Distribuição de imagem do AKS Base Ubuntu 18.04-LTS (necessária para agentes do Linux)
  • AKS Base Windows de Imagem do Servidor (necessário para Windows agentes)

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

  • Verifique a tabela mecanismo do AKS e Azure Stack de versão para as imagens base do AKS necessárias.

    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 (normalmente um usuário de locatário do Azure Stack Hub) precisará baixar a nova versão do mecanismo aks 0.67.0. Confira as instruções no artigo a seguir, Instalar o mecanismo do AKS no Linux Azure Stack Hub (ou artigo Windows equivalente). 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 .

Atualizando clusters do Kubernetes criados com a distro do Ubuntu 16.04

Atualizando clusters do Kubernetes criados com a distro do Ubuntu 16.04 A partir do Mecanismo do AKS v0.67.0, a distro do Ubuntu 16.04 não é mais uma opção com suporte, pois o sistema operacional atingiu seu fim de vida útil. Para atualizar um cluster, certifique-se de definir a distro do sistema operacional como no modelo de API de entrada, aquele gerado por e passado como aks-ubuntu-18.04aks-engine deploy entrada para aks-engine upgrade .

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

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

Mecanismo do AKS e mapeamento Azure Stack versão

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 de versão do Kubernetes no mecanismo do AKS v0.67.0

Você pode encontrar a versão atual e a versão de atualização 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 do 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.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, 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
v0.63.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24), Imagem de Windows base 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), Imagem de Windows base do AKS (17763.2213.210927) 1.19.15, 1.20.11 Exemplos de modelo de API (Linux,Windows)

Novidades

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

Os novos recursos incluem:

  • Suporte para Kubernetes 1.19.15 e 1.20.11

Problemas conhecidos

  • Implantar vários serviços do Kubernetes em paralelo dentro de um único cluster pode levar a um erro na configuração básica do balanceador de carga. É recomendável implantar um serviço 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.60.1 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 os itens corretos do marketplace, o AKS Base Ubuntu 16.04-LTS ou a 18.04 Image Distro ou o 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 o 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 de implantação 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. Um cluster de backup é altamente recomendado.
  • Se possível, execute o comando de uma VM dentro do 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 de atualização do mecanismo do AKS, conforme descrito no artigo a seguir Atualizar um cluster kubernetes no Azure Stack Hub.

Interrupções de atualização

Às vezes, fatores inesperados interrompem a atualização do cluster. Uma interrupção pode ocorrer quando o mecanismo do AKS relata um erro ou algo acontece com o processo de execução do mecanismo do AKS. Examine a causa da interrupção, 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:

  • O binário aks-engine (obrigatório)
  • AKS Base Ubuntu 16.04-LTS Image Distro (obrigatório)
  • AKS Base Ubuntu 18.04-LTS Image Distro (opcional)
  • Distro de imagem Windows base do AKS (opcional)

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

  • O Azure Stack Hub operador precisará 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)

    • AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q1 (2021.01.28),

    • Imagem de Windows base do AKS(17763.1697.210129)

      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 (normalmente um usuário de locatário do Azure Stack Hub) precisará baixar a nova versão do mecanismo aks 0.60.1. Consulte as instruções no artigo a seguir, Instalar o mecanismo do AKS no Linux Azure Stack Hub (ou artigo Windows equivalente). 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

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 de versão do kubernetes no AKS Engine v 0.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 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.15
1.17.17 1.18.15

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
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, 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
v0.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
v0.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 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, 4
  • #4214 de visualização pública de rotação de certificado
  • #4259 de visualização privada NVIDIA GPU do T4
  • visualização privada de integração de Azure Active Directory
  • Driver do CSI para BLOBs do Azure visualização privada #712
  • Versão de visualização pública dos discos do Azure para driver do CSI #712
  • Versão prévia pública NFS do driver CSI #712
  • Suporte para kubernetes 1. 17,17 #4188 e 1.18.15 #4187

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.55.4 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 o item correto do Marketplace, AKS base Ubuntu 16, 4-LTS Image distribuição para sua versão do mecanismo de AKS? Você pode encontrar as versões na seção "baixar nova imagem e 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 deploy parâmetros de comando deploy.

  • 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

Será necessário usar o comando do mecanismo AKS upgrade conforme descrito no seguinte artigo upgrade.

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 dois componentes principais:

  • O binário AKs-Engine

  • AKS base Ubuntu 16, 4-LTS Image distribuição

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 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 de versão do kubernetes no AKS Engine v 0.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 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.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 liberação e versão na orchestratorProfile seção, por exemplo, se você estiver planejando implantar kubernetes 1.16.14, os dois valores a seguir devem ser definidos, (consulte o exemplo orchestratorProfile):

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

Mecanismo de 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 do Linux Azure Stack para 2020.09.14 #3828
  • Adiciona suporte para K8s v 1.17.11 no Azure Stack #3702
  • Adiciona suporte para K8s v 1.16.14 no Azure Stack #3704
  • Atualização do VHD do Linux para 2020.09.14 #3750
  • atualização Windows do VHD para agosto de #3730
  • Atualiza as métricas de kubernetes-servidor para v 0.3.7 #3669
  • Atualiza a versão do Docker para corrigir o problema de rotação de log #3693
  • Atualiza CoreDNS para v 1.7.0 #3608
  • Usar pacotes Moby 19.03. x #3549
  • Correções para a estratégia de atualização do Azure-CNI #3571

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. Implantando um serviço no momento, se possível.
  • A execução de Get-Versions do AKS produzirá informações aplicáveis ao Azure e ao Hub de Azure Stack, 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 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 0.48.0 ou anterior do mecanismo de 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 neste artigo.

Considerações de atualização

  • Você está usando o item correto do Marketplace, AKS base Ubuntu 16, 4-LTS Image distribuição para sua versão do mecanismo de AKS? Você pode encontrar as versões na seção baixar a nova imagem AKs base Ubuntu e as versões do mecanismo 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 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.

  • 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

Será necessário usar o comando "upgrade" do mecanismo do 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 dois componentes principais:

  • O binário AKs-Engine
  • AKS base Ubuntu 16, 4-LTS Image distribuição

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

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 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.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 em seu arquivo JSON de modelo de API (arquivo de definição de cluster a.k.s.) o número de versão de lançamento, 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 kubernetes não for explicitamente fornecida no arquivo JSON do modelo de API, a versão 1.15 será usada (1.15) e o orchestratorVersion usará como padrão 1.15.11 , o que resultará em um erro durante a implantação do cluster.

  • Com o AKs-Engine v 0.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 Gerenciador de recursos de Hub Azure Stack para solicitações de entrada. Essa atualização altera os padrões para Azure Stack hub a fim de reduzir o carregamento de repetição para Azure Stack o Gerenciador de recursos de Hub (#2861).

  • A nova etapa de verificação no AKs-Engine fará com que a execução Pare ou exiba avisos se o arquivo JSON do modelo de API contiver Propriedades sem suporte pelo hub de Azure Stack (#2717).

  • Com um novo check-in de verificação, o AKs irá validar a disponibilidade da versão da imagem base AKS necessária para a versão do AKS-Engine em execução (#2342). Isso ocorrerá após a análise do arquivo de modelo de API e antes de chamar o Gerenciador de recursos de Hub de Azure Stack.

  • A nova opção AKs-Engine "--Control-avião-only" no comando "upgrade" permite que o usuário atualize as operações para direcionar apenas as máquinas virtuais mestras (#2635).

  • Atualizações do kernel do Linux versão 4.15.0-1071-Azure para Ubuntu 16, 4-LTS. Consulte "pacote: 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 kubernetes 1.14.8 e 1.15.10.

  • Atualize kubectl para corresponder à versão de kubernetes para o cluster.. Esse componente está disponível nos nós do mestre de cluster kubernetes, 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 do coredns para a versão v 1.6.6 (coredns).

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

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

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

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. Implantando um serviço no momento, se possível.

  • A execução de Get-Versions do AKS produzirá informações aplicáveis ao Azure e ao Hub de Azure Stack, 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 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, ignore-as e use a tabela de versões acima como o guia oficial para essa atualização.

Referência

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

Correções de bug

  • userAssignedIdentityIdazure.jsonaspas ausentes no Windows (userAssignedIdentityId)

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

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

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

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

  • Atualizar para usar o omsagent YAML único para todas as versões do 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 o Hub de Azure Stack combinado

Próximas etapas