Azion CLI variables
Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem variáveis de ambiente e segredos, com cada flag, seu tipo e seu padrão.
Os comandos variables da Azion CLI criam, listam, descrevem, atualizam e excluem as variáveis de ambiente da sua conta, os pares chave-valor e segredos que uma function lê pela chave em tempo de execução. Cada variável tem um UUID, que a flag --variable-id recebe. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais da Azion CLI.
Criar
azion create variables cria uma variável de ambiente ou um segredo para as suas functions usarem:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--file | — | string | — | Caminho de um arquivo JSON com os atributos da variável. Use - para ler o JSON da entrada padrão. |
--key | — | string | — | Chave da variável. Uma function lê o valor por essa chave. |
--secret | — | string | — | Marca o valor como confidencial (true) ou não (false). A CLI imprime um valor confidencial como vazio. |
--value | — | string | — | Obrigatório, a menos que --file esteja definida. Valor da variável. Sem ela, o comando pede o valor. |
Este comando cria uma variável com a chave MY_VARIABLE e um valor que não é confidencial:
O comando imprime o UUID da variável:
Listar
azion list variables lista as variáveis de ambiente e os segredos da sua conta:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--details | — | — | — | Adiciona as colunas SECRET e LAST EDITOR às colunas ID, KEY e VALUE. |
--dump | — | — | — | Grava as variáveis em um arquivo .env no diretório atual, uma linha KEY=value por variável. Os valores dos segredos são gravados vazios. |
Este comando lista as variáveis da conta:
O comando imprime uma linha por variável. A coluna VALUE de um segredo fica vazia:
Com --dump, o comando imprime Variables file (.env) dumped successfully e grava este arquivo .env para as mesmas duas variáveis:
Descrever
azion describe variables imprime os atributos de uma variável:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--variable-id | — | string | — | Obrigatório. UUID da variável a descrever. |
Este comando descreve a variável com UUID 00000000-0000-0000-0000-000000000005:
O comando imprime a chave, o valor e o histórico da variável:
Com --format json, o comando imprime o objeto completo: created_at, key, last_editor, secret, updated_at, uuid e value. Para um segredo, value é uma string vazia (""). Com --out var-describe.json, o comando grava esse objeto JSON no arquivo e imprime File successfully written to: var-describe.json.
Um UUID que não existe, ou um ID numérico, falha com este erro:
Atualizar
azion update variables altera a chave, o valor ou a confidencialidade de uma variável:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--file | — | string | — | Caminho de um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão. |
--key | — | string | — | Obrigatório, a menos que --file esteja definida. Chave da variável. Sem ela, o comando pede a chave, mesmo quando você altera somente o valor. |
--secret | — | string | — | Marca o valor como confidencial (true) ou não (false). |
--value | — | string | — | Valor a definir na variável. |
--variable-id | — | string | "0" | Obrigatório, a menos que o JSON de --file traga "uuid". UUID da variável a atualizar. |
Este comando define o valor da variável com UUID 00000000-0000-0000-0000-000000000005 como updated-value e mantém sua chave:
O comando imprime o UUID da variável atualizada:
Um describe da variável passa então a retornar updated-value como seu valor.
Excluir
azion delete variables exclui uma variável:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--variable-id | — | string | — | Obrigatório. UUID da variável a excluir. |
Este comando exclui a variável com UUID 00000000-0000-0000-0000-000000000005:
O comando confirma a exclusão:
Usar um arquivo JSON
azion create variables e azion update variables leem os atributos de uma variável de um arquivo JSON com --file.
Este arquivo cria um segredo com a chave MY_SECRET. O comando lê key, value e secret dele:
Passe o arquivo para o comando de criação:
O comando imprime o UUID do segredo:
Na atualização, o comando também lê "uuid" do arquivo, então --variable-id não é necessária. Este arquivo altera o valor do segredo com UUID 00000000-0000-0000-0000-000000000006:
Passe o arquivo para o comando de atualização:
O comando imprime o UUID do segredo atualizado:
Um describe do segredo então mostra um horário de updated_at posterior e "value": "", porque a CLI não imprime de volta um valor confidencial.