Dapr-extensie voor Azure Functions

Artikel
02/06/2024

Belangrijk

De Dapr-extensie voor Azure Functions is momenteel in preview en wordt alleen ondersteund in Azure Container Apps-omgevingen.

De Dapr-extensie voor Azure Functions is een set hulpprogramma's en services waarmee ontwikkelaars Azure Functions eenvoudig kunnen integreren met het Dapr-platform (Distributed Application Runtime).

Azure Functions is een gebeurtenisgestuurde rekenservice die een set triggers en bindingen biedt om eenvoudig verbinding te maken met andere Azure-services. Dapr biedt een set bouwstenen en aanbevolen procedures voor het bouwen van gedistribueerde toepassingen, waaronder microservices, statusbeheer, pub/subberichten en meer.

Met de integratie tussen Dapr en Functions kunt u functies bouwen die reageren op gebeurtenissen van Dapr of externe systemen.

Actie	Richting	Type
Trigger op een Dapr-invoerbinding	N.v.t.	daprBindingTrigger
Activeren bij een aanroep van een Dapr-service	N.v.t.	daprServiceInvocationTrigger
Activeren voor een Dapr-onderwerpabonnement	N.v.t.	daprTopicTrigger
Dapr-status ophalen voor een uitvoering	Over	daprState
Dapr-geheimen ophalen voor een uitvoering	Over	daprSecret
Een waarde opslaan in een Dapr-status	Out	daprState
Een andere Dapr-app aanroepen	Out	daprInvoke
Een bericht publiceren naar een Dapr-onderwerp	Out	daprPublish
Een waarde verzenden naar een Dapr-uitvoerbinding	Out	daprBinding

De extensie installeren

Het NuGet-extensiepakket dat u installeert, is afhankelijk van de C#-modus in-proces of geïsoleerd werkproces dat u gebruikt in uw functie-app:

In-proces
Geïsoleerd proces

Deze extensie is beschikbaar door het NuGet-pakket versie 0.17.0-preview01 te installeren.

De .NET CLI gebruiken:

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

Voeg de extensie toe aan uw project door het NuGet-pakket versie 0.17.0-preview01 te installeren.

De .NET CLI gebruiken:

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

Bundel installeren

Preview-bundel v4.x

U kunt de preview-extensie toevoegen door de volgende code in uw host.json bestand toe te voegen of te vervangen:

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

Dapr-inschakeling

U kunt Dapr configureren met behulp van verschillende [argumenten en aantekeningen][dapr-args] op basis van de runtimecontext. U kunt Dapr voor Azure Functions configureren via twee kanalen:

IaC-sjablonen (Infrastructure as Code), zoals in Bicep- of Arm-sjablonen (Azure Resource Manager)
Azure Portal

Wanneer u een IaC-sjabloon gebruikt, geeft u de volgende argumenten op in de properties sectie van de container-app-resourcedefinitie.

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
}

De bovenstaande Dapr-configuratiewaarden worden beschouwd als wijzigingen in het toepassingsbereik. Wanneer u een container-app uitvoert in de modus voor meerdere revisies, worden wijzigingen in deze instellingen geen nieuwe revisie gemaakt. In plaats daarvan worden alle bestaande revisies opnieuw gestart om ervoor te zorgen dat ze zijn geconfigureerd met de meest recente waarden.

Wanneer u Dapr configureert met behulp van Azure Portal, gaat u naar uw functie-app en selecteert u Dapr in het menu aan de linkerkant:

Screenshot demonstrating where to find Dapr enablement for a Function App in the Azure portal.

Dapr-poorten en -listeners

Wanneer u een functie activeert vanuit Dapr, maakt de extensie automatisch een poort 3001 beschikbaar om te luisteren naar binnenkomende aanvragen van de Dapr-sidecar.

Belangrijk

Poort 3001 wordt alleen weergegeven en geluisterd als er een Dapr-trigger is gedefinieerd in de functie-app. Wanneer u Dapr gebruikt, wacht de sidecar om een antwoord van de gedefinieerde poort te ontvangen voordat de instantie wordt voltooid. Definieer de dapr.io/port aantekening niet of --app-port tenzij u een trigger hebt. Als u dit doet, kan uw toepassing worden vergrendeld vanuit de Sidecar van Dapr.

Als u alleen invoer- en uitvoerbindingen gebruikt, hoeft de poort 3001 niet beschikbaar te worden gemaakt of gedefinieerd.

Wanneer Azure Functions standaard probeert te communiceren met Dapr, wordt Dapr aanroepen via de poort die is omgezet vanuit de omgevingsvariabele DAPR_HTTP_PORT. Als deze variabele null is, wordt deze standaard ingesteld op poort 3500.

U kunt het Dapr-adres dat wordt gebruikt door invoer- en uitvoerbindingen overschrijven door de DaprAddress eigenschap in de function.json voor de binding (of het kenmerk) in te stellen. Standaard wordt er gebruikgemaakt van http://localhost:{DAPR_HTTP_PORT}.

De functie-app maakt nog steeds een andere poort en eindpunt beschikbaar voor zaken zoals HTTP-triggers, die lokaal worden standaard ingesteld 7071, maar in een container standaard 80ingesteld op .

Bindingstypen

De bindingstypen die worden ondersteund voor .NET zijn afhankelijk van zowel de extensieversie als de C#-uitvoeringsmodus. Dit kan een van de volgende zijn:

Klassebibliotheek in proces
Geïsoleerd proces

Een in-process-klassebibliotheek is een gecompileerde C#-functie die wordt uitgevoerd in hetzelfde proces als de Functions-runtime.

De Dapr-extensie ondersteunt parametertypen volgens de onderstaande tabel.

Binding	Parametertypen
Dapr-trigger	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dapr-invoer	daprState daprSecret
Dapr-uitvoer	daprState daprInvoke daprPublish daprBinding

Zie de GitHub-opslagplaats voor de extensie voor voorbeelden die deze typen gebruiken.