Dapr OSS에서 AKS(Azure Kubernetes Service)용 Dapr 확장으로 마이그레이션

이 문서에서는 Dapr OSS에서 AKS용 Dapr 확장으로 마이그레이션하는 방법을 보여 줍니다.

Azure CLI(기본 방법)를 사용하여 기존 Dapr 설치를 확인하거나 --configuration-settings를 사용하여 기존 Dapr 설치를 구성하여 Dapr OSS에서 만든 Kubernetes 리소스를 사용하고 관리하도록 Dapr 확장을 구성할 수 있습니다.

자세한 내용은 AKS용 Dapr 확장을 참조하세요.

기존 Dapr 설치 확인

Dapr 확장을 만들 때 확장은 클러스터에 기존 Dapr 설치를 확인합니다. Dapr이 있는 경우 확장은 Dapr OSS에서 만든 Kubernetes 리소스를 사용하고 관리합니다.

1. helm list -A 명령을 사용하여 현재 Dapr 설치의 세부 정보를 나열하고 출력에서 Dapr 릴리스 이름 및 네임스페이스를 저장합니다.

   helm list -A
   

2. 다음 질문이 표시되면 Helm 릴리스 이름 및 네임스페이스(helm list -A에서)를 입력합니다.

   Enter the Helm release name for Dapr, or press Enter to use the default name [dapr]:
   Enter the namespace where Dapr is installed, or press Enter to use the default namespace [dapr-system]:
   

--configuration-settings를 사용하여 기존 Dapr 설치 구성

Dapr 확장을 만들 때--configuration-settings 플래그를 사용하여 Dapr OSS에서 만든 Kubernetes 리소스를 사용하고 관리하도록 확장을 구성할 수 있습니다.

1. helm list -A 명령을 사용하여 현재 Dapr 설치의 세부 정보를 나열하고 출력에서 Dapr 릴리스 이름 및 네임스페이스를 저장합니다.

   helm list -A
   

2. az k8s-extension create를 사용하여 Dapr 확장을 만들고 --configuration-settings 플래그를 사용하여 Dapr 릴리스 이름 및 네임스페이스를 설정합니다.

   az k8s-extension create --cluster-type managedClusters \
   --cluster-name myAKSCluster \
   --resource-group myResourceGroup \
   --name dapr \
   --extension-type Microsoft.Dapr \
   --configuration-settings "existingDaprReleaseName=dapr" \
   --configuration-settings "existingDaprReleaseNamespace=dapr-system"
   

HA 모드 또는 배치 서비스 설정 업데이트

기존 Dapr 설치 위에 Dapr 확장을 설치하면 다음 메시지가 표시됩니다.

The extension will be installed on your existing Dapr installation. Note, if you have updated the default values for global.ha.* or dapr_placement.* in your existing Dapr installation, you must provide them in the configuration settings. Failing to do so will result in an error, since Helm upgrade will try to modify the StatefulSet. See <link> for more information.

Kubernetes는 StatefulSets의 제한된 필드에 대해서만 패치를 허용합니다. HA 모드 또는 배치 서비스 설정이 구성된 경우 업그레이드가 실패합니다. HA 모드 또는 배치 서비스 설정을 업데이트하려면 상태 저장 세트를 삭제한 다음 HA 모드를 업데이트해야 합니다.

1. kubectl delete 명령을 사용하여 상태 저장 세트를 삭제합니다.

   kubectl delete statefulset.apps/dapr-placement-server -n dapr-system
   

2. az k8s-extension update 명령을 사용하여 HA 모드를 업데이트합니다.

   az k8s-extension update --cluster-type managedClusters \
   --cluster-name myAKSCluster \
   --resource-group myResourceGroup \
   --name dapr \
   --extension-type Microsoft.Dapr \
   --auto-upgrade-minor-version true \  
   --configuration-settings "global.ha.enabled=true" \    
   

자세한 내용은 Dapr 프로덕션 지침을 참조하세요.

다음 단계

Dapr 및 사용 방법에 대해 자세히 알아봅니다.