As variáveis de ambiente são úteis para alimentar seu aplicativo com informações de fora da execução daquele aplicativo. É tipicamente usado para definir coisas como detalhes de conexão de banco de dados e chaves API.

Adicionando variáveis de ambiente
As variáveis de ambiente podem ser adicionadas na etapa de detalhes do aplicativo ao adicionar um aplicativo ou na página de Configurações do seu aplicativo após a implantação.
Caracteres especiais em variáveis de ambiente
As variáveis de ambiente são aplicadas literalmente, com exceção de vírgulas e aspas duplas. Vírgulas são interpretadas como delimitadores, e as aspas duplas não escapadas são ignoradas ou causam falha no processo de implantação.
- Por exemplo:
"my_example_variable"
será aplicado como:my_example_variable
. - Se as aspas duplas estiverem dentro de uma string (por exemplo,
my_exampl"e_text
), o processo de implantação falhará. - Para manter as aspas duplas ao redor de uma variável, escape-as com uma barra invertida (
\
). Por exemplo:\"my_example_var\"
será aplicado como:"my_example_var"
. - As aspas duplas dentro de strings também podem ser manipuladas com escape, para que o processo de implantação possa ser concluído. Por exemplo:
my_examp\"le_var
será aplicado como:my_examp"le_var
.
Nos detalhes do aplicativo
Para adicionar variáveis de ambiente ao adicionar o seu aplicativo, expanda a seção Variáveis de ambiente, insira os pares de chave-valor e selecione se as variáveis devem estar disponíveis durante a execução e/ou o processo de build.

Após a Implantação
Para adicionar variáveis de ambiente após a implantação, vá para a página de Configurações do seu aplicativo, role até a seção Variáveis de ambiente e clique em Adicionar variável de ambiente. Adicione os pares de chave-valor na janela modal/pop-up Adicionar variável de ambiente e selecione se as variáveis devem estar disponíveis durante a execução e/ou o processo de compilação.

Usando variáveis de ambiente
Como você usa as variáveis de ambiente depende do seu aplicativo. Em Node.js, por exemplo, você pode acessar uma variável chamada API_KEY
com process.env.API_KEY
. Em PHP, você usaria getenv('API_KEY')
.
Variáveis de ambiente definidas pela Kinsta
Kinsta sempre define PORT
como a porta usada pelo servidor web. Se você gostaria que o seu aplicativo interagisse com o servidor web, você precisará usar esta variável de ambiente. Por exemplo, no Node.js, é assim que você iniciaria um servidor:
app.listen(process.env.PORT, () => {
console.log("Weather server is up and running")
})
Variáveis de ambiente não definidas pela Kinsta
Por padrão, a variável de ambiente NODE_ENV
não é definida no ambiente de production
para aplicativos Node.js; você deve adicionar esta variável de ambiente manualmente.
Exemplos de Linguagem de Variável de Ambiente
Como você usa as variáveis de ambiente depende do seu aplicativo. A tabela a seguir mostra como chamar uma variável de ambiente chamada API_KEY em várias linguagens:
Linguagem | Código |
---|---|
Ruby | ENV["API_KEY"] |
Node.js | process.env.API_KEY; |
Python | os.environ.get('API_KEY') |
Java | System.getenv("API_KEY"); |
Scala | System.getenv("API_KEY"); |
PHP | getenv('API_KEY'); |
Go | os.Getenv("API_KEY") |