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

Dapr , bulutta ve uçta çalışan, dillerin ve geliştirici çerçevelerinin çeşitliliğini benimsemiş dayanıklı, durum bilgisi olmayan ve durum bilgisi olan uygulamalar oluşturmayı basitleştirir. Dapr'ın sepet mimarisiyle kod platformunuzu belirsiz tutarken mikro hizmetler oluşturmayla ilgili zorluklarla da başa çıkabilirsiniz, örneğin:

• Diğer hizmetleri güvenilir ve güvenli bir şekilde çağırma
• Pub/sub ile olay odaklı uygulamalar oluşturma
• Birden çok bulut hizmeti ve ana bilgisayar arasında taşınabilir uygulamalar oluşturma (örneğin, Kubernetes ve vm)

Not

Dapr'ı bir Kubernetes üretim ortamına yüklemeyi planlıyorsanız, üretim kullanımı için Dapr yönergeleri belgeleri sayfasına bakın.

Nasıl çalışır?

Dapr uzantısı, AKS veya Arc özellikli Kubernetes kümenizde Dapr denetim düzlemini sağlamak için Azure CLI veya Bicep şablonunu kullanarak aşağıdaki Dapr hizmetlerini oluşturur:

Dapr hizmeti	Açıklama
dapr-operator	Dapr için bileşen güncelleştirmelerini ve Kubernetes hizmet uç noktalarını yönetir (durum depoları, pub/subs vb.)
dapr-sidecar-injector	Dapr'ı açıklamalı dağıtım podlarına ekler ve ortam değişkenlerini DAPR_HTTP_PORT ekler ve DAPR_GRPC_PORT kullanıcı tanımlı uygulamaların Dapr bağlantı noktası değerlerini sabit kodlamadan dapr ile kolayca iletişim kurmasını sağlar.
dapr-placement	Yalnızca aktörler için kullanılır. Aktör örneklerini podlarla eşleyen eşleme tabloları oluşturur.
dapr-sentry	Hizmetler arasında mTLS'i yönetir ve sertifika yetkilisi olarak görev yapar. Daha fazla bilgi için güvenliğe genel bakış'ı okuyun.

Kümenize Dapr yüklendikten sonra, dağıtımlarınıza birkaç ek açıklama ekleyerek Dapr yapı taşı API'lerini kullanarak geliştirmeye başlayabilirsiniz. Yapı taşı API'lerine ve bunların en iyi şekilde nasıl kullanılacağına daha ayrıntılı bir genel bakış için bkz . Dapr yapı taşları genel bakış.

Uyarı

Dapr'ı AKS veya Arc özellikli Kubernetes uzantısı aracılığıyla yüklerseniz, dapr CLI yerine Dapr'ın gelecekteki yönetimi için uzantıyı kullanmaya devam edebilirsiniz. İki aracı birleştirmek çakışmalara neden olabilir ve istenmeyen davranışlara neden olabilir.

Önkoşullar

• Azure aboneliği. Yok mu? Ücretsiz bir hesap oluşturun.
• Azure CLI'nın en son sürümünü yükleyin.
• Henüz bir kümeniz yoksa bir AKS kümesi oluşturmanız veya Arc özellikli bir Kubernetes kümesi bağlamanız gerekir.
• Azure Kubernetes Service RBAC Yönetici rolünüz olduğundan emin olun

Dapr uzantısını nasıl yüklemek, dağıtmak ve yapılandırmak istediğinizi seçin.

Azure CLI

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

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

Daha önce küme uzantılarını kullanmadıysanız kaynak sağlayıcısını aboneliğinize kaydetmeniz gerekebilir. Aşağıdaki örnekte gösterildiği gibi [az provider list][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

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.

Not

AKS kümenizde Dapr OSS kullanıyorsanız ve AKS için Dapr uzantısını yüklemek istiyorsanız, Dapr uzantısına başarıyla geçiş hakkında daha fazla bilgi edinin.

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

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

Uyarı

Dapr denetim düzleminde otomatik güncelleştirmeleri yalnızca geliştirme veya test ortamlarında etkinleştirebilirsiniz. Otomatik yükseltme üretim ortamları için uygun değildir.

Dapr'ı bir sürüm belirtmeden yüklerseniz, --auto-upgrade-minor-versiondapr 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.01.12.0.

--auto-upgrade-minor-version true

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

Not

Dapr, yalnızca geçerli ve önceki sürümler de dahil olmak üzere sıralı bir pencereyle desteklenir. Bu desteklenen sürümlerle güncel kalmak operasyonel sorumluluğunuzdadır. Dapr'ın eski bir sürümüne sahipseniz desteklenen bir sürüme ulaşmak için ara yükseltmeler yapmanız gerekebilir.

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.11.2 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.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:

Value	Açıklama
stable	Varsayılan.
dev	Erken sürümler deneysel özellikler içerebilir. Üretim için uygun değildir.

Örneğin:

--release-train stable

Bicep

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

Daha önce küme uzantılarını kullanmadıysanız kaynak sağlayıcısını aboneliğinize kaydetmeniz gerekebilir. Aşağıdaki örnekte gösterildiği gibi [az provider list][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

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

Dapr uzantısını mevcut kümenize dağıtmak için aşağıdaki örneğe benzer bir Bicep şablonu oluşturun.

@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

Uyarı

Dapr denetim düzleminde otomatik güncelleştirmeleri yalnızca geliştirme veya test ortamlarında etkinleştirebilirsiniz. Otomatik yükseltme üretim ortamları için uygun değildir.

Dapr'ı bir sürüm belirtmeden dağıtırsanız, autoUpgradeMinorVersiondapr 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.01.12.0.

properties {
  autoUpgradeMinorVersion: true
}

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

Not

Dapr, yalnızca geçerli ve önceki sürümler de dahil olmak üzere sıralı bir pencereyle desteklenir. Bu desteklenen sürümlerle güncel kalmak operasyonel sorumluluğunuzdadır. Dapr'ın eski bir sürümüne sahipseniz desteklenen bir sürüme ulaşmak için ara yükseltmeler yapmanız gerekebilir.

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:

Value	Açıklama
stable	Varsayılan.
dev	Erken sürümler deneysel özellikler içerebilir. Üretim için uygun değildir.

Örneğin:

properties: {
  releaseTrain: 'stable'
}

Uzantı hatalarını giderme

Uzantı oluşturulamıyor veya güncelleştirilemiyorsa, Dapr uzantısı sorun giderme kılavuzunda önerileri ve çözümleri deneyin.

Dapr sorunlarını giderme

Sık karşılaşılan Dapr sorunları ve çözümleri kılavuzu aracılığıyla Dapr hatalarını giderme.

Uzantıyı silme

Uzantıyı silmeniz ve AKS kümenizden Dapr'ı kaldırmanız gerekiyorsa aşağıdaki komutu kullanabilirsiniz:

az k8s-extension delete --resource-group myResourceGroup --cluster-name myAKSCluster --cluster-type managedClusters --name dapr

Veya yalnızca Bicep şablonunu kaldırın.

Sonraki Adımlar

• Dapr uzantısında ayarlayabileceğiniz ek ayarlar ve tercihler hakkında daha fazla bilgi edinin.
• AKS kümenizde Dapr'ı başarıyla sağladıktan sonra örnek bir uygulama dağıtmayı deneyin.
• AKS için Dapr uzantınızda Dapr İş Akışını deneyin