Introduzione a YARP

YARP è progettato come libreria che fornisce la funzionalità proxy principale, che è possibile personalizzare aggiungendo o sostituendo moduli. YARP è attualmente disponibile come pacchetto NuGet ed esempi di codice. Si prevede di fornire un modello di progetto e un eseguibile predefinito (.exe) in futuro.

YARP viene implementato sopra l'infrastruttura .NET ed è utilizzabile in Windows, Linux o MacOS. Sviluppare app con l'SDK e l'editor preferito, Microsoft Visual Studio o Visual Studio Code.

YARP 2.3.0 supporta .NET 8 o versione successiva.

È possibile scaricare .NET SDK da https://dotnet.microsoft.com/download/dotnet/.

Creare un nuovo progetto

Una versione completa del progetto compilato usando la procedura seguente è disponibile in esempio YARP di base.

Per iniziare, creare un'applicazione ASP.NET Core vuota usando la riga di comando:

dotnet new web -n MyProxy

In alternativa, creare una nuova applicazione Web ASP.NET Core in Visual Studio 2022, scegliendo "Vuoto" per il modello di progetto.

Aggiungere il riferimento al pacchetto

Aggiungere un riferimento al pacchetto per Yarp.ReverseProxy, versione 2.3.0 o successiva.

dotnet add package Yarp.ReverseProxy

Note

Per indicazioni sull'aggiunta di pacchetti alle app .NET, consultare gli articoli nella sezione Installare e gestire i pacchetti in Flusso di lavoro per l'utilizzo di pacchetti (documentazione di NuGet). Verificare le versioni corrette dei pacchetti in NuGet.org.

Aggiungere il middleware YARP

Aggiornare il file Program per usare il middleware YARP:

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddReverseProxy()
    .LoadFromConfig(builder.Configuration.GetSection("ReverseProxy"));
var app = builder.Build();
app.MapReverseProxy();
app.Run();

Configuration

La configurazione per YARP viene definita nel file appsettings.json. Per altre informazioni, vedere file di configurazione YARP.

È anche possibile specificare la configurazione a livello di codice. Per ulteriori informazioni, vedere Provider di Estensibilità della Configurazione YARP.

Per altre informazioni sulle opzioni di configurazione disponibili, vedere RouteConfig e ClusterConfig.

{
 "Logging": {
   "LogLevel": {
     "Default": "Information",
     "Microsoft": "Warning",
     "Microsoft.Hosting.Lifetime": "Information"
   }
 },
 "AllowedHosts": "*",
 "ReverseProxy": {
   "Routes": {
     "route1" : {
       "ClusterId": "cluster1",
       "Match": {
         "Path": "{**catch-all}"
       }
     }
   },
   "Clusters": {
     "cluster1": {
       "Destinations": {
         "destination1": {
           "Address": "https://example.com/"
         }
       }
     }
   }
 }
}

Eseguire il progetto

Quando si usa l'interfaccia della riga di comando di .NET, usare dotnet run all'interno della directory dell'esempio o dotnet run --project <path to .csproj file>.

In Visual Studio avviare l'app facendo clic sul pulsante Esegui .