Problemas conhecidos com o motor AKS no Azure Stack HubKnown issues with the AKS engine on Azure Stack Hub

Este tópico aborda questões conhecidas para o motor AKS no Azure Stack Hub.This topic covers known issues for the AKS engine on Azure Stack Hub.

Incapaz de redimensionar vMs de cluster com o serviço ComputeUnable to resize cluster VMs with the Compute service

  • Aplicável a : Azure Stack Hub, motor AKS (todos)Applicable to : Azure Stack Hub, AKS engine (all)
  • Descrição : Redimensionar os VMs do cluster através do serviço Compute não funciona com o motor AKS.Description : Resizing cluster VMs through the Compute service doesn't work with AKS engine. O motor AKS mantém o estado do cluster no ficheiro json modelo API.The AKS engine maintains the state of the cluster in the API model json file. Para garantir que o tamanho VM desejado se reflete em qualquer operação de criação, atualização ou escala feita com o motor AKS, deve atualizar o modelo 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 alterar um tamanho VM num cluster já implantado para um tamanho diferente usando o serviço Compute, o estado perder-se-á 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.
  • Remediação : Para que este trabalho localize o modelo API para o cluster, mude o tamanho e, em seguida, corra 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 utilizando o serviço Compute.Occurrence : When attempting to resize using the Compute service.

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

  • Aplicável a : Azure Stack Hub (atualização 2005), motor AKS 0.55.0Applicable to : Azure Stack Hub (update 2005), AKS engine 0.55.0
  • Descrição : Quando se tenta eliminar uma implantação que contenha volumes de persistência, a operação de eliminação desencadeia uma série de erros de anexação/desprendimento.Description : When you try to delete a deployment that contains persistence volumes, the delete operation triggers a series of attach/detach errors. Isto deve-se a um erro no motor AKS v0.55.0 Cloud Provider.This is due to a bug in the AKS engine v0.55.0 Cloud Provider. O Cloud Provider chama o Gestor de Recursos Azure usando uma versão mais recente da API do que o Azure Resource Manager suporta atualmente no Azure Stack Hub (atualização de 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).
  • Remediação : Pode encontrar os detalhes e os passos de mitigação no repositório GitHub (Edição 3817) do motor AKS.Remediation : You can find the details and mitigation steps in the AKS engine GitHub repository (Issue 3817). Upgrade assim que estiver disponível uma nova construção do motor AKS e imagem correspondente.Upgrade as soon as a new build of AKS engine and corresponding image are available.
  • Ocorrência : Ao eliminar uma implantação que contenha volumes de persistência.Occurrence : When deleting a deployment that contains persistence volumes.

Problemas de upgrade no motor AKS 0.51.0Upgrade issues in AKS engine 0.51.0

  • Durante a atualização (atualização do motor aks) de um cluster Kubernetes da versão 1.15.x a 1.16.x, a atualização dos seguintes componentes kubernetes requer passos manuais extra: kube-proxy, azure-cni-networkmonitor, csi-secrets-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 pode observar e como contornar as questões.The following describes what you may observe and how to work around the issues.

    • Em ambientes conectados, não é óbvio notar esta questão, uma vez que 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 como esperado.Everything appears to work as expected.
    kubectl get pods -n kube-system
    
    • Como uma solução alternativa para resolver este problema para cada um destes componentes, executar o comando na coluna Workaround na tabela seguinte.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çãoWorkaround Cenários afetadosAffected Scenarios
      kube-proxykube-proxy kubectl delete ds kube-proxy -n kube-system Conectado, DesligadoConnected, Disconnected
      azure-cni-networkmonitorazure-cni-networkmonitor kubectl delete ds azure-cni-networkmonitor -n kube-system Conectado, DesligadoConnected, Disconnected
      csi-secrets-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
      DesligadoDisconnected
      kubernetes-dashboardkubernetes-dashboard Executar 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
      DesligadoDisconnected
  • Kubernetes 1.17 não é suportado nesta versão.Kubernetes 1.17 is not supported in this release. Embora existam pedidos de retirada do GitHub (PR) referente a 1.17, não é suportado.Although there are GitHub pull requests (PR)s referencing 1.17, it is not supported.

limitações de comando de versões aks-engineaks-engine get-versions command limitations

A saída do comando aks-engine get-versions apenas diz respeito 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 upgrade, consulte Passos para atualizar para uma versão mais recente de Kubernetes.For more information about the various upgrade paths, see Steps to upgrade to a newer Kubernetes version.

Próximas etapasNext steps

Motor AKS na visão geral do Azure Stack HubAKS engine on Azure Stack Hub overview