Configura las recomendaciones de tipo de máquina

En esta página, se describe cómo ver y cambiar la configuración de las recomendaciones de tipo de máquina. Puedes modificar los tipos de máquinas recomendados para que las recomendaciones generadas solo incluyan tu serie de máquinas preferida. También puedes cambiar las métricas que se usan para generar recomendaciones de memoria para mejorar la precisión de las recomendaciones. Los cambios en la configuración se aplican a nivel del proyecto.

Para obtener más información sobre las recomendaciones de tipo de máquina, consulta Aplica recomendaciones de tipo de máquina para VMs.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los Google Cloud servicios y las APIs. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    1. Instala la Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

    2. Configura una región y una zona predeterminadas.

Roles obligatorios

Si quieres obtener los permisos que necesitas para modificar las recomendaciones de tipo de máquina, pídele a tu administrador que te otorgue el rol de IAM Administrador de Recommender de Compute (roles/recommender.computeAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para cambiar las recomendaciones de tipo de máquina. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para cambiar las recomendaciones de tipo de máquina:

  • Ver la configuración de recomendaciones de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.get en el proyecto
  • Cambiar la configuración de recomendaciones de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.update en el proyecto

También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.

Configura tus recomendaciones

Para configurar las recomendaciones de tipo de máquina, sigue estos pasos:

  1. Obtén la configuración actual para obtener el archivo JSON de la configuración.
  2. Cambia el archivo de configuración en formato JSON.
  3. Sube el archivo de configuración nuevo para aplicar los cambios.

Obtén la configuración actual

Puedes obtener la configuración actual para las recomendaciones de tipo de máquina de tu proyecto mediante Google Cloud CLI.

gcloud

Para obtener los parámetros de configuración actuales, usa el comando gcloud beta recommender recommender-config describe y usa google.compute.instance.MachineTypeRecommender como el ID del recomendador:

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto.
  • ZONE: La zona para la que deseas obtener la configuración actual

El comando muestra la configuración del recomendador, incluidos los subcampos preferred_machine_types y memory_metrics modificables.

{
  "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 deseas guardar la configuración en un archivo local para poder editarla y subirla más tarde, ejecuta el siguiente comando:

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

Edita la configuración de recomendaciones

La configuración te permite personalizar los siguientes parámetros:

  • preferred_machine_types: Las recomendaciones de tipos de máquinas que recibes.
  • memory_metrics: Cómo se usan las métricas de memoria para generar recomendaciones.

Opciones para las recomendaciones de tipos de máquinas

Puedes especificar qué recomendaciones de tipos de máquinas obtienes si cambias el parámetro preferred_machine_types a uno de los siguientes valores:

  • DEFAULT: El valor predeterminado es STANDARD_AND_CUSTOM.
  • STANDARD_AND_CUSTOM: Recomienda la mejor coincidencia de los tipos de máquinas estándar y personalizados.
  • STANDARD_ONLY: Recomienda la mejor coincidencia solo de los tipos de máquinas estándar.

Opciones para las recomendaciones de memoria

Para las métricas de memoria que se usan para generar las recomendaciones, puedes establecer los siguientes valores:

  • MEMORY_METRICS_DEFAULT: Usa las métricas predeterminadas para generar recomendaciones.
  • MEMORY_METRICS_ALL: Usa todas las métricas disponibles para generar recomendaciones.
  • MONITORING_AGENT_ONLY: Usa solo las métricas recopiladas por el Agente de operaciones de Cloud Monitoring.
  • Si no usas el Agente de operaciones y prefieres no recibir recomendaciones de memoria, usa el valor MEMORY_AGENT_ONLY para inhabilitar las recomendaciones.

Para obtener recomendaciones más precisas sobre el uso de memoria, usa el Agente de operaciones.

Actualiza la configuración de un proyecto

Para actualizar la configuración de las recomendaciones de tipo de máquina, modifica los valores de configuración y sube la configuración nueva del proyecto. Puedes cambiar los tipos de máquinas preferidos, las métricas de memoria que se usan para las recomendaciones o ambos valores en la misma solicitud.

Después de subir la configuración nueva, lleva alrededor de 48 horas para que se aplique. Hasta ese momento, las recomendaciones generadas usan la configuración anterior.

gcloud

Para actualizar los parámetros de configuración, usa el comando gcloud beta recommender recommender-config update y usa google.compute.instance.MachineTypeRecommender como el ID del recomendador:

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto.
  • ZONE: La zona para la que deseas obtener la configuración actual
  • LOCAL_FILE_PATH_AND_NAME: Es la ruta al archivo JSON con la configuración actual
  • ETAG: El valor de etag de la configuración actual Puedes encontrar este valor en el resultado del comando anterior.

En el archivo de configuración, especifica solo el objeto recommenderGenerationConfig con los parámetros de configuración actualizados. Si guardaste la configuración en un archivo local, asegúrate de copiar el valor etag y, luego, quitar todos los campos, excepto el valor recommenderGenerationConfig.

Por ejemplo, para obtener recomendaciones solo con tipos de máquinas estándar, usa el siguiente archivo de configuración:

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

Si el comando se ejecuta de forma correcta, muestra un cuerpo de respuesta similar al siguiente, que muestra la configuración nueva con los parámetros que acabas de cambiar.

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

¿Qué sigue?