Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Warning
Rozszerzenie Dapr dla Azure Functions zostanie wycofane 20 kwietnia 2027 roku i planowane jest usunięcie z pakietów rozszerzenia tego dnia. Usunięcie dotyczy pakietu głównego rozszerzenia w wersji 4.42.0 i nowszych oraz pakietu rozszerzenia podglądowego w wersji 4.60.0 i nowszych.
To usunięcie dotyczy również wersji pakietów preinstalowanych lub cacheowanych w obrazach hostingowych Linuksa albo dystrybuowanych przez hosting Windows.
Migruj do Dapr client SDK lub API HTTP Dapr bezpośrednio z kodu funkcji i zastąp wyzwalacze Dapr funkcjami wyzwalanymi przez HTTP, które odbierają odwołania Dapr. Istniejące aplikacje mogą tymczasowo przypiąć główny pakiet lub [4.*, 4.42.0) pakiet podglądowy do [4.*, 4.60.0) .host.json Aplikacje .NET mogą nadal korzystać bezpośrednio z odpowiadających pakietów NuGet do Dapr. Ani przypinanie starszego pakietu, ani dalsze korzystanie z pakietów NuGet nie przedłuża wsparcia po 20 kwietnia 2027 roku ani nie zmienia daty usunięcia.
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 | Direction | Typ |
|---|---|---|
| Wyzwalanie w powiązaniu wejściowym języka Dapr | N/A | daprBindingTrigger |
| Wyzwalanie wywołania usługi Dapr | N/A | daprServiceInvocationTrigger |
| Wyzwalanie w subskrypcji tematu dapr | N/A | daprTopicTrigger |
| Ściąganie stanu dapr na potrzeby wykonania | In | daprState |
| Ściąganie wpisów tajnych języka Dapr na potrzeby wykonywania | In | 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:
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
Instalowanie pakietu
W przypadku istniejących aplikacji korzystających z rozszerzenia Dapr, które wycofuje się 20 kwietnia 2027 roku, wybierz pakiet, z którego korzysta Twoja aplikacja, i dodaj lub zastąp poniższy kod w swoim host.json pliku. Te zakresy wersji wykluczają wersje zaplanowane do usunięcia rozszerzenia Dapr.
Wybrany starszy pakiet musi być dostępny w Twojej aplikacji. Ustawienie zakresu wersji nie zmienia zawartości pakietów preinstalowanych w obrazach Linuksa ani dostępnych na dysku w SKU Windows. Kontynuacja przypinania starszego pakietu nie przedłuża wsparcia po 20 kwietnia 2027 roku ani nie zmienia daty usunięcia.
Rozszerzenie Dapr planowane jest do usunięcia 20 kwietnia 2027 roku, zaczynając od głównego pakietu rozszerzenia w wersji 4.42.0.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.*, 4.42.0)"
}
}
Migracja z rozszerzenia Dapr
Możesz kontynuować korzystanie z Dapr w Azure Container Apps bez rozszerzenia Azure Functions Dapr. Ta migracja wymaga zmian w kodzie funkcji i konfiguracji callback Dapr; samo zainstalowanie SDK klienta nie zastąpi wyzwalaczy Dapr.
Zastąpienie wiązań wejściowych i wyjściowych Dapr wywołaniami do SDK klienta Dapr lub API HTTP Dapr. Używaj odpowiednich API do odczytu i zapisu stanów, pobierania sekretów, wywoływania usług, publikowania wiadomości oraz wiązań wyjściowych. Zachowaj nazwy komponentów, identyfikatory aplikacji, klucze stanów oraz metadane wymagane przez istniejącą aplikację. Wybrane API i pakiety SDK wspierane w Azure Container Apps.
Zamień wyzwalacze specyficzne dla rozszerzenia funkcjami wyzwalanymi przez HTTP i skonfiguruj Dapr tak, aby wywoływał nowe punkty końcowe:
Istniejący wyzwalacz Replacement daprServiceInvocationTriggerPunkt końcowy HTTP, który obsługuje wywołaną metodę. Zobacz wezwanie do nabożeństwa Dapr. daprTopicTriggerEndpoint HTTP, który odbiera wiadomości tematyczne, z deklaratywną lub programową subskrypcją Dapr , która kieruje do niego wiadomości. daprBindingTriggerPunkt końcowy HTTP, który akceptuje odwołania OPTIONSi żądania odkrycia z wiązaniaPOST. Zobacz callbacki wiązania wejściowego Dapr.Zaktualizuj konfigurację Dapr w Azure Container Apps, aby korzystała z portu HTTP aplikacji funkcyjnej oraz protokołu HTTP aplikacji, zamiast słuchacza rozszerzenia na porcie
3001. Dopasuj trasy callback do punktów końcowych funkcji, uwzględniając domyślny/apiprefiks trasy. Jeśli używasz programatycznej subskrypcji pub/sub, udostępnij punkt odkrywania dokładnie na/dapr/subscribetej samej ścieżce. Upewnij się, że Dapr może dotrzeć do wymaganych punktów końcowych, jednocześnie zachowując uwierzytelnianie i kontrolę dostępu aplikacji.Weryfikacja dostępu do stanu i tajemnicy, wywołania usługi, publikowania, payloadów callback, potwierdzeń, prób oraz obsługi duplikatów zdarzeń przed przełączeniem ruchu. Po wymianie wszystkich przypisań i spustów specyficznych dla rozszerzenia usuń pakiet lub rejestrację Dapr oraz tymczasowy pin pakietu. Użyj normalnej konfiguracji wiązek wymaganej przez pozostałe wiązania.
Poniższe sekcje opisują konfigurację istniejących aplikacji, które nadal korzystają z rozszerzenia Dapr przed jego wycofaniem 20 kwietnia 2027 roku.
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)
- Portal Azure
W przypadku korzystania z szablonu IaC określ następujące argumenty w properties sekcji definicji zasobu aplikacji kontenera.
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 up-to-date wartości.
Podczas konfigurowania języka Dapr przy użyciu witryny Azure Portal przejdź do aplikacji funkcji i wybierz pozycję Dapr z menu po lewej stronie:
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 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ą.
| Binding | 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.
Wypróbuj rozszerzenie Dapr dla usługi Azure Functions
Dowiedz się, jak używać rozszerzenia Dapr dla usługi Azure Functions za pośrednictwem podanych przykładów.
| Samples | Description |
|---|---|
| Szybki start | Rozpocznij pracę przy użyciu powiązania usługi Dapr Pub/sub i HttpTrigger. |
| Dapr Kafka | Dowiedz się, jak używać rozszerzenia Dapr usługi Azure Functions z składnikiem Dapr powiązania platformy Kafka. |
| Proces in-process platformy .NET | Dowiedz się, jak używać modelu przetwarzania usługi Azure Functions do integracji z wieloma składnikami języka Dapr na platformie .NET, takimi jak wywołanie usługi, pub/pod, powiązania i zarządzanie stanem. |
| Izolowana platforma .NET | Integracja ze składnikami języka Dapr na platformie .NET przy użyciu modelu wykonywania out-of-of-proc (OOP) usługi Azure Functions. |
Wypróbuj rozszerzenie Dapr dla usługi Azure Functions
Dowiedz się, jak używać rozszerzenia Dapr dla usługi Azure Functions za pośrednictwem podanych przykładów.
| Samples | Description |
|---|---|
| Funkcje Języka Java | Dowiedz się, jak używać rozszerzenia Dapr usługi Azure Functions przy użyciu języka Java. |
Wypróbuj rozszerzenie Dapr dla usługi Azure Functions
Dowiedz się, jak używać rozszerzenia Dapr dla usługi Azure Functions za pośrednictwem podanych przykładów.
| Samples | Description |
|---|---|
| Szybki start | Rozpocznij pracę przy użyciu powiązania usługi Dapr Pub/sub i HttpTrigger. |
| Dapr Kafka | Dowiedz się, jak używać rozszerzenia Dapr usługi Azure Functions z składnikiem Dapr powiązania platformy Kafka. |
| JavaScript | Uruchom aplikację funkcji Języka Dapr języka JavaScript i zintegruj się z wywołaniem usługi Dapr, pubem/sub, powiązaniami i zarządzaniem stanem przy użyciu usługi Azure Functions. |
Wypróbuj rozszerzenie Dapr dla usługi Azure Functions
Dowiedz się, jak używać rozszerzenia Dapr dla usługi Azure Functions za pośrednictwem podanych przykładów.
| Samples | Description |
|---|---|
| Funkcje programu PowerShell | Dowiedz się, jak używać rozszerzenia Dapr usługi Azure Functions za pomocą programu PowerShell. |
Wypróbuj rozszerzenie Dapr dla usługi Azure Functions
Dowiedz się, jak używać rozszerzenia Dapr dla usługi Azure Functions za pośrednictwem podanych przykładów.
| Samples | Description |
|---|---|
| Dapr Kafka | Dowiedz się, jak używać rozszerzenia Dapr usługi Azure Functions z składnikiem Dapr powiązania platformy Kafka. |
| Python v1 | Uruchom aplikację języka Python z obsługą języka Dapr i użyj modelu programowania Języka Python w wersji 1 usługi Azure Functions do integracji ze składnikami języka Dapr. |
| Python v2 | Uruchom aplikację dapr przy użyciu modelu programowania języka Python w języku Python w usłudze Azure Functions w wersji 2, aby zintegrować ją ze składnikami języka Dapr. |
Rozwiązywanie problemów
W tej sekcji opisano sposób rozwiązywania problemów, które mogą wystąpić podczas korzystania z rozszerzenia Dapr dla usługi Azure Functions.
Upewnij się, że język Dapr jest włączony w danym środowisku
Jeśli używasz powiązań i wyzwalaczy języka Dapr w usłudze Azure Functions, a język Dapr nie jest włączony w danym środowisku, może zostać wyświetlony komunikat o błędzie: Aby włączyć język Dapr w środowisku: Dapr sidecar isn't present. Please see (https://aka.ms/azure-functions-dapr-sidecar-missing) for more information.
Jeśli funkcja platformy Azure jest wdrożona w usłudze Azure Container Apps, zapoznaj się z instrukcjami dotyczącymi włączania języka Dapr dla rozszerzenia Dapr dla usługi Azure Functions.
Jeśli funkcja platformy Azure jest wdrożona na platformie Kubernetes, sprawdź, czy konfiguracja YAML wdrożenia ma następujące adnotacje:
annotations: ... dapr.io/enabled: "true" dapr.io/app-id: "functionapp" # You should only set app-port if you are using a Dapr trigger in your code. dapr.io/app-port: "<DAPR_APP_PORT>" ...Jeśli używasz funkcji platformy Azure lokalnie, uruchom następujące polecenie, aby upewnić się, że używasz aplikacji funkcji z językiem Dapr:
dapr run --app-id functionapp --app-port <DAPR_APP_PORT> --components-path <COMPONENTS_PATH> -- func host start
Weryfikowanie wartości portu aplikacji w konfiguracji języka Dapr
Rozszerzenie Dapr dla usługi Azure Functions domyślnie uruchamia serwer HTTP na porcie 3001 . Ten port można skonfigurować przy użyciu zmiennej środowiskowejDAPR_APP_PORT.
Jeśli podasz nieprawidłową wartość portu aplikacji podczas uruchamiania aplikacji usługi Azure Functions, może zostać wyświetlony komunikat o błędzie: Aby rozwiązać ten komunikat o błędzie: The Dapr sidecar is configured to listen on port {portInt}, but the app server is running on port {appPort}. This may cause unexpected behavior. For more information, visit [this link](https://aka.ms/azfunc-dapr-app-config-error).
W ustawieniach języka Dapr aplikacji kontenera:
Jeśli używasz wyzwalacza języka Dapr w kodzie, sprawdź, czy port aplikacji jest ustawiony na
3001lub na wartość zmiennej środowiskowejDAPR_APP_PORT.Jeśli nie używasz wyzwalacza języka Dapr w kodzie, sprawdź, czy port aplikacji nie został ustawiony. Powinna być pusta.
Sprawdź, czy w konfiguracji języka Dapr podasz poprawną wartość portu aplikacji.
Jeśli używasz usługi Azure Container Apps, określ port aplikacji w aplikacji Bicep:
DaprConfig: { ... appPort: <DAPR_APP_PORT> ... }Jeśli używasz środowiska Kubernetes, ustaw adnotację
dapr.io/app-port:annotations: ... dapr.io/app-port: "<DAPR_APP_PORT>" ...Jeśli programujesz lokalnie, sprawdź, czy skonfigurowana
--app-portpodczas uruchamiania aplikacji funkcji przy użyciu języka Dapr:dapr run --app-id functionapp --app-port <DAPR_APP_PORT> --components-path <COMPONENTS_PATH> -- func host start