Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    Variável de ambiente

    Variável de ambiente é um valor nomeado fornecido ao ambiente de um processo e lido pelo programa em tempo de execução.

    Também chamado de: environment variable, variável de processo

    Definição

    Variável de ambiente é um valor nomeado fornecido ao ambiente de um processo. O programa lê o nome durante a execução e recebe o valor configurado para aquele ambiente, sem que o código precise conter o valor fixo.

    O mesmo código, valores diferentes

    O mesmo código pode receber parâmetros diferentes em cada ambiente. Um processo de desenvolvimento lê um conjunto de valores, e um processo de produção lê outro, apenas pela forma como cada ambiente fornece as variáveis.

    Valores por ambientebash
    # ambiente de desenvolvimento
    APP_ENV=development
    SERVICO_URL=http://localhost:3000
    
    # ambiente de produção
    APP_ENV=production
    SERVICO_URL=https://api.exemplo.com

    Variável de ambiente e secret

    Variável de ambiente não é automaticamente secreta. Qualquer valor pode ser fornecido por esse mecanismo, inclusive o público. O arquivo .env é uma forma de fornecer esses valores ao processo local, e guardar um secret nele não dispensa o controle de acesso ao arquivo.

    O valor que não chega

    No exemplo dos dois ambientes, o código lê o mesmo nome e recebe o valor próprio de cada cenário. A falha provável aparece quando o ambiente novo não fornece uma das variáveis e o programa lê um valor ausente, assumindo um padrão ou quebrando na primeira chamada. A verificação declara as variáveis obrigatórias, confere no início da execução se todas estão presentes e testa o cenário sem cada uma delas. A variável só cumpre o papel quando o ambiente que a fornece está configurado de forma completa.

    Veja a definição de secret

    Dúvidas frequentes

    Perguntas frequentes sobre Variável de ambiente

    Variável de ambiente é sempre secreta?
    Não. O mecanismo pode carregar valores públicos e privados. A natureza sensível depende do valor guardado.
    O que é um arquivo .env?
    Um arquivo que declara pares de nome e valor lidos como variáveis de ambiente no processo local. Ele facilita a configuração sem colocar valores no código.
    O mesmo código funciona em ambientes diferentes?
    Sim, quando os valores vêm de variáveis de ambiente. Cada ambiente fornece os valores próprios e o código mantém a lógica inalterada.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Developer Workspace

    Na Formação Developer Workspace, a variável de ambiente fornece valores nomeados ao processo em tempo de execução.

    Conhecer a formação
    Capa da Formação Developer Workspace

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva.

    R$ 2.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva (segunda a sexta)
    • War Rooms às segundas, quartas e sextas
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano