Azure Kubernetes Service (AKS) ve Arc özellikli Kubernetes için Dapr uzantısını yükleme

Başlamadan önce

Küme uzantıları için Azure CLI uzantısını ekleme

k8s-extension Aşağıdaki komutları çalıştırarak Azure CLI uzantısını yükleyin:

az extension add --name k8s-extension

k8s-extension Uzantı zaten yüklüyse, aşağıdaki komutu kullanarak uzantıyı en son sürüme güncelleştirebilirsiniz:

az extension update --name k8s-extension

Kaynak sağlayıcısını KubernetesConfiguration kaydetme

Küme uzantılarını henüz kullanmıyorsanız kaynak sağlayıcısını aboneliğinize kaydetmeniz gerekebilir. Aşağıdaki örnekte gösterildiği gibi az provider list komutunu kullanarak sağlayıcı kaydının durumunu de kontrol edebilirsiniz:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Microsoft.KubernetesConfiguration sağlayıcısı, aşağıdaki örnek çıktıda gösterildiği gibi Kayıtlı olarak bildirmelidir:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Sağlayıcı NotRegistered olarak görünüyorsa, aşağıdaki örnekte gösterildiği gibi az provider register komutunu kullanarak sağlayıcıyı kaydedin:

az provider register --namespace Microsoft.KubernetesConfiguration

ExtenstionTypes Özelliği Azure aboneliğinize kaydetme

Özelliğin ExtensionTypes Azure aboneliğinize kaydedilmesi gerekir. Terminalde doğru abonelikte olduğunuzu doğrulayın:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

ExtenstionTypes Özelliği kaydedin.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Özellik kaydı biraz zaman alabilir. Birkaç dakika sonra aşağıdaki komutu kullanarak kayıt durumunu denetleyin:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Uzantıyı oluşturma ve AKS veya Arc özellikli Kubernetes kümenize Dapr yükleme

Dapr uzantısını yüklerken kümenizin türüne karşılık gelen bayrak değerini kullanın:

• AKS kümesi: --cluster-type managedClusters.
• Arc özellikli Kubernetes kümesi: --cluster-type connectedClusters.

AKS veya Arc özellikli Kubernetes kümenize Dapr yükleyen Dapr uzantısını oluşturun.

Örneğin, AKS kümenize Dapr uzantısı aracılığıyla Dapr'ın en son sürümünü yükleyin:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false

Yönetilen AKS kümenizi en son sürüme güncelleştirin

Ortamınıza (geliştirme, test veya üretim) bağlı olarak en son kararlı Dapr sürümleriyle güncel bilgilere sahip olabilirsiniz.

Yayın treni seçme

Uzantıyı yapılandırırken, Belirli bir sürüm treninden Dapr'ı yüklemeyi seçebilirsiniz. İki sürüm eğitme değerinden birini belirtin:

Örneğin:

--release-train stable

Dapr denetim düzlemi için otomatik güncelleştirmeleri yapılandırma

Dapr'ı bir sürüm belirtmeden yüklerseniz, --auto-upgrade-minor-version dapr denetim düzlemini yeni sürümlerde ikincil sürümünü otomatik olarak güncelleştirecek şekilde yapılandırarak otomatik olarak etkinleştirilir.

parametresini belirtip --auto-upgrade-minor-version değerini falseolarak ayarlayarak otomatik güncelleştirmeyi devre dışı bırakabilirsiniz.

Dapr sürüm oluşturma biçimidirMAJOR.MINOR.PATCH, yani ikincil sürüm yükseltmesi anlamına gelir 1.11.0 1.12.0.

--auto-upgrade-minor-version true

Kullanılabilir en son kararlı Dapr sürümlerini görüntüleme

Üretim ortamında en son Dapr sürümüne yükseltmek için el ile yükseltmeniz gerekir. Yönetilen AKS kümenizde kullanılabilen kararlı Dapr sürümlerinin listesini görüntüleyerek başlayın. Şu komutu çalıştırın:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

Yönetilen AKS kümenizde kullanılabilen en son kararlı Dapr sürümünü görmek için aşağıdaki komutu çalıştırın:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

Konuma göre kullanılabilen kararlı Dapr sürümlerinin listesini görüntülemek için:

1. Özelliği Azure aboneliğinize kaydettiğinizden ExtenstionTypes emin olun.
2. Aşağıdaki komutu çalıştırın.

az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr

Ardından Dapr'ı en son kararlı sürüme el ile güncelleştirin.

Belirli bir Dapr sürümünü hedefleme

Dapr'ın belirli bir sürümünü yüklemek veya önceki bir sürüme geri dönmek için aynı komut satırı bağımsız değişkeni kullanılır. false Yüklemek istediğiniz Dapr sürümüne ve --version sürümüne ayarlayın--auto-upgrade-minor-version. version Parametresi atlanırsa, uzantı En son Dapr sürümünü yükler. Örneğin, Dapr 1.13.5 kullanmak için:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.13.5

Başlamadan önce

Kaynak sağlayıcısını KubernetesConfiguration kaydetme

Küme uzantılarını henüz kullanmıyorsanız kaynak sağlayıcısını aboneliğinize kaydetmeniz gerekebilir. Aşağıdaki örnekte gösterildiği gibi az provider list komutunu kullanarak sağlayıcı kaydının durumunu de kontrol edebilirsiniz:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

Microsoft.KubernetesConfiguration sağlayıcısı, aşağıdaki örnek çıktıda gösterildiği gibi Kayıtlı olarak bildirmelidir:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Sağlayıcı NotRegistered olarak görünüyorsa, aşağıdaki örnekte gösterildiği gibi az provider register komutunu kullanarak sağlayıcıyı kaydedin:

az provider register --namespace Microsoft.KubernetesConfiguration

ExtenstionTypes Özelliği Azure aboneliğinize kaydetme

Özelliğin ExtensionTypes Azure aboneliğinize kaydedilmesi gerekir. Terminalde doğru abonelikte olduğunuzu doğrulayın:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

ExtenstionTypes Özelliği kaydedin.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Özellik kaydı biraz zaman alabilir. Birkaç dakika sonra aşağıdaki komutu kullanarak kayıt durumunu denetleyin:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

AKS veya Arc özellikli Kubernetes kümenizde Dapr uzantısını dağıtma

Aşağıdaki örneğe benzer bir Bicep şablonu oluşturun ve Dapr uzantısını mevcut kümenize dağıtın.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedClusters 'Microsoft.ContainerService/managedClusters@2023-05-02-preview' existing = {
  name: clusterName
}

resource daprExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'dapr'
  scope: existingManagedClusters
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    autoUpgradeMinorVersion: true
    configurationProtectedSettings: {}
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.dapr'
    releaseTrain: 'stable'
    scope: {
      cluster: {
        releaseNamespace: 'dapr-system'
      }
    }
    version: '1.11.2'
  }
}

Aşağıdaki değerleri gerçek kaynak grubunuz ve küme adlarınız olarak değiştirerek aşağıdaki değişkenleri ayarlayın.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

komutunu kullanarak Bicep şablonunu dağıtın az deployment group .

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

Dapr denetim düzlemi için otomatik güncelleştirmeleri yapılandırma

Dapr'ı bir sürüm belirtmeden dağıtırsanız, autoUpgradeMinorVersion dapr denetim düzlemini yeni sürümlerde ikincil sürümünü otomatik olarak güncelleştirecek şekilde yapılandırarak otomatik olarak etkinleştirilir.

parametresini belirtip autoUpgradeMinorVersion değerini falseolarak ayarlayarak otomatik güncelleştirmeyi devre dışı bırakabilirsiniz.

Dapr sürüm oluşturma biçimidirMAJOR.MINOR.PATCH, yani ikincil sürüm yükseltmesi anlamına gelir 1.11.0 1.12.0.

properties {
  autoUpgradeMinorVersion: true
}

Belirli bir Dapr sürümünü hedefleme

false Yüklemek istediğiniz Dapr sürümüne ve version sürümüne ayarlayınautoUpgradeMinorVersion. autoUpgradeMinorVersion parametresi olarak ayarlanırsa trueve version parametresi atlanırsa, uzantı En son Dapr sürümünü yükler.

Örneğin, Dapr 1.11.2 kullanmak için:

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

Yayın treni seçme

Uzantıyı yapılandırırken, Belirli bir sürüm treninden Dapr'ı yüklemeyi seçebilirsiniz. İki sürüm eğitme değerinden birini belirtin:

Örneğin:

properties: {
  releaseTrain: 'stable'
}