API de variáveis de ambiente

A API de variáveis de ambiente do Azion Runtime entrega a uma function os valores das variáveis de ambiente armazenadas na sua conta Azion. Uma variável mantém um valor de configuração ou um secret fora do código da function. Use-a para se conectar a um banco de dados, a uma API privada ou a qualquer outro serviço que exija credenciais. Você cria e gerencia variáveis com a Azion CLI, pelo comando azion create variables e pelos comandos relacionados. Para mais informações, consulte Variáveis de ambiente.

nota — Com azion dev, uma function lê as variáveis do arquivo .env da pasta do projeto, e não as variáveis armazenadas na sua conta.

Acesso

Uma function lê uma variável com Azion.env.get(), que recebe a chave da variável:

const apiToken = Azion.env.get('API_SERVICE_TOKEN');

Em uma function com deploy feito, as variáveis da sua conta também são propriedades de process.env:

const apiToken = process.env.API_SERVICE_TOKEN;

O argumento env do handler fetch(request, env, ctx) não contém variáveis em uma function com deploy feito: ele é um objeto vazio. Leia as variáveis com Azion.env.get() ou process.env.

Atenção — Sem um arquivo .env na pasta do projeto, azion dev passa todo o ambiente do shell da sua máquina para a function como env e process.env. Qualquer token ou credencial definido nesse shell fica legível pelo código da function.

Parâmetros

Azion.env.get() recebe um parâmetro.

Parâmetro	Tipo	Descrição
`key`	string	Chave da variável a ser lida.

Valor de retorno

Azion.env.get() retorna o valor armazenado sob a chave, como uma string. Uma variável criada como secret, com --secret true, retorna o valor dela da mesma forma.

Quando a chave não corresponde a nenhuma variável da sua conta, a chamada retorna undefined e não lança erro. Uma chamada que não passa nenhuma chave também retorna undefined.

Exemplo

Esta function lê a variável MY_VARIABLE e retorna o valor dela como texto simples, ou uma string alternativa quando a variável não existe:

JavaScript

01export default {

02 async fetch(request, env, ctx) {

03 const value = Azion.env.get('MY_VARIABLE');

05 return new Response(value || 'Variable not set', {

06 headers: { 'content-type': 'text/plain' },

07 });

08 },

09};

Com MY_VARIABLE definida como my-value na sua conta, uma requisição à function com deploy feito retorna:

my-value

Recursos relacionados

Variáveis de ambiente

Os campos de uma variável, os limites da conta e as interfaces que gerenciam variáveis.

Azion CLI variables

Todas as flags dos comandos que criam, listam, descrevem, atualizam e excluem variáveis.

Handlers

Os formatos de handler que uma function exporta e os argumentos que cada um recebe.

Desenvolva e teste uma function localmente

Como passar as variáveis para uma function por um arquivo .env com azion dev.