Variáveis de Ambiente

Aprenda a configurar e utilizar variáveis de ambiente nos seus containers na MozHost.

O Que São Variáveis de Ambiente?

Variáveis de ambiente são pares de chave=valor que ficam disponíveis para a sua aplicação em tempo de execução. Elas permitem separar configurações sensíveis (como senhas e tokens) do código-fonte do projecto.

💡 Por que usar variáveis de ambiente?

🔒Segurança — Senhas e tokens ficam fora do código-fonte
⚙️Flexibilidade — Altere configurações sem alterar o código
🔄Ambientes diferentes — Use valores distintos para desenvolvimento e produção
👥Colaboração — Cada desenvolvedor pode ter suas próprias credenciais

Configurar pelo Dashboard

A forma mais simples de definir variáveis de ambiente é através do painel de controlo da MozHost:

Acesse as configurações do container

No dashboard, clique no container desejado e depois em "Configurações" ou "Settings".

Encontre a secção de variáveis

Procure pela secção "Variáveis de Ambiente" ou "Environment Variables".

Adicione as variáveis

Preencha o campo Chave e o campo Valor, depois clique em "Salvar".

Chave

DATABASE_URL

Valor

mysql://user:pass@host:3306/db

Chave

NODE_ENV

Valor

production

✅ Dica: As variáveis definidas no dashboard ficam disponíveis automaticamente após reiniciar o container.

Configurar pelo CLI

Você também pode definir variáveis de ambiente usando o CLI da MozHost:

Definir uma variável:

$ mozhost env:set DATABASE_URL=mysql://user:pass@host:3306/db

Definir várias de uma vez:

$ mozhost env:set NODE_ENV=production PORT=3000 API_KEY=minha-chave

Listar variáveis definidas:

$ mozhost env:list

DATABASE_URL = mysql://user:***@host:3306/db

NODE_ENV = production

PORT = 3000

Remover uma variável:

$ mozhost env:unset API_KEY

Variáveis Comuns

Estas são as variáveis de ambiente mais utilizadas em projectos hospedados na MozHost:

Variável	Descrição	Exemplo
`PORT`	Porta em que a aplicação escuta	`3000`
`DATABASE_URL`	String de conexão ao banco de dados	`mysql://user:pass@host:5101/db`
`NODE_ENV`	Ambiente de execução (Node.js)	`production`
`API_KEY`	Chave de API de serviços externos	`sk_live_abc123...`
`JWT_SECRET`	Chave secreta para assinar tokens JWT	`minha-chave-secreta-forte`

Como Acessar no Código

Depois de definir as variáveis, acesse-as no código da sua aplicação:

💚

Node.js / JavaScript

// Acessar variáveis de ambiente

const port = process.env.PORT || 3000;

const dbUrl = process.env.DATABASE_URL;

const jwtSecret = process.env.JWT_SECRET;

// Exemplo: iniciar servidor

app.listen(port, () => {

console.log(`Servidor rodando na porta ${port}`);

});

🐍

Python

import os

# Acessar variáveis de ambiente

port = os.environ.get('PORT', '3000')

db_url = os.environ['DATABASE_URL']

jwt_secret = os.environ['JWT_SECRET']

# Com valor padrão (não lança erro se não existir)

api_key = os.environ.get('API_KEY', 'chave-padrao')

Dicas de Segurança

⚠️ Nunca coloque segredos no código-fonte

Tokens, senhas de banco de dados, chaves de API e segredos JWT nunca devem ser escritos directamente no código. Sempre use variáveis de ambiente.

❌Errado

// NÃO faça isso!

const senha = 'minha-senha-123';

const token = 'sk_live_abc...';

✅Correcto

// Use variáveis de ambiente

const senha = process.env.DB_PASSWORD;

const token = process.env.API_KEY;

📁 Desenvolvimento local: Use um ficheiro .env na raiz do projecto para guardar variáveis localmente. Adicione .env ao seu .gitignore para nunca enviar segredos ao repositório.

🚀 Produção: Sempre defina as variáveis de ambiente pelo dashboard ou pelo CLI da MozHost. Nunca suba ficheiros .env para o servidor.

🔑 Chaves fortes: Para variáveis como JWT_SECRET, use strings longas e aleatórias com pelo menos 32 caracteres.

Exemplo Prático: Conectar ao Database MozHost

🎯 Objectivo: Conectar um container Node.js ao database MySQL da MozHost

Definir variáveis via CLI

$ mozhost env:set \

DB_HOST=meu-db-mysql.mozhost.shop \

DB_PORT=5101 \

DB_USER=user_tevfao6tux \

DB_PASS=minha-senha-segura \

DB_NAME=db_a4vcv35wm9

Usar no código (Node.js com mysql2)

const mysql = require('mysql2');

const connection = mysql.createConnection({

host: process.env.DB_HOST,

port: process.env.DB_PORT,

user: process.env.DB_USER,

password: process.env.DB_PASS,

database: process.env.DB_NAME

});

connection.connect((err) => {

if (err) {

console.error('Erro ao conectar:', err);

return;

}

console.log('✅ Conectado ao database MozHost!');

});

Fazer deploy

$ mozhost deploy

🎉 Pronto! A sua aplicação vai conectar ao database usando as variáveis de ambiente, sem nenhuma senha exposta no código.

Próximos Passos

Agora que você sabe configurar variáveis de ambiente, explore mais:

🗄️ Criar Database 💻 CLI da MozHost 📤 Deploy