Konfigurace rozšíření Dapr pro váš projekt Kubernetes Service (AKS) a Kubernetes s podporou Arc

Po dokončení požadavků pro instalaci rozšíření Dapr můžete nakonfigurovat rozšíření Dapr tak, aby fungovalo nejlépe pro vás a váš projekt pomocí různých možností konfigurace, například:

• Obměně certifikátů s vypršenou platností
• Zřizování dapr s povolenou vysokou dostupností
• Omezení počtu uzlů pomocí rozšíření Dapr
• Nastavení automatických aktualizací definice vlastních prostředků (CRD)
• Konfigurace oboru názvů vydaných verzí Dapr

Rozšíření umožňuje nastavit možnosti konfigurace Dapr pomocí --configuration-settings parametru v Azure CLI nebo configurationSettings vlastnosti v šabloně Bicep.

Obměna vlastních certifikátů, jejichž platnost vypršela

Můžete aktualizovat certficates a restartovat systémové služby.

Důležité

Pokud certifikáty explicitně nenakonfigurujete, dapr ve výchozím nastavení vygeneruje certifikáty podepsané svým držitelem, které jsou obecně platné po dobu 1 roku. V současné době se nedoporučuje používat certifikáty podepsané svým držitelem vygenerované nástrojem Dapr. Osvědčeným postupem je generovat vlastní certifikáty a aktualizovat je ručně.

Generování vlastních certifikátů

Vytvoření vlastního certifikátu; Například certifikát služby Azure Key Vault.

Ruční aktualizace vlastního certficate

Podle pokynů uvedených v opensourcové dokumentaci Dapr aktualizujte vlastní certifikáty ručně pomocí nástroje Helm a kubectl.

Zřízení Dapr s povolenou vysokou dostupností

Zřízení Dapr s vysokou dostupností povolenou nastavením parametru global.ha.enabled na true.

Azure CLI

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"

Poznámka:

Pokud jsou nastavení konfigurace citlivá a je třeba je chránit (například informace související s certifikáty), předejte --configuration-protected-settings parametr a hodnota bude chráněna před čtením.

Bicep

properties: {
  configurationSettings: {
    'global.ha.enabled': true
  }
}

Poznámka:

Pokud jsou nastavení konfigurace citlivá a je třeba je chránit (například informace související s certifikáty), použijte configurationProtectedSettings vlastnost a hodnota bude chráněna před čtením.

Pokud se nepředá žádné nastavení konfigurace, nastaví se výchozí nastavení dapr na:

  ha:
    enabled: true
    replicaCount: 3
    disruption:
      minimumAvailable: ""
      maximumUnavailable: "25%"
  prometheus:
    enabled: true
    port: 9090
  mtls:
    enabled: true
    workloadCertTTL: 24h
    allowedClockSkew: 15m

Seznam dostupných možností najdete v tématu Konfigurace Dapr.

Omezení rozšíření na určité uzly

V některých konfiguracích můžete chtít spustit dapr jenom na určitých uzlech. Rozšíření můžete omezit předáním nodeSelector konfigurace rozšíření. Pokud požadovaná nodeSelector hodnota obsahuje ., musíte je utéct z prostředí a rozšíření. Například následující konfigurace nainstaluje Dapr pouze na uzly s topology.kubernetes.io/zone: "us-east-1c":

Azure CLI

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"

Ke správě operačního global.daprControlPlaneOs systému a architektury použijte podporované verze a global.daprControlPlaneArch konfigurace:

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”

Bicep

properties: {
  configurationSettings: {
    'global.clusterType': 'managedclusters'
    'global.ha.enabled': true
    'global.nodeSelector.kubernetes\.io/zone': 'us-east-1c'
    
  }
}

Ke správě operačního global.daprControlPlaneOs systému a architektury použijte podporované verze a global.daprControlPlaneArch konfigurace:

properties: {
  configurationSettings: {
    'global.clusterType': 'managedclusters'
    'global.ha.enabled': true
    'global.daprControlPlaneOs': 'linux'
    'global.daprControlPlaneArch': 'amd64'
  }
}

Instalace Dapr v několika zónách dostupnosti v režimu vysoké dostupnosti

Ve výchozím nastavení služba umístění používá třídu úložiště typu standard_LRS. Při instalaci Dapr v režimu vysoké dostupnosti napříč několika zónami dostupnosti se doporučuje vytvořit zónově redundantní třídu úložiště. Pokud chcete například vytvořit zrs třídu úložiště typu, přidejte parametr storageaccounttype :

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

Při instalaci Dapr použijte třídu úložiště, kterou jste použili v souboru YAML:

Azure CLI

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"

Bicep

properties: {
  configurationSettings: {
    'dapr_placement.volumeclaims.storageClassName': 'custom-zone-redundant-storage'
    'global.ha.enabled': true  
  }
}

Konfigurace oboru názvů verze Dapr

Obor názvů vydaných verzí můžete nakonfigurovat.

Azure CLI

Rozšíření Dapr se ve výchozím nastavení nainstaluje do dapr-system oboru názvů. Chcete-li jej přepsat, použijte --release-namespace. Chcete-li předefinovat obor názvů, zahrňte cluster --scope.

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

Bicep

Rozšíření Dapr se ve výchozím nastavení nainstaluje do dapr-system oboru názvů. Pokud ho chcete přepsat, použijte releaseNamespace ho v clusteru scope k opětovnému definici oboru názvů.

properties: {
  scope: {
    cluster: {
      releaseNamespace: 'dapr-custom'
    }
  }
}

Zjistěte, jak nakonfigurovat obor názvů verze Dapr při migraci z open source Dapr na rozšíření Dapr.

Zobrazit aktuální nastavení konfigurace

az k8s-extension show Pomocí příkazu zobrazíte aktuální nastavení konfigurace Dapr:

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

Aktualizace nastavení konfigurace

Důležité

Některé možnosti konfigurace nelze po vytvoření změnit. Úpravy těchto možností vyžadují odstranění a odpočinek rozšíření, které platí pro následující nastavení:

• global.ha.*
• dapr_placement.*

Vysoká dostupnost je ve výchozím nastavení povolená. Zakázání vyžaduje odstranění a opětovné odstranění rozšíření.

Pokud chcete aktualizovat nastavení konfigurace Dapr, znovu vytvořte rozšíření s požadovaným stavem. Řekněme například, že jste dříve vytvořili a nainstalovali rozšíření pomocí následující konfigurace:

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" 

Pokud chcete aktualizovat dapr_operator.replicaCount hodnoty ze dvou na tři, použijte následující příkaz:

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"

Nastavení odchozího proxy serveru pro rozšíření Dapr pro místní službu Azure Arc

Pokud chcete pro AKS použít odchozí proxy server s rozšířením Dapr, můžete to udělat takto:

1. Nastavení proměnných prostředí proxy pomocí dapr.io/env poznámek:
   • HTTP_PROXY
   • HTTPS_PROXY
   • NO_PROXY
2. Instalace proxy certifikátu do sajdkáře.

Aktualizace verze instalace Dapr

Azure CLI

Pokud používáte konkrétní verzi Dapr a nemáte --auto-upgrade-minor-version k dispozici, můžete k upgradu nebo downgradu Dapr použít následující příkaz:

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

Bicep

Pokud používáte konkrétní verzi Dapr a nemáte autoUpgradeMinorVersion k dispozici, můžete k upgradu nebo downgradu Dapr použít následující vlastnost Bicep:

properties: {
  version: '1.12.0'
}

Předchozí příkaz aktualizuje pouze řídicí rovinu Dapr. Pokud chcete aktualizovat sajdkáře Dapr, restartujte nasazení aplikací:

kubectl rollout restart deploy/<DEPLOYMENT-NAME>

Použití imagí založených na Linuxu v Azure

Z Dapr verze 1.8.0 můžete použít image Azure Linuxu s rozšířením Dapr. Pokud je chcete použít, nastavte global.tag příznak:

Azure CLI

az k8s-extension update --cluster-type managedClusters \
--cluster-name myAKSCluster \
--resource-group myResourceGroup \
--name dapr \
--set global.tag=1.10.0-mariner

Bicep

properties: {
  global.tag: '1.10.0-mariner'
}

• Přečtěte si další informace o používání obrázků založených na Marineru s Dapr.
• Přečtěte si další informace o nasazení Azure Linuxu v AKS.

Zakázání automatických aktualizací CRD

Z Dapr verze 1.9.2 se při upgradu rozšíření automaticky upgradují CRD. Chcete-li toto nastavení zakázat, můžete nastavit hooks.applyCrds na falsehodnotu .

Azure CLI

az k8s-extension update --cluster-type managedClusters \
--cluster-name myAKSCluster \
--resource-group myResourceGroup \
--name dapr \
--configuration-settings "hooks.applyCrds=false"

Bicep

properties: {
  configurationSettings: {
    'hooks.applyCrds': false
  } 
}

Poznámka:

Disky CRD se použijí jenom v případě upgradů a během downgradů se přeskočí.

Splnění požadavků na síť

Rozšíření Dapr vyžaduje, aby fungovaly v AKS a Arc pro Kubernetes následující odchozí adresy URL https://:443 :

1. https://mcr.microsoft.com/daprio Adresa URL pro vyžádání artefaktů Dapr
2. Odchozí adresy URL vyžadované pro AKS nebo Arc pro Kubernetes

Další kroky

• Projděte si kurz nasazení pracovního postupu Dapr prostřednictvím rozšíření.
• Migrujte z open source Dapr na rozšíření Dapr.