Configurer les recommandations de types de machines

Cette page explique comment afficher et modifier la configuration de vos recommandations de types de machines. Vous pouvez modifier les types de machines recommandés afin que les recommandations générées n'incluent que les séries de machines de votre choix. Vous pouvez également modifier les métriques utilisées pour générer des recommandations de mémoire afin d'améliorer leur précision. Les modifications apportées à la configuration s'appliquent au niveau du projet.

Pour en savoir plus sur les recommandations de types de machines, consultez Appliquer des recommandations de types de machines aux VM.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet de valider votre identité pour accéder aux Google Cloud services et aux API. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :

    1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisezla en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    2. Définissez une région et une zone par défaut.

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier les recommandations de types de machines, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de l'outil de recommandation Compute (roles/recommender.computeAdmin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour modifier les recommandations de types de machines. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour modifier les recommandations de types de machines :

  • Afficher la configuration des recommandations de types de machines : recommender.computeInstanceMachineTypeRecommenderConfig.get sur le projet
  • Modifier la configuration des recommandations de types de machines : recommender.computeInstanceMachineTypeRecommenderConfig.update sur le projet

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Configurer vos recommandations

Pour configurer vos recommandations de types de machines, procédez comme suit :

  1. Obtenez la configuration actuelle pour obtenir le fichier JSON de la configuration.
  2. Modifiez le fichier de configuration au format JSON.
  3. Importez le nouveau fichier de configuration pour appliquer les modifications.

Obtenir la configuration actuelle

Vous pouvez obtenir la configuration actuelle des recommandations de types de machines pour votre projet à l'aide de Google Cloud CLI.

gcloud

Pour obtenir les paramètres de configuration actuels, utilisez la commande gcloud beta recommender recommender-config describe et utilisez google.compute.instance.MachineTypeRecommender comme ID de l'outil de recommandation :

gcloud beta recommender recommender-config describe google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE

Remplacez les éléments suivants :

  • PROJECT_ID : par l'ID du projet.
  • ZONE: zone pour laquelle vous souhaitez obtenir la configuration actuelle.

La commande renvoie la configuration de l'outil de recommandation, y compris les sous-champs modifiables preferred_machine_types et memory_metrics.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_AND_CUSTOM",
      "memory_metrics": "MONITORING_AGENT_ONLY"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-08-20T04:41:15.330351Z"
}

Si vous souhaitez enregistrer la configuration dans un fichier local afin de pouvoir la modifier et l'importer ultérieurement, exécutez la commande suivante :

gcloud beta recommender recommender-config describe \
  google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE > LOCAL_FILE_PATH_AND_NAME

Modifier la configuration des recommandations

La configuration vous permet de personnaliser les paramètres suivants :

  • preferred_machine_types : recommandations de types de machines que vous recevez.
  • memory_metrics : mode d'utilisation des métriques de mémoire pour générer des recommandations.

Options pour les recommandations de types de machines

Vous pouvez spécifier les recommandations de types de machines que vous recevez en remplaçant le paramètre preferred_machine_types par l'une des valeurs suivantes :

  • DEFAULT : la valeur par défaut est STANDARD_AND_CUSTOM.
  • STANDARD_AND_CUSTOM: recommande la meilleure correspondance parmi les types de machines standards et personnalisés.
  • STANDARD_ONLY : recommande la meilleure correspondance parmi les types de machines standards uniquement.

Options pour les recommandations de mémoire

Pour les métriques de mémoire utilisées pour générer les recommandations, vous pouvez définir les valeurs suivantes :

  • MEMORY_METRICS_DEFAULT : utiliser les métriques par défaut pour générer des recommandations.
  • MEMORY_METRICS_ALL: utiliser toutes les métriques disponibles pour générer des recommandations.
  • MONITORING_AGENT_ONLY: utiliser uniquement les métriques collectées par l'agent Ops de Cloud Monitoring.
  • Si vous n'utilisez pas l'agent Ops et que vous préférez ne pas recevoir de recommandations de mémoire, utilisez la valeur MEMORY_AGENT_ONLY pour désactiver les recommandations.

Pour obtenir des recommandations plus précises sur l'utilisation de la mémoire, utilisez l' agent Ops.

Mettre à jour la configuration d'un projet

Pour mettre à jour la configuration de vos recommandations de types de machines, modifiez les valeurs de configuration et importez la nouvelle configuration pour votre projet. Vous pouvez modifier les types de machines préférés, les métriques de mémoire utilisées pour les recommandations, ou les deux valeurs dans la même requête.

Une fois la nouvelle configuration importée, la prise en compte de la modification prend environ 48 heures. Pendant ce temps, toutes les recommandations générées utilisent la configuration précédente.

gcloud

Pour mettre à jour les paramètres de configuration, exécutez la commande gcloud beta recommender recommender-config update et utilisez google.compute.instance.MachineTypeRecommender comme ID de l'outil de recommandation :

gcloud beta recommender recommender-config update google.compute.instance.MachineTypeRecommender\
  --project=PROJECT_ID \
  --location=ZONE \
  --config-file=LOCAL_FILE_PATH_AND_NAME \
  --etag=ETAG

Remplacez les éléments suivants :

  • PROJECT_ID : par l'ID du projet.
  • ZONE: zone pour laquelle vous souhaitez obtenir la configuration actuelle.
  • LOCAL_FILE_PATH_AND_NAME: chemin d'accès au fichier JSON contenant la configuration actuelle.
  • ETAG : valeur etag de la configuration actuelle. Vous trouverez cette valeur dans le résultat de la commande précédente.

Dans votre fichier de configuration, spécifiez uniquement l'objet recommenderGenerationConfig avec les paramètres de configuration mis à jour. Si vous avez enregistré la configuration dans un fichier local, veillez à copier la valeur etag, puis supprimez tous les champs à l'exception de la valeur recommenderGenerationConfig.

Par exemple, pour obtenir des recommandations avec des types de machines standards uniquement, utilisez le fichier de configuration suivant :

{
  "params": {
    "preferred_machine_types": "STANDARD_ONLY"
  }
}

Si la commande aboutit, elle renvoie un corps de réponse semblable à celui-ci, qui indique la nouvelle configuration avec les paramètres que vous venez de modifier.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_ONLY"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-08-20T05:00:05Z"
}

Étape suivante