Estensione Dapr per Funzioni di Azure

L'estensione Dapr per Funzioni di Azure è un set di strumenti e servizi che consentono agli sviluppatori di integrare facilmente Funzioni di Azure con la piattaforma Dapr (Distributed Application Runtime).

Funzioni di Azure è un servizio di calcolo basato su eventi che fornisce un set di trigger e associazioni per connettersi facilmente ad altri servizi di Azure. Dapr offre un set di blocchi predefiniti e procedure consigliate per la creazione di applicazioni distribuite, tra cui microservizi, gestione dello stato, messaggistica pub/sub e altro ancora.

Con l'integrazione tra Dapr e Funzioni, è possibile creare funzioni che reagiscono agli eventi da dapr o da sistemi esterni.

Action	Direction	TIPO
Trigger in un'associazione di input dapr	N/A	daprBindingTrigger
Trigger in una chiamata al servizio Dapr	N/A	daprServiceInvocationTrigger
Attivare in una sottoscrizione dell'argomento Dapr	N/A	daprTopicTrigger
Eseguire il pull dello stato dapr per un'esecuzione	In	daprState
Eseguire il pull dei segreti dapr per un'esecuzione	In	daprSecret
Salvare un valore in uno stato dapr	Out	daprState
Richiamare un'altra app Dapr	Out	daprInvoke
Pubblicare un messaggio in un argomento dapr	Out	daprPublish
Inviare un valore a un'associazione di output dapr	Out	daprBinding

Installare l'estensione

Il pacchetto NuGet di estensione installato dipende dal processo di lavoro isolato o in modalità C# in uso nell'app per le funzioni:

In-process
Processo isolato

Questa estensione è disponibile installando il pacchetto NuGet versione 1.0.0.

Uso dell'interfaccia della riga di comando di .NET:

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

Aggiungere l'estensione al progetto installando il pacchetto NuGet versione 1.0.0.

Uso dell'interfaccia della riga di comando di .NET:

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

Installare il bundle

Per poter usare questa estensione di associazione nell'app, assicurarsi che il file host.json nella radice del progetto contenga questo extensionBundle riferimento:

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

In questo esempio, il version valore di indica all'host di Funzioni di [4.0.0, 5.0.0) usare una versione del bundle che è almeno 4.0.0 ma minore di 5.0.0, che include tutte le versioni potenziali di 4.x. Questa notazione mantiene l'app nella versione secondaria più recente disponibile del bundle di estensione v4.x.

Quando possibile, è consigliabile usare la versione principale del bundle di estensione più recente e consentire al runtime di mantenere automaticamente la versione secondaria più recente. È possibile visualizzare il contenuto del bundle più recente nella pagina di rilascio dei bundle di estensioni. Per altre informazioni, vedere Bundle di estensioni di Funzioni di Azure.

Abilitazione dapr

È possibile configurare Dapr usando diversi [argomenti e annotazioni][dapr-args] in base al contesto di runtime. È possibile configurare Dapr per Funzioni di Azure tramite due canali:

Modelli IaC (Infrastructure as Code), come nei modelli Bicep o Azure Resource Manager (ARM)
Ilportale di Azure

Quando si usa un modello IaC, specificare gli argomenti seguenti nella properties sezione della definizione della risorsa dell'app contenitore.

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

I valori di configurazione di Dapr precedenti sono considerati modifiche all'ambito dell'applicazione. Quando si esegue un'app contenitore in modalità di revisione multipla, le modifiche apportate a queste impostazioni non creerà una nuova revisione. Tutte le revisioni esistenti vengono invece riavviate per assicurarsi che siano configurate con i valori più up-to-date.

Quando si configura Dapr usando il portale di Azure, passare all'app per le funzioni e selezionare Dapr dal menu a sinistra:

Screenshot che illustra dove trovare l'abilitazione dapr per un'app per le funzioni nel portale di Azure.

Porte e listener dapr

Quando si attiva una funzione da Dapr, l'estensione espone automaticamente la porta 3001 per ascoltare le richieste in ingresso dal sidecar Dapr.

Importante

La porta 3001 viene esposta e ascoltata solo se nell'app per le funzioni è definito un trigger Dapr. Quando si usa Dapr, il sidecar attende di ricevere una risposta dalla porta definita prima di completare la creazione di istanze. Non definire l'annotazione dapr.io/port o --app-port a meno che non si disponga di un trigger. In questo modo l'applicazione può essere bloccata dal sidecar Dapr.

Se si usano solo associazioni di input e output, la porta 3001 non deve essere esposta o definita.

Per impostazione predefinita, quando Funzioni di Azure tenta di comunicare con Dapr, chiama Dapr sulla porta risolta dalla variabile DAPR_HTTP_PORTdi ambiente . Se tale variabile è Null, per impostazione predefinita viene usata la porta 3500.

È possibile eseguire l'override dell'indirizzo Dapr usato dalle associazioni di input e output impostando la DaprAddress proprietà in function.json per l'associazione (o l'attributo). Per impostazione predefinita, usa http://localhost:{DAPR_HTTP_PORT}.

L'app per le funzioni espone ancora un'altra porta e un altro endpoint per elementi come i trigger HTTP, che per impostazione predefinita in locale è 7071, ma in un contenitore, per impostazione predefinita è 80.

Tipi di associazione

I tipi di associazione supportati per .NET dipendono sia dalla versione dell'estensione che dalla modalità di esecuzione C#, che può essere una delle seguenti:

Libreria di classi in-process
Processo isolato

Una libreria di classi in-process è una funzione C# compilata eseguita nello stesso processo del runtime di Funzioni.

L'estensione Dapr supporta i tipi di parametro in base alla tabella seguente.

Binding	Tipi di parametri
Trigger dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Input dapr	daprState daprSecret
Output dapr	daprState daprInvoke daprPublish daprBinding

Per esempi relativi all'uso di questi tipi, vedere il repository GitHub per l'estensione.