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

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Cette page explique comment attribuer des libellés à vos environnements Cloud Composer pour ensuite 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 un libellé personnalisé, 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 même environnement doivent être uniques. Vous pouvez attribuer la même clé et la 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 seront pas associés au libellé attribué.

Attribuer des libellés à de nouveaux environnements

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

Attribuer des libellés à des environnements existants

Console

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

    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 des libellés pour l'environnement :

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

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

  • --remove-labels supprime les libellés spécifiés. Les libellés spécifiés qui n'existent pas sont ignorés.

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

Modifier 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 dans laquelle se trouve l'environnement.
  • LABEL_KEY par la clé du 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 nouveau 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, spécifiez de nouveaux libellés pour votre environnement dans la ressource Environnement.

Remplacer tous les libellés

Pour remplacer tous les libellés, incluez labels dans le paramètre de requête updateMask et fournissez une valeur de 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é de 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 tous les libellés, incluez labels dans le paramètre de requête updateMask et ne fournissez pas de valeur de remplacement.

Mettre à jour des libellés individuels

Pour mettre à jour un libellé ou en ajouter un, incluez labels.LABEL_KEY dans le paramètre de requête updateMask et fournissez une valeur de 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é de 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 libellés, incluez labels.LABEL_KEY dans le paramètre de requête updateMask et ne fournissez pas de valeur de remplacement.

Terraform

Pour créer un environnement avec des paramètres par défaut à un emplacement spécifié, modifiez le bloc labels dans votre configuration Terraform, puis 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 leurs champs.
  • 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 se sont propagés aux rapports de facturation, vous pouvez ventiler les coûts de facturation en fonction des libellés :

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

  2. Sur la page Rapports :

    1. Cliquez sur 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