Administrar las etiquetas del entorno y desglosar los costos del entorno

Cloud Composer 1 | Cloud Composer 2

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

Información acerca de las etiquetas de entorno

Las etiquetas de entorno son pares clave-valor que puedes asignar a tus 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 entorno único deben ser únicas. Puedes asignar la misma clave y valor a varios entornos.

Etiquetas de entorno en informes de facturación

Las etiquetas de entorno que asignas a tus entornos son visibles en los informes de facturación, por lo que puedes desglosar los costos según las claves y los valores de las etiquetas.

Las etiquetas no se aplican de forma retroactiva. Por ejemplo, si asignas una etiqueta el 15 de mayo, los costos de facturación del 14 de mayo no contienen la etiqueta asignada.

Asigna etiquetas a entornos nuevos

Puedes asignar etiquetas cuando creas un entorno. Para obtener más información, consulta Crea entornos.

Asigna etiquetas a los entornos existentes

Consola

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

    Ir a Entornos

  2. Selecciona tu entorno.

  3. Ve a la pestaña Etiquetas.

  4. Haz clic en Editar y, luego, en Agregar etiqueta.

  5. Agrega un par clave-valor para la etiqueta y haz clic en Guardar.

  6. Espera hasta 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 quita todas las etiquetas.

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

  • --remove-labels quita las etiquetas especificadas. Se ignoran las etiquetas especificadas que no existen.

Si usas varios de estos argumentos, se aplican en el siguiente orden: --clear-labels, --update-labels, --remove-labels.

Actualiza o crea etiquetas

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

Quita las etiquetas especificadas

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

Quita todas las etiquetas

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

Reemplaza lo siguiente:

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

Ejemplo

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

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

API

Cuando actualizas un entorno, en el recurso Entorno, especifica etiquetas nuevas de tu entorno.

Reemplaza todas las etiquetas

Para reemplazar todas las etiquetas, incluye labels en el parámetro de consulta updateMask y proporciona un reemplazo en el cuerpo de la solicitud.

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

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

Reemplaza lo siguiente:

  • LABEL_KEY por una clave de la etiqueta del entorno.
  • LABEL_VALUE por un valor nuevo 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"
  }
}

Quita todas las etiquetas

Para quitar todas las etiquetas, incluye labels en el parámetro de consulta updateMask y no proporciones el valor de reemplazo.

Actualiza etiquetas individuales

Para actualizar una etiqueta o agregar una etiqueta nueva a las etiquetas existentes, incluye labels.LABEL_KEY en el parámetro de consulta updateMask y proporciona un reemplazo 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"
    }
}

Reemplaza lo siguiente:

  • LABEL_KEY por una clave de la etiqueta del entorno.
  • LABEL_VALUE por un valor nuevo 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"
  }
}

Quita etiquetas individuales

Para quitar etiquetas, incluye labels.LABEL_KEY en el parámetro de consulta updateMask y no proporciones el valor de reemplazo.

Terraform

Para crear un entorno con parámetros predeterminados como una ubicación especificada, edita el bloque labels en la configuración de Terraform y ejecuta terraform apply.

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

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Reemplaza lo siguiente:

  • LABEL_KEY por la clave de la etiqueta de entorno que deseas crear o actualizar. Para quitar etiquetas, borra sus campos.
  • LABEL_VALUE por 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"
  }
}

Visualiza etiquetas en los informes

Una vez que las etiquetas de tu entorno se propaguen a los informes de facturación, puedes desglosar los costos de facturación en función de las siguientes etiquetas:

  1. Visualiza los informes de la Facturación de Cloud correspondientes a tu cuenta.

  2. En la página Informes (Reports), haz lo siguiente:

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

¿Qué sigue?