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.
Como criar uma conta no 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
Como importar um projeto Node.js 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 customizadas:
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 node.js 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 node.js 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 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
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.