HTTP Registration get start

ASP.NET Core project

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

1. add the Shenyu ASP.NET Core dependency into project.

dotnet add package Apache.ShenYu.AspNetCore

2. in Startup.ConfigureServices method, add the ShenyuRegister service.

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

3. set your Shenyu configurations in appsettings.json.

{
  "Shenyu": {
    "Register": {
      "RegisterType": "http",
      "ServerList": "http://localhost:9095",
      "Props": {
        // your admin user name
        "UserName": "admin",
        // your admin password
        "Password": "123456"
      }
    },
    "Client": {
      "AppName": "dotnet-example",
      "ContextPath": "/dotnet",
      "IsFull": false,
      "ClientType": "http"
    }
  }
}

4. 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}

Setting by environment variables ASPNETCORE_URLS. e.g. ASPNETCORE_URLS "http://*:5000"

export ASPNETCORE_URLS=http://+:5000

5. start the application.

# build project
dotnet build --configuration Release
# start project
cd examples/AspNetCoreExample/bin/Release/netcoreapp3.1
dotnet AspNetCoreExample.dll

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