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 ulteriori informazioni, 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:

• Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1)
• Per connetterti a una VM che può essere eseguita come account di servizio: Utente account di servizio (v1) (roles/iam.serviceAccountUser)

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:

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:
  • Non puoi modificare il tipo di macchina per le istanze bare metal.
  • Se vuoi cambiare il tipo di macchina da una serie di macchine di prima o seconda generazione a un tipo di macchina per una serie di macchine di terza generazione o successive, non puoi utilizzare questa procedura. Segui invece le istruzioni riportate in Trasferire il carico di lavoro in una nuova istanza di calcolo.
  • Se vuoi modificare il tipo di macchina in un tipo di macchina Arm, non puoi utilizzare questa procedura. Segui invece le istruzioni riportate in Trasferire il carico di lavoro in una nuova istanza di calcolo.
  • Puoi utilizzare i passaggi descritti in questo documento per modificare il tipo di macchina per i tipi di macchina ottimizzati per l'acceleratore G2. Per altri tipi di macchine ottimizzate per l'acceleratore, consulta Modificare le VM ottimizzate per l'acceleratore.

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

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

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());
    }
  }
}

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")

Passaggi successivi

• Scopri di più sui consigli sui tipi di macchine.
• Scopri di più sui gruppi di istanze gestite.
• Scopri di più sui pattern per app scalabili e resilienti.
• Per aggiornare una VM di prima o seconda generazione in modo da utilizzare una serie di macchine di terza generazione o successiva, consulta Spostare il carico di lavoro in una nuova istanza di calcolo.