Documentação ServBay: Como Definir uma Versão Específica do Node.js para Seus Projetos, Scripts e Sites
O ServBay é um ambiente local de desenvolvimento web robusto que oferece suporte a diversas linguagens e stacks de tecnologia, incluindo Node.js. Na prática, você pode precisar utilizar versões diferentes do Node.js para diferentes projetos, scripts individuais ou até mesmo para sites inteiros. Por exemplo, um projeto legado pode depender do Node.js 14, enquanto um projeto mais recente pode exigir os recursos do Node.js 20. O ServBay fornece maneiras flexíveis de lidar com essas necessidades.
Neste artigo, você aprenderá em detalhes como definir facilmente uma versão específica do Node.js para scripts e sites no ServBay, além de usar configurações a nível de projeto.
Usando o Arquivo .servbay.config para Especificar a Versão do Node.js e Configurar o Projeto
Para projetos que exigem controle rigoroso da versão do Node.js e das variáveis de ambiente, o ServBay oferece uma configuração em nível de projeto: basta criar um arquivo .servbay.config
na raiz do projeto. Esse arquivo permite definir a versão do Node.js, o repositório do gerenciador de pacotes, os diretórios de cache e outros ajustes, garantindo o isolamento e a consistência do ambiente do projeto.
Um exemplo de arquivo .servbay.config
que define uma versão específica do Node.js, além de configurar o repositório e o caminho de cache do npm/yarn, pode ser assim:
bash
NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Exemplo: usando um mirror específico
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Exemplo: usando um mirror específico
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Exemplo: especificando o caminho do cache
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Exemplo: especificando o caminho do cache
1
2
3
4
5
2
3
4
5
Explicação:
NODE_VERSION
: Define a versão principal do Node.js que será utilizada neste projeto. O ServBay irá buscar e usar a versão instalada correspondente.YARN_CONFIG_REGISTRY
eNPM_CONFIG_REGISTRY
: Configura o repositório utilizado pelo npm ou yarn para este projeto.NPM_CONFIG_CACHE
eYARN_CONFIG_CACHE
: Define o diretório de cache utilizado pelo npm ou yarn. No exemplo, é usado o diretório padrão de arquivos temporários do ServBay em/Applications/ServBay/tmp/
.
Geralmente, o arquivo .servbay.config
deve ser colocado na raiz do seu projeto. Para informações detalhadas sobre configuração e utilização, consulte a seção sobre o arquivo .servbay.config na documentação oficial do ServBay.
Executando Scripts com Versões Específicas do Node.js via Linha de Comando
Caso você não queira configurar a versão do Node.js no nível do projeto, mas apenas executar temporariamente um script com uma versão específica do Node.js, o ServBay oferece aliases práticos na linha de comando.
No terminal integrado do ServBay (acessível pela interface do aplicativo), você pode facilmente escolher a versão desejada executando comandos no formato node-<versão>
. O ServBay cria automaticamente esses aliases para cada versão instalada do Node.js.
Por exemplo, para executar o script script.js
com o Node.js 14, use o comando:
bash
$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Exemplo de saída; o número da versão pode variar
$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Exemplo de saída; o número da versão pode variar
$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Exemplo de saída; o número da versão pode variar
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
Explicação dos Exemplos
$ node-14 script.js
: executa oscript.js
usando a versão 14.x.x do Node.js instalada no ServBay.$ node-16 script.js
: executa oscript.js
usando a versão 16.x.x do Node.js instalada no ServBay.$ node-20 script.js
: executa oscript.js
usando a versão 20.x.x do Node.js instalada no ServBay.
Esse método permite testar a compatibilidade e rodar tarefas rapidamente com diferentes versões do Node.js, sem precisar alternar a versão globalmente.
Definindo a Versão do Node.js para um Site via Interface Gráfica do ServBay
O ServBay possibilita definir a versão padrão do Node.js para um site diretamente pela interface de administração. Isso é útil para sites ou aplicações que dependem do Node.js no backend (como apps em frameworks Node.js, atrás de um proxy reverso Caddy ou Nginx), ou que precisam de um ambiente Node.js específico.
Passos
Abra a interface de administração do ServBay: Inicie o aplicativo e acesse a interface via navegador (tipicamente em
http://localhost:5200
ou pelo atalho na janela principal do app).Navegue até Gerenciamento de Sites: No menu lateral, clique em
Sites
.Escolha e Edite o Site: Na lista, localize o site desejado (por exemplo, criado em
/Applications/ServBay/www/servbay.demo
). Clique no botão de editar ao lado do site (ícone de engrenagem ou lápis), ou diretamente no nome do site para acessar os detalhes.Defina a Versão do Node.js: Na página de configuração do site, localize a opção referente à versão do Node.js (geralmente um menu suspenso). Escolha a versão padrão desejada para o site.
Salve as Alterações: Após selecionar a versão, clique em
Salvar
ouAplicar
no fim da página para registrar as configurações.Reinicie o Site ou o ServBay (se necessário): Algumas alterações podem exigir o reinício do servidor web (como Caddy ou Nginx) ou do próprio ServBay. O sistema normalmente alerta sobre essa necessidade para que as mudanças tenham efeito.
Observações
- Garanta que a versão do Node.js esteja instalada e ativa: A versão escolhida deve estar instalada e em execução na seção
Pacotes
do ServBay. Caso necessário, instale ou ative a versão emPacotes
. - Tipo de site: Esta configuração afeta principalmente sites que utilizam Node.js como ambiente de execução (como backends com Express.js, Next.js, NestJS, etc.). Para sites estáticos ou que utilizam apenas PHP/Python/Go, a configuração pode não ter efeito ou ter efeito limitado.
- Testes de compatibilidade: Após alterar a versão do Node.js, sempre teste todas as funcionalidades do site para garantir que as dependências funcionem corretamente na nova versão e que não haja problemas de compatibilidade.
- Relação com
.servbay.config
: A configuração a nível de site serve como padrão. Se existir um arquivo.servbay.config
no diretório do site especificandoNODE_VERSION
, ele terá prioridade sobre a configuração global do site, possibilitando controle mais granular.
Resumo
O ServBay é um ambiente de desenvolvimento local completo, que oferece maneiras flexíveis e poderosas de gerenciar e especificar o ambiente de execução do Node.js. Você pode controlar precisamente o projeto com o arquivo .servbay.config
na raiz, executar scripts rapidamente com uma versão específica pelo comando node-<versão>
, ou definir a versão padrão do Node.js para seus sites via interface gráfica. Com esses recursos, fica fácil gerenciar necessidades diversas de versões do Node.js em diferentes projetos—seja para manter compatibilidade com sistemas legados, testar novos recursos ou garantir a consistência entre os ambientes de desenvolvimento e produção. O ServBay fornece suporte robusto, aumentando consideravelmente sua produtividade e capacidade de gerenciamento de ambientes.