Configuración de inicio de las herramientas de contenedor

  • Artículo
  • Tiempo de lectura: 2 minutos

En la carpeta Properties de un proyecto de ASP.NET Core, encontrará el archivo launchSettings.json, que contiene la configuración que controla el modo en que se inicia la aplicación web en el equipo de desarrollo. Para obtener información detallada sobre cómo se usa este archivo en el desarrollo de ASP.NET, vea Usar varios entornos en ASP.NET Core. En launchSettings.json, los valores de la sección Docker están relacionados con la forma en que Visual Studio controla las aplicaciones en contenedores.

    "Docker": {
      "commandName": "Docker",
      "launchBrowser": true,
      "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}"
    }

    "Docker": {
      "commandName": "Docker",
      "launchBrowser": true,
      "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
      "environmentVariables": {
        "ASPNETCORE_URLS": "https://+:443;http://+:80",
        "ASPNETCORE_HTTPS_PORT": "44360"
      },
      "httpPort": 51803,
      "useSSL": true,
      "sslPort": 44360
    }

El valor commandName identifica que esta sección se aplica a las herramientas de contenedor. En la tabla siguiente se muestran las propiedades que se pueden establecer en esta sección:

Nombre de valor Versión Ejemplo Descripción
launchBrowser Visual Studio 2017 "launchBrowser": true Indica si se debe iniciar el explorador después de iniciar correctamente el proyecto.
launchUrl Visual Studio 2017 "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}" Esta dirección URL se usa al iniciar el explorador. Los tokens de reemplazo admitidos para esta cadena son:

- {Scheme}: se reemplaza por "http" o "https" en función de si se usa SSL.

- {ServiceHost}: normalmente se reemplaza por "localhost". Cuando el destino son los contenedores de Windows en Windows 10 RS3 o versiones anteriores, se reemplaza por la dirección IP del contenedor.

{ServicePort}: normalmente se reemplaza por sslPort o httpPort, en función de si se usa SSL. Cuando el destino son los contenedores de Windows en Windows 10 RS3 o versiones anteriores, se reemplaza por "443" o "80", en función de si se usa SSL.
Nombre de valor Ejemplo Descripción
commandLineArgs "commandLineArgs": "--mysetting myvalue" Estos argumentos de la línea de comandos para iniciar la aplicación se usan al ejecutar el proyecto en el contenedor.
environmentVariables "environmentVariables": {
"ASPNETCORE_URLS": "https://+:443; http://+:80",
"ASPNETCORE_HTTPS_PORT": "44381"
}		 Estos valores de variables de entorno se pasan al proceso cuando se inicia en el contenedor.
httpPort "httpPort": 24051 Este puerto del host se asigna al puerto 80 del contenedor al iniciar el contenedor.
launchBrowser "launchBrowser": true Indica si se debe iniciar el explorador después de iniciar correctamente el proyecto.
launchUrl "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}" Esta dirección URL se usa al iniciar el explorador. Los tokens de reemplazo admitidos para esta cadena son:

- {Scheme}: se reemplaza por "http" o "https" en función de si se usa SSL.

- {ServiceHost}: normalmente se reemplaza por "localhost".
Cuando el destino son los contenedores de Windows en Windows 10 RS3 o versiones anteriores, se reemplaza por la dirección IP del contenedor.

- {ServicePort}: normalmente se reemplaza por sslPort o httpPort, en función de si se usa SSL.
Cuando el destino son los contenedores de Windows en Windows 10 RS3 o versiones anteriores, se reemplaza por "443" o "80", en función de si se usa SSL.
sslPort "sslPort": 44381 Este puerto del host se asigna al puerto 443 del contenedor al iniciar el contenedor.
useSSL "useSSL": true Indica si se debe usar SSL al iniciar el proyecto. Si no se especifica useSSL, se usa SSL cuando sslPort > 0.

Pasos siguientes

Configure el proyecto estableciendo las propiedades de compilación las herramientas de contenedor.

Vea también