Gérer les libellés d'environnement et ventiler les coûts liés à l'environnement

Cette page explique comment attribuer des libellés à vos environnements Cloud Composer, puis ventiler les coûts de facturation en fonction de ces libellés.

À propos des libellés d'environnement

Les libellés d'environnement sont des paires clé/valeur que vous pouvez attribuer à vos environnements. Par exemple, si owner:engineering-team est une étiquette personnalisée, owner est la clé et engineering-team est la valeur.

Chaque environnement peut avoir plusieurs libellés, mais les clés de libellé d'un seul environnement doivent être uniques. Vous pouvez attribuer une même clé et une même valeur à plusieurs environnements.

Libellés d'environnement dans les rapports de facturation

Les libellés d'environnement que vous attribuez à vos environnements sont visibles dans les rapports de facturation. Vous pouvez donc ventiler les coûts en fonction des clés et des valeurs des libellés.

Les libellés ne s'appliquent pas rétroactivement. Par exemple, si vous attribuez un libellé le 15 mai, les coûts de facturation du 14 mai ne contiennent pas le libellé attribué.

Attribuer des libellés à de nouveaux environnements

Vous pouvez attribuer des libellés lors de la création d'un environnement. Pour plus d'informations, consultez la section Créer des environnements.

Attribuer des libellés à des environnements existants

Console

  1. Accédez à la page Environnements dans Google Cloud Console:

    Accéder à la page Environnements

  2. Sélectionnez votre environnement.

  3. Accédez à l'onglet Libellés.

  4. Cliquez sur Modifier, puis sur Ajouter un libellé.

  5. Ajoutez une paire clé-valeur pour le libellé, puis cliquez sur Enregistrer.

  6. Attendez que l'environnement soit mis à jour.

gcloud

Lorsque vous mettez à jour un environnement à l'aide de la commande gcloud composer, les arguments suivants spécifient les libellés de l'environnement:

  • --clear-labels supprime tous les libellés.

  • --update-labels met à jour les libellés spécifiés. crée des libellés s'ils n'existent pas encore.

  • --remove-labels supprime les libellés spécifiés ; un libellé spécifié qui n'existe pas est ignoré.

Si vous utilisez plusieurs de ces arguments, ils sont appliqués dans l'ordre suivant: --clear-labels, --update-labels, --remove-labels.

Mettre à jour ou créer des libellés

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

Supprimer les libellés spécifiés

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

Supprimer tous les libellés

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

Remplacez :

  • ENVIRONMENT_NAME par le nom de l'environnement.
  • LOCATION par la région Compute Engine dans laquelle se trouve l'environnement.
  • LABEL_KEY par la clé de libellé d'environnement que vous souhaitez créer, mettre à jour ou supprimer.
  • LABEL_VALUE par la valeur du libellé d'environnement.

Exemple

L'exemple suivant met à jour le libellé owner, crée le libellé env et supprime le libellé misc:

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

API

Lorsque vous mettez à jour un environnement, dans la ressource Environment, spécifiez les nouveaux libellés de votre environnement.

Remplacer tous les libellés

Pour remplacer tous les libellés, incluez labels dans le paramètre de requête updateMask et fournissez un remplacement dans le corps de la requête.

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

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

Remplacez :

  • LABEL_KEY par une clé du libellé d'environnement.
  • LABEL_VALUE par une nouvelle valeur pour le libellé d'environnement.

Exemple :

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

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

Supprimer tous les libellés

Pour supprimer toutes les étiquettes, incluez labels dans le paramètre de requête updateMask et ne fournissez pas la valeur de remplacement.

Mettre à jour des libellés individuels

Pour mettre à jour un libellé ou en ajouter un à des libellés existants, ajoutez labels.LABEL_KEY au paramètre de requête updateMask et fournissez un remplacement dans le corps de la requête.

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

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

Remplacez :

  • LABEL_KEY par une clé du libellé d'environnement.
  • LABEL_VALUE par une nouvelle valeur pour le libellé d'environnement.

Exemple :

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

Supprimer des libellés individuels

Pour supprimer des étiquettes, incluez labels.LABEL_KEY dans le paramètre de requête updateMask et ne fournissez pas la valeur de remplacement.

Terraform

Pour créer un environnement avec des paramètres par défaut, spécifiez un emplacement : modifiez le bloc labels dans votre configuration Terraform et exécutez terraform apply.

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

  labels = {
    LABEL_KEY = "LABEL_VALUE"
  }

}

Remplacez :

  • LABEL_KEY par la clé de libellé d'environnement que vous souhaitez créer ou mettre à jour. Pour supprimer des libellés, supprimez les champs correspondants.
  • LABEL_VALUE par la valeur du libellé d'environnement.

Exemple :

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

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

Afficher les libellés dans les rapports

Une fois que les libellés de votre environnement ont été appliqués aux rapports de facturation, vous pouvez ventiler les coûts de facturation en fonction des libellés suivants:

  1. Affichez les rapports Cloud Billing pour votre compte Cloud Billing.

  2. Sur la page Rapports:

    1. Cliquez sur Show filters (Afficher les filtres).
    2. Dans la boîte de dialogue Filtres, développez la section Libellés.
    3. Filtrez les données affichées en fonction des clés et des valeurs de vos libellés d'environnement.

Étape suivante