Neste artigo, vamos explorar o processo de hospedagem de um projeto Node.js na plataforma Vercel. Abordaremos desde a criação de conta e importação do repositório do GitHub até a configuração de variáveis de ambiente, funções serverless, domínios e versão do Node.js, visando garantir a correta configuração para o ambiente de produção.

Criando Conta na Vercel

O primeiro passo é acessar o site da Vercel (vercel.com) e criar uma conta gratuita ou fazer login com uma conta existente, como o GitHub. A Vercel permite hospedar projetos de forma gratuita, utilizando a arquitetura serverless.

  • Acessar o site da Vercel (vercel.com)
  • Criar uma conta gratuita ou fazer login com uma conta existente, como o GitHub
  • Hospedar projetos gratuitamente utilizando a arquitetura serverless

Importando o Projeto do GitHub

Depois de logar, devemos clicar em ‘Add New Project’ e importar o nosso repositório do GitHub que contém o projeto que queremos hospedar. No exemplo, estamos importando o repositório ‘dnc-board-task-back’. A Vercel detecta automaticamente as configurações do projeto e tenta fazer o deploy.

  • Clicar em ‘Add New Project’ após fazer o login
  • Importar o repositório do GitHub que contém o projeto desejado
  • Exemplo prático de importação de repositório

Configurações Personalizadas

Como estamos utilizando configurações customizadas, o deploy inicial não funcionará corretamente. Como a Vercel cria uma integração automática com o GitHub ao importar o projeto, precisamos desconectar essa integração, pois iremos config

  • Necessidade de realizar configurações personalizadas
  • Problemas com o deploy inicial devido às configurações customizadas
  • Processo de desconectar a integração automática com o GitHub

Desconectando o projeto do GitHub

Para desconectar o projeto do GitHub na Vercel, é necessário acessar as configurações do projeto e clicar em ‘Settings’ > ‘Git’ e, em seguida, clicar em ‘Disconnect’. Após essa ação, o projeto continuará na Vercel, porém não terá mais integração direta com o GitHub.

  • Acessar as configurações do projeto na Vercel
  • Clicar em ‘Settings’ > ‘Git’
  • Selecionar a opção ‘Disconnect’
  • Confirmar a desconexão do projeto com o GitHub

Ao definir as variáveis de ambiente no ambiente local (arquivo .env), é essencial configurá-las também no servidor da Vercel, porém com valores diferentes. Para isso, é possível acessar ‘Settings’ > ‘Environment Variables’ e criar as variáveis necessárias, como por exemplo, a variável NODE_ENV, onde podemos definir o valor ‘production’ para indicar que o ambiente é de produção.

  • Acessar ‘Settings’ > ‘Environment Variables’ na Vercel
  • Exemplo: Definir o valor ‘production’ para a variável NODE_ENV

Configurando Funções Serverless

A Vercel, por padrão, utiliza servidores localizados nos EUA. No entanto, é possível alterar essa configuração para utilizar servidores no Brasil, proporcionando uma melhoria na latência. Para realizar essa configuração, basta acessar ‘Settings’ > ‘Functions’ e alterar a região para ‘South America’ > ‘São Paulo’, garantindo que as funções JavaScript sejam executadas em servidores localizados no Brasil.

  • Alterar a configuração de servidores na Vercel
  • Acessar ‘Settings’ > ‘Functions’ na Vercel
  • Selecionar a região ‘South America’ > ‘São Paulo’
  • Garantir a execução das funções JavaScript em servidores no Brasil

Configurando Domínios

Por padrão, a Vercel atribui um domínio com um formato específico. No entanto, é possível configurar domínios personalizados. Para realizar essa configuração, é necessário acessar as configurações de domínio na Vercel e seguir as etapas necessárias para atribuir um domínio personalizado ao projeto.

  • Personalizar domínios na Vercel
  • Acessar as configurações de domínio na Vercel
  • Atribuir um domínio personalizado ao projeto
  • Seguir as etapas necessárias para configurar o domínio

Configurando um Projeto na Vercel

Ao criar um projeto na Vercel, é importante configurar corretamente o ambiente para garantir que esteja pronto para receber deploys a partir da pipeline de CI/CD. Isso inclui a configuração de variáveis de ambiente, funções serverless, domínios e versão do Node.js.

  • Ao criar um projeto na Vercel, é essencial configurar corretamente o ambiente para garantir que esteja pronto para receber deploys a partir da pipeline de CI/CD
  • Uma configuração adequada assegura que o projeto esteja pronto para o ambiente de produção

A configuração de variáveis de ambiente é fundamental para garantir que o projeto na Vercel funcione corretamente. Isso permite a definição de variáveis específicas para cada ambiente, como produção, desenvolvimento e teste.

Configurando Funções Serverless

Além da configuração de variáveis de ambiente, a Vercel permite a configuração de funções serverless, que são essenciais para a execução de código de forma escalável e eficiente, sem a necessidade de gerenciar a infraestrutura.

  • A Vercel permite a configuração de funções serverless, essenciais para a execução de código de forma escalável e eficiente
  • As funções serverless eliminam a necessidade de gerenciar a infraestrutura, simplificando o processo de desenvolvimento e implantação

Configurando Domínios Personalizados

Ao hospedar um projeto na Vercel, é possível customizar o domínio ou utilizar um domínio próprio. Isso pode ser feito facilmente através das configurações, permitindo até mesmo encurtar o domínio gerado automaticamente ou apontar domínios comprados em outros serviços diretamente para o projeto na Vercel.

  • Ao hospedar um projeto na Vercel, é possível customizar o domínio ou utilizar um domínio próprio
  • As configurações permitem encurtar o domínio gerado automaticamente ou apontar domínios comprados em outros serviços diretamente para o projeto na Vercel
  • Isso oferece flexibilidade na escolha e personalização do domínio, adaptando-se às necessidades específicas do projeto

Configurando a Versão do Node.js

Configurar a versão do Node.js é crucial para garantir a compatibilidade entre o ambiente de desenvolvimento e o ambiente da Vercel. Ao selecionar uma versão igual ou inferior à utilizada localmente, assegura-se que o projeto funcionará corretamente na Vercel.

  • Configurar a versão do Node.js é crucial para garantir a compatibilidade entre o ambiente de desenvolvimento e o ambiente da Vercel
  • Selecionar uma versão igual ou inferior à utilizada localmente assegura que o projeto funcionará corretamente na Vercel
  • Isso evita possíveis problemas de compatibilidade e garante um ambiente de execução estável e confiável

Torne-se um desenvolvedor(a) aprendendo tudo na prática!

Conheça a nossa Formação em Tecnologia e impulsione sua carreira sabendo as tecnologias mais requisitadas do mercado em ambas as pontas do desenvolvimento: front-end e back-end, aprendendo a desenvolver sites e aplicativos web, além de criar e manipular estruturas de banco de dados.

  • SQL
  • MongoDB
  • Testes Unitários
  • JavaScript ES6
  • HTML5, CSS3
  • NodeJS
  • ExpressJS

Conclusão

Ao seguir os passos descritos, o projeto estará pronto para receber deploys a partir da pipeline de CI/CD, assegurando que esteja devidamente configurado para o ambiente de produção. Com a configuração adequada de variáveis de ambiente, funções serverless, domínios e versão do Node.js, estaremos prontos para garantir a eficiência e compatibilidade do projeto na Vercel.