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.

Variáveis de ambiente para o seu aplicativo.
Variáveis de ambiente para o seu aplicativo.

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.

Adicionar detalhes do aplicativo.
Adicionar detalhes do aplicativo.

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.

Adicione um par de valores de chaves de variáveis de ambiente.
Adicione um par de valores de chaves de variáveis de ambiente.

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")