Exportar uma imagem personalizada para o Cloud Storage

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Se precisar mover os dados do disco de inicialização do Compute Engine para fora do projeto do Compute Engine, você poderá exportar uma imagem do disco de inicialização para o Cloud Storage como um arquivo tar.gz Se você precisar criar uma imagem de disco permanente para usar ao criar novos discos permanentes no Compute Engine, leia Como criar uma imagem personalizada .

Você pode fazer backup ou compartilhar uma imagem personalizada exportando-a para o Cloud Storage. Este método é ideal para compartilhar imagens individuais com projetos que não têm acesso às suas imagens. Como alternativa, você pode compartilhar imagens concedendo o papel de usuário de imagem do Compute Engine na imagem ou no projeto que a contém.

O diagrama a seguir mostra alguns fluxos de trabalho típicos para a criação e reutilização de uma imagem personalizada.

Antes de começar

• Leia a página de imagens .
• Se o projeto do qual você deseja exportar a imagem tiver uma política de imagem confiável definida, adicione projects/compute-image-import e projects/compute-image-tools à lista permitida de editores.
• Para saber como atender aos requisitos antes de exportar imagens, consulte Pré-requisitos para importar e exportar imagens de VM .
• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  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

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para 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.

  Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Limitações e restrições

As seguintes limitações são aplicáveis ​​ao processo de exportação de imagens.

Limitações gerais

Ao exportar uma imagem, uma sessão é criada na máquina da qual você está exportando a imagem. Esta sessão precisa permanecer ativa até que o processo de exportação seja concluído. Se a sessão terminar antes da conclusão do processo de exportação, recursos temporários, como discos temporários, instâncias de VM ou buckets de armazenamento, poderão não ser excluídos. Nesse caso, você deverá excluir esses recursos efêmeros manualmente.

O processo de exportação usa o Cloud Build para exportar uma imagem. Uma sessão do Cloud Build dura no máximo 24 horas. Se a sua imagem for muito grande e precisar de mais de 24 horas para ser exportada, você poderá exportar a imagem manualmente .

Limitações do VPC Service Controls

Para projetos protegidos com VPC Service Controls , use um dos seguintes métodos:

• exportar do mesmo projeto onde a imagem reside
• exportar a imagem manualmente

Exporte uma imagem com um único comando

Exportar uma imagem para o Cloud Storage

Você pode exportar suas imagens usando o console do Google Cloud , a CLI do Google Cloud ou 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"
 }
 }

Exportar uma imagem de um projeto usando uma conta de serviço personalizada do Compute Engine

Durante uma exportação de imagem, uma instância temporária de máquina virtual (VM) é criada em seu projeto. A ferramenta de exportação de imagens nesta VM temporária deve ser autenticada.

Uma conta de serviço é uma identidade anexada a uma VM. Os tokens de acesso à conta de serviço podem ser acessados ​​por meio do servidor de metadados da instância e usados ​​para autenticar a ferramenta de exportação de imagens na VM.

Por padrão, o processo de exportação usa o Compute Engine Service Agent padrão do projeto. No entanto, se a conta de serviço padrão do Compute Engine estiver desativada no seu projeto ou se você quiser usar uma conta de serviço personalizada do Compute Engine, será necessário criar uma conta de serviço e especificá-la para o processo de exportação.

Você pode exportar suas imagens usando a CLI do Google Cloud ou 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
    

Exportar uma imagem usando VPC compartilhada

Antes de exportar uma imagem que usa uma VPC compartilhada, você deve adicionar a função compute.networkUser à conta de serviço do Cloud Build. Para obter mais informações, consulte Conceder papéis necessários à conta de serviço do Cloud Build .

Você pode exportar sua imagem usando a CLI do Google Cloud ou 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
 

Crie e exporte uma imagem manualmente

Se os comandos gcloud compute images create e gcloud compute images export não atenderem aos seus requisitos, você poderá criar e exportar uma imagem manualmente de uma instância do Compute Engine. Este processo possui etapas discretas para primeiro criar uma imagem e depois exportá-la.

No exemplo a seguir, observe que o disco criado é chamado image-disk .

Para criar e exportar uma imagem:

1. Opcional: Pare a instância à qual o disco está conectado antes de criar a captura instantânea. A interrupção da instância garante a integridade do conteúdo do disco no snapshot.

2. Crie um instantâneo do disco. Nomeie o instantâneo image-snapshot .

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

   Substitua DISK_NAME pelo nome do disco que você deseja usar para criar o instantâneo. Você pode encontrar o nome do disco listando disks .

3. Use o instantâneo image-snapshot para criar um novo disco denominado image-disk executando o seguinte comando:

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

4. Crie um disco temporário denominado temporary-disk para armazenar seu arquivo tar e especifique o SIZE do disco para ser pelo menos 50% maior que o disco de imagem.

   Você pode desconectar e excluir o disco posteriormente.

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

   onde SIZE é o tamanho, em gigabytes ou terabytes, do disco temporário. Por exemplo, especifique 100GB para criar um disco de 100 gigabytes.

5. Crie uma instância e habilite o escopo storage-rw na instância. Além disso, anexe o image-disk e o temporary-disk à instância como discos secundários com atributos específicos device-name . Substitua VM_NAME pelo nome da instância a ser criada.

   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

   Observe que você está transmitindo escopos de conta de serviço para poder fazer upload do arquivo para o Cloud Storage em etapas posteriores.

   Revise os detalhes sobre como iniciar uma nova instância, se necessário.

6. Conecte-se à sua instância . Substitua VM_NAME pelo nome da instância à qual se conectar.

   gcloud compute ssh VM_NAME

7. Formate e monte o disco temporário. A formatação do disco exclui o conteúdo do disco temporário.

   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. Opcional: monte o disco de imagem e faça alterações adicionais antes de criar o arquivo tar . Por exemplo, você pode querer excluir quaisquer arquivos existentes do diretório /home se não quiser que eles façam parte da sua imagem. Monte as partições do disco que você precisa modificar, modifique os arquivos no disco que você precisa alterar e desmonte o disco quando terminar.

   1. Crie um diretório onde você possa montar seu disco ou partição.

      sudo mkdir /mnt/image-disk

   2. Use o comando ls para determinar qual disco ou partição de disco você precisa montar.

      ls /dev/disk/by-id/

      O comando imprime uma lista de IDs de disco e partições. Por exemplo, o disco a seguir possui uma tabela de partição com uma partição. O ID google-image-disk aponta para o disco completo a partir do qual você deseja criar uma imagem. O ID google-image-disk-part1 aponta para a primeira partição deste disco. Monte a partição se precisar fazer alterações no disco e crie a imagem do disco completo.

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

   3. Monte o disco ou partição. Se o seu disco tiver uma tabela de partições, monte as partições individuais do seu disco. Por exemplo, monte google-image-disk-part1 .

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

      Alternativamente, se o seu disco estiver formatado sem tabela de partição, monte o disco google-image-disk completo.

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

   4. Modifique os arquivos no diretório /mnt/image-disk para configurar os arquivos no disco. Por exemplo, você pode remover o arquivo /mnt/image-disk/home/[USER]/.ssh/authorized_keys para proteger suas chaves SSH de serem compartilhadas.

   5. Depois de terminar de modificar os arquivos, desmonte o disco.

      sudo umount /mnt/image-disk/

9. Crie um arquivo tar da sua imagem.

   Ao terminar de personalizar os arquivos no disco de imagem, crie um arquivo de disco bruto em seu disco temporário. O nome da imagem de disco bruta deve ser 'disk.raw':

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

   Em seguida, crie o arquivo tar.gz :

   cd /mnt/tmp

   sudo tar czvf myimage.tar.gz disk.raw

   Este comando cria uma imagem da instância no seguinte local:

   /mnt/tmp/myimage.tar.gz

10. Faça upload da imagem no Cloud Storage.

    Para fazer upload do arquivo tar para o Cloud Storage, use a CLI do Google Cloud que vem pré-instalada na sua instância.

    1. Crie um bucket usando a CLI gcloud.

       Certifique-se de revisar as diretrizes de nomenclatura de bucket e objeto antes de criar seu bucket. Em seguida, crie seu bucket usando o comando a seguir. Substitua BUCKET_NAME pelo nome do bucket a ser criado.

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

    2. Copie seu arquivo para seu novo bucket. Substitua BUCKET_NAME pelo nome do bucket para o qual copiar o arquivo.

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

Você exportou seu arquivo para o Cloud Storage. Agora você pode compartilhar a imagem com outras pessoas ou usar o arquivo tar para adicionar uma nova imagem a um projeto do console do Google Cloud.

O que vem a seguir

• Compartilhe imagens usando a função de usuário de imagem .
• Saiba mais sobre os métodos de importação disponíveis para o Compute Engine.