Como atualizar e excluir ambientes

Nesta página, você aprende a atualizar, excluir e visualizar os detalhes de um ambiente do Cloud Composer. Você também vê como atualizar e visualizar as configurações do Apache Airflow de um ambiente.

Antes de começar

  • As permissões a seguir são necessárias para atualizar ou excluir ambientes:

    • composer.environments.update é necessária para atualizar ambientes.
    • composer.environments.delete é necessária para excluir ambientes.

      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.

  • Alguns parâmetros do Airflow são pré-configurados no Cloud Composer e não podem ser alterados. É possível atualizar estas configurações de ambiente do Cloud Composer: contagem de nós, modificações de configuração do Airflow, variáveis de ambiente, rótulos e pacotes PyPI.

  • As atualizações nas configurações do Airflow são aplicadas em todas as instâncias dele, ou seja, worker, servidor e programador. Isso ocorre aproximadamente cinco minutos após o envio da solicitação de atualização.

Limitações

O Cloud Composer não aceita solicitações simultâneas de atualização ou de exclusão de ambientes. Aguarde a conclusão dessas solicitações antes de emitir outra.

Como atualizar ambientes

Para atualizar os ambientes do Cloud Composer, incluindo as configurações do Airflow, siga estes passos:

Console

  1. Abra a página Ambientes no Google Cloud Platform.

    Abrir a página "Ambientes"

  2. Clique no Nome do ambiente para fazer a modificação.

  3. Selecione a guia da propriedade que você quer atualizar.

  4. Clique em Editar.

  5. Depois de fazer as atualizações, clique em Enviar.

gcloud

Para atualizar as configurações do Airflow, execute o comando gcloud composer environments update com a sinalização --update-airflow-configs:

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-airflow-configs=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 é a seção da configuração e o nome da propriedade separados por um hífen, como core-print_stats_interval, além do valor correspondente.

Por exemplo:

gcloud composer environments update test-environment \
    --location us-central1 \
    --update-airflow-configs=core-load_example=True,webserver-dag_orientation=TB 

Consulte a página de referência Atualização de ambientes do gcloud composer para mais exemplos.

API

Para atualizar um ambiente do Cloud Composer, incluindo as configurações do Airflow, usando a API REST do Cloud Composer, emita uma solicitação de API environments.patch.

Como restaurar a configuração padrão do Airflow

Para restaurar todos os valores de configuração padrão do Airflow, execute o seguinte comando:

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-airflow-configs

Para restaurar um ou mais valores de configuração padrão do Airflow, execute o seguinte comando:

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-airflow-configs=core-load_example,webserver-dag_orientation 

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 \
    --update-airflow-configs=core-load_example=True,webserver-dag_orientation=TB 

O comando termina quando a operação é concluída. Para não ficar esperando, use a sinalização --async.

Como ver os detalhes do ambiente

Para ver os detalhes do ambiente do Cloud Composer, incluindo as configurações do Airflow, siga estes passos:

Console

  1. Abra a página Ambientes no Console do GCP.

    Abrir a página "Ambientes"

  2. Clique no Nome do ambiente.
  3. Selecione a guia de propriedade adequada.

gcloud

gcloud composer environments describe ENVIRONMENT_NAME \
    --location LOCATION
    --format="get(PROPERTY)"

em que:

  • ENVIRONMENT_NAME é o nome do ambiente;
  • LOCATION é a região do Compute Engine em que o ambiente está localizado;
  • --format é uma opção para especificar uma propriedade de ambiente, como o config.airflowUri do URL do servidor da Web do Airflow.

Por exemplo:

gcloud composer environments describe test-environment 
--location us-central1 --format="get(config.airflowUri)"

# Returns https://a6b3z6e3nnZZZnnd3a-tp.appspot.com

API

Para ver as configurações do Airflow usando a API REST do Cloud Composer, faça uma solicitação de API environments.get, preenchendo o ID do ambiente.

Como atualizar o tipo de máquina

É possível fazer o upgrade manual do tipo de máquina do cluster do GKE do ambiente. Basta criar um novo modelo de grupo de instâncias gerenciadas e atualizar as instâncias no cluster do GKE do ambiente.

Para fazer upgrade do tipo de máquina, siga estas etapas:

  1. No Console do GCP, clique no nome do ambiente que você fará upgrade.
  2. Para encontrar o modelo atual do grupo de instâncias:
    1. Na página Detalhes do ambiente, clique no link ID do cluster do GKE.
    2. Na página "Clusters" na seção Pools de nós, anote o nome dos Grupos de instâncias e clique no link dele.
    3. Em Membros, localizado na página Grupos de instâncias, clique no link "Modelo". A página Modelos de instância é exibida.
  3. Para criar um novo modelo de grupo de instâncias:
    1. Na página Modelos de instância, clique em Criar semelhante.
    2. Na página Criar um modelo de instância, especifique um nome para o novo modelo.
    3. Em Tipo de máquina, escolha o tipo de máquina e clique em Criar. O novo modelo é exibido na lista da página Modelos de instância.
  4. Para atualizar as instâncias no cluster do ambiente:
    1. Na página Compute Engine > Grupos de instância, clique no nome do grupo de instâncias anotado anteriormente.
    2. Clique em Atualização gradual.
    3. Em Modelo, selecione o novo modelo criado.
    4. Clique em Atualizar.

Como excluir um ambiente

Para excluir um ambiente do Cloud Composer, siga estes passos:

Console

  1. Abra a página Ambientes no Console do GCP.

    Abrir a página "Ambientes"

  2. Marque a caixa ao lado do ambiente que será excluído.
  3. Clique em Excluir.

gcloud

Execute o comando a seguir para excluir um ambiente do Cloud Composer:

gcloud composer environments delete ENVIRONMENT_NAME \
    --location LOCATION   

em que:

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

Execute gcloud composer environments describe --help para mais informações sobre parâmetros do comando.

API

Para excluir um ambiente usando a API REST do Cloud Composer, faça uma solicitação de API environments.delete, preenchendo o ID do ambiente.

A seguir

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

Enviar comentários sobre…