Problemi noti relativi al motore AKS nell'hub Azure StackKnown issues with the AKS engine on Azure Stack Hub

Questo argomento descrive i problemi noti del motore AKS nell'hub Azure Stack.This topic covers known issues for the AKS engine on Azure Stack Hub.

Non è possibile ridimensionare le macchine virtuali del cluster con il servizio di calcoloUnable to resize cluster VMs with the Compute service

  • Applicabile a: Hub Azure stack, motore AKS (tutti)Applicable to: Azure Stack Hub, AKS engine (all)
  • Descrizione: il ridimensionamento delle macchine virtuali del cluster tramite il servizio di calcolo non funziona con il motore AKS.Description: Resizing cluster VMs through the Compute service doesn't work with AKS engine. Il motore AKS gestisce lo stato del cluster nel file JSON del modello API.The AKS engine maintains the state of the cluster in the API model json file. Per assicurarsi che le dimensioni della macchina virtuale desiderate si riflettano in qualsiasi operazione di creazione, aggiornamento o ridimensionamento eseguita con il motore AKS, è necessario aggiornare il modello API prima di eseguire una di queste operazioni.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. Se ad esempio si modificano le dimensioni di una macchina virtuale in un cluster già distribuito a una dimensione diversa usando il servizio di calcolo, lo stato andrà perso quando aks-engine update viene eseguito.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.
  • Correzione: per eseguire questa operazione, individuare il modello API per il cluster, modificare le dimensioni e quindi eseguire 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.
  • Occorrenza: durante il tentativo di ridimensionare usando il servizio di calcolo.Occurrence: When attempting to resize using the Compute service.

L'operazione di scollegamento del disco non riesce nel motore AKS 0.55.0Disk detach operation fails in AKS engine 0.55.0

  • Applicabile a: Hub Azure stack (aggiornamento 2005), motore AKS 0.55.0Applicable to: Azure Stack Hub (update 2005), AKS engine 0.55.0
  • Descrizione: quando si tenta di eliminare una distribuzione che contiene volumi di persistenza, l'operazione di eliminazione attiva una serie di errori di collegamento/scollegamento.Description: When you try to delete a deployment that contains persistence volumes, the delete operation triggers a series of attach/detach errors. Questo problema è dovuto a un bug del provider di servizi cloud 0.55.0 del motore AKS.This is due to a bug in the AKS engine v0.55.0 Cloud Provider. Il provider di servizi cloud chiama il Azure Resource Manager usando una versione più recente dell'API rispetto al Azure Resource Manager attualmente supportato nell'hub Azure Stack (aggiornamento 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).
  • Correzione: è possibile trovare i dettagli e le procedure di mitigazione nel repository GITHUB del motore AKS (problema 3817).Remediation: You can find the details and mitigation steps in the AKS engine GitHub repository (Issue 3817). Aggiornare non appena è disponibile una nuova build del motore AKS e dell'immagine corrispondente.Upgrade as soon as a new build of AKS engine and corresponding image are available.
  • Occorrenza: quando si elimina una distribuzione che contiene volumi di persistenza.Occurrence: When deleting a deployment that contains persistence volumes.

Problemi di aggiornamento nel motore AKS 0.51.0Upgrade issues in AKS engine 0.51.0

  • Durante l'aggiornamento (aggiornamento del motore AKS) di un cluster Kubernetes dalla versione 1.15. x alla versione 1.16. x, l'aggiornamento dei seguenti componenti di Kubernetes richiede passaggi manuali aggiuntivi: 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. Di seguito vengono descritte le operazioni che è possibile osservare e il modo in cui aggirare i problemi.The following describes what you may observe and how to work around the issues.

    • Negli ambienti connessi non è evidente che questo problema si verifica perché non sono presenti segni nel cluster in cui i componenti interessati non sono stati aggiornati.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. Tutti gli elementi sembrano funzionare come previsto.Everything appears to work as expected.
    kubectl get pods -n kube-system
    
    • Come soluzione alternativa per risolvere questo problema per ognuno di questi componenti, eseguire il comando nella colonna soluzione nella tabella seguente.As a workaround to solve this issue for each of these components, run the command in the Workaround column in the following table.

      Nome componenteComponent Name Soluzione alternativaWorkaround Scenari interessatiAffected Scenarios
      Kube-proxykube-proxy kubectl delete ds kube-proxy -n kube-system Connesso, disconnessoConnected, Disconnected
      Azure-CNI-networkmonitorazure-cni-networkmonitor kubectl delete ds azure-cni-networkmonitor -n kube-system Connesso, disconnessoConnected, 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
      DisconnessoDisconnected
      kubernetes-dashboardkubernetes-dashboard Eseguire il comando seguente in ogni nodo master:Run the following command on each master node:
      sudo sed -i s/Always/IfNotPresent/g /etc/kubernetes/addons/kubernetes-dashboard.yaml
      DisconnessoDisconnected
  • Kubernetes 1,17 non è supportato in questa versione.Kubernetes 1.17 is not supported in this release. Sebbene ci siano richieste pull di GitHub (PR) che fanno riferimento a 1,17, non è supportato.Although there are GitHub pull requests (PR)s referencing 1.17, it is not supported.

limitazioni del comando di get-version del motore AKSaks-engine get-versions command limitations

L'output del comando AKS-Engine get-versions si riferisce solo a global Azure anziché Azure stack Hub.The output of the aks-engine get-versions command only relates to global Azure rather than Azure Stack Hub. Per ulteriori informazioni sui vari percorsi di aggiornamento, vedere la procedura per eseguire l'aggiornamento a una versione più recente di Kubernetes.For more information about the various upgrade paths, see Steps to upgrade to a newer Kubernetes version.

Passaggi successiviNext steps

Panoramica sul motore AKS in Azure Stack HubAKS engine on Azure Stack Hub overview