Tutorial: Proxying .NET Core e Kestrel com NGINX e NGINX Plus

Instruções

As instruções a seguir explicam como criar rapidamente um aplicativo “Hello World” usando .NET Core, executá-lo no Linux e implantá-lo por trás de um proxy reverso NGINX ou NGINX Plus com funcionalidade avançada de gerenciamento de tráfego.

Instalar .NET Core, NGINX e NGINX Plus

Instale o .NET Core usando as instruções no site da Microsoft.

No nosso exemplo, estamos usando o Ubuntu 16.04. Os comandos a seguir estavam corretos no momento da escrita, mas estão sujeitos a alterações porque o Kestrel ainda está em desenvolvimento. Consulte a documentação do .NET Core conforme necessário.

$ sudo apt-get install apt-transport-https$ sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet-release/ xenial main" > /etc/apt/sources.list.d/dotnetdev.list'
$ sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893
$ sudo apt-get update
$ sudo apt-get install dotnet-dev-1.0.0-preview2-003131

Instalar o NGINX:

$ sudo apt-get install nginx

Instale o NGINX Plus se quiser monitoramento de atividades em tempo real, verificações de integridade ativas ou ambos. Veja as instruções no Guia de administração do NGINX Plus .

Edite o arquivo ./project.json para adicionar o Kestrel como uma dependência do projeto.

{  "version": "1.0.0-*",
  "buildOptions": {
    "debugType": "portable",
    "emitEntryPoint": true
  },
  "dependencies": {},
  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.0.1"
        },
        "Microsoft.AspNetCore.Server.Kestrel": "1.0.0"
      },
      "imports": "dnxcore50"
    }
  }
}

Copie este código para um aplicativo simples para um novo arquivo chamado Program.cs . Ele retorna a data e hora atuais, executando o Kestrel na porta 5000 no host local.

using System;using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;

namespace ConsoleApplication
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                .UseKestrel()
                .Configure(app =>
                {
                    app.Run(async (context) => await context.Response.WriteAsync("Current date: " + DateTime.Now + "n"));
                })
                .Build();

            host.Run();
        }
    }
}

Execute o comando dotnet run para iniciar o servidor .NET Core:

$ dotnet runProject app (.NETCoreApp,Version=v1.0) will be compiled because inputs were modified
Compiling app for .NETCoreApp,Version=v1.0

Compilation succeeded.
    0 Warning(s)
    0 Error(s)

Time elapsed 00:00:01.9047678

Hello World!
Hosting environment: Production
Content root path: /app/bin/Debug/netcoreapp1.0
Now listening on: http://localhost:5000
Application started. Press Ctrl+C to shut down.

Execute o comando curl para testar a conectividade e o HTTP:

$ curl -v localhost:5000* Rebuilt URL to: localhost:5000/
*   Trying ::1...
* Connected to localhost (::1) port 5000 (#0)
> GET / HTTP/1.1
> Host: localhost:5000
> User-Agent: curl/7.47.0
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Tue, 14 Feb 2017 19:50:59 GMT
< Transfer-Encoding: chunked
< Server: Kestrel
<
Current date: 02/14/17 12:50:59 PM
* Connection #0 to host localhost left intact

Instale um certificado SSL. Existem várias maneiras de obter um:
- Compre de uma autoridade de certificação (CA) bem conhecida
- Peça ao seu grupo de TI corporativo ou CA para gerá-lo
- Exporte-o de um servidor IIS existente
- Use uma CA gratuita como a Let's Encrypt
- Gerar um certificado autoassinado diretamente
Para fins de criação rápida de um aplicativo .NET Core de exemplo com SSL, estamos gerando um certificado autoassinado e uma chave associada com este comando openssl . Estamos instalando o certificado e a chave no local padrão do NGINX, /etc/nginx , mas você pode escolher um local diferente.
```
$ openssl req -x509 -subj /CN=localhost -days 365 -set_serial 2 -newkey rsa:4096 -keyout /etc/nginx/cert.key -nodes -out /etc/nginx/cert.pemGenerating a 4096 bit RSA private key
.........++
............................++
writing new private key to '/etc/nginx/cert.key'
-----
```
Configure o proxy reverso no arquivo de configuração padrão do NGINX e do NGINX Plus para servidores virtuais HTTP.

O arquivo de configuração principal do NGINX e do NGINX Plus é /etc/nginx/nginx.conf . Entretanto, várias distribuições NGINX (assim como o NGINX Plus) seguem a convenção de que você não coloca muita configuração real no arquivo principal, mas, em vez disso, cria arquivos menores e específicos de função em um subdiretório de /etc/nginx :
- Para compilações NGINX Open Source fornecidas por nginx.org e para NGINX Plus, o diretório é /etc/nginx/conf.d e o arquivo padrão para servidores virtuais HTTP é default.conf .
- Para compilações NGINX Open Source distribuídas com o Ubuntu, o diretório é /etc/nginx/sites-enabled , e o arquivo padrão para servidores virtuais HTTP é default .
O conteúdo dos arquivos específicos da função nesses diretórios é então lido no arquivo principal ( nginx.conf ) com uma diretiva include , por exemplo:
```
include /etc/nginx/conf.d/*.conf;include /etc/nginx/sites-enabled/*;
```
Se você não tiver certeza de qual é o arquivo de configuração padrão para servidores virtuais HTTP em seu sistema, encontre a diretiva include relevante em /etc/nginx/nginx.conf .

Para configurar o NGINX ou o NGINX Plus como um proxy reverso, adicione os três blocos de configuração a seguir ao arquivo de configuração padrão para servidores virtuais HTTP:
- O primeiro bloco do servidor aceita solicitações HTTP na porta 80 e as redireciona para o servidor virtual para solicitações HTTPS.
- O segundo bloco de servidores aceita solicitações HTTPS na porta 443 e as envia por proxy para um grupo de um ou mais servidores upstream (backend), aqui chamados de dotnet . (Se na Etapa 1 você instalou seu certificado SSL autoassinado em um diretório diferente de /etc/nginx , substitua o caminho correto nas diretivas ssl_certificate e ssl_certificate_key .)
- O bloco upstream define o grupo dotnet de servidores backend.
  
  Em Executar o servidor HTTP Kestrel , configuramos o Kestrel em localhost:5000 , o que significa que ele escuta tanto o tráfego IPv4 quanto o IPv6 nessa porta. (Configurar o Kestrel para apenas um protocolo pode causar instabilidade e potencialmente502 erros.) Da mesma forma, o NGINX e o NGINX Plus resolvem o localhost para seus endereços IPv4 e IPv6 (127.0.0.1 e ::1). Para simplificar, aqui identificamos o servidor upstream como127.0.0.1 em vez de localhost , para que ele escute apenas tráfego IPv4. Você pode usar o localhost se estiver confortável com uma configuração mais avançada que inclua IPv6.
```
server {    listen 80 default_server;
    listen [::]:80 default_server;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2 default_server;
    listen [::]:443 ssl http2 default_server;

    ssl_certificate /etc/nginx/cert.pem;
    ssl_certificate_key /etc/nginx/cert.key;

    location / {
        proxy_pass http://dotnet;
        proxy_set_header Host $host;
    }
}

upstream dotnet {
    zone dotnet 64k;
    server 127.0.0.1:5000;
}
```

Execute este comando curl para testar a conectividade com o aplicativo .NET Core via HTTPS. (Você também pode apontar seu navegador para seu servidor Linux.)

$ curl -kv https://localhost* Rebuilt URL to: https://localhost/
*   Trying ::1...
* Connected to localhost (::1) port 443 (#0)
...[SKIPPED]...
< HTTP/1.1 200 OK
< Server: nginx/1.10.0 (Ubuntu)
< Date: Tue, 14 Feb 2017 20:22:07 GMT
< Transfer-Encoding: chunked
< Connection: keep-alive
<
Current date: 02/14/17 1:22:07 PM

Observação: Se você ver 502 Ruim Porta de entrada erros, significa que o NGINX ou o NGINX Plus não pode se conectar ao seu aplicativo .NET. Certifique-se de que ele esteja em execução e fornecendo respostas na porta 5000.

Se você instalou o pacote nghttp2 , também pode executar o seguinte comando nghttp para testar a conectividade via HTTP/2. Procure a linha destacada em laranja no exemplo a seguir, perto do início do resultado bastante longo.

$ nghttp -v https://localhost[  0.000] Connected
The negotiated protocol: h2
[  0.009] send SETTINGS frame 
          (niv=2)
          [SETTINGS_MAX_CONCURRENT_STREAMS(0x03):100]
          [SETTINGS_INITIAL_WINDOW_SIZE(0x04):65535]
[  0.009] send PRIORITY frame 
          (dep_stream_id=0, weight=201, exclusive=0)

O código de resposta é 200OK
O servidor de aplicativos é o Kestrel e não algum outro software
O corpo da resposta inclui as palavras “Data atual”
O aplicativo responde dentro de um período de tempo limite de 1 segundo

Execute o aplicativo “Hello World”

Instale e inicialize um aplicativo “Hello World” no diretório pai de sua escolha:

$ cd parent-dir-for-apps
$ mkdir app
$ cd app
$ dotnet restore

Para verificar se o aplicativo está funcionando, execute o comando dotnet run .

Execute o servidor HTTP Kestrel

Neste ponto, o .NET Core está sendo executado no Linux e servindo dados dinâmicos usando o Kestrel como servidor HTTP.

Configurar NGINX ou NGINX Plus para fazer proxy reverso do aplicativo .NET

Com o NGINX ou NGINX Plus como proxy reverso para o aplicativo .NET, você pode configurar facilmente a segurança com SSL/TLS, suporte a HTTP/2 e muitos outros recursos para entrega rápida do aplicativo na mesma máquina em que o aplicativo .NET Core está em execução. As instruções a seguir pressupõem que o NGINX e o NGINX Plus já estejam instalados no seu sistema; caso contrário, consulte Instalar o .NET Core, o NGINX e o NGINX Plus .

Configurar o NGINX Plus Live Activity Monitoring e as verificações de integridade ativas

Neste ponto, concluímos a configuração básica do NGINX ou NGINX Plus com .NET Core. O NGINX ou NGINX Plus fornece tratamento HTTP, verificações de integridade passivas, segurança com SSL/TLS e conectividade HTTP/2 para nosso aplicativo .NET Core.

Se você instalou o NGINX Plus, poderá configurar dois recursos adicionais: monitoramento de atividades ao vivo e verificações de integridade ativas.

Configurar o monitoramento de atividade ao vivo

[Editor – Esta seção foi atualizada para se referir à API NGINX Plus , que substitui e desaprova o módulo Status estendido separado originalmente discutido aqui.]

Adicione o seguinte bloco de servidor ao arquivo de configuração NGINX padrão para servidores virtuais HTTP. Recomendamos fortemente que você restrinja o acesso às estatísticas e métricas. Aqui permitimos acesso apenas a usuários no host local e em uma rede local.

Para obter mais informações sobre monitoramento de atividades ao vivo, consulte Monitoramento de atividades ao vivo do NGINX Plus em 3 etapas simples em nosso blog e o Guia de administração do NGINX Plus .

server {    listen 8080;
    allow 127.0.0.1;   # Allow localhost to access the statistics
    allow 10.3.3.0/24; # Allow local network to access the statistics
    deny all;          # Prevent access from anywhere else

    root /usr/share/nginx/html;

    location / {
        return 302 /dashboard.html;
    }

    location /api {
        api write=on;
    }

    location = /dashboard.html {
        root /usr/share/nginx/html;
    }

    # Redirect requests made to the old dashboard
    location = /status.html {
        return 301 /dashboard.html;
    }
}

Configurar verificações de integridade ativas

Verificações de integridade ativas garantem que o NGINX Plus envie tráfego somente para aplicativos que estejam funcionando corretamente. Você define as solicitações HTTP que o NGINX Plus envia periodicamente ao aplicativo e o tipo de resposta que o aplicativo deve retornar para ser considerado íntegro.

Aqui exigimos que a resposta do aplicativo atenda às seguintes condições:

No arquivo de configuração padrão para servidores virtuais HTTP, adicione o seguinte bloco de localização ao bloco do servidor principal (o bloco para tráfego HTTPS definido na Etapa 2 de Configurar o NGINX ou o NGINX Plus para fazer proxy reverso do aplicativo .NET ):

location @healthcheck {    proxy_pass http://dotnet;
    proxy_set_header Host localhost;
    health_check match=currentdate;
    proxy_connect_timeout 1s;
    proxy_read_timeout 1s;
}

Adicione também o seguinte bloco de correspondência no mesmo nível na hierarquia dos blocos do servidor e do upstream :

match currentdate {    status 200;
    header Server = Kestrel;
    body ~ "Current date";
}

Você pode verificar se seu aplicativo de backend está íntegro na guia Upstreams do painel de monitoramento de atividades ao vivo integrado (aponte seu navegador para //http:// nginx-plus-server-address :8080/ ):

O painel de monitoramento de atividades ao vivo do NGINX Plus relata a integridade dos aplicativos .NET de backend que o NGINX está usando como proxy

Para mais opções de configuração do NGINX, consulte a documentação da Microsoft .

Conclusão

Para implantações prontas para produção dos aplicativos que você desenvolve com ASP.NET, o NGINX e o NGINX Plus fornecem os recursos de gerenciamento de tráfego necessários em um proxy reverso. NGINX e NGINX Plus fornecem segurança, escalabilidade, autenticação, limitação de tráfego e roteamento inteligente de suas solicitações HTTP para aplicativos .NET Core.

Para experimentar o NGINX Plus, comece hoje mesmo seu teste gratuito de 30 dias ou entre em contato conosco para discutir seus casos de uso .

"Esta postagem do blog pode fazer referência a produtos que não estão mais disponíveis e/ou não têm mais suporte. Para obter as informações mais atualizadas sobre os produtos e soluções F5 NGINX disponíveis, explore nossa família de produtos NGINX . O NGINX agora faz parte do F5. Todos os links anteriores do NGINX.com redirecionarão para conteúdo semelhante do NGINX no F5.com."

Pesquisas sugeridas

Tutorial: Proxying .NET Core e Kestrel com NGINX e NGINX Plus

Instruções

Instalar .NET Core, NGINX e NGINX Plus

Execute o aplicativo “Hello World”

Execute o servidor HTTP Kestrel

Configurar NGINX ou NGINX Plus para fazer proxy reverso do aplicativo .NET

Configurar o NGINX Plus Live Activity Monitoring e as verificações de integridade ativas

Configurar o monitoramento de atividade ao vivo

Configurar verificações de integridade ativas

Conclusão

Forneça e proteja todos os aplicativos

Tutorial: Proxying .NET Core e Kestrel com NGINX e NGINX Plus

Instruções

Instalar .NET Core, NGINX e NGINX Plus

Execute o aplicativo “Hello World”

Execute o servidor HTTP Kestrel

Configurar NGINX ou NGINX Plus para fazer proxy reverso do aplicativo .NET

Configurar o NGINX Plus Live Activity Monitoring e as verificações de integridade ativas

Configurar o monitoramento de atividade ao vivo

Configurar verificações de integridade ativas

Conclusão

Forneça e proteja todos os aplicativos

CONECTE-SE A NÓS