Problemas conhecidos com o mecanismo AKS no Hub Azure StackKnown issues with the AKS engine on Azure Stack Hub

Este tópico aborda problemas conhecidos do mecanismo do AKS no Hub Azure Stack.This topic covers known issues for the AKS engine on Azure Stack Hub.

Não é possível redimensionar as VMs do cluster com o serviço de computaçãoUnable to resize cluster VMs with the Compute service

  • Aplicável a : Azure Stack Hub, mecanismo AKs (tudo)Applicable to : Azure Stack Hub, AKS engine (all)
  • Descrição : o redimensionamento de VMs de cluster por meio do serviço de computação não funciona com o mecanismo AKs.Description : Resizing cluster VMs through the Compute service doesn't work with AKS engine. O mecanismo AKS mantém o estado do cluster no arquivo JSON do modelo de API.The AKS engine maintains the state of the cluster in the API model json file. Para garantir que o tamanho desejado da VM seja refletido em qualquer operação de criação, atualização ou dimensionamento feita com o mecanismo do AKS, você deve atualizar o modelo de API antes de executar qualquer uma dessas operações.To ensure that the desired VM size is reflected in any create, update, or scale operation done with AKS engine you must update the API model before executing any of those operations. Por exemplo, se você alterar um tamanho de VM em um cluster já implantado para um tamanho diferente usando o serviço de computação, o estado será perdido quando aks-engine update for executado.For example, if you change a VM size on an already deployed cluster to a different size using the Compute service, the state will be lost when aks-engine update is executed.
  • Correção : para fazer esse trabalho localizar o modelo de API para o cluster, altere o tamanho e, em seguida, execute aks-engine update .Remediation : To make this work locate the API model for the cluster, change the size there, and then run aks-engine update.
  • Ocorrência : ao tentar redimensionar usando o serviço de computação.Occurrence : When attempting to resize using the Compute service.

Falha na operação de desanexação do disco no mecanismo de AKS 0.55.0Disk detach operation fails in AKS engine 0.55.0

  • Aplicável a : Azure Stack Hub (atualização 2005), 0.55.0 do mecanismo AKsApplicable to : Azure Stack Hub (update 2005), AKS engine 0.55.0
  • Descrição : quando você tenta excluir uma implantação que contém volumes de persistência, a operação de exclusão dispara uma série de erros de anexação/desanexação.Description : When you try to delete a deployment that contains persistence volumes, the delete operation triggers a series of attach/detach errors. Isso ocorre devido a um bug no provedor de nuvem do AKS Engine v 0.55.0.This is due to a bug in the AKS engine v0.55.0 Cloud Provider. O provedor de nuvem chama o Azure Resource Manager usando uma versão mais recente da API do que a Azure Resource Manager atualmente dá suporte no Hub Azure Stack (atualização 2005).The Cloud Provider calls the Azure Resource Manager using a newer version of the API than the Azure Resource Manager currently supports in Azure Stack Hub (update 2005).
  • Correção : você pode encontrar os detalhes e as etapas de mitigação no repositório GITHUB do mecanismo AKS (problema 3817).Remediation : You can find the details and mitigation steps in the AKS engine GitHub repository (Issue 3817). Atualize assim que uma nova compilação do mecanismo AKS e a imagem correspondente estiverem disponíveis.Upgrade as soon as a new build of AKS engine and corresponding image are available.
  • Ocorrência : ao excluir uma implantação que contém volumes de persistência.Occurrence : When deleting a deployment that contains persistence volumes.

Problemas de atualização no AKS Engine 0.51.0Upgrade issues in AKS engine 0.51.0

  • Durante a atualização (AKs-Engine Upgrade) de um cluster kubernetes da versão 1.15. x para 1.16. x, a atualização dos seguintes componentes do kubernetes requer etapas manuais adicionais: Kube-proxy , Azure-CNI-NetworkMonitor , CSI-segredos-Store , kubernetes-Dashboard .During upgrade (aks-engine upgrade) of a Kubernetes cluster from version 1.15.x to 1.16.x, upgrade of the following kubernetes components requires extra manual steps: kube-proxy , azure-cni-networkmonitor , csi-secrets-store , kubernetes-dashboard . O seguinte descreve o que você pode observar e como contornar os problemas.The following describes what you may observe and how to work around the issues.

    • Em ambientes conectados, não é óbvio observar esse problema, pois não há sinais no cluster de que os componentes afetados não foram atualizados.In connected environments, it is not obvious to notice this issue since there are no signs in the cluster that the affected components were not upgraded. Tudo parece funcionar conforme o esperado.Everything appears to work as expected.
    kubectl get pods -n kube-system
    
    • Como solução alternativa para resolver esse problema para cada um desses componentes, execute o comando na coluna solução alternativa na tabela a seguir.As a workaround to solve this issue for each of these components, run the command in the Workaround column in the following table.

      Nome do ComponenteComponent Name Solução alternativaWorkaround Cenários afetadosAffected Scenarios
      Kube-proxykube-proxy kubectl delete ds kube-proxy -n kube-system Conectado, desconectadoConnected, Disconnected
      Azure-CNI-NetworkMonitorazure-cni-networkmonitor kubectl delete ds azure-cni-networkmonitor -n kube-system Conectado, desconectadoConnected, Disconnected
      CSI-segredos-Storecsi-secrets-store sudo sed -i s/Always/IfNotPresent/g /etc/kubernetes/addons/secrets-store-csi-driver.yaml
      kubectl delete ds csi-secrets-store -n kube-system
      DesconectadoDisconnected
      kubernetes-painelkubernetes-dashboard Execute o seguinte comando em cada nó mestre:Run the following command on each master node:
      sudo sed -i s/Always/IfNotPresent/g /etc/kubernetes/addons/kubernetes-dashboard.yaml
      DesconectadoDisconnected
  • Kubernetes 1,17 não tem suporte nesta versão.Kubernetes 1.17 is not supported in this release. Embora existam solicitações pull (PR) s que fazem referência a 1,17, não há suporte para ele.Although there are GitHub pull requests (PR)s referencing 1.17, it is not supported.

limitações de comando de Get-Versions do AKS-Engineaks-engine get-versions command limitations

A saída do comando AKs-Engine get-versions está relacionada apenas ao Azure global em vez de Azure Stack Hub.The output of the aks-engine get-versions command only relates to global Azure rather than Azure Stack Hub. Para obter mais informações sobre os vários caminhos de atualização, consulte etapas para atualizar para uma versão mais recente do kubernetes.For more information about the various upgrade paths, see Steps to upgrade to a newer Kubernetes version.

Próximas etapasNext steps

Visão geral do mecanismo AKS na Azure Stack HubAKS engine on Azure Stack Hub overview