commit	b6625f99fe0408d088946af860ea615a8bfb2dbd	[log] [tgz]
author	Han Gao <dhangao@hotmail.com>	Fri Aug 12 14:41:56 2022 +0800
committer	GitHub <noreply@github.com>	Fri Aug 12 14:41:56 2022 +0800
tree	a506924975f2466306c21f6bb22ec4a1c03b436c
parent	83bf3039e208524296ced5c561cc316fd1ff6a5b [diff]

tree: a506924975f2466306c21f6bb22ec4a1c03b436c

README.md

Shenyu .NET client

Getting Started

ASP.NET Core project

For ASP.NET Core project, we can refer to the example code at examples/AspNetCoreExample. What you need to do is quite simple and straightforward.

add the Shenyu ASP.NET Core dependency into project.

dotnet add package <todo>

in Startup.ConfigureServices method, add the ShenyuRegister service.

public void ConfigureServices(IServiceCollection services)
{
    ...
    services.AddShenyuRegister(this.Configuration);
    ...
}

set your Shenyu configurations in appsettings.json.

{
    "Shenyu": {
        "Register": {
            "ServerList": "http://localhost:9095",
            "Props": {
              "UserName": "<your_admin_user>",
              "Password": "<your_admin_password>"
            }
        },
        "Client": {
            "AppName": "dotnet-example",
            "ContextPath": "/dotnet",
            "IsFull": false,
            "ClientType": "http"
        }
    }
}

enable calling via ip.

When running on your local machine, ASP.NET Core service can only be called from localhost. To enable calling by IP, you can replace https://localhost:{port};http://localhost:{port} with https://*:{port};http://*:{port} by one of the following ways.

Setting in launchSettings.json. Replace for applicationUrl field.
Setting by environment variables ASPNETCORE_URLS. e.g. ASPNETCORE_URLS "http://*:5000"
Adding --urls when start. e.g. dotnet run --urls "https://*:5001;http://*:5000"
Setting progratically by UseUrls() in Program.cs.

e.g.

public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
                webBuilder.UseUrls("http://*:5000", "https://*:5001");
            });

That's all! After finished above steps, you can just start your project and you can visit shenyu-admin portal to see the APIs have been registered in Shenyu.