![\"exemplo](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/01-What-Are-Environment-Variables.jpg\")
<\/figure>\n\n\n\nVari\u00e1veis de ambiente s\u00e3o valores nomeados din\u00e2micos que podem afetar o comportamento de processos em execu\u00e7\u00e3o em um computador. Algumas propriedades chave das vari\u00e1veis de ambiente s\u00e3o:<\/p>\n\n\n\n
- \n
- Nomeadas<\/strong>: Tenha nomes de vari\u00e1veis descritivos como APP_MODE<\/em> e DB_URL<\/em>.<\/li>\n\n\n\n
- Externas<\/strong>: Os valores s\u00e3o definidos fora do c\u00f3digo do aplicativo por meio de arquivos, linhas de comando e sistemas.<\/li>\n\n\n\n
- Din\u00e2micas<\/strong>: Podem atualizar vari\u00e1veis sem reiniciar aplicativos.<\/li>\n\n\n\n
- Configuradas<\/strong>: O c\u00f3digo depende de vari\u00e1veis, mas n\u00e3o as define.<\/li>\n\n\n\n
- Desacopladas<\/strong>: N\u00e3o \u00e9 necess\u00e1rio alterar configura\u00e7\u00f5es do c\u00f3digo uma vez que as vari\u00e1veis est\u00e3o definidas.<\/li>\n\n\n<\/ul>\n\n\n\n
Aqui est\u00e1 uma analogia<\/strong>. Imagine que voc\u00ea est\u00e1 seguindo uma receita de cookies de chocolate. A receita pode dizer:<\/p>\n\n\n\n
- \n
- Adicione 1 x\u00edcara de a\u00e7\u00facar<\/li>\n\n\n\n
- Adicione 1 barra de manteiga amolecida<\/li>\n\n\n\n
- Adicione 2 ovos<\/li>\n\n\n<\/ul>\n\n\n\n
Em vez desses valores codificados, voc\u00ea poderia usar vari\u00e1veis de ambiente:<\/p>\n\n\n\n
- \n
- Adicione $SUGAR x\u00edcara de a\u00e7\u00facar<\/li>\n\n\n\n
- Adicione $BUTTER barras de manteiga amolecida<\/li>\n\n\n\n
- Adicione $EGGS ovos<\/li>\n\n\n<\/ul>\n\n\n\n
Antes de fazer os cookies, voc\u00ea definiria os nomes das vari\u00e1veis de ambiente com valores de sua escolha:<\/p>\n\n\n\n
SUGAR=1 \nBUTTER=1\nEGGS=2<\/code><\/pre>\n\n\n\nEnt\u00e3o, ao seguir a receita, seus ingredientes seriam:<\/p>\n\n\n\n
- \n
- Adicione 1 x\u00edcara de a\u00e7\u00facar<\/li>\n\n\n\n
- Adicione 1 barra de manteiga amolecida<\/li>\n\n\n\n
- Adicione 2 ovos<\/li>\n\n\n<\/ul>\n\n\n\n
Isso permite que voc\u00ea configure a receita do cookie sem alterar o c\u00f3digo da receita.<\/p>\n\n\n\n
O mesmo conceito se aplica \u00e0 computa\u00e7\u00e3o e desenvolvimento. Vari\u00e1veis de ambiente permitem que voc\u00ea altere o ambiente no qual um processo \u00e9 executado sem mudar o c\u00f3digo subjacente. Aqui est\u00e3o alguns exemplos comuns:<\/p>\n\n\n\n
- \n
- Configurando o ambiente para “development” ou “production”<\/li>\n\n\n\n
- Configurando chaves API para servi\u00e7os externos<\/li>\n\n\n\n
- Inserindo chaves secretas ou credenciais<\/li>\n\n\n\n
- Alternando certas funcionalidades entre ativo e inativo<\/li>\n\n\n<\/ul>\n\n\n\n
As vari\u00e1veis de ambiente oferecem grande flexibilidade. Voc\u00ea pode implantar o mesmo c\u00f3digo em v\u00e1rios ambientes sem alterar o c\u00f3digo em si. Mas vamos entender melhor por que elas s\u00e3o valiosas.<\/p>\n\n\n\n
Por que as Vari\u00e1veis de Ambiente s\u00e3o Valiosas?<\/h2>\n\n\n\n
![\"as](\"data:image\/svg+xml;base64,PHN2ZyB3aWR0aD0iMSIgaGVpZ2h0PSIxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==\")
<\/figure>\n\n\n\nConsidere as vari\u00e1veis de ambiente como bot\u00f5es de aplicativos usados para ajustar prefer\u00eancias. Exploraremos casos de uso excelentes em breve.<\/p>\n\n\n\n
Vamos consolidar a intui\u00e7\u00e3o sobre por que as vari\u00e1veis de ambiente s\u00e3o importantes!<\/p>\n\n\n\n
Raz\u00e3o #1: Eles Separam o C\u00f3digo da Aplica\u00e7\u00e3o das Configura\u00e7\u00f5es<\/h3>\n\n\n\n
<\/figure>\n\n\n\nCodificar configura\u00e7\u00f5es e credenciais diretamente no seu c\u00f3digo pode causar todo tipo de problemas:<\/p>\n\n\n\n
- \n
- Commits acidentais no controle de fonte<\/li>\n\n\n\n
- Reconstru\u00e7\u00e3o e redespacho de c\u00f3digo apenas para alterar um valor<\/li>\n\n\n\n
- Problemas de configura\u00e7\u00e3o ao promover entre ambientes<\/li>\n\n\n<\/ul>\n\n\n\n
Isso tamb\u00e9m leva a um c\u00f3digo confuso:<\/p>\n\n\n\n
import os\n\n# Configura\u00e7\u00e3o codificada\nDB_USER = 'appuser' \nDB_PASS = 'password123'\nDB_HOST = 'localhost'\nDB_NAME = 'myappdb'\n\ndef connect_to_db():\n print(f\"Conectando a {DB_USER}:{DB_PASS}@{DB_HOST}\/{DB_NAME}\") \n\nconnect_to_db()<\/code><\/pre>\n\n\n\nIsso entrela\u00e7a a l\u00f3gica de neg\u00f3cios com detalhes de configura\u00e7\u00e3o. O acoplamento apertado torna a manuten\u00e7\u00e3o \u00e1rdua ao longo do tempo:<\/p>\n\n\n\n
- \n
- As mudan\u00e7as requerem a modifica\u00e7\u00e3o do c\u00f3digo-fonte<\/li>\n\n\n\n
- Risco de vazar segredos no controle de fonte<\/li>\n\n\n<\/ul>\n\n\n\n
Usar vari\u00e1veis de ambiente reduz esses problemas. Por exemplo, voc\u00ea pode definir as vari\u00e1veis de ambiente DB_USER e DB_NAME.<\/p>\n\n\n\n
# Arquivo .env\nDB_USER=appuser\nDB_PASS=password123 \nDB_HOST=localhost\nDB_NAME=myappdb<\/code><\/pre>\n\n\n\nO c\u00f3digo da aplica\u00e7\u00e3o pode acessar as vari\u00e1veis de ambiente sempre que necess\u00e1rio, mantendo o c\u00f3digo limpo e simples.<\/p>\n\n\n\n
import os\n\n# Carregar configura\u00e7\u00e3o do ambiente\nDB_USER = os.environ['DB_USER']\nDB_PASS = os.environ['DB_PASS'] \nDB_HOST = os.environ['DB_HOST']\nDB_NAME = os.environ['DB_NAME']\n\ndef connect_to_db():\n print(f\"Conectando a {DB_USER}:{DB_PASS}@{DB_HOST}\/{DB_NAME}\")\n \nconnect_to_db()<\/code><\/pre>\n\n\n\nAs vari\u00e1veis de ambiente separam claramente a configura\u00e7\u00e3o do c\u00f3digo, mantendo os valores sens\u00edveis abstra\u00eddos no ambiente.<\/p>\n\n\n\n
Voc\u00ea pode implementar o mesmo c\u00f3digo do desenvolvimento para a produ\u00e7\u00e3o sem alterar nada. As vari\u00e1veis de ambiente podem variar entre os ambientes sem impactar o c\u00f3digo de forma alguma.<\/p>\n\n\n\n
Raz\u00e3o #2: Eles Simplificam a Configura\u00e7\u00e3o de Aplica\u00e7\u00f5es<\/h3>\n\n\n\n
<\/figure>\n\n\n\nVari\u00e1veis de ambiente simplificam ajustes nas configura\u00e7\u00f5es sem alterar o c\u00f3digo:<\/p>\n\n\n\n
# Arquivo .env:\nDEBUG=true<\/code><\/pre>\n\n\n\nAqui est\u00e1 como podemos us\u00e1-lo dentro do arquivo de script:<\/p>\n\n\n\n
# Conte\u00fado do Script:\nimport os\n\nDEBUG = os.environ.get('DEBUG') == 'true' \n\nif DEBUG:\n print(\"No modo DEBUG\")<\/code><\/pre>\n\n\n\nAlternar o modo de depura\u00e7\u00e3o requer apenas a atualiza\u00e7\u00e3o do arquivo .env \u2014 n\u00e3o s\u00e3o necess\u00e1rias altera\u00e7\u00f5es de c\u00f3digo, reconstru\u00e7\u00e3o ou redespliegue. “Env vars”, abreviatura de vari\u00e1veis de ambiente, tamb\u00e9m ajudam a implantar em diferentes ambientes de forma cont\u00ednua:<\/p>\n\n\n\n
import os\n\n# Recupera a vari\u00e1vel de ambiente para determinar o ambiente atual (produ\u00e7\u00e3o ou staging)\ncurrent_env = os.getenv('APP_ENV', 'staging') # Padr\u00e3o para 'staging' se n\u00e3o estiver definido\n\n# Chave da API de Produ\u00e7\u00e3o\nPROD_API_KEY = os.environ['PROD_API_KEY']\n\n# Chave da API de Staging\nSTG_API_KEY = os.environ['STG_API_KEY']\n\n# L\u00f3gica que define api_key baseada no ambiente atual\nif current_env == 'production':\n api_key = PROD_API_KEY\nelse:\n api_key = STG_API_KEY\n\n# Inicializa o cliente API com a chave API apropriada\napi = ApiClient(api_key)<\/code><\/pre>\n\n\n\nO mesmo c\u00f3digo pode usar chaves de API<\/a> separadas para produ\u00e7\u00e3o vs staging sem quaisquer altera\u00e7\u00f5es.<\/p>\n\n\n\n
E, por \u00faltimo, eles ativam altern\u00e2ncias de funcionalidades sem novas implementa\u00e7\u00f5es:<\/p>\n\n\n\n
NOVO_RECURSO = os.environ['NOVO_RECURSO'] == 'true'\n\nif NOVO_RECURSO:\n habilitarNovoRecurso()<\/code><\/pre>\n\n\n\nAlterar a vari\u00e1vel NEW_FEATURE<\/em> ativa a funcionalidade instantaneamente dentro do nosso c\u00f3digo. A interface para atualizar configura\u00e7\u00f5es depende dos sistemas:<\/p>\n\n\n\n
- \n
- Plataformas de Cloud<\/a> como Heroku usam pain\u00e9is web<\/li>\n\n\n\n
- Servidores usam ferramentas de comando de OS<\/li>\n\n\n\n
- Desenvolvimento local pode usar arquivos .env<\/li>\n\n\n<\/ul>\n\n\n\n
As vari\u00e1veis de ambiente s\u00e3o ben\u00e9ficas ao criar aplica\u00e7\u00f5es, permitindo que os usu\u00e1rios configurem elementos de acordo com suas necessidades.<\/p>\n\n\n\n
Raz\u00e3o #3: Eles ajudam a gerenciar segredos e credenciais<\/h3>\n\n\n\n
<\/figure>\n\n\n\nArmazenar segredos como chaves de API, senhas e chaves privadas diretamente no c\u00f3digo-fonte apresenta riscos de seguran\u00e7a<\/a> substanciais:<\/p>\n\n\n\n
# Evite expor segredos no c\u00f3digo!\nSTRIPE_KEY = 'sk_live_1234abc'\nDB_PASSWORD = 'password123'\n\nstripe.api_key = STRIPE_KEY \ndb.connect(DB_PASSWORD)<\/code><\/pre>\n\n\n\n
- Plataformas de Cloud<\/a> como Heroku usam pain\u00e9is web<\/li>\n\n\n\n
- Externas<\/strong>: Os valores s\u00e3o definidos fora do c\u00f3digo do aplicativo por meio de arquivos, linhas de comando e sistemas.<\/li>\n\n\n\n
![\"as](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/02-Why-Are-Environment-Variables-Valuable.jpg\")
<\/figure>\n\n\n\n![\"motivo](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/03-They-Separate-Application-Code-From-Configurations.jpg\")
<\/figure>\n\n\n\n![\"Aplicativo](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/04-They-Simplify-Configuring-Applications.jpg\")
<\/figure>\n\n\n\n![\"c\u00f3digo](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/05-They-Help-Manage-Secrets-And-Credentials.jpg\")
<\/figure>\n\n\n\n![\"configura\u00e7\u00e3o](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/06-They-Promote-Consistency.jpg\")
<\/figure>\n\n\n\n