As variáveis de ambiente são úteis para alimentar o processo de criação das informações do seu site estático de fora do código do site. Isso permite que informações como chaves de API sejam armazenadas e fornecidas com segurança, em vez de estarem no código do site como texto simples.

Caracteres especiais em variáveis de ambiente

Nas chaves de variáveis de ambiente, você pode usar apenas a-z, 0-9 ou sublinhado (_). Os valores das variáveis de ambiente são aplicados literalmente, com exceção de parênteses, vírgulas e aspas duplas.

Parênteses

Parênteses podem fazer com que o processo de build e implantação falhe. Eles não podem ser usados em variáveis de ambiente.

Vírgulas

Vírgulas não escapadas são interpretadas como delimitadores e não podem ser usadas em variáveis de ambiente.

  • Por exemplo: write_stock,read_orders fará com que o processo de implantação falhe.
  • Para manter uma vírgula dentro de uma string, utilize uma barra invertida (\) assim: write_stock\,read_orders — que será aplicado como write_stock,read_orders.

Aspas duplas

Aspas duplas não escapadas são ou desconsideradas, ou farão com que o processo de implantação falhe.

  • Por exemplo, "my_example_variable" será aplicado como: my_example_variable.
  • Para manter aspas duplas em torno de uma variável, utilize uma barra invertida (\) assim: \"my_example_var\" — que será aplicado como "my_example_var".
  • Se aspas duplas estiverem dentro de uma string (por exemplo, my_exampl"e_text), o processo de implantação falhará.
  • Para manter aspas duplas dentro de uma string, utilize uma barra invertida () assim: my_examp\"le_var — que será aplicado como my_examp"le_var.

Adicionando variáveis de ambiente

Variáveis de ambiente podem ser adicionadas na etapa de Configurações de Build ao adicionar um site estático ou na página de Configurações do seu site após a implantação.

Nas configurações de build

Para adicionar variáveis de ambiente ao adicionar seu site, expanda a seção de Variáveis de Ambiente e insira os pares de chave-valor.

Após a implantação

Para adicionar variáveis de ambiente após a implantação, vá para a página Configurações do site, role para baixo até a seção Variáveis de ambiente e clique em Adicionar variável de ambiente. Adicione os pares de valores-chave na janela modal/pop-up Adicionar variável de ambiente.

Editando Variáveis de Ambiente

Você pode editar os nomes das variáveis (chaves) ou valores na página de Configurações. Para editar uma variável, clique no ícone de Edição (lápis), faça suas alterações e clique em Salvar alterações.

Documentação relacionada