Saltar al contenido principal

Implementación de su aplicación en .NET

aviso

⚠️ Todas las configuraciones hechas en este manual son ejemplos simples e hipotéticos. Será necesario realizar adaptaciones según la topología de su entorno.

🖥️ Crear el servidor de aplicación​

Primero, realice la creación de su servidor de aplicación .NET según la imagen a continuación:

Criação do ambiente

⚙️ Configuraciones necesarias​

Después de crear el entorno, es necesario realizar algunas configuraciones antes de hacer el deploy de su aplicación.

🔧 Paso 1 - Variables de entorno​

Acceda a las variables de entorno de su servidor de aplicación .NET:

Variável

➕ Paso 2 - Añadir las variables necesarias​

Agregue las siguientes variables de entorno:

  • APP_NAME = especifique el .dll de su aplicación o el directorio donde se encuentra (ejemplo: aplicacao.dll o /diretorio/aplicacao/aplicacao.dll).
  • ASPNETCORE_URLS = defina la dirección y puerto de su aplicación (ejemplo: http://*:5000).
  • RUN_OPTION = si es necesario, añada parámetros al comando dotnet run (ej: dotnet run --parametros). Este comando se ejecuta automáticamente al reiniciar el servidor o al hacer el deploy.

⚠️ Existen dos formas de definir la URL de la aplicación:

  1. A través de la variable de entorno ASPNETCORE_URLS;
  2. O mediante el archivo appsettings.json, usando Kestrel.

📝 Ejemplo de configuración en el appsettings.json:​

"Kestrel": {
  "Endpoints": {
    "Http": {
      "Url": "http://*:5000"
    }
  }
}

A continuación, un ejemplo de cómo debería estar configurado considerando una aplicación simple:

Variável do servidor de aplicação

❌ Paso 3 - Eliminar el redireccionamiento HTTPS en el Program.cs​

Verifique si existe la línea app.UseHttpsRedirection() en el archivo Program.cs. Si existe, comente o elimine.

Esto porque el HTTPS será gestionado por el balanceador de carga (NGINX), y no directamente por la aplicación.

aviso

¡Esta línea **solo puede ser modificada antes de que su aplicación sea publicada!

🚀 Paso 4 - Implementación de la aplicación​

Después de configurar todo, puede implementar su aplicación de dos formas mediante el Gestor de Implantación:

  • Vía Git.
  • O realizando la subida de un archivo .zip que contenga su aplicación.

🔗 Para aprender más sobre el Gestor de Implantación, ¡haga clic aquí!

tip

Si está utilizando el SLB, la plataforma hará un redireccionamiento automático del puerto 80 al puerto configurado en la aplicación, por lo tanto, al acceder a su aplicación vía SLB no es necesario pasar el número de puerto en la URL. Sin embargo, si está utilizando un dominio propio con el apuntamiento tipo A al IP público de su instancia, es necesario informar el número de puerto.

🔒 HTTPS​

Para manejar el HTTPS en su aplicación .NET, necesitará añadir un Balanceador de Carga NGINX y realizar la instalación de Let's Encrypt así como configurar el redireccionamiento.

  • Para aprender sobre la configuración de NGINX para realizar el Proxy Reverso (HTTPS), ¡haga clic aquí!

🧰 Solución de problemas​

Si está recibiendo el error connection refused (conexión rechazada), verifique si el puerto de la aplicación está liberado en el Firewall.

🔗 Para aprender sobre Gestión de Firewall, ¡haga clic aquí!

ℹ️ Enlaces útiles​