Rozszerzenie dapr dla usługi Azure Functions

Artykuł
05/10/2024

Rozszerzenie Dapr dla usługi Azure Functions to zestaw narzędzi i usług, które umożliwiają deweloperom łatwe integrowanie usługi Azure Functions z platformą Distributed Application Runtime (Dapr).

Azure Functions to oparta na zdarzeniach usługa obliczeniowa, która udostępnia zestaw wyzwalaczy i powiązań umożliwiających łatwe łączenie się z innymi usługami platformy Azure. Język Dapr udostępnia zestaw bloków konstrukcyjnych i najlepszych rozwiązań dotyczących tworzenia aplikacji rozproszonych, w tym mikrousług, zarządzania stanem, obsługi komunikatów pub/podrzędnych i nie tylko.

Dzięki integracji między językami Dapr i Functions można tworzyć funkcje reagujące na zdarzenia z języka Dapr lub systemów zewnętrznych.

Akcja	Kierunek	Typ
Wyzwalanie w powiązaniu wejściowym języka Dapr	Nie dotyczy	daprBindingTrigger
Wyzwalanie wywołania usługi Dapr	Nie dotyczy	daprServiceInvocationTrigger
Wyzwalanie w subskrypcji tematu dapr	Nie dotyczy	daprTopicTrigger
Ściąganie stanu dapr na potrzeby wykonania	W	daprState
Ściąganie wpisów tajnych języka Dapr na potrzeby wykonywania	W	daprSecret
Zapisywanie wartości w stanie dapr	Out	daprState
Wywoływanie innej aplikacji Dapr	Out	daprInvoke
Publikowanie komunikatu w temacie języka Dapr	Out	daprPublish
Wysyłanie wartości do powiązania wyjściowego języka Dapr	Out	daprBinding

Instalowanie rozszerzenia

Instalowany pakiet NuGet rozszerzenia zależy od trybu W# w procesie lub izolowanym procesie roboczym używanym w aplikacji funkcji:

Proces
Proces izolowany

To rozszerzenie jest dostępne przez zainstalowanie pakietu NuGet w wersji 1.0.0.

Korzystanie z interfejsu wiersza polecenia platformy .NET:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr

Dodaj rozszerzenie do projektu, instalując pakiet NuGet w wersji 1.0.0.

Korzystanie z interfejsu wiersza polecenia platformy .NET:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr

Instalowanie pakietu

Pakiet w wersji 4.x

Rozszerzenie można dodać, dodając lub zastępując następujący kod w host.json pliku:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Włączanie języka Dapr

Język Dapr można skonfigurować przy użyciu różnych [argumentów i adnotacji][dapr-args] na podstawie kontekstu środowiska uruchomieniowego. Język Dapr dla usługi Azure Functions można skonfigurować za pomocą dwóch kanałów:

Szablony infrastruktury jako kodu (IaC), jak w szablonach Bicep lub Azure Resource Manager (ARM)
Azure Portal

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

Bicep
ARM

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

Powyższe wartości konfiguracji języka Dapr są uznawane za zmiany zakresu aplikacji. Po uruchomieniu aplikacji kontenera w trybie wielokrotnej wersji zmiany tych ustawień nie będą tworzyć nowej poprawki. Zamiast tego wszystkie istniejące poprawki są uruchamiane ponownie, aby upewnić się, że są skonfigurowane z najbardziej aktualnymi wartościami.

Podczas konfigurowania języka Dapr przy użyciu witryny Azure Portal przejdź do aplikacji funkcji i wybierz pozycję Dapr z menu po lewej stronie:

Zrzut ekranu przedstawiający miejsce znalezienia włączenia języka Dapr dla aplikacji funkcji w witrynie Azure Portal.

Porty i odbiorniki języka Dapr

Po wyzwoleniu funkcji z języka Dapr rozszerzenie uwidacznia port 3001 automatycznie w celu nasłuchiwania żądań przychodzących z przyczepki Dapr.

Ważne

Port 3001 jest uwidoczniony i nasłuchuje tylko wtedy, gdy wyzwalacz języka Dapr jest zdefiniowany w aplikacji funkcji. W przypadku korzystania z języka Dapr przyczepka czeka na odebranie odpowiedzi ze zdefiniowanego portu przed ukończeniem tworzenia wystąpienia. Nie należy definiować dapr.io/port adnotacji ani --app-port nie mieć wyzwalacza. Może to spowodować zablokowanie aplikacji z przyczepki Dapr.

Jeśli używasz tylko powiązań wejściowych i wyjściowych, port 3001 nie musi być uwidoczniony ani zdefiniowany.

Domyślnie gdy usługa Azure Functions próbuje nawiązać komunikację z językiem Dapr, wywołuje metodę Dapr przez port rozpoznany ze zmiennej środowiskowej DAPR_HTTP_PORT. Jeśli ta zmienna ma wartość null, wartość domyślna to port 3500.

Możesz zastąpić adres Dapr używany przez powiązania wejściowe i wyjściowe, ustawiając DaprAddress właściwość w elemecie function.json dla powiązania (lub atrybutu). Domyślnie używa polecenia http://localhost:{DAPR_HTTP_PORT}.

Aplikacja funkcji nadal uwidacznia inny port i punkt końcowy dla elementów, takich jak wyzwalacze HTTP, które lokalnie domyślnie są domyślnie ustawione na 7071, ale w kontenerze wartość domyślna to 80.

Typy powiązań

Typy powiązań obsługiwane dla platformy .NET zależą zarówno od wersji rozszerzenia, jak i trybu wykonywania języka C#, który może być jednym z następujących elementów:

Biblioteka klas w procesie
Proces izolowany

Biblioteka klas w procesie jest skompilowaną funkcją języka C# uruchamianą w tym samym procesie co środowisko uruchomieniowe usługi Functions.

Rozszerzenie Języka Dapr obsługuje typy parametrów zgodnie z poniższą tabelą.

Wiązanie	Typy parametrów
Wyzwalacz języka Dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dane wejściowe języka Dapr	daprState daprSecret
Dane wyjściowe języka Dapr	daprState daprInvoke daprPublish daprBinding

Przykłady użycia tych typów można znaleźć w repozytorium GitHub dla rozszerzenia.