Gerenciar rótulos de ambiente e detalhar custos de ambiente

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Nesta página, você aprenderá a atribuir identificadores aos ambientes do Cloud Composer e a dividir os custos de faturamento com base nesses identificadores.

Sobre identificadores de ambiente

Os identificadores de ambiente são pares de chave-valor que podem ser atribuídos aos seus ambientes. Por exemplo, se owner:engineering-team for um identificador personalizado, owner será a chave e engineering-team será o valor.

Cada ambiente pode ter vários identificadores, mas as chaves para um único ambiente precisam ser exclusivas. É possível atribuir uma mesma chave e valor a vários ambientes.

Identificadores de ambiente em relatórios de faturamento

Os identificadores de ambiente atribuídos aos ambientes são visíveis nos relatórios de faturamento. Assim, é possível detalhar os custos com base nas chaves e nos valores dos identificadores.

Os identificadores não se aplicam retroativamente. Por exemplo, se você atribuir um identificador em 15 de maio, os custos de faturamento de 14 de maio não conterão o identificador atribuído.

Atribuir identificadores a novos ambientes

É possível atribuir identificadores ao criar um ambiente. Para mais informações, consulte Como criar ambientes.

Atribuir identificadores a ambientes atuais

Console

  1. Acesse a página Ambientes no console do 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"
  }
}

Ver identificadores nos relatórios

Depois que os identificadores do ambiente forem propagados para os relatórios de faturamento, será possível dividir os custos de faturamento com base nesses identificadores:

  1. Visualizar relatórios do Cloud Billing para sua conta do Cloud Billing.

  2. Na página Relatórios:

    1. Clique em Mostrar filtros.
    2. Na caixa de diálogo Filtros, expanda a seção Identificadores.
    3. Filtre os dados exibidos com base nas chaves e nos valores dos identificadores do ambiente.

A seguir