Neste artigo vamos ver como configurar o PostgreSQL além de subir a sua aplicação Node.js plugada nele.

Atenção: este é um tutorial intermediário. Se você não sabe programar Node.js ainda, não comece com ele pois vai mais te atrapalhar do que te ajudar. Para iniciantes, eu recomendo meus livros e meu curso (inclusive no curso você encontra este conteúdo em vídeoaula). 

Criando o banco PostgreSQL

O LightSail fornece um produto de PostgreSQL na nuvem extremamente robusto e profissional, mas proporcionalmente caro, algo a partir de U$15/mês na data que escrevo este tutorial. Ele é super simples de criar, você apenas dá nome ao banco, ao usuário e define uma senha, tendo como resultado o host que eles geram dinamicamente, para que você possa montar a sua connection string e usar na sua aplicação. Não precisa de tutorial pra isso.

Minha ideia aqui é lhe ensinar como instalar e configurar o PostgreSQL dentro do mesmo servidor em que o Node.js está. Isso tem algumas vantagens como custo reduzido e performance nas consultas. E isso tem duas desvantagens, como você ser responsável pela administração do mesmo e no futuro o PostgreSQL pode atrapalhar o desempenho da sua aplicação por consumir recursos demais da máquina, sendo que, para estudo, a máquina de 512MB resolve, mas se for realmente colocar uma aplicação a rodar, tenha em mente no mínimo 1GB, quiçá 2GB.

Futuramente você pode aumentar os recursos da máquina ou executar o mesmo passo a passo abaixo em outra máquina Amazon Linux 2023 se quiser separar o PostgreSQL da aplicação Node.js, então não precisa ficar mega preocupado com isso não.

Mas vamos ao que interessa, abra o terminal SSH web clicando no botão laranja de “Connect using SSH” ou use seu cliente SSH favorito.

O primeiro passo a se fazer no terminal é baixar e instalar o pacote do PostgreSQL para o servidor.

O primeiro comando atualiza as referências e o segundo instala o PostgreSQL em si. Eventualmente algum dos comandos vai pedir confirmação para instalar, o que você faz apenas apertando y.

O próximo passo é inicializar o PostgreSQL e registrá-lo para iniciar junto do Linux.

Quando o PostgreSQL subir pela primeira vez, ele estará com um password root aleatório. Para mudar a senha de administrador use o comando abaixo.

Para deixarmos nossa instalação do PostgreSQL profissional, vamos trocar também a senha do banco default. Para isso, primeiro se autentique como root usando o primeiro comando, depois mude a senha do usuário do banco default com os demais comandos abaixo.

Não há necessidade de mexer em nada relacionado à rede pois a instalação default só aceita conexões localhost por padrão. Mas precisando fazer outras tarefas alternativas você irá precisar editar o arquivo de configuração do Postgre, que fica em /var/lib/pgsql/data/postgresql.conf

Preparando a aplicação

Quando o setup terminar, você vai precisar criar um usuário e uma base de dados da sua aplicação. Para isso, conecte-se no servidor de PostgreSQL usando o comando abaixo.

Ele vai pedir a sua senha de root (a mesma que cadastrou antes) e logo depois você pode criar o usuário e banco de dados usando o comando abaixo (substitua seu-banco).

Eu não sei como você vai fazer para migrar os seus dados. Pode ser que você queira rodar algum comando de import, de restore ou os SQL um-a-um, você que sabe. Eu particularmente gosto de usar Sequelize com PostgreSQL, que já cria a estrutura do banco automaticamente e o popula, basta ter a database criada.

Da mesma forma, tem muitas maneiras de trazer sua aplicação pra dentro do servidor. Você pode fazê-lo via FTP (apenas certifique-se de não subir a node_modules) ou via Git, que é meu método favorito.

O Git não vem instalado por padrão no Amazon Linux 2023, então rode o comando abaixo para baixá-lo.

Com o Git instalado, clone o repositório do seu projeto, altere as variáveis de ambiente para apontar para seu PostgreSQL recém instalado e para a porta que liberou no firewall do Lightsail para a aplicação (falei disso na parte 1, lembra?).

E por último, teste a sua aplicação, rodando primeiro o comando de instalar as dependências e depois o comando de inicialização da mesma, dentro da pasta dela.

Isso por si só já é o suficiente para sua aplicação Node.js funcionar. Se você acessar via Postman ou via navegador o seu IP público ou DNS, na porta da sua aplicação, já deve conseguir utilizar ela.

No entanto, se ela crashar por algum motivo ou o servidor reiniciar, ela não irá voltar sozinha. Por isso recomendo o uso do PM2, que ensino a usar neste tutorial e no vídeo abaixo.

Um resumo dos comandos necessários para instalar e usar o PM2 na sua máquina da Amazon pode ser encontrado abaixo. O primeiro comando instala o PM2 globalmente, o segundo registra ele na inicialização do servidor, o terceiro (que deve ser executado dentro da pasta do projeto) registra a sua aplicação no PM2 (definindo que ela vai rodar com npm start) e o último salva suas novas configurações.

Outra alternativa é usar um arquivo de configuração JSON na raiz do seu projeto, aí o comando de registro da sua aplicação fica levemente diferente, tendo de referenciar o arquivo JSON.

Criando um snapshot como backup do servidor

Se você não deixou configurado para serem feitos snapshots diários do seu servidor, você terá de fazê-lo tão logo termine de configurar e subir a sua aplicação para o servidor. Afinal, imagine ter de fazer todos os passos que já fizemos até aqui de novo caso dê algum problema com a sua máquina?

Para Fazê-lo é muito simples, basta ir na área de administração (Manage) da sua instância e acessar a aba Snapshots.

Ali você pode tanto configurar os snapshots automáticos quanto criar um manualmente. Saliento que snapshots ocupam espaço em disco e consequentemente são cobrados pela Amazon, embora não sejam caros.

Se a sua máquina na Amazon for multi-core e você quiser aproveitar todo o desempenho dela, dá uma olhada no vídeo abaixo de como subir o Node.js em modo cluster.

Espero que tenha gostado do tutorial!

*O conteúdo deste artigo é de responsabilidade do(a) autor(a) e não reflete necessariamente a opinião do iMasters.