Todos os produtos
Search
Central de documentação

Serverless App Engine:Configurar variáveis de ambiente

Última atualização: Jul 17, 2026

Aplicações precisam de variáveis de ambiente específicas para funcionar. Uma aplicação Java, por exemplo, exige as variáveis JAVA_HOME e Path antes da execução de seus comandos. No console do SAE, é possível definir variáveis de ambiente personalizadas ou referenciar variáveis de ConfigMaps e Secrets dentro de um namespace.

Procedimento

  1. O ponto de entrada varia conforme o cenário:

    Criar uma aplicação

    1. Faça login no console do SAE. No painel de navegação à esquerda, escolha Application Management > Applications. Selecione uma região e um namespace e clique em Create Application.

    2. Na página Basic Information, configure as definições e clique em Next: Advanced Settings.

    Implantar aplicação

    Aviso

    A reimplantação de uma aplicação reinicia o serviço. Para evitar erros imprevisíveis, como interrupções de negócios, recomendamos implantar aplicações fora dos horários de pico.

    1. Faça login no console do SAE. No painel de navegação à esquerda, escolha Application Management > Applications. Selecione uma região e um namespace e clique no nome da aplicação.

    2. Na página Basic Information da aplicação desejada, clique em Deploy Application.

    Modificar aplicação

    1. Faça login no console do SAE. No painel de navegação à esquerda, escolha Application Management > Applications. Selecione uma região e um namespace e clique no nome da aplicação.

    2. Na página Basic Information da aplicação desejada, clique em modifique Modify Application Configurations.

  2. Expanda a seção Environment Variable e configure suas variáveis.

Configuração

Adicionar uma variável de ambiente personalizada

Na lista suspensa Type, selecione Custom. Insira um Variable Name e um Variable Value.

Referenciar um ConfigMap

Na lista suspensa Type, selecione Reference ConfigMap. Insira um Variable Name. Na lista suspensa ConfigMap Name, Key, selecione um ConfigMap e uma chave. É possível referenciar uma única chave ou All Keys.

Crie ConfigMaps antecipadamente na página Namespace. Como alternativa, clique em Create Configuration Item (ConfigMap) na seção atual para criar um no painel Create ConfigMap. Para mais informações, consulte Gerenciar e usar ConfigMaps (Kubernetes ConfigMap).

Nota
  • Ao selecionar All Keys, o SAE utiliza os nomes das chaves do ConfigMap como nomes das variáveis de ambiente. Não é possível alterar esses nomes.

  • Mantenha os nomes das variáveis de ambiente com menos de 256 caracteres.

Referenciar um Secret

Na lista suspensa Type, selecione Reference the Secret. Insira um Variable Name. Na lista suspensa Secret Name, Key, selecione um Secret e uma chave. É possível referenciar uma única chave ou All Keys.

Crie Secrets antecipadamente na página Namespace. Como alternativa, clique em Create Secret na seção atual para criar um no painel Create Secret. Para mais informações, consulte Gerenciar e usar Secrets (Kubernetes Secret).

Nota
  • Ao selecionar All Keys, o SAE utiliza os nomes das chaves do Secret como nomes das variáveis de ambiente. Não é possível alterar esses nomes.

  • Mantenha os nomes das variáveis de ambiente com menos de 256 caracteres.

Exemplo

Se sua aplicação utilizar MySQL, configure estas variáveis de ambiente durante a implantação:

  • Obrigatório: MYSQL_ROOT_PASSWORD: Defina a senha root do MySQL. O contêiner do MySQL não iniciará se esta variável não estiver definida.

  • Opcional: MYSQL_USER e MYSQL_PASSWORD: Crie um novo usuário e sua respectiva senha.

  • Opcional: MYSQL_DATABASE: Crie um novo banco de dados quando o contêiner inicia.