Konfigurace Dapr v existující aplikaci kontejneru

Dapr můžete nakonfigurovat pomocí různých argumentů a poznámek na základě kontextu modulu runtime. Konfigurace Dapr dostupné v Azure Container Apps se považují za změny rozsahu aplikace . Když spustíte aplikaci typu kontejner v režimu více revizí, změny těchto nastavení nevytvoří novou revizi. Místo toho se všechny existující revize restartují, aby se zajistilo, že jsou nakonfigurované s nejaktuálnějšími hodnotami.

Azure Container Apps poskytuje tři kanály, pomocí kterých můžete povolit a nakonfigurovat Dapr:

Následující tabulka uvádí aktuálně podporované konfigurace pro použití Dapr sidecaru v Azure Container Apps, které umožňují použití Dapr:

Container Apps CLI Pole Šablony Popis
--enable-dapr dapr.enabled Povolí Dapr pro aplikaci kontejneru.
--dapr-app-port dapr.appPort Port, na kterém vaše aplikace naslouchá, který Dapr používá ke komunikaci s vaší aplikací.
--dapr-app-protocol dapr.appProtocol Řekne Dapr, jaký protokol vaše aplikace používá. Platné možnosti jsou http nebo grpc. Výchozí nastavení je http.
--dapr-app-id dapr.appId Jedinečný identifikátor Dapr pro vaši aplikaci kontejneru používanou ke zjišťování služby, zapouzdření stavu a ID pub/sub consumer.
--dapr-max-request-size dapr.httpMaxRequestSize Nastaví maximální velikost těla požadavku pro HTTP a GRPC servery, aby mohly zpracovávat nahrávání velkých souborů. Výchozí nastavení je 4 MB.
--dapr-read-buffer-size dapr.httpReadBufferSize Nastaví maximální velikost vyrovnávací paměti pro čtení HTTP hlavičky, aby mohla zpracovat hlavičky s několika kilobajty při odesílání. Výchozí nastavení je 4 KB.
--dapr-api-logging dapr.enableApiLogging Umožňuje zobrazit volání rozhraní API z vaší aplikace do sajdkáru Dapr.
--dapr-log-level dapr.logLevel Nastaví úroveň protokolu pro Dapr sidecar. Povolené hodnoty: debug, chyba, info, varování. Výchozí nastavení je info.
--dapr-app-health-enabled dapr.appHealth.enabled Volitelná konfigurace pro povolení kontrol stavu aplikace pro vaši aplikaci kontejneru pomocí logického formátu Výchozí nastavení je false. Stav Dapr sidecaru souvisí s tímto nastavením stavu aplikace.
--dapr-app-health-path dapr.appHealth.path Nastaví cestu, kterou Dapr vyvolá pro sondy stavu, když je kanál aplikace HTTP. Tato hodnota se ignoruje, pokud kanál aplikace používá gRPC. Výchozí nastavení je /healthz.
--dapr-app-health-probe-interval dapr.appHealth.probeIntervalSeconds Počet sekund mezi jednotlivými sondami stavu. Výchozí nastavení je 3.
--dapr-app-health-probe-timeout dapr.appHealth.probeTimeoutMilliseconds Časový limit v milisekundách pro dotazy sondy stavu Tato hodnota musí být menší než probeIntervalSeconds hodnota. Výchozí nastavení je 500.
--dapr-app-health-threshold dapr.appHealth.threshold Maximální počet po sobě jdoucích selhání před tím, než je aplikace považována za špatnou. Výchozí nastavení je 3.
--dapr-max-concurrency dapr.maxConcurrency Omezuje souběžnost vaší aplikace. Platná hodnota je libovolné číslo větší než 0. -1 znamená žádný limit souběžnosti.

Použití rozhraní příkazového řádku

Dapr můžete ve své aplikaci kontejneru povolit pomocí Azure CLI.

az containerapp dapr enable

Další informace a příklady najdete v referenční dokumentaci.

Použití Bicep nebo ARM

Pokud chcete použít šablonu infrastruktury jako kódu (IaC), například Bicep nebo ARM, zadejte v properties.configuration části definice prostředku aplikace kontejneru následující argumenty.

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
   httpReadBufferSize: 30
   httpMaxRequestSize: 10
   logLevel: 'debug'
   enableApiLogging: true
   appHealth: {
     enabled: true
     path: '/health'
     probeIntervalSeconds: 3
     probeTimeoutMilliseconds: 1000
     threshold: 3
   },
   maxConcurrency: 10
  }

Pomocí webu Azure Portal

Dapr můžete také povolit prostřednictvím zobrazení portálu vašich aplikací kontejnerů.

Poznámka:

Než začnete, ujistěte se, že jste už vytvořili vlastní komponenty Dapr. Komponenty Dapr můžete připojit prostřednictvím prostředí aplikace kontejneru na portálu.

Přejděte do své kontejnerové aplikace v portálu Azure a v nabídce bočního panelu v části Nastavení vyberte Dapr.

Snímek obrazovky znázorňující, kde povolit Dapr v aplikaci kontejneru prostřednictvím zobrazení webu Azure Portal

Ve výchozím nastavení je Dapr zakázaný. Výběrem možnosti Povoleno rozbalíte nastavení Dapr.

Snímek obrazovky s deaktivovaným Dapr ve výchozím nastavení a kde kliknout pro jeho povolení.

Zadejte ID aplikace komponenty a vyberte příslušné nadpisy. Pokud je to možné, vyberte v hlavičce Součásti odkaz pro přidání a správu komponent Dapr do prostředí aplikace kontejneru.

Snímek obrazovky zobrazující některá základní nastavení pro povolení Dapr v aplikaci kontejneru

Další krok