Mevcut bir kapsayıcı uygulamasında Dapr'ı yapılandırma

Dapr'ı, çalışma zamanı bağlamını temel alan çeşitli bağımsız değişkenler ve ek açıklamalar kullanarak yapılandırabilirsiniz. Azure Container Apps'te kullanılabilen Dapr yapılandırmaları , uygulama kapsamı değişiklikleri olarak kabul edilir. Bir kapsayıcı uygulamasını birden çok düzeltme modunda çalıştırdığınızda, bu ayarlarda yapılan değişiklikler yeni bir düzeltme oluşturmaz. Bunun yerine, tüm mevcut düzeltmeler en güncel değerlerle yapılandırıldığından emin olmak için yeniden başlatılır.

Azure Container Apps, Dapr'ı etkinleştirebileceğiniz ve yapılandırabileceğiniz üç kanal sağlar:

• The Azure CLI
• Bicep veya Azure Resource Manager (ARM) şablonları
• Azure portal

Aşağıdaki tabloda, Azure Container Apps'te Dapr'yi etkinleştirmek için şu anda desteklenen Dapr sepet yapılandırmaları listesi özetlenmektedir:

Container Uygulamaları CLI	Şablon alanı	Açıklama
--enable-dapr	dapr.enabled	Kapsayıcı uygulamasında Dapr'i etkinleştirir.
--dapr-app-port	dapr.appPort	Uygulamanızın dinlediği ve Dapr'ın uygulamanızla iletişim kurmak için kullandığı bağlantı noktası.
--dapr-app-protocol	dapr.appProtocol	Uygulamanızın hangi protokolü kullandığını Dapr'a bildirir. Geçerli seçenekler http veya grpc. Varsayılan ayar şeklindedir http.
--dapr-app-id	dapr.appId	Hizmet bulma, durum kapsülleme ve pub/sub tüketici kimliği için kullanılan konteyner uygulamanız için özel bir Dapr tanımlayıcısı.
--dapr-max-request-size	dapr.httpMaxRequestSize	Büyük dosyaların karşıya yüklenmesini işlemek için HTTP ve gRPC sunucularının işleyebileceği istek gövdesinin maksimum boyutunu ayarlar. Varsayılan ayar şeklindedir 4 MB.
--dapr-read-buffer-size	dapr.httpReadBufferSize	Birden fazla KB'lık başlıklar gönderilirken işlenecek HTTP başlığı okuma arabelleğinin maksimum boyutunu ayarlar. Varsayılan ayar şeklindedir 4 KB.
--dapr-api-logging	dapr.enableApiLogging	Uygulamanızdan Dapr sidecar birimine yapılan API çağrılarını görüntülemenizi sağlar.
--dapr-log-level	dapr.logLevel	Dapr sidecar için günlük seviyesi ayarlar. İzin verilen değerler: hata ayıklama, hata, bilgi, uyarı. Varsayılan ayar şeklindedir info.
--dapr-app-health-enabled	dapr.appHealth.enabled	Boole biçimini kullanarak kapsayıcı uygulamanız için uygulama durumu denetimlerini etkinleştirmek için isteğe bağlı yapılandırma. Varsayılan ayar şeklindedir false. Dapr yan arabirim durumu, bu uygulamanın sağlık ayarına bağlıdır.
--dapr-app-health-path	dapr.appHealth.path	Uygulama kanalı HTTP olduğunda Dapr'ın sistem durumu yoklamaları için çağırdığını yolu ayarlar. Uygulama kanalı gRPC kullanıyorsa bu değer yoksayılır. Varsayılan ayar şeklindedir /healthz.
--dapr-app-health-probe-interval	dapr.appHealth.probeIntervalSeconds	Her sağlık kontrolü arasındaki saniye sayısı. Varsayılan ayar şeklindedir 3.
--dapr-app-health-probe-timeout	dapr.appHealth.probeTimeoutMilliseconds	Sağlık denetimi istekleri için milisaniye cinsinden zaman aşımı. Bu değer değerden daha probeIntervalSeconds küçük olmalıdır. Varsayılan ayar şeklindedir 500.
--dapr-app-health-threshold	dapr.appHealth.threshold	Uygulama iyi durumda değil olarak kabul edilmeden önce en fazla ardışık hata sayısı. Varsayılan ayar şeklindedir 3.
--dapr-max-concurrency	dapr.maxConcurrency	Uygulamanızın eşzamanlılığını sınırlar. Geçerli bir değer, değerinden 0büyük herhangi bir sayıdır. -1 eşzamanlılık sınırı olmadığı anlamına gelir.

CLI'yi kullanma

Azure CLI'yı kullanarak kapsayıcı uygulamanızda Dapr'i etkinleştirebilirsiniz.

az containerapp dapr enable

Daha fazla bilgi ve örnek için başvuru belgelerine bakın.

Bicep veya ARM Kullanma

Bicep veya ARM gibi bir altyapı kodu (IaC) şablonunu kullanmak için konteyner uygulamanın kaynak tanımlaması properties.configuration bölümünde aşağıdaki parametreleri belirtin.

Biceps

 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
  }

ARM

  "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
  }

Azure portalını kullanma

Dapr'i kapsayıcı uygulamalarınızın portal görünümü aracılığıyla da etkinleştirebilirsiniz.

Not

Başlamadan önce kendi Dapr bileşenlerinizi oluşturduğunuzdan emin olun. Dapr bileşenlerini portaldaki kapsayıcı uygulama ortamınız aracılığıyla bağlayabilirsiniz.

Azure portalında kapsayıcı uygulamanıza gidin ve kenar çubuğu menüsündeki Ayarlar'ın altında Dapr'ı seçin.

Varsayılan olarak, Dapr devre dışıdır. Dapr ayarlarını genişletmek için Etkin'i seçin.

Bileşen Uygulama Kimliğini girin ve uygun başlıkları seçin. Varsa, Bileşenler üst bilgisinin altında Dapr bileşenlerinizi kapsayıcı uygulaması ortamına eklemek ve yönetmek için bağlantıyı seçin.

Sonraki adım

Azure Container Apps'teki Dapr bileşenleri hakkında bilgi edinin