Faça a gestão das etiquetas de ambiente e discrimine os custos do ambiente

Consola

1. Aceda à página Ambientes na Google Cloud consola:

   Aceder a Ambientes

2. Selecione o seu ambiente.

3. Aceda ao separador Etiquetas.

4. Clique em Editar e, de seguida, em Adicionar etiqueta.

5. Adicione um par de chave-valor para a etiqueta e, de seguida, clique em Guardar.

6. Aguarde até que o ambiente seja atualizado.

gcloud

Quando atualiza um ambiente com o comando gcloud composer, os seguintes argumentos especificam etiquetas para o ambiente:

• --clear-labels remove todas as etiquetas.

• --update-labels atualiza as etiquetas especificadas; cria novas etiquetas se ainda não existirem.

• --remove-labels remove as etiquetas especificadas; as etiquetas especificadas que não existam são ignoradas.

Se usar vários destes argumentos, são aplicados pela seguinte ordem: --clear-labels, --update-labels e --remove-labels.

Atualize ou crie etiquetas

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

Remova etiquetas específicas

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

Remova todas as etiquetas

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

Substituir:

• ENVIRONMENT_NAME com o nome do ambiente.
• LOCATION com a região onde o ambiente está localizado.
• LABEL_KEY com a chave da etiqueta de ambiente que quer criar, atualizar ou remover.
• LABEL_VALUE com o valor da etiqueta do ambiente.

Exemplo

O exemplo seguinte atualiza a etiqueta owner, cria a nova etiqueta env e remove a etiqueta misc:

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

API

Quando atualiza um ambiente, no recurso Environment, especifique novas etiquetas do seu ambiente.

Substitua todas as etiquetas

Para substituir todas as etiquetas, inclua labels no parâmetro de consulta updateMask e forneça uma substituição no corpo do pedido.

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

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

Substituir:

• LABEL_KEY com uma chave da etiqueta de ambiente.
• LABEL_VALUE com um novo valor para a etiqueta de ambiente.

Exemplo:

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

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

Remova todas as etiquetas

Para remover todas as etiquetas, inclua labels no parâmetro de consulta updateMask e não faculte o valor de substituição.

Atualize etiquetas individuais

Para atualizar uma etiqueta ou adicionar uma nova etiqueta a etiquetas existentes, inclua labels.LABEL_KEY no parâmetro de consulta updateMask e forneça uma substituição no corpo do pedido.

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

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

Substituir:

• LABEL_KEY com uma chave da etiqueta de ambiente.
• LABEL_VALUE com um novo valor para a etiqueta de 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"
  }
}

Remova etiquetas individuais

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

Terraform

Para criar um ambiente com parâmetros predefinidos numa localização especificada, 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"
  }

}

Substituir:

• LABEL_KEY com a chave da etiqueta do ambiente que quer criar ou atualizar. Para remover etiquetas, elimine os respetivos campos.
• LABEL_VALUE com o valor da etiqueta do ambiente.

Exemplo:

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

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