Configurer les recommandations de types de machines

Cette page explique comment afficher et modifier la configuration de vos recommandations de type de machine. 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 sont appliquées au niveau du projet.

Pour en savoir plus sur les recommandations de types de machines, consultez la page 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 est le processus permettant 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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier les recommandations de type de machine, demandez à votre administrateur de vous accorder le rôle IAM Administrateur du recommendeur Compute (roles/recommender.computeAdmin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page 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 type de machine. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour modifier les recommandations de type de machine:

  • Afficher la configuration des recommandations de types de machines : recommender.computeInstanceMachineTypeRecommenderConfig.get sur le projet
  • Modifiez la configuration des recommandations de type de machine : 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 type de machine, 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 type de machine 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 sur les types de machines que vous recevez.
  • memory_metrics: Comment les métriques de mémoire sont utilisées 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 définissant le paramètre preferred_machine_types sur 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: utilisez les métriques par défaut pour générer des recommandations.
  • MEMORY_METRICS_ALL: utilisez toutes les métriques disponibles pour générer des recommandations.
  • MONITORING_AGENT_ONLY: n'utilisez que les métriques collectées par l'agent Ops 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 les désactiver.

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 type de machine, 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 avec la configuration actuelle.
  • ETAG: valeur etag de la configuration actuelle. Vous pouvez trouver cette valeur dans la sortie 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 à supprimer 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