Implantação da API em um VPS

Por que usar uma API de exemplo no desenvolvimento web?

De início, Tim explica a importância de ter uma API de exemplo. É um campo de testes vital ao construir aplicações front-end com tecnologias como HTML, JavaScript ou até mesmo Blazor. Você obtém a experiência completa de desenvolvimento web — da lógica de backend à hospedagem e implantação.

Estratégia de domínio: compre somente quando estiver pronto.

Tim enfatiza um princípio fundamental: não se precipite em comprar um nome de domínio assim que tiver uma nova ideia de aplicativo. Muitos desenvolvedores iniciantes gastam demais com domínios, pacotes de hospedagem e recursos como servidores de e-mail sem ter um protótipo funcional.

Em vez disso, concentre-se primeiro nas linguagens de programação, nos modelos de dados e na lógica da API. Quando o projeto estiver mais maduro, aí sim será a hora de registrar seu domínio e contratar uma hospedagem. No entanto, para este tutorial, Tim comprou antecipadamente o domínio thesampleapi.com através da Namecheap — um provedor de hospedagem confiável que ele recomenda.

Como escolher um provedor de hospedagem VPS

Tim utiliza o InterServer para este projeto — um provedor de hospedagem VPS em que ele confia para obter servidores virtuais privados de alto desempenho e baixo custo. Embora normalmente utilize o Azure (especialmente para o Microsoft SQL Server ou implantações em escala empresarial), Tim opta pelo InterServer neste caso para demonstrar a flexibilidade.

Ele menciona os benefícios dos planos de hospedagem VPS:

• Mais controle do que os planos de hospedagem compartilhada

• Melhor desempenho para sites dinâmicos

• Armazenamento SSD e espaço em disco escalável

• Proteção DDoS opcional e acesso total ao sistema operacional

Para desenvolvedores que comparam opções de hospedagem VPS Linux e Windows Server, o caso de uso de Tim mostra como trabalhar com ambos os ambientes, embora este exemplo utilize um VPS baseado em Windows.

Configuração de hospedagem web com o painel de controle Plesk

Tim demonstra passo a passo como configurar seu serviço de hospedagem através do painel de controle Plesk. As soluções VPS geralmente concedem acesso root ou acesso ao painel de controle para configurar seu servidor web. Ele cria o domínio thesampleapi.com e configura a hospedagem web básica.

Esta etapa inclui:

• Ativação do serviço de hospedagem DNS

• Criando o diretório de hospedagem

• Entendendo a estrutura de servidor compartilhado versus servidor dedicado em VPS

Tim observa que os usuários de VPS geralmente hospedam vários domínios em uma única instância de servidor. Essa é a vantagem do VPS sobre a hospedagem compartilhada básica do Windows: ele se adapta às suas necessidades e consegue lidar com alto tráfego de forma eficiente.

Atualizando as configurações de DNS via Namecheap

Para conectar o domínio ao provedor de hospedagem, Tim atualiza os registros do Servidor de Nomes (NS) no Namecheap para apontar para o DNS da InterServer. Isso permite que o domínio seja resolvido para o endereço IP do VPS.

Tim diz que isso pode levar até 48 horas, mas, segundo sua experiência, geralmente é concluído em 15 minutos ou menos — uma vantagem para os desenvolvedores .NET ansiosos para ver seu trabalho em funcionamento.

Instalando um certificado SSL

A segurança é um requisito inegociável em aplicações web modernas. Tim configura um certificado SSL usando o Let's Encrypt, que oferece criptografia gratuita para sites. Ele usa um certificado SSL curinga para que subdomínios como www.thesampleapi.com e api.thesampleapi.com também fiquem protegidos.

Este é um passo crucial, especialmente para APIs ASP.NET Core que lidam com dados sensíveis. Os certificados SSL criptografam a comunicação entre os clientes e o servidor web, sendo essenciais para sites seguros e de alto desempenho.

Publicando com o Visual Studio

Em seguida, Tim demonstra como publicar a API ASP.NET Core a partir do Visual Studio:

1. Clique com o botão direito do mouse no projeto → Publicar

2. Selecione Pasta como destino.

3. Selecione o modo de liberação.

4. Defina o tipo de implantação como Dependente do Framework (para ambientes com as versões apropriadas do .NET pré-instaladas).

Se a implantação for feita em um ambiente de hospedagem Linux sem o .NET instalado, Tim sugere a mudança para uma implantação autocontida. Este pacote inclui o ambiente de execução .NET Core necessário, garantindo a compatibilidade em servidores remotos.

A publicação gera um conjunto de arquivos que podem ser enviados diretamente para o seu provedor de hospedagem.

Envio de arquivos para o servidor web

Tim usa o gerenciador de arquivos no painel de controle para excluir arquivos padrão e carregar a pasta publicada. Ele arrasta o conteúdo diretamente de sua máquina para o sistema de arquivos do VPS. Após o upload, acessar o URL do domínio retorna uma mensagem básica "Olá Mundo", indicando que o aplicativo está online.

Para usuários mais avançados, ele recomenda automatizar a implantação usando o GitHub Actions ou o webdev, dependendo dos recursos do seu serviço de hospedagem.

Testando os endpoints da API

Tim então navega até /courses, uma rota definida em sua API C#. Retorna dados JSON, comprovando que o aplicativo ASP.NET Core está funcionando corretamente. Isso também confirma que a lógica de backend, o roteamento e o middleware estão sendo tratados corretamente no servidor web.

Corrigindo a interface do usuário do Swagger (Scaler/V1)

Um problema comum enfrentado por muitos desenvolvedores .NET é que o Swagger UI (usado para documentação de API) só funciona no modo de desenvolvimento. Tim identifica que o arquivo de configuração do projeto desativa o Swagger em produção.

Ele atualiza a configuração do OpenAPI no arquivo de configuração para torná-la disponível mesmo em ambientes de produção — essencial para depuração e testes em ambientes reais.

Redirecionando a raiz para a interface do usuário do Swagger.

Em vez de exibir "Olá Mundo" na página inicial, Tim adiciona um redirecionamento no endpoint raiz da API. Agora, visitandohttps://thesampleapi.com redirecionará automaticamente os usuários para a documentação do Swagger em /scaler/v1. Essa pequena alteração melhora a usabilidade e ajuda os desenvolvedores a acessar rapidamente as especificações da API.

Reimplementação após atualizações

Para refletir as novas alterações, Tim repete o processo de publicação e upload. Ele limpa o diretório de arquivos do VPS e reenvia a nova versão. Ele explica que, embora esse método resulte em breves períodos de inatividade, isso é aceitável durante a fase de desenvolvimento.

Para aplicações de produção com alto tráfego, Tim recomenda o uso de um espaço de teste (staging slot) — um recurso encontrado em planos de hospedagem mais avançados ou plataformas como o Azure. Isso permite uma implementação perfeita, sem tempo de inatividade.

Verificação final e teste de API

Com a API atualizada já implementada, Tim confirma:

• O certificado SSL está ativo

• Os endpoints retornam dados corretos

• A interface do Swagger está acessível em /scaler/v1

A implantação foi um sucesso. Os desenvolvedores agora podem testar essa API em tempo real a partir de qualquer frontend — seja Angular, React, Blazor ou até mesmo aplicativos de desktop como WPF e WinForms.

Qual o próximo passo?

Tim conclui incentivando os desenvolvedores a explorarem o uso da API de exemplo com diferentes interfaces. Seja para criar sites dinâmicos, testar integrações ou experimentar com ASP clássico ou Visual Basic, esta API implantada é um excelente recurso.

Você pode acessar a API em tempo real em:

• https://thesampleapi.com

• https://www.thesampleapi.com

Resumo

Implantar uma API em um VPS é uma experiência de aprendizado valiosa para qualquer desenvolvedor que trabalhe com .NET Core, .NET Framework ou aplicações web em geral. O vídeo de Tim Corey ilustra toda a jornada — da configuração do domínio à implantação final — oferecendo dicas práticas e melhores práticas.

Se você está pensando em migrar para planos de hospedagem VPS, precisa evitar taxas ocultas de empresas de hospedagem web tradicionais ou deseja experimentar algo além da hospedagem compartilhada, este tutorial o colocará no caminho certo.

Quer esteja lançando sua primeira API ou explorando a hospedagem de serviços .NET, este guia oferece clareza, controle e recursos poderosos para criar aplicativos da Web dinâmicos e escaláveis.