Microsoft.Azure.Functions.Worker.Extensions.Rpc 1.0.1

Microsoft.Azure.Functions.Worker.Extensions.Rpc

This package provides helpers for RPC communication with the functions host.

Commonly used types

• FunctionsGrpcOptions
• GrpcHttpClientBuilderExtensions.ConfigureForFunctionsHostGrpc (>= net6.0 only)

Example usage

Both examples below you have some gRPC client "MyGrpcClient" which has a CallInvoker accepting constructor.

netstandard

When using netstandard2.0, creating a gRPC client that communicates to the host is done via FunctionsGrpcOptions.

[assembly: WorkerExtensionStartup(typeof(WorkerRpcStartup))]
public class MyWorkerExtensionStartup : WorkerExtensionStartup
{
 public override void Configure(IFunctionsWorkerApplicationBuilder applicationBuilder)
 {
 applicationBuilder.Services.AddTransient<MyGrpcClient>(sp =>
 {
 IOptions<FunctionsGrpcOptions> options = sp.GetRequiredService<IOptions<FunctionsGrpcOptions>>();
 return new MyGrpcClient(options.CallInvoker);
 });
 }
}

net6.0

When using net6.0 or newer, creating a gRPC client can be done either the same way as the netstandard example, or it can be done via Grpc.Net.ClientFactory. Using the client factory lets you further customize your client.

[assembly: WorkerExtensionStartup(typeof(WorkerRpcStartup))]
public class MyWorkerExtensionStartup : WorkerExtensionStartup
{
 public override void Configure(IFunctionsWorkerApplicationBuilder applicationBuilder)
 {
 applicationBuilder.Services
 .AddGrpcClient<MyGrpcClient>(options =>
 {
 // configure options here as necessary.
 })
 .ConfigureForFunctionsHostGrpc();
 }
}