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:
-
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.
- 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:
- Obtenga la configuración actual para obtener el archivo JSON de la configuración.
- Edite el archivo de configuración en formato JSON.
- 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 esSTANDARD_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?
- Aprenda a aplicar recomendaciones de tipo de máquina a instancias .
- Aprenda a aplicar recomendaciones de tipos de máquinas a grupos de instancias administrados .