Gerenciar rótulos de ambiente e detalhar custos de ambiente

Console

1. Acesse a página Ambientes no console Google Cloud :

   Acessar "Ambientes"

2. Selecione o ambiente.

3. Abra a guia Identificadores.

4. Clique em Editar e, depois, em Adicionar identificador.

5. Adicione um par de chave-valor para o identificador e clique em Salvar.

6. Aguarde a atualização do ambiente.

gcloud

Ao atualizar um ambiente usando o comando gcloud composer, os argumentos a seguir especificam identificadores para o ambiente:

• --clear-labels remove todos os identificadores.

• --update-labels atualiza os identificadores especificados e cria novos se eles ainda não existirem.

• --remove-labels remove os identificadores especificados. Os identificadores especificados que não existem são ignorados.

Se você usar vários desses argumentos, eles serão aplicados na seguinte ordem: --clear-labels, --update-labels e --remove-labels.

Atualizar ou criar identificadores

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --update-labels LABEL_KEY=LABEL_VALUE

Remover identificadores especificados

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --remove-labels LABEL_KEY

Remover todos os identificadores

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --clear-labels

Substitua:

• ENVIRONMENT_NAME pelo nome do ambiente
• LOCATION pela região em que o ambiente está localizado;
• LABEL_KEY pela chave do identificador do ambiente que você quer criar, atualizar ou remover;
• LABEL_VALUE pelo valor do identificador do ambiente.

Exemplo

O exemplo a seguir atualiza o identificador owner, cria o novo identificador env e remove o identificador misc:

gcloud composer environments update example-environment \
    --location us-central1 \
    --update-labels owner=engineering-team,env=production \
    --remove-labels misc

API

Ao atualizar um ambiente, no recurso Ambiente, especifique novos identificadores do ambiente.

Substituir todos os identificadores

Para substituir todos os identificadores, inclua labels no parâmetro de consulta updateMask e forneça uma substituição no corpo da solicitação.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Substitua:

• LABEL_KEY por uma chave do identificador do ambiente.
• LABEL_VALUE por um novo valor para o identificador do ambiente.

Exemplo:

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Remover todos os identificadores

Para remover todos os identificadores, inclua labels no parâmetro de consulta updateMask e não forneça o valor de substituição.

Atualizar identificadores individuais

Para atualizar um identificador ou adicionar um novo aos identificadores atuais, inclua labels.LABEL_KEY no parâmetro de consulta updateMask e forneça um substituto no corpo da solicitação.

// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY

{
  "labels":{
      "LABEL_KEY": "LABEL_VALUE"
    }
}

Substitua:

• LABEL_KEY por uma chave do identificador do ambiente.
• LABEL_VALUE por um novo valor para o identificador do ambiente.

Exemplo:

// PATCH https://composer.googleapis.com/v1/
// ?name=projects/example-project/locations/
// us-central1/environments/example-environment
// &updateMask=labels.owner,labels.env

{
  "labels": {
    "owner": "engineering-team",
    "env": "production"
  }
}

Remover identificadores individuais

Para remover identificadores, inclua labels.LABEL_KEY no parâmetro de consulta updateMask e não forneça o valor de substituição.

Terraform

Para criar um ambiente com parâmetros padrão em um local especificado, edite o bloco labels na configuração do Terraform e execute terraform apply.

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Substitua:

• LABEL_KEY pela chave de identificador do ambiente que você quer criar ou atualizar. Para remover identificadores, exclua os campos.
• LABEL_VALUE pelo valor do identificador do ambiente.

Exemplo:

resource "google_composer_environment" "example" {
  name = "example-environment"
  region = "us-central1"

  labels = {
    owner = "engineering-team"
    env = "production"
  }
}