Pular para o conteúdo principal

Implementação da sua aplicação em .NET

atenção

⚠️ Todas as configurações feitas neste manual são exemplos simples e hipotéticos. Será necessário realizar adaptações conforme a topologia do seu ambiente.

🖥️ Criar o servidor de aplicação​

Primeiramente, realize a criação do seu servidor de aplicação .NET conforme a imagem abaixo:

Criação do ambiente

⚙️ Configurações Necessárias​

Após a criação do ambiente, é necessário realizar algumas configurações antes de fazer o deploy da sua aplicação.

🔧 Passo 1 - Variáveis de ambiente​

Acesse as variáveis de ambiente do seu servidor de aplicação .NET:

Variável

➕ Passo 2 - Adicionar as variáveis necessárias​

Adicione as seguintes variáveis de ambiente:

  • APP_NAME = especifique o .dll da sua aplicação ou o diretório onde ela se encontra (exemplo: aplicacao.dll ou /diretorio/aplicacao/aplicacao.dll).
  • ASPNETCORE_URLS = defina o endereço e porta da sua aplicação (exemplo: http://*:5000).
  • RUN_OPTION = se necessário, adicione parâmetros ao comando dotnet run (ex: dotnet run --parametros). Este comando é executado automaticamente ao reiniciar o servidor ou ao fazer o deploy.

⚠️ Existem duas formas de definir a URL da aplicação:

  1. Através da variável de ambiente ASPNETCORE_URLS;
  2. Ou via arquivo appsettings.json, usando o Kestrel.

📝 Exemplo de configuração no appsettings.json:​

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

Abaixo, um exemplo de como precisaria estar configurado levando em consideração uma aplicação simples:

Variável do servidor de aplicação

❌ Passo 3 - Remover o redirecionamento HTTPS no Program.cs​

Verifique se existe a linha app.UseHttpsRedirection() no arquivo Program.cs. Se existir, comente ou remova.

Isso porque o HTTPS será gerenciado pelo balanceador de carga (NGINX), e não diretamente pela aplicação.

atenção

Essa linha só pode ser alterada antes da sua aplicação ser publicada!

🚀 Passo 4 - Implementação da aplicação​

Após configurar tudo, você pode implementar a sua aplicação de duas formas pelo Gestor de Implantação

  • Via Git.
  • Ou realizando o upload de um arquivo .zip contendo sua aplicação.

🔗 Para aprender mais sobre o Gestor de Implantação, clique aqui!

dica

Caso esteja utilizando o SLB, a plataforma fará um redirecionamento automático da porta 80 para a porta configurada na aplicação, portanto, ao acessar a sua aplicação via SLB não é necessário passar o número da porta na URL. No entanto, caso esteja utilizando um domínio próprio com o apontamento do tipo A para o IP público da sua instância, é preciso informar o número da porta.

🔒 HTTPS​

Para tratar o HTTPS em sua aplicação .NET, você precisará estar adicionando um Balanceador de Carga NGINX e estar realizando a instalação do Let's Encrypt bem como realizar a configuração de redirecionamento.

  • Para aprender sobre a configuração do NGINX para realizar o Proxy Reverso (HTTPS), clique aqui!

🧰 Troubleshooting​

Se estiver recebendo o erro connection refused (conexão recusada), verifique se a porta da aplicação está liberada no Firewall.

🔗 Para aprender sobre Gestão de Firewall, clique aqui!