Azure Kubernetes Service (AKS) ve Arc özellikli Kubernetes projeniz için Dapr uzantısını yapılandırma
Dapr uzantısını yüklemek için önkoşulları tamamladıktan sonra, aşağıdakiler gibi çeşitli yapılandırma seçeneklerini kullanarak Dapr uzantısını sizin ve projeniz için en iyi şekilde çalışacak şekilde yapılandırabilirsiniz:
- Süresi dolan sertifikaları döndürme
- Yüksek kullanılabilirlik (HA) etkinleştirilmiş Dapr sağlama
- Hangi düğümlerinizin Dapr uzantısını kullandığını sınırlama
- Otomatik özel kaynak tanımı (CRD) güncelleştirmelerini ayarlama
- Dapr yayın ad alanını yapılandırma
Uzantı, Azure CLI'daki parametresini --configuration-settings
veya configurationSettings
bicep şablonundaki özelliği kullanarak Dapr yapılandırma seçeneklerini ayarlamanıza olanak tanır.
Süresi dolan özel sertifikaları döndürme
Süresi dolan sertifikaları güncelleştirebilir ve sistem hizmetlerinizi yeniden başlatabilirsiniz.
Önemli
Sertifikaları açıkça yapılandırmazsanız, Dapr varsayılan olarak 1 yıl boyunca geçerli olan otomatik olarak imzalanan sertifikalar oluşturur. Şu anda Dapr tarafından oluşturulan otomatik olarak imzalanan sertifikaların kullanılması önerilmez. En iyi yöntem, özel sertifikalar oluşturmak ve bunları el ile güncelleştirmektir.
Özel sertifikalar oluşturma
Kendi özel sertifikanızı oluşturun; örneğin, bir Azure Key Vault sertifikası.
Özel sertifikanızı el ile güncelleştirme
Helm ve kullanarak özel sertifikalarınızı el ile güncelleştirmek için Dapr açık kaynak belgelerinde sağlanan yönergeleri izleyin.kubectl
Yüksek kullanılabilirlik (HA) etkin olarak Dapr sağlama
Parametresini olarak ayarlayarak global.ha.enabled
Dapr'ı yüksek kullanılabilirlik (HA) etkin olarak true
sağlayın.
az k8s-extension create --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" \
--configuration-settings "dapr_operator.replicaCount=2"
Not
Yapılandırma ayarları hassassa ve korunması gerekiyorsa (örneğin, sertifikayla ilgili bilgiler), parametresini --configuration-protected-settings
geçirin; değer okunmaya karşı korunur.
Hiçbir yapılandırma ayarı geçirilmediyse, Dapr yapılandırması varsayılan olarak şunlardır:
ha:
enabled: true
replicaCount: 3
disruption:
minimumAvailable: ""
maximumUnavailable: "25%"
prometheus:
enabled: true
port: 9090
mtls:
enabled: true
workloadCertTTL: 24h
allowedClockSkew: 15m
Kullanılabilir seçeneklerin listesi için bkz . Dapr yapılandırması.
Uzantıyı belirli düğümler ile sınırlama
Bazı yapılandırmalarda, Yalnızca belirli düğümlerde Dapr çalıştırmak isteyebilirsiniz. Uzantı yapılandırmasında bir nodeSelector
geçirerek uzantıyı sınırlayabilirsiniz. İstenen nodeSelector
öğesini içeriyorsa .
, bunları kabuktan ve uzantıdan kaçmalısınız. Örneğin, aşağıdaki yapılandırma Dapr'ı yalnızca ile topology.kubernetes.io/zone: "us-east-1c"
düğümlere yükler:
az k8s-extension create --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" \
--configuration-settings "dapr_operator.replicaCount=2" \
--configuration-settings "global.nodeSelector.kubernetes\.io/zone=us-east-1c"
İşletim sistemi ve mimariyi yönetmek için ve global.daprControlPlaneArch
yapılandırmasının global.daprControlPlaneOs
desteklenen sürümlerini kullanın:
az k8s-extension create --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" \
--configuration-settings "dapr_operator.replicaCount=2" \
--configuration-settings "global.daprControlPlaneOs=linux” \
--configuration-settings "global.daprControlPlaneArch=amd64”
DAPR'yi HA modundayken birden çok kullanılabilirlik alanına yükleme
Varsayılan olarak, yerleştirme hizmeti türünde standard_LRS
bir depolama sınıfı kullanır. Dapr'ı birden çok kullanılabilirlik alanında HA modunda yüklerken alanlar arası yedekli depolama sınıfı oluşturmanız önerilir. Örneğin, tür zrs
depolama sınıfı oluşturmak için parametresini storageaccounttype
ekleyin:
kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
name: custom-zone-redundant-storage
provisioner: disk.csi.azure.com
reclaimPolicy: Delete
allowVolumeExpansion: true
volumeBindingMode: WaitForFirstConsumer
parameters:
storageaccounttype: Premium_ZRS
Dapr'ı yüklerken YAML dosyasında kullandığınız depolama sınıfını kullanın:
az k8s-extension create --cluster-type managedClusters
--cluster-name XXX
--resource-group XXX
--name XXX
--extension-type Microsoft.Dapr
--auto-upgrade-minor-version XXX
--version XXX
--configuration-settings "dapr_placement.volumeclaims.storageClassName=custom-zone-redundant-storage"
Dapr yayın ad alanını yapılandırma
Yayın ad alanını yapılandırabilirsiniz.
Dapr uzantısı varsayılan olarak ad alanına dapr-system
yüklenir. Geçersiz kılmak için kullanın --release-namespace
. Ad alanını yeniden tanımlamak için kümesini --scope
ekleyin.
az k8s-extension create \
--cluster-type managedClusters \
--cluster-name dapr-aks \
--resource-group dapr-rg \
--name my-dapr-ext \
--extension-type microsoft.dapr \
--release-train stable \
--auto-upgrade false \
--version 1.9.2 \
--scope cluster \
--release-namespace dapr-custom
Dapr açık kaynak'den Dapr uzantısına geçiş yaparken Dapr yayın ad alanını yapılandırmayı öğrenin.
Geçerli yapılandırma ayarlarını göster
az k8s-extension show
Geçerli Dapr yapılandırma ayarlarını göstermek için komutunu kullanın:
az k8s-extension show --cluster-type managedClusters \
--cluster-name myAKSCluster \
--resource-group myResourceGroup \
--name dapr
Yapılandırma ayarlarını güncelleştirme
Önemli
Bazı yapılandırma seçenekleri oluşturma işleminden sonra değiştirilemez. Bu seçeneklerde yapılan ayarlamalar, aşağıdaki ayarlar için geçerli olan uzantının silinmesini ve yeniden kullanılmasını gerektirir:
global.ha.*
dapr_placement.*
HA varsayılan olarak etkindir. Devre dışı bırakmak, uzantının silinmesini ve yeniden kullanılmasını gerektirir.
Dapr yapılandırma ayarlarınızı güncelleştirmek için uzantıyı istenen durumla yeniden oluşturun. Örneğin, uzantıyı daha önce aşağıdaki yapılandırmayı kullanarak oluşturup yüklediğinizi varsayalım:
az k8s-extension create --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" \
--configuration-settings "dapr_operator.replicaCount=2"
öğesini ikiden üçe güncelleştirmek dapr_operator.replicaCount
için aşağıdaki komutu kullanın:
az k8s-extension create --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" \
--configuration-settings "dapr_operator.replicaCount=3"
Şirket içi Azure Arc için Dapr uzantısının giden ara sunucusunu ayarlama
AKS için Dapr uzantısıyla giden ara sunucu kullanmak istiyorsanız, bunu şu şekilde yapabilirsiniz:
- Ek açıklamaları kullanarak
dapr.io/env
ara sunucu ortam değişkenlerini ayarlama:HTTP_PROXY
HTTPS_PROXY
NO_PROXY
- Ara sunucu sertifikasını sepete yükleme.
Dapr yükleme sürümünüzü güncelleştirme
Belirli bir Dapr sürümü kullanıyorsanız ve kullanılabilir durumda değilseniz --auto-upgrade-minor-version
, Dapr'yi yükseltmek veya düşürmek için aşağıdaki komutu kullanabilirsiniz:
az k8s-extension update --cluster-type managedClusters \
--cluster-name myAKSCluster \
--resource-group myResourceGroup \
--name dapr \
--version 1.12.0 # Version to upgrade or downgrade to
Yukarıdaki komut yalnızca Dapr denetim düzlemini güncelleştirir. Dapr sepetlerini güncelleştirmek için uygulama dağıtımlarınızı yeniden başlatın:
kubectl rollout restart deploy/<DEPLOYMENT-NAME>
Azure Linux tabanlı görüntüleri kullanma
Dapr sürüm 1.8.0'dan Azure Linux görüntülerini Dapr uzantısıyla kullanabilirsiniz. Bunları kullanmak için bayrağını global.tag
ayarlayın:
az k8s-extension update --cluster-type managedClusters \
--cluster-name myAKSCluster \
--resource-group myResourceGroup \
--name dapr \
--set global.tag=1.10.0-mariner
- Dapr ile Mariner tabanlı görüntüleri kullanma hakkında daha fazla bilgi edinin.
- AKS'de Azure Linux dağıtma hakkında daha fazla bilgi edinin.
Otomatik CRD güncelleştirmelerini devre dışı bırakma
Dapr sürüm 1.9.2'den uzantı yükseltildiğinde CRD'ler otomatik olarak yükseltilir. Bu ayarı devre dışı bırakmak için olarak ayarlayabilirsiniz hooks.applyCrds
false
.
az k8s-extension update --cluster-type managedClusters \
--cluster-name myAKSCluster \
--resource-group myResourceGroup \
--name dapr \
--configuration-settings "hooks.applyCrds=false"
Not
CRD'ler yalnızca yükseltme durumunda uygulanır ve sürüm düşürme işlemleri sırasında atlanır.
Ağ gereksinimlerini karşılama
Dapr uzantısı, Kubernetes için AKS ve Arc üzerinde çalışması için aşağıdaki giden URL'leri https://:443
gerektirir:
https://mcr.microsoft.com/daprio
Dapr yapıtlarını çekmek için URL.- Kubernetes için AKS veya Arc için gereken giden URL'ler.
Sonraki Adımlar
Azure Kubernetes Service