Azure Stack Hub에서 AKS 엔진의 알려진 문제Known issues with the AKS engine on Azure Stack Hub

이 항목에서는 Azure Stack Hub의 AKS 엔진에 대 한 알려진 문제에 대해 설명 합니다.This topic covers known issues for the AKS engine on Azure Stack Hub.

계산 서비스를 사용 하 여 클러스터 Vm의 크기를 조정할 수 없습니다.Unable to resize cluster VMs with the Compute service

  • 적용 대상: Azure Stack 허브, AKS 엔진 (모두)Applicable to: Azure Stack Hub, AKS engine (all)
  • 설명: 계산 서비스를 통해 클러스터 vm의 크기를 조정 하는 작업은 AKS 엔진에서 작동 하지 않습니다.Description: Resizing cluster VMs through the Compute service doesn't work with AKS engine. AKS 엔진은 API 모델 json 파일에 클러스터의 상태를 유지 합니다.The AKS engine maintains the state of the cluster in the API model json file. AKS 엔진을 사용 하 여 수행 되는 모든 만들기, 업데이트 또는 크기 조정 작업에 원하는 VM 크기가 반영 되도록 하려면 해당 작업을 실행 하기 전에 API 모델을 업데이트 해야 합니다.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. 예를 들어, 계산 서비스를 사용 하 여 이미 배포 된 클러스터의 VM 크기를 다른 크기로 변경 하는 경우가 실행 될 때 상태가 손실 됩니다 aks-engine update .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.
  • 수정:이 작업을 수행 하려면 클러스터에 대 한 API 모델을 찾아 크기를 변경한 다음를 실행 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.
  • 발생: 계산 서비스를 사용 하 여 크기를 조정 하려고 할 때Occurrence: When attempting to resize using the Compute service.

AKS engine 0.55.0에서 디스크 분리 작업이 실패 합니다.Disk detach operation fails in AKS engine 0.55.0

  • 적용 대상: Azure Stack 허브 (업데이트 2005), AKS engine 0.55.0Applicable to: Azure Stack Hub (update 2005), AKS engine 0.55.0
  • 설명: 지 속성 볼륨이 포함 된 배포를 삭제 하려고 할 때 삭제 작업은 일련의 연결/분리 오류를 트리거합니다.Description: When you try to delete a deployment that contains persistence volumes, the delete operation triggers a series of attach/detach errors. 이는 AKS engine v 0.55.0 클라우드 공급자의 버그로 인 한 것입니다.This is due to a bug in the AKS engine v0.55.0 Cloud Provider. 클라우드 공급자는 현재 Azure Stack 허브 (업데이트 2005)에서 지원 되는 Azure Resource Manager 보다 최신 버전의 API를 사용 하 여 Azure Resource Manager를 호출 합니다.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).
  • 수정: AKS 엔진 GitHub 리포지토리 (문제 3817)에서 세부 정보 및 완화 단계를 찾을 수 있습니다.Remediation: You can find the details and mitigation steps in the AKS engine GitHub repository (Issue 3817). AKS 엔진의 새 빌드와 해당 이미지를 사용할 수 있게 되 면 즉시 업그레이드 하십시오.Upgrade as soon as a new build of AKS engine and corresponding image are available.
  • 발생: 지 속성 볼륨이 포함 된 배포를 삭제 하는 경우Occurrence: When deleting a deployment that contains persistence volumes.

AKS engine 0.51.0의 업그레이드 문제Upgrade issues in AKS engine 0.51.0

  • Kubernetes 클러스터의 업그레이드 (aks engine 업그레이드)를 버전 1.15에서 1.16로 업그레이드 하는 동안 다음 Kubernetes 구성 요소를 업그레이드 하려면 추가 수동 단계가 필요 합니다. kube-proxy, azure-cni-networkmonitor, csi-, 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. 다음은 관찰할 수 있는 내용과 문제를 해결 하는 방법을 설명 합니다.The following describes what you may observe and how to work around the issues.

    • 연결 된 환경에서는 영향을 받는 구성 요소가 업그레이드 되지 않은 클러스터의 부호가 없기 때문에이 문제를 알 수 없습니다.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. 모든 것이 예상 대로 작동 하는 것 처럼 보입니다.Everything appears to work as expected.
    kubectl get pods -n kube-system
    • 이러한 각 구성 요소에 대해이 문제를 해결 하기 위한 해결 방법으로 다음 표의 해결 방법 열에서 명령을 실행 합니다.As a workaround to solve this issue for each of these components, run the command in the Workaround column in the following table.

      구성 요소 이름Component Name 해결 방법Workaround 영향을 받는 시나리오Affected Scenarios
      kube-프록시kube-proxy kubectl delete ds kube-proxy -n kube-system 연결 됨, 연결 끊김Connected, Disconnected
      azure-cni-networkmonitorazure-cni-networkmonitor kubectl delete ds azure-cni-networkmonitor -n kube-system 연결 됨, 연결 끊김Connected, Disconnected
      csicsi-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
      연결 끊김Disconnected
      kubernetes-대시보드kubernetes-dashboard 각 마스터 노드에서 다음 명령을 실행 합니다.Run the following command on each master node:
      sudo sed -i s/Always/IfNotPresent/g /etc/kubernetes/addons/kubernetes-dashboard.yaml
      연결 끊김Disconnected
  • Kubernetes 1.17은이 릴리스에서 지원 되지 않습니다.Kubernetes 1.17 is not supported in this release. GitHub 끌어오기 요청 (PR)은 1.17을 참조 하지만 지원 되지 않습니다.Although there are GitHub pull requests (PR)s referencing 1.17, it is not supported.

aks-versions 명령 제한 사항aks-engine get-versions command limitations

Aks 명령 출력은 get-versions Azure Stack 허브가 아닌 글로벌 Azure에만 관련 됩니다.The output of the aks-engine get-versions command only relates to global Azure rather than Azure Stack Hub. 다양 한 업그레이드 경로에 대 한 자세한 내용은 최신 Kubernetes 버전으로 업그레이드 하는 단계를 참조 하세요.For more information about the various upgrade paths, see Steps to upgrade to a newer Kubernetes version.

다음 단계Next steps

Azure Stack Hub의 AKS 엔진 개요AKS engine on Azure Stack Hub overview