Modificare il tipo di macchina di un'istanza di calcolo

Se l'istanza della macchina virtuale (VM) non ha un'unità SSD locale collegata e non fa parte di un gruppo di istanze gestite (MIG), puoi modificare il tipo di macchina dell'istanza dopo averla arrestata.

Se il tipo di macchina esistente non è adatto ai carichi di lavoro che esegui sulla VM, modifica il tipo di macchina della VM. Ad esempio, puoi avviare una VM con un tipo di macchina più piccolo durante la configurazione, lo sviluppo e il test e modificare la VM in modo che utilizzi un tipo di macchina più grande quando è tutto pronto per i carichi di lavoro di produzione.

Puoi utilizzare questa procedura nelle seguenti situazioni:

  • Per passare a un tipo di macchina simile, ma con un numero diverso di vCPU o memoria all'interno della stessa serie di macchine, ad esempio:
    • Puoi cambiare n2-highcpu-4 in n2-standard-4.
    • Puoi cambiare c3d-standard-30 in c3d-highmem-30.
  • Per modificare il tipo di macchina in modo da utilizzare una serie di macchine diversa. Questa opzione è supportata solo per le serie di macchine di prima e seconda generazione, escluse le serie T2A e A2. Ad esempio:
    • Puoi cambiare n2-standard-4 in c2-standard-8.
    • Puoi cambiare n1-highmem-4 in n2d-standard-16.

Se vuoi modificare il tipo di macchina di una VM che utilizza una serie di macchine di prima o seconda generazione (N1, N2, M1 e così via) in un tipo di macchina per una serie di macchine di terza generazione o successive (M3, C3, N4 e così via), devi utilizzare la procedura descritta in Spostare il carico di lavoro in una nuova istanza di calcolo.

Puoi modificare il tipo di macchina senza influire sulle seguenti risorse:

  • Le chiavi SSH della VM
  • Le configurazioni della VM, ad esempio i metadati della VM
  • I dati sul Persistent Disk o Hyperdisk collegato, inclusi le applicazioni installate e i dati delle applicazioni

Per modificare il tipo di macchina delle VM all'interno di un gruppo di istanze gestite, consulta Applicare automaticamente gli aggiornamenti della configurazione delle VM in un gruppo di istanze gestite.

Prima di iniziare

  • Scopri come arrestare una VM.
  • Scopri di più sui tipi di macchine.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    Java

    Per utilizzare gli Java esempi in questa pagina in un ambiente di sviluppo locale, installa e inizializza l'interfaccia alla gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

    Per ulteriori informazioni, consulta Set up authentication for a local development environment.

    Python

    Per utilizzare gli Python esempi in questa pagina in un ambiente di sviluppo locale, installa e inizializza l'interfaccia alla gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.

    1. Install the Google Cloud CLI.

    2. To initialize the gcloud CLI, run the following command: 

      gcloud init

    3. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

    Per ulteriori informazioni, consulta Set up authentication for a local development environment.

    REST

    Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

      Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init

    Per saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare il tipo di macchina di una VM, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per modificare il tipo di macchina di una VM. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per modificare il tipo di macchina di una VM sono necessarie le seguenti autorizzazioni:

  • compute.instances.setMachineType su VM
  • compute.instances.start su VM
  • compute.instances.stop su VM

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

  • Se l'istanza di calcolo ha una o più unità SSD locali, non puoi modificare il tipo di macchina dell'istanza.
  • Se l'istanza di calcolo utilizza un indirizzo IP esterno temporaneo, l'indirizzo IP potrebbe cambiare quando modifichi il tipo di macchina dell'istanza. Per conservare l'indirizzo IP, promuovilo a un indirizzo IP esterno statico prima di cambiare il tipo di macchina.
  • La modifica del tipo di macchina di un'istanza di calcolo non è disponibile per alcune configurazioni:

Implicazioni per la fatturazione

Ogni tipo di macchina viene fatturato a una tariffa diversa, quindi assicurati di comprendere le implicazioni relative ai prezzi del cambio di tipo di macchina. Ad esempio, un tipo di macchina e2-standard-2 costa più di un tipo di macchina e2-micro.

La modifica di un tipo di macchina potrebbe influire anche sugli sconti per utilizzo sostenuto per quella VM. Gli sconti per utilizzo sostenuto vengono calcolati separatamente per categorie diverse nella stessa regione. Se modifichi i tipi di macchine in modo che il nuovo tipo di macchina sia in una categoria diversa, il tempo di esecuzione successivo della VM viene conteggiato ai fini dello sconto per utilizzo sostenuto della nuova categoria.

Ad esempio, supponiamo che tu abbia una VM con tipo di macchina n2-standard-2 in esecuzione per metà mese. Poi decidi di cambiare il tipo di macchina in m1-ultramem-40. Dopo aver apportato la modifica, Compute Engine inizia a conteggiare il tempo di esecuzione della VM ai fini dello sconto per utilizzo sostenuto della categoria di vCPU e memoria ottimizzate per la memoria.

Nella fattura vedrai uno sconto per utilizzo sostenuto applicato al tipo di macchina n2-standard-2 precedente alla modifica e uno sconto per utilizzo sostenuto separato per m1-ultramem-40, se la VM rimane in esecuzione su m1-ultramem-40 per almeno il 25% del resto del mese.

Passare a un tipo di macchina più piccolo

Se passi da un tipo di macchina con più risorse a un tipo di macchina con meno risorse, ad esempio da un tipo di macchina e2-standard-8 a un tipo di macchina e2-standard-2, potresti riscontrare problemi relativi alle risorse hardware o limitazioni delle prestazioni perché i tipi di macchina più piccoli sono meno potenti di quelli più grandi. Assicurati che il nuovo tipo di macchina sia in grado di supportare eventuali applicazioni o servizi in esecuzione sulla tua VM attuale oppure aggiorna i servizi e le applicazioni in modo che vengano eseguiti sui tipi di macchine più piccoli.

Esamina i suggerimenti per la scelta della dimensione giusta prima di modificare il tipo di macchina. Per informazioni sui suggerimenti per il dimensionamento di Compute Engine, consulta Applicare i suggerimenti per il tipo di macchina per le istanze VM.

Best practice

Di seguito sono riportate alcune best practice per aiutarti a modificare correttamente il tipo di VM.

  • Esegui backup regolari dei dati del Persistent Disk utilizzando gli snapshot. Valuta la possibilità di eseguire uno snapshot dei dati del Persistent Disk prima di modificare il tipo di macchina. Se vuoi assicurarti che il nuovo tipo di macchina sia in grado di supportare i dati della VM esistente, puoi acquisire uno snapshot Persistent Disk e utilizzarlo per avviare una seconda VM con il nuovo tipo di macchina per verificare che la VM si avvii correttamente.

  • Aggiungi altri dischi al file /etc/fstab. Se hai altri dischi collegati alla VM, assicurati che vengano aggiunti al file /etc/fstab in modo che vengano montati automaticamente al riavvio della VM.

  • Crea una prenotazione prima di modificare il tipo di macchina. Per evitare errori correlati alla disponibilità delle risorse, crea prenotazioni Compute Engine per i nuovi tipi di macchine quando sono disponibili per prenotarli all'interno di una zona. Le prenotazioni contribuiscono a garantire che le risorse siano disponibili quando ne hai bisogno.

Per creare una prenotazione:

  1. Crea una prenotazione (o identifica le prenotazioni esistenti) con proprietà identiche a quelle delle VM pianificate. Il numero di VM della prenotazione deve essere uguale o superiore al numero di VM che vuoi modificare. Se vuoi, per impedire ad altre VM di utilizzare questa prenotazione, utilizza l'opzione specificReservationRequired.

  2. Verifica che le VM pianificate possano utilizzare la prenotazione:

    1. Verifica che le VM abbiano l'affinità di prenotazione corretta.
    2. Immediatamente prima di modificare le VM, assicurati che la prenotazione abbia una capacità sufficiente.

Modificare un tipo di macchina

Puoi modificare il tipo di macchina solo di una VM arrestata. Una VM è considerata interrotta solo quando è nello stato TERMINATED. Non puoi cambiare il tipo di macchina di una VM in esecuzione.

Se esegui l'upgrade del tipo di macchina all'ultima generazione, consulta Valutare le opzioni di migrazione delle VM prima di procedere.

Console

  1. Nella console Google Cloud, vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. Nella colonna Nome, fai clic sul nome della VM per cui vuoi cambiare il tipo di macchina.

  3. Nella pagina Dettagli dell'istanza VM, completa i seguenti passaggi:

    1. Se la VM è in esecuzione, nel menu nella parte superiore della pagina, selezionare Arresta per arrestarla.
    2. Per modificare la VM, fai clic su Modifica.

    3. Nella sezione Configurazione macchina, seleziona il tipo di macchina che vuoi utilizzare o crea un tipo di macchina personalizzato.

    4. Per salvare le modifiche, fai clic su Salva.

    5. Riavvia la VM.

gcloud

  1. Interrompi la VM utilizzando il comando gcloud compute instances stop:

    gcloud compute instances stop VM_NAME

    Sostituisci VM_NAME con la VM contenente il tipo di macchina da modificare.

  2. Modifica il tipo di macchina utilizzando il comando gcloud compute instances set-machine-type:

    gcloud compute instances set-machine-type VM_NAME \
    --machine-type NEW_MACHINE_TYPE

    Sostituisci NEW_MACHINE_TYPE con il nuovo tipo di macchina per la VM. Il tipo di macchina può essere uno dei seguenti:

  3. Avvia la VM utilizzando il comando gcloud compute instances start:

    gcloud compute instances start VM_NAME

    Sostituisci VM_NAME con il nome della VM che hai modificato.

Java

Java

Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Compute Engine che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Compute Engine Java.

Per autenticarti a Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale. 


import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.Instance.Status;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.InstancesSetMachineTypeRequest;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class ChangeInstanceMachineType {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "your-project-id";
    // Name of the zone your instance belongs to.
    String zone = "zone-name";
    // Name of the VM you want to modify.
    String instanceName = "instance-name";
    // The new machine type you want to use for the VM.
    // For example: "e2-standard-8", "e2-custom-4-2048" or "m1-ultramem-40"
    // More about machine types: https://cloud.google.com/compute/docs/machine-resource
    String newMachineType = "e2-standard-8";
    changeMachineType(projectId, zone, instanceName, newMachineType);
  }

  // Changes the machine type of VM.
  // The VM needs to be in the 'TERMINATED' state for this operation to be successful.
  public static void changeMachineType(String projectId, String zone, String instanceName,
      String newMachineType)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the `instancesClient.close()` method on the client to safely
    // clean up any remaining background resources.
    try (InstancesClient instancesClient = InstancesClient.create()) {

      Instance instance = instancesClient.get(projectId, zone, instanceName);
      if (!instance.getStatus().equals(Status.TERMINATED.name())) {
        throw new Error(String.format(
            "Only machines in TERMINATED state can have their machine type changed. "
                + "%s is in %s state.", instance.getName(), instance.getStatus()));
      }

      InstancesSetMachineTypeRequest machineTypeRequest =
          InstancesSetMachineTypeRequest.newBuilder()
              .setMachineType(String.format("projects/%s/zones/%s/machineTypes/%s",
                  projectId, zone, newMachineType))
              .build();

      Operation response = instancesClient
          .setMachineTypeAsync(projectId, zone, instanceName, machineTypeRequest)
          .get(3, TimeUnit.MINUTES);

      if (response.hasError()) {
        System.out.println("Machine type update failed! " + response);
        return;
      }
      System.out.println("Machine type update - operation status: " + response.getStatus());
    }
  }
}

Python

Python

Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Compute Engine che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Compute Engine Python.

Per autenticarti a Compute Engine, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale. 

from __future__ import annotations

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1


def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    Waits for the extended (long-running) operation to complete.

    If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result


def change_machine_type(
    project_id: str, zone: str, instance_name: str, new_machine_type: str
) -> None:
    """
    Changes the machine type of VM. The VM needs to be in the 'TERMINATED' state for this operation to be successful.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        zone: name of the zone your instance belongs to.
        instance_name: name of the VM you want to modify.
        new_machine_type: the new machine type you want to use for the VM.
            For example: `e2-standard-8`, `e2-custom-4-2048` or `m1-ultramem-40`
            More about machine types: https://cloud.google.com/compute/docs/machine-resource
    """
    client = compute_v1.InstancesClient()
    instance = client.get(project=project_id, zone=zone, instance=instance_name)

    if instance.status != compute_v1.Instance.Status.TERMINATED.name:
        raise RuntimeError(
            f"Only machines in TERMINATED state can have their machine type changed. "
            f"{instance.name} is in {instance.status}({instance.status_message}) state."
        )

    machine_type = compute_v1.InstancesSetMachineTypeRequest()
    machine_type.machine_type = (
        f"projects/{project_id}/zones/{zone}/machineTypes/{new_machine_type}"
    )
    operation = client.set_machine_type(
        project=project_id,
        zone=zone,
        instance=instance_name,
        instances_set_machine_type_request_resource=machine_type,
    )

    wait_for_extended_operation(operation, "changing machine type")

REST

  1. Arresta la VM utilizzando il metodo instances.stop: 

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/stop

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto

    • ZONE: la zona contenente la VM

    • VM_NAME: la VM contenente il tipo di macchina da modificare

  2. Modifica il tipo di macchina utilizzando il metodo instances.setMachineType:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMachineType

    Nel corpo della richiesta, fornisci il machineType aggiornato:

    {
    machineType: "zones/MACHINE_TYPE_ZONE/machineTypes/NEW_MACHINE_TYPE"
}

    Sostituisci quanto segue:

    • MACHINE_TYPE_ZONE: la zona contenente il tipo di macchina

    • NEW_MACHINE_TYPE: il nuovo tipo di macchina per la VM

      Il tipo di macchina può essere uno dei seguenti:

  3. Avvia la VM utilizzando il metodo instances.start: 

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/start

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto
    • ZONE: la zona contenente la VM
    • VM_NAME: il nome della VM che hai modificato

Passaggi successivi