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 theShenyuRegister
service.
public void ConfigureServices(IServiceCollection services)
{
...
services.AddShenyuRegister(this.Configuration);
...
}
- set your
Shenyu
configurations inappsettings.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 forapplicationUrl
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()
inProgram.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.