Comment spécifier le port sur lequel une application ASP.NET Core est hébergée ?

Question

Lorsque vous utilisez WebHostBuilder dans un Main comment puis-je spécifier le port auquel il se lie ?

Par défaut, il utilise 5000.

Notez que cette question est spécifique à la nouvelle API ASP.NET Core (actuellement en 1.0.0-RC2).

Answer 1

Dans ASP.NET Core 3.1, il existe 4 façons principales de spécifier un port personnalisé :

• En utilisant des arguments de ligne de commande, en démarrant votre application .NET avec --urls=[url] :

  dotnet run --urls=http://localhost:5001/

• Utilisation de appsettings.json en ajoutant un Urls nœud :

  { "Urls": "http://localhost:5001" }

• Utilisation de variables d'environnement, avec ASPNETCORE_URLS=http://localhost:5001/ .

• Utilisation de UseUrls() si vous préférez le faire de manière programmatique :

  public static class Program { public static void Main(string[] args) => CreateHostBuilder(args).Build().Run();

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

  }

Ou, si vous utilisez toujours le constructeur d'hôte web au lieu du constructeur d'hôte générique :

public class Program
{
    public static void Main(string[] args) =>
        new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .UseUrls("http://localhost:5001/")
            .Build()
            .Run();
}

Answer 2

Réponse complémentaire pour aider tous ceux qui font cela avec l'intégration VS-Docker. J'ai dû changer le port 8080 pour utiliser l'environnement "flexible" dans google appengine.

Vous aurez besoin des éléments suivants dans votre Dockerfile :

ENV ASPNETCORE_URLS=http://+:8080
EXPOSE 8080

et vous devrez également modifier le port dans docker-compose.yml :

    ports:
      - "8080"

Answer 3

Vous pouvez spécifier l'URL d'hébergement sans aucune modification de votre application.

Créer un Properties/launchSettings.json dans le répertoire de votre projet et remplissez-le avec quelque chose comme ceci :

{
  "profiles": {
    "MyApp1-Dev": {
        "commandName": "Project",
        "environmentVariables": {
            "ASPNETCORE_ENVIRONMENT": "Development"
        },
        "applicationUrl": "http://localhost:5001/"
    }
  }
}

dotnet run devrait choisir votre launchSettings.json et l'affichera dans la console :

C:\ProjectPath [master ]
  dotnet run
Using launch settings from C:\ProjectPath\Properties\launchSettings.json...
Hosting environment: Development
Content root path: C:\ProjectPath
Now listening on: http://localhost:5001
Application started. Press Ctrl+C to shut down. 

Plus de détails : https://docs.microsoft.com/en-us/aspnet/core/fundamentals/environments

Answer 4

La solution alternative consiste à utiliser un hosting.json dans la Racine du projet.

{
  "urls": "http://localhost:60000"
}

Et ensuite dans Program.cs

public static void Main(string[] args)
{
    var config = new ConfigurationBuilder()
        .SetBasePath(Directory.GetCurrentDirectory())
        .AddJsonFile("hosting.json", true)
        .Build();

    var host = new WebHostBuilder()
        .UseKestrel(options => options.AddServerHeader = false)
        .UseConfiguration(config)
        .UseContentRoot(Directory.GetCurrentDirectory())
        .UseIISIntegration()
        .UseStartup<Startup>()
        .Build();

    host.Run();
}

Answer 5

Lorsqu'il est hébergé dans des conteneurs docker (version linux pour moi), vous pouvez obtenir un message 'Connection Refused'. Dans ce cas, vous pouvez utiliser l'adresse IP 0.0.0.0 ce qui signifie "toutes les adresses IP de cette machine" au lieu de l'expression localhost loopback pour réparer le transfert de port.

public class Program
{
    public static void Main(string[] args)
    {
        var host = new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .UseUrls("http://0.0.0.0:5000/")
            .Build();

        host.Run();
    }
}