Konfiguracja Dapr w istniejącej aplikacji kontenerowej

Język Dapr można skonfigurować przy użyciu różnych argumentów i adnotacji na podstawie kontekstu środowiska uruchomieniowego. Konfiguracje języka Dapr dostępne w usłudze Azure Container Apps są uznawane za zmiany zakresu aplikacji . Po uruchomieniu aplikacji kontenera w trybie wielokrotnej wersji zmiany tych ustawień nie tworzą nowej poprawki. Zamiast tego wszystkie istniejące poprawki są uruchamiane ponownie, aby upewnić się, że są skonfigurowane z najbardziej aktualnymi wartościami.

Usługa Azure Container Apps udostępnia trzy kanały, za pomocą których można włączyć i skonfigurować język Dapr:

Interfejs wiersza polecenia platformy Azure
Szablony infrastruktury jako kodu (IaC), takie jak szablony Bicep lub Azure Resource Manager (ARM)
Witryna Azure Portal

W poniższej tabeli przedstawiono listę obecnie obsługiwanych konfiguracji przyczepki języka Dapr na potrzeby włączania języka Dapr w usłudze Azure Container Apps:

Interfejs wiersza polecenia usługi Container Apps	Pole szablonu	opis
`--enable-dapr`	`dapr.enabled`	Włącza funkcję Dapr w aplikacji kontenera.
`--dapr-app-port`	`dapr.appPort`	Port, na którym nasłuchuje aplikacja, na którym jest używana usługa Dapr do komunikowania się z aplikacją
`--dapr-app-protocol`	`dapr.appProtocol`	Informuje dapr, którego protokołu używa aplikacja. Prawidłowe opcje to `http` lub `grpc`. Ustawieniem domyślnym jest `http`.
`--dapr-app-id`	`dapr.appId`	Unikatowy identyfikator języka Dapr dla aplikacji kontenera używanej do odnajdywania usługi, hermetyzacji stanu i identyfikatora odbiorcy pub/sub.
`--dapr-max-request-size`	`dapr.httpMaxRequestSize`	Ustaw maksymalny rozmiar serwerów http i grpc treści żądania do obsługi przekazywania dużych plików. Ustawieniem domyślnym jest `4 MB`.
`--dapr-read-buffer-size`	`dapr.httpReadBufferSize`	Ustaw maksymalny rozmiar buforu odczytu nagłówka http w pliku , aby obsłużyć podczas wysyłania nagłówków z wieloma kb. Ustawieniem domyślnym jest `4 KB`.
`--dapr-api-logging`	`dapr.enableApiLogging`	Umożliwia wyświetlanie wywołań interfejsu API z aplikacji do przyczepki Dapr.
`--dapr-log-level`	`dapr.logLevel`	Ustaw poziom dziennika dla przyczepki Dapr. Dozwolone wartości: debugowanie, błąd, informacje, ostrzeganie. Ustawieniem domyślnym jest `info`.
`--dapr-app-health-enabled`	`dapr.appHealth.enabled`	Opcjonalna konfiguracja umożliwiająca sprawdzanie kondycji aplikacji dla aplikacji kontenera przy użyciu formatu logicznego. Ustawieniem domyślnym jest `false`. Kondycja sidecara Dapr jest powiązana z tym ustawieniem kondycji aplikacji.
`--dapr-app-health-path`	`dapr.appHealth.path`	Ustaw ścieżkę wywoływaną przez narzędzie Dapr dla sond kondycji, gdy kanał aplikacji to HTTP. Ta wartość jest ignorowana, jeśli kanał aplikacji używa gRPC. Ustawieniem domyślnym jest `/healthz`.
`--dapr-app-health-probe-interval`	`dapr.appHealth.probeIntervalSeconds`	Liczba sekund między poszczególnymi sondami kondycji. Ustawieniem domyślnym jest `3`.
`--dapr-app-health-probe-timeout`	`dapr.appHealth.probeTimeoutMilliseconds`	Limit czasu w milisekundach na żądania sondy zdrowotnej. Ta wartość musi być mniejsza niż `probeIntervalSeconds` wartość. Ustawieniem domyślnym jest `500`.
`--dapr-app-health-threshold`	`dapr.appHealth.threshold`	Maksymalna liczba kolejnych niepowodzeń przed uznaniem aplikacji za niezdrową. Ustawieniem domyślnym jest `3`.
`--dapr-max-concurrency`	`dapr.maxConcurrency`	Ogranicz współbieżność aplikacji. Prawidłowa wartość to dowolna liczba większa niż `0`. `-1` oznacza brak limitu współbieżności.

Korzystanie z interfejsu wiersza polecenia

Możesz włączyć język Dapr w aplikacji kontenera przy użyciu interfejsu wiersza polecenia platformy Azure.

az containerapp dapr enable

Aby uzyskać więcej informacji i przykładów, zobacz dokumentację referencyjną.

Korzystanie z Bicep lub ARM

W przypadku korzystania z szablonu IaC określ następujące argumenty w properties.configuration sekcji definicji zasobu aplikacji kontenera.

Biceps
RAMIĘ

 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
  }

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

Korzystanie z witryny Azure Portal

Możesz również włączyć język Dapr za pośrednictwem widoku portalu aplikacji kontenera.

Uwaga

Przed rozpoczęciem upewnij się, że masz już utworzone własne składniki języka Dapr. Składniki języka Dapr można połączyć za pośrednictwem środowiska aplikacji kontenera w portalu.

Przejdź do aplikacji kontenera w witrynie Azure Portal i wybierz pozycję Dapr w obszarze Ustawienia w menu po lewej stronie.

Domyślnie dapr jest wyłączony. Wybierz pozycję Włączone, aby rozwinąć ustawienia języka Dapr.

Zrzut ekranu przedstawiający domyślne wyłączenie języka Dapr i lokalizację, którą należy kliknąć, aby ją włączyć.

Wprowadź identyfikator aplikacji składnika i wybierz odpowiednie nagłówki. Jeśli ma to zastosowanie, w nagłówku Składniki wybierz link, aby dodać składniki języka Dapr i zarządzać nimi w środowisku aplikacji kontenera.

Zrzut ekranu przedstawiający niektóre podstawowe ustawienia włączania języka Dapr w aplikacji kontenera.

Następne kroki

Dowiedz się więcej o składnikach języka Dapr w usłudze Azure Container Apps.

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-05-07