Modifica il tipo di macchina di un'istanza Compute

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, i test e la modifica per utilizzare 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 modificare 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 modificare n1-highmem-4 in n2d-standard-16.

Se vuoi cambiare il tipo di macchina per una VM che utilizza un serie di macchine di prima o seconda generazione (N1, N2, M1, ecc.) a un tipo di macchina per una serie di macchine di terza generazione o successiva (M3, C3, N4 e così via), è necessario utilizzare la procedura documentata Sposta il carico di lavoro in una nuova istanza di computing.

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

• Le chiavi SSH della VM
• Le configurazioni delle VM, ad esempio i metadati
• I dati sul disco permanente 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 Applica automaticamente gli aggiornamenti della configurazione delle VM in un gruppo di istanze gestite.

Prima di iniziare

• Scopri come interrompere 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 eseguire l'autenticazione Compute Engine come segue.
  

  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 a riga di comando gcloud, 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 a riga di comando gcloud, 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, vedi 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, vedi Esegui 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 seguenti ruoli IAM sul progetto:

• Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1)
• Per connetterti a una VM che possa 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 vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

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 la tua istanza Compute utilizza un modello 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 un primo o un secondo serie di macchine di generazione a un tipo di macchina per una serie di macchine di terza generazione o successive, non possono utilizzare questa procedura. Segui invece le istruzioni in Sposta il carico di lavoro in una nuova istanza di computing.
  • Se vuoi modificare il tipo di macchina in un tipo di macchina Arm, non puoi utilizzare questa procedura. Segui invece le istruzioni in Sposta il carico di lavoro in una nuova istanza di computing.
  • Puoi utilizzare i passaggi in questo documento per modificare il tipo di macchina per tipi di macchine ottimizzate per l'acceleratore G2. Per altro tipi di macchine ottimizzati per l'acceleratore, Modifica 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 ha un costo superiore a tipo di macchina e2-micro.

La modifica di un tipo di macchina potrebbe influire anche sugli sconti per utilizzo sostenuto. VM. Gli sconti per utilizzo sostenuto sono calcolati separatamente per le diverse categorie nella stessa regione. Se cambi tipo di macchina in modo che il nuovo tipo di macchina appartenenti a un'altra categoria, il tempo di esecuzione successivo della VM viene conteggiato ai fini del calcolo per 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. Decidi quindi di cambiare il tipo di macchina m1-ultramem-40. Una volta apportata la modifica, Compute Engine avvia contando il tempo di esecuzione della VM rispetto al tempo di esecuzione per utilizzo 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 qualsiasi applicazione o servizi in esecuzione sulla VM attuale o che aggiorni e applicazioni per l'esecuzione su tipi di macchina più piccoli.

Esamina i consigli relativi al dimensionamento ottimale prima di cambiare il tipo di macchina. Per informazioni sui suggerimenti sulle dimensioni di Compute Engine vedi Applicazione dei suggerimenti sul 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. Prendi in considerazione scattare uno snapshot dei dati del Persistent Disk prima di cambiare il tipo di macchina. Se vuoi per assicurarti che il nuovo tipo di macchina sia in grado di supportare i dati sul una VM esistente, puoi creare uno snapshot di Persistent Disk e usarlo per avviare seconda VM con il nuovo tipo di macchina per verificare che la VM si avvii correttamente.

• Aggiungi altri dischi al file /etc/fstab. Se alla VM sono collegati altri dischi, assicurati vengono 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 ad assicurare che le risorse siano disponibili quando ne hanno bisogno.

Per creare una prenotazione:

1. Creare una prenotazione (o identificare le prenotazioni esistenti) con proprietà come di VM pianificate. Il conteggio di VM della prenotazione deve essere uguale o maggiore del e il 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.

Cambiare un tipo di macchina

Se stai eseguendo l'upgrade del tipo di macchina all'ultima generazione, rivedi Valuta 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 le 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.