Gestionar las etiquetas de entorno y desglosar los costes de los entornos

Cloud Composer 3 | Cloud Composer 2 | Cloud Composer 1

En esta página se explica cómo asignar etiquetas a los entornos de Cloud Composer y, a continuación, desglosar los costes de facturación en función de estas etiquetas.

Acerca de las etiquetas de entorno

Las etiquetas de entorno son pares clave-valor que puede asignar a sus entornos. Por ejemplo, si owner:engineering-team es una etiqueta personalizada, owner es la clave y engineering-team es el valor.

Cada entorno puede tener varias etiquetas, pero las claves de etiqueta de un mismo entorno deben ser únicas. Puedes asignar la misma clave y el mismo valor a varios entornos.

Etiquetas de entorno en los informes de facturación

Las etiquetas de entorno que asignes a tus entornos se mostrarán en los informes de facturación, por lo que podrás desglosar los costes en función de las claves y los valores de las etiquetas.

Las etiquetas no se aplican de forma retroactiva. Por ejemplo, si asigna una etiqueta el 15 de mayo, los costes de facturación del 14 de mayo no contendrán la etiqueta asignada.

Asignar etiquetas a entornos nuevos

Puedes asignar etiquetas al crear un entorno. Para obtener más información, consulta Crear entornos.

Asignar etiquetas a entornos

Consola

  1. Ve a la página Entornos de la consola de Google Cloud :

    Ir a Entornos

  2. Selecciona tu entorno.

  3. Vaya a la pestaña Etiquetas.

  4. Haz clic en Editar y, a continuación, en Añadir etiqueta.

  5. Añada un par clave-valor para la etiqueta y, a continuación, haga clic en Guardar.

  6. Espera a que se actualice el entorno.

gcloud

Cuando actualizas un entorno con el comando gcloud composer, los siguientes argumentos especifican etiquetas para el entorno:

  • --clear-labels elimina todas las etiquetas.

  • --update-labels actualiza las etiquetas especificadas y crea etiquetas nuevas si aún no existen.

  • --remove-labels elimina las etiquetas especificadas. Las etiquetas especificadas que no existan se ignoran.

Si usas varios de estos argumentos, se aplicarán en el siguiente orden: --clear-labels, --update-labels y --remove-labels.

Actualizar o crear etiquetas

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

Quitar etiquetas específicas

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

Quitar todas las etiquetas

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

Sustituye:

  • ENVIRONMENT_NAME con el nombre del entorno.
  • LOCATION con la región en la que se encuentra el entorno.
  • LABEL_KEY con la clave de la etiqueta del entorno que quieras crear, actualizar o quitar.
  • LABEL_VALUE con el valor de la etiqueta de entorno.

Ejemplo

En el siguiente ejemplo se actualiza la etiqueta owner, se crea la etiqueta env y se elimina la etiqueta misc:

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

API

Cuando actualices un entorno, en el recurso Environment, especifica las nuevas etiquetas del entorno.

Sustituir todas las etiquetas

Para sustituir todas las etiquetas, incluya labels en el parámetro de consulta updateMask y proporcione una sustitución en el cuerpo de la solicitud.

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

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

Sustituye:

  • LABEL_KEY con una clave de la etiqueta del entorno.
  • LABEL_VALUE con un nuevo valor para la etiqueta de entorno.

Ejemplo:

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

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

Quitar todas las etiquetas

Para quitar todas las etiquetas, incluya labels en el parámetro de consulta updateMask y no proporcione el valor de sustitución.

Actualizar etiquetas concretas

Para actualizar una etiqueta o añadir una nueva a las etiquetas que ya tengas, incluye labels.LABEL_KEY en el parámetro de consulta updateMask y proporciona un valor de sustitución en el cuerpo de la solicitud.

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

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

Sustituye:

  • LABEL_KEY con una clave de la etiqueta del entorno.
  • LABEL_VALUE con un nuevo valor para la etiqueta de entorno.

Ejemplo:

// 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"
  }
}

Quitar etiquetas concretas

Para quitar etiquetas, incluya labels.LABEL_KEY en el parámetro de consulta updateMask y no proporcione el valor de sustitución.

Terraform

Para crear un entorno con parámetros predeterminados en una ubicación específica, edita el bloque labels de tu configuración de Terraform y ejecuta terraform apply.

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

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Sustituye:

  • LABEL_KEY con la clave de etiqueta de entorno que quieras crear o actualizar. Para quitar etiquetas, elimina sus campos.
  • LABEL_VALUE con el valor de la etiqueta de entorno.

Ejemplo:

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

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

Ver etiquetas en los informes

Una vez que las etiquetas de su entorno se propaguen a los informes de facturación, podrá desglosar los costes de facturación en función de estas etiquetas:

  1. Consulta los informes de facturación de Cloud de tu cuenta de facturación de Cloud.

  2. En la página Informes:

    1. Haz clic en Mostrar filtros.
    2. En el cuadro de diálogo Filtros, despliega la sección Etiquetas.
    3. Filtra los datos que se muestran según las claves y los valores de las etiquetas de tu entorno.

Siguientes pasos