Como configurar variáveis de ambiente

Nesta página, você encontra os requisitos para configurar variáveis de ambiente no Cloud Composer.

Ao criar ou atualizar um ambiente, é possível adicionar variáveis. Elas são fornecidas pelo Cloud Composer aos processos do servidor da Web, worker e programador do Apache Airflow. Por exemplo, o Cloud Composer usa o módulo sendgrid (em inglês) do Apache Airflow nas notificações por e-mail. Para configurar essas notificações, você precisa definir as variáveis de ambiente SENDGRID_API_KEY e SENDGRID_MAIL_FROM.

Requisitos

As variáveis de ambiente precisam corresponder à expressão regular [a-zA-Z_][a-zA-Z0-9_]*.

Não especifique modificações de configuração de software do Apache Airflow nas variáveis de ambiente. Ou seja, as variáveis não podem ter o formato $AIRFLOW__{SECTION}__{KEY} ou corresponder à expressão regular AIRFLOW__[A-Z0-9_]+__[A-Z0-9_]+) .

Nomes reservados

Os nomes a seguir estão reservados e não podem ser usados:

  • AIRFLOW_HOME
  • C_FORCE_ROOT
  • CONTAINER_NAME
  • DAGS_FOLDER
  • GCP_PROJECT
  • GCS_BUCKET
  • GKE_CLUSTER_NAME
  • SQL_DATABASE
  • SQL_INSTANCE
  • SQL_PASSWORD
  • SQL_PROJECT
  • SQL_REGION
  • SQL_USER

Antes de começar

  • As permissões a seguir são necessárias para configurar variáveis de ambiente:

    • composer.environments.create para configurar variáveis de ambiente durante a criação do ambiente.
    • composer.environments.update para atualizar variáveis de ambiente.

      Para mais informações, consulte Controle de acesso do Cloud Composer.

  • A maioria dos comandos gcloud composer requer um local. Para especificá-lo, use a sinalização --location ou defina o local padrão.

Como adicionar ou atualizar variáveis de ambiente

Para configurar variáveis de ambiente:

Console

Para adicionar uma variável de ambiente, siga estas etapas:

  1. Abra a página Criar ambiente no Console do Google Cloud Platform.

    Abrir a página "Criar ambiente"

  2. Em Configuração do nó, clique em Adicionar variável de ambiente.

  3. Insira NAME e VALUE das variáveis de ambiente.

gcloud

gcloud composer environments update ENVIRONMENT_NAME \
  --location LOCATION \
  --update-env-variables=KEY=VALUE,KEY=VALUE...

em que:

  • ENVIRONMENT_NAME é o nome do ambiente;
  • LOCATION é a região do Compute Engine em que o ambiente está localizado;
  • KEY=VALUE especifica as variáveis de ambiente que serão criadas ou atualizadas.

Por exemplo:

gcloud composer environments update test-environment 
--location us-central1
--update-env-variables=SENDGRID_MAIL_FROM=updated-email@domain.com

API

Para usar a API REST do Cloud Composer, emita um environments.patch.

Como remover variáveis de ambiente

Para remover variáveis de ambiente, siga as etapas abaixo:

Console

  1. Abra a página Ambientes.

    Abrir a página "Ambientes"

  2. Na página Listar ambientes, clique no nome do ambiente para ver os detalhes dele.
  3. Em Variáveis de ambiente, clique em Editar.
  4. À direita do valor da variável, clique no ícone de lixeira.

gcloud

Para remover todas as variáveis de ambiente, use o comando a seguir:

gcloud composer environments update ENVIRONMENT_NAME 
--location LOCATION
--clear-env-variables

em que:

  • ENVIRONMENT_NAME é o nome do ambiente;
  • LOCATION é a região do Compute Engine em que o ambiente está localizado.

Por exemplo:

gcloud composer environments update test-environment 
--location us-central1
--clear-env-variables

Para remover uma lista de variáveis de ambiente, use:

gcloud composer environments update ENVIRONMENT_NAME 
--location LOCATION
--remove-env-variables=NAME,NAME,...
em que:

  • ENVIRONMENT_NAME é o nome do ambiente;
  • LOCATION é a região do Compute Engine em que o ambiente está localizado;
  • NAME é a variável de ambiente que será removida.

API

Para usar a API REST do Cloud Composer, emita um environments.patch.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…