Configurar recomendaciones de tipo de máquina


Esta página describe cómo ver y modificar la configuración de las recomendaciones de tipo de máquina. Puede modificar qué tipos de máquinas se recomiendan, de modo que las recomendaciones generadas solo incluyan su serie de máquinas preferida. También puede cambiar las métricas utilizadas para generar recomendaciones de memoria para mejorar la precisión de las recomendaciones. Los cambios en la configuración se aplican a nivel de proyecto.

Para obtener más información sobre las recomendaciones de tipos de máquinas, consulte Aplicar recomendaciones de tipos de máquinas para máquinas virtuales .

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
    1. After installing the Google Cloud CLI, initialize it by running the following command:

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

Roles requeridos

Para obtener los permisos que necesita para modificar las recomendaciones de tipo de máquina, solicite a su administrador que le otorgue el rol de IAM de Administrador de recomendación de computación ( roles/recommender.computeAdmin ) en su proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Esta función predefinida contiene los permisos necesarios para modificar las recomendaciones de tipo de máquina. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Permisos requeridos

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

  • Vea la configuración de recomendación del tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.get en el proyecto
  • Modifique la configuración de recomendación del tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.update en el proyecto

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Configura tus recomendaciones

Para configurar las recomendaciones de tipo de máquina, realice los siguientes pasos:

  1. Obtenga la configuración actual para obtener el archivo JSON de la configuración.
  2. Edite el archivo de configuración en formato JSON.
  3. Cargue el nuevo archivo de configuración para aplicar los cambios.

Obtener la configuración actual

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

nube de gcloud

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

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID de su proyecto.
  • ZONE : la zona para la que desea obtener la configuración actual.

El comando devuelve la configuración del recomendador, incluidos los subcampos modificables preferred_machine_types y 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 desea guardar la configuración en un archivo local, para poder editarla y cargarla más tarde, ejecute el siguiente comando:

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

Editar la configuración de recomendación

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

  • preferred_machine_types : las recomendaciones de tipos de máquinas que recibe.
  • memory_metrics : cómo se utilizan las métricas de memoria para generar recomendaciones.

Opciones para recomendaciones de tipos de máquinas.

Puede especificar qué tipos de máquinas recomendaciones obtiene cambiando la configuración de preferred_machine_types a uno de los siguientes valores:

  • DEFAULT : El valor predeterminado es STANDARD_AND_CUSTOM .
  • STANDARD_AND_CUSTOM : recomienda la mejor combinación entre los tipos de máquinas estándar y personalizadas.
  • STANDARD_ONLY : recomienda la mejor combinación únicamente entre los tipos de máquinas estándar.

Opciones para recomendaciones de memoria.

Para las métricas de memoria utilizadas para generar las recomendaciones, puede establecer los siguientes valores:

  • MEMORY_METRICS_DEFAULT : utiliza las métricas predeterminadas para generar recomendaciones.
  • MEMORY_METRICS_ALL : utiliza todas las métricas disponibles para generar recomendaciones.
  • MONITORING_AGENT_ONLY : use solo métricas recopiladas por el agente de operaciones de monitoreo de la nube.
  • Si no utiliza Ops Agent y prefiere no recibir recomendaciones de memoria, use el valor MEMORY_AGENT_ONLY para deshabilitar las recomendaciones.

Para obtener recomendaciones más precisas sobre el uso de la memoria, utilice Ops Agent .

Actualizar la configuración de un proyecto.

Para actualizar la configuración de sus recomendaciones de tipo de máquina, modifique los valores de configuración y cargue la nueva configuración para su proyecto. Puede cambiar los tipos de máquinas preferidas, las métricas de memoria utilizadas para las recomendaciones o ambos valores en la misma solicitud.

Después de cargar la nueva configuración, tarda aproximadamente 48 horas en surtir efecto. Hasta ese momento, todas las recomendaciones generadas utilizan la configuración anterior.

nube de gcloud

Para actualizar los parámetros de configuración, use el comando gcloud beta recommender recommender-config update y use google.compute.instance.MachineTypeRecommender como 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

Reemplace lo siguiente:

  • PROJECT_ID : el ID de su proyecto.
  • ZONE : la zona para la que desea obtener la configuración actual.
  • LOCAL_FILE_PATH_AND_NAME : la ruta al archivo JSON con la configuración actual.
  • ETAG : el valor de etag de la configuración actual. Puede encontrar este valor en el resultado del comando anterior .

En su archivo de configuración, especifique solo el objeto recommenderGenerationConfig con los parámetros de configuración actualizados. Si guardó la configuración en un archivo local, asegúrese de copiar el valor etag y luego elimine todos los campos excepto el valor recommenderGenerationConfig .

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

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

Si el comando tiene éxito, devuelve un cuerpo de respuesta similar al siguiente, que muestra la nueva configuración con los parámetros que acaba de modificar.

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