Esporta un'immagine personalizzata in Cloud Storage

Se devi spostare i dati del disco di avvio di Compute Engine al di fuori del tuo progetto Compute Engine, puoi esportare un'immagine del disco di avvio in Cloud Storage come file tar.gz. Se devi creare un'immagine del disco permanente da utilizzare quando crei nuovi dischi permanenti su Compute Engine, leggi Creazione di un'immagine personalizzata.

Puoi eseguire il backup o condividere un'immagine personalizzata esportandola in Cloud Storage. Questo metodo è ideale per condividere singole immagini con progetti che non hanno accesso alle tue immagini. In alternativa, puoi condividere le immagini concedendo il ruolo Utente immagine Compute Engine sull'immagine o sul progetto che la contiene.

Il seguente diagramma mostra alcuni flussi di lavoro tipici per la creazione e il riutilizzo di un'immagine personalizzata.

Prima di iniziare

• Leggi la pagina Immagini.
• Se il progetto da cui vuoi esportare l'immagine ha un criterio per le immagini attendibili definito, aggiungi projects/compute-image-import e projects/compute-image-tools all'elenco dei publisher consentiti.
• Per scoprire come soddisfare i requisiti prima di esportare le immagini, consulta Prerequisiti per l'importazione e l'esportazione di immagini VM.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. 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.

  gcloud

  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.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

  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.

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

Limitazioni e restrizioni

Al processo di esportazione delle immagini si applicano le seguenti limitazioni.

Limitazioni generali

Quando esporti un'immagine, viene creata una sessione sulla macchina da cui esporti l'immagine. Questa sessione deve rimanere attiva fino al completamento della procedura di esportazione. Se la sessione termina prima del completamento del processo di esportazione o se il job non va a buon fine, le risorse temporanee come dischi temporanei, istanze VM o bucket di archiviazione potrebbero non essere eliminate. In questo caso, devi eliminare manualmente queste risorse effimere.

Viene creato un bucket Cloud Storage chiamato ${PROJECT}-daisy-bkt-${REGION} per le risorse effimere create durante il processo di esportazione nella stessa regione o multiregione del bucket di destinazione. Per gestire il ciclo di vita di queste risorse, consulta la sezione Gestione del ciclo di vita degli oggetti.

Il processo di esportazione utilizza Cloud Build per esportare un'immagine. Una sessione Cloud Build dura al massimo 24 ore. Se l'immagine è molto grande e l'esportazione richiede più di 24 ore, puoi esportarla manualmente.

Limitazioni dei Controlli di servizio VPC

Per i progetti protetti con Controlli di servizio VPC, utilizza uno dei seguenti metodi:

• esportare dallo stesso progetto in cui si trova l'immagine
• esportare l'immagine manualmente

Esportare un'immagine con un solo comando

Esporta un'immagine in Cloud Storage

Puoi esportare le immagini utilizzando la Google Cloud console, Google Cloud CLI o REST.

gcloud compute images export \
    --destination-uri DESTINATION_URI \
    --image IMAGE_NAME

gcloud compute images export \
    --destination-uri gs://my-bucket/my-image.tar.gz \
    --image my-image \
    --project my-project

POST https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/builds
{
  "timeout": "7200s",
  "steps":[
    {
      "args":[
        "-timeout=7000s",
        "-source_image=SOURCE_IMAGE",
        "-client_id=api",
        "-format=IMAGE_FORMAT",
        "-destination_uri=DESTINATION_URI"
      ],
      "name":"gcr.io/compute-image-tools/gce_vm_image_export:release",
      "env":[
        "BUILD_ID=$BUILD_ID"
      ]
    }
  ],
  "tags":[
    "gce-daisy",
    "gce-daisy-image-export"
  ]
}

{
"name": "operations/build/myproject-12345/operation-1578608233418",
"metadata": {
 "@type": "type.googleapis.com/google.devtools.cloudbuild.v1.BuildOperationMetadata",
 "build": {
  "id": "3a2055bc-ccbd-4101-9434-d376b88b8940",
  "status": "QUEUED",
  "createTime": "2019-10-02T18:59:13.393492020Z",
  "steps": [
   {
    "name": "gcr.io/compute-image-tools/gce_vm_image_export:release",
    "env": [
     "BUILD_ID=3a2055bc-ccbd-4101-9434-d376b88b8940"
    ],
    "args": [
     "-timeout=7056s",
     "-source_image=my-image",
     "-client_id=api",
     "-format=vmdk",
     "-destination_uri=gs://my-bucket/my-exported-image.vmdk"
    ]
   }
  ],
  "timeout": "7200s",
  "projectId": "myproject-12345",
  "logsBucket": "gs://123456.cloudbuild-logs.googleusercontent.com",
  "options": {
   "logging": "LEGACY"
  },
  "logUrl": "https://console.cloud.google.com/cloud-build/builds/3a2055bc-ccbd-4101-9434-d376b88b8940?project=123456"
 }
 }

Esporta un'immagine da un progetto utilizzando un account di servizio Compute Engine personalizzato

Durante l'esportazione di un'immagine, nel tuo progetto viene creata un'istanza di macchina virtuale (VM) temporanea. Lo strumento di esportazione delle immagini su questa VM temporanea deve essere autenticato.

Un service account è un'identità associata a una VM. È possibile accedere ai token di accesso del service account tramite il server di metadati dell'istanza e utilizzarli per autenticare lo strumento di esportazione delle immagini sulla VM.

Per impostazione predefinita, il processo di esportazione utilizza l'agente di servizio Compute Engine predefinito del progetto. Tuttavia, se il account di servizio Compute Engine predefinito è disattivato nel tuo progetto o se vuoi utilizzare un account di servizio Compute Engine personalizzato, devi creare un account di servizio e specificarlo per il processo di esportazione.

Puoi esportare le immagini utilizzando Google Cloud CLI o REST.

gcloud compute images export \
    --destination-uri gs://my-bucket/my-image.tar.gz \
    --image my-image \
    --project my-project \
    --compute-service-account image-export-service-account@proj-12345.iam.gserviceaccount.com
    

Esportare un'immagine utilizzando il VPC condiviso

Prima di esportare un'immagine che utilizza un VPC condiviso, devi aggiungere il ruolo compute.networkUser alaccount di serviziot Cloud Build nel progetto da cui esporti le immagini. Per ulteriori informazioni, consulta Concedere i ruoli richiesti al service account Cloud Build.

Puoi esportare l'immagine utilizzando Google Cloud CLI o REST.

gcloud compute images export \
    --image IMAGE_NAME \
    --destination-uri DESTINATION_URI \
    --project PROJECT_ID \
    --network NETWORK \
    --subnet SUBNET \
    --zone ZONE

gcloud compute images export \
    --image example-image \
    --destination-uri gs://my-bucket/my-image.tar.gz \
    --project my-project \
    --network projects/my-vpc-project/global/networks/my-shared-vpc \
    --subnet projects/my-vpc-project/regions/us-west1/subnetworks/my-custom-subnet \
    --zone us-west1-c
 

Creare ed esportare un'immagine manualmente

Se i comandi gcloud compute images create e gcloud compute images export non soddisfano i tuoi requisiti, puoi creare ed esportare un'immagine manualmente da un'istanza Compute Engine. Questo processo prevede passaggi discreti per creare prima un'immagine e poi esportarla.

Nell'esempio seguente, tieni presente che il disco creato è denominato image-disk.

Per creare ed esportare un'immagine:

1. (Facoltativo) Arresta l'istanza a cui è collegato il disco prima di creare lo snapshot. L'arresto dell'istanza garantisce l'integrità dei contenuti del disco nello snapshot.

2. Crea uno snapshot del disco. Assegna un nome allo snapshot image-snapshot.

   gcloud compute disks snapshot DISK_NAME \
       --snapshot-names image-snapshot

   Sostituisci DISK_NAME con il nome del disco che vuoi utilizzare per creare lo snapshot. Puoi trovare il nome del disco elencando i dischi.

3. Utilizza lo snapshot image-snapshot per creare un nuovo disco denominato image-disk eseguendo il comando seguente:

   gcloud compute disks create image-disk \
       --source-snapshot image-snapshot

4. Crea un disco temporaneo denominato temporary-disk per contenere il file tar e specifica che le dimensioni del disco SIZE siano almeno il 50% più grandi del disco immagine.

   Puoi scollegare ed eliminare il disco in un secondo momento.

   gcloud compute disks create temporary-disk \
       --size SIZE

   dove SIZE è la dimensione, in gigabyte o terabyte, del disco temporaneo. Ad esempio, specifica 100GB per creare un disco da 100 gigabyte.

5. Crea un'istanza e abilita l'ambito storage-rw sull'istanza. Inoltre, collega image-disk e temporary-disk all'istanza come dischi secondari con attributi device-name specifici. Sostituisci VM_NAME con il nome dell'istanza da creare.

   gcloud compute instances create VM_NAME \
       --scopes storage-rw \
       --disk name=image-disk,device-name=image-disk \
       --disk name=temporary-disk,device-name=temporary-disk

   Tieni presente che stai trasmettendo gli ambiti del account di servizio in modo da poter caricare il file in Cloud Storage nei passaggi successivi.

   Se necessario, esamina i dettagli relativi all'avvio di una nuova istanza.

6. Connettiti all'istanza. Sostituisci VM_NAME con il nome dell'istanza a cui connetterti.

   gcloud compute ssh VM_NAME

7. Formatta e monta il disco temporaneo. La formattazione del disco elimina i contenuti del disco temporaneo.

   sudo mkdir /mnt/tmp

   sudo mkfs.ext4 -F /dev/disk/by-id/google-temporary-disk

   sudo mount -o discard,defaults /dev/disk/by-id/google-temporary-disk /mnt/tmp

8. (Facoltativo) Monta il disco dell'immagine e apporta modifiche aggiuntive prima di creare il file tar. Ad esempio, potresti voler eliminare tutti i file esistenti dalla directory /home se non vuoi che facciano parte dell'immagine. Monta le partizioni del disco che devi modificare, modifica i file sul disco che devi cambiare e poi smonta il disco al termine dell'operazione.

   1. Crea una directory in cui puoi montare il disco o la partizione.

      sudo mkdir /mnt/image-disk

   2. Utilizza il comando ls per determinare quale disco o partizione del disco devi montare.

      ls /dev/disk/by-id/

      Il comando stampa un elenco di ID disco e partizioni. Ad esempio, il seguente disco ha una tabella delle partizioni con una partizione. L'ID google-image-disk punta al disco completo da cui vuoi creare un'immagine. L'ID google-image-disk-part1 punta alla prima partizione di questo disco. Monta la partizione se devi apportare modifiche al disco, quindi crea l'immagine dal disco completo.

      google-image-disk
      google-image-disk-part1
      

   3. Monta il disco o la partizione. Se il disco ha una tabella di partizione, monta le singole partizioni del disco. Ad esempio, monta google-image-disk-part1.

      sudo mount /dev/disk/by-id/google-image-disk-part1 /mnt/image-disk

      In alternativa, se il disco è formattato in formato non elaborato senza tabella delle partizioni, monta l'intero disco google-image-disk.

      sudo mount /dev/disk/by-id/google-image-disk /mnt/image-disk

   4. Modifica i file nella directory /mnt/image-disk per configurare i file sul disco. Ad esempio, potresti rimuovere il file /mnt/image-disk/home/[USER]/.ssh/authorized_keys per impedire la condivisione delle tue chiavi SSH.

   5. Dopo aver terminato la modifica dei file, smonta il disco.

      sudo umount /mnt/image-disk/

9. Crea un file tar dell'immagine.

   Al termine della personalizzazione dei file sul disco immagine, crea un file di disco non elaborato sul disco temporaneo. Il nome dell'immagine del disco non elaborata deve essere "disk.raw":

    sudo dd if=/dev/disk/by-id/google-image-disk of=/mnt/tmp/disk.raw bs=4096

   Quindi, crea il file tar.gz:

   cd /mnt/tmp

   sudo tar czvf myimage.tar.gz disk.raw

   Questo comando crea un'immagine dell'istanza nella seguente posizione:

   /mnt/tmp/myimage.tar.gz

10. Carica l'immagine in Cloud Storage.

    Per caricare il file tar su Cloud Storage, utilizza Google Cloud CLI preinstallata sulla tua istanza.

    1. Crea un bucket utilizzando gcloud CLI.

       Prima di creare il bucket, assicurati di esaminare le linee guida per la denominazione di bucket e oggetti. Quindi, crea il bucket utilizzando il seguente comando. Sostituisci BUCKET_NAME con il nome del bucket da creare.

       me@example-instance:~$ 
       gcloud storage buckets create gs://BUCKET_NAME

    2. Copia il file nel nuovo bucket. Sostituisci BUCKET_NAME con il nome del bucket in cui copiare il file.

       me@example-instance:~$ 
       gcloud storage cp /mnt/tmp/myimage.tar.gz gs://BUCKET_NAME

Hai esportato il file in Cloud Storage. Ora puoi condividere l'immagine con altre persone o utilizzare il file tar per aggiungere una nuova immagine a un progetto della consoleGoogle Cloud .

Passaggi successivi

• Condividere immagini utilizzando il ruolo utente Immagine.
• Scopri di più sui metodi di importazione disponibili per Compute Engine.