Mengekspor image kustom ke Cloud Storage

Jika harus memindahkan data disk boot Compute Engine ke luar project Compute Engine, Anda dapat mengekspor image disk boot ke Cloud Storage sebagai file tar.gz. Jika Anda perlu membuat image persistent disk untuk digunakan saat membuat persistent disk baru di Compute Engine, baca Membuat image kustom.

Anda dapat mencadangkan atau membagikan image kustom dengan mengekspor image ke Cloud Storage. Metode ini ideal untuk membagikan gambar individual ke project yang tidak memiliki akses ke gambar Anda. Atau, Anda dapat membagikan image dengan memberikan peran pengguna image Compute Engine pada image atau project yang berisi image tersebut.

Diagram berikut menunjukkan beberapa alur kerja umum untuk pembuatan dan penggunaan ulang image kustom.

Sebelum memulai

• Baca halaman gambar.
• Jika project tempat Anda ingin mengekspor image memiliki kebijakan image tepercaya yang telah ditentukan, tambahkan projects/compute-image-import dan projects/compute-image-tools ke daftar penayang yang diizinkan.
• Untuk mengetahui cara memenuhi persyaratan sebelum mengekspor image, lihat Prasyarat untuk mengimpor dan mengekspor image VM.
• Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
  

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

  Console

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

  gcloud

  1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

     gcloud init

  2. Set a default region and zone.

  REST

  Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

  Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

  gcloud init

  Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .

Pembatasan dan batasan

Batasan berikut berlaku untuk proses ekspor gambar.

Batasan umum

Saat Anda mengekspor gambar, sesi akan dibuat di mesin tempat Anda mengekspor gambar. Sesi ini harus tetap aktif hingga proses pengeksporan selesai. Jika sesi berakhir sebelum proses ekspor selesai, atau jika tugas gagal, resource sementara seperti disk sementara, instance VM, atau bucket penyimpanan mungkin tidak akan dihapus. Dalam hal ini, Anda harus menghapus resource sementara ini secara manual.

Bucket Cloud Storage bernama ${PROJECT}-daisy-bkt-${REGION} dibuat untuk resource sementara yang dibuat selama proses ekspor di region atau multi-region yang sama dengan bucket target. Untuk mengelola siklus proses resource ini, lihat Object lifecycle management.

Proses ekspor menggunakan Cloud Build untuk mengekspor image. Sesi Cloud Build berlangsung maksimal selama 24 jam. Jika gambar Anda sangat besar dan memerlukan waktu lebih dari 24 jam untuk diekspor, Anda dapat mengekspor gambar secara manual.

Batasan Kontrol Layanan VPC

Untuk project yang dilindungi dengan Kontrol Layanan VPC, gunakan salah satu metode berikut:

• mengekspor dari project yang sama dengan tempat gambar berada
• mengekspor gambar secara manual

Mengekspor gambar dengan satu perintah

Mengekspor gambar ke Cloud Storage

Anda dapat mengekspor image menggunakan Trusted Cloud konsol, Google Cloud CLI, atau 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"
 }
 }

Mengekspor image dari project menggunakan akun layanan Compute Engine kustom

Selama proses ekspor image, instance virtual machine (VM) sementara akan dibuat di project Anda. Alat ekspor image pada VM sementara ini harus diautentikasi.

Akun layanan adalah identitas yang terpasang pada VM. Token akses akun layanan dapat diakses melalui server metadata instance dan digunakan untuk mengautentikasi alat ekspor image pada VM.

Secara default, proses ekspor menggunakan Agen Layanan Compute Engine default project. Namun, jika akun layanan Compute Engine default dinonaktifkan di project Anda atau jika ingin menggunakan akun layanan Compute Engine kustom, Anda harus membuat akun layanan dan menentukannya untuk proses ekspor.

Anda dapat mengekspor image menggunakan Google Cloud CLI atau 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.s3ns-system.iam.gserviceaccount.com
    

Mengekspor image menggunakan VPC Bersama

Sebelum mengekspor image yang menggunakan VPC bersama, Anda harus menambahkan peran compute.networkUser ke akun layanan Cloud Build di project tempat Anda mengekspor image. Akun layanan yang digunakan untuk Cloud Build bergantung pada apakah Anda menggunakan Cloud Build di project sebelum Mei 2024. Jika ya, akun layanan Cloud Build lama akan digunakan untuk build mendatang. Jika tidak, akun layanan Compute Engine default akan digunakan.

Untuk mengetahui informasi selengkapnya, lihat Memberikan peran yang diperlukan ke akun layanan Cloud Build.

Anda dapat mengekspor image menggunakan Google Cloud CLI atau 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
 

Membuat dan mengekspor gambar secara manual

Jika perintah gcloud compute images create dan gcloud compute images export tidak memenuhi persyaratan, Anda dapat membuat dan mengekspor image secara manual dari instance Compute Engine. Proses ini memiliki langkah-langkah terpisah untuk membuat gambar terlebih dahulu, lalu mengekspor gambar.

Dalam contoh berikut, perhatikan bahwa disk yang dibuat disebut image-disk.

Untuk membuat dan mengekspor gambar:

1. Opsional: Hentikan instance yang disknya terpasang sebelum Anda membuat snapshot. Menghentikan instance memastikan integritas konten disk dalam snapshot.

2. Buat snapshot disk. Beri nama snapshot image-snapshot.

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

   Ganti DISK_NAME dengan nama disk yang ingin Anda gunakan untuk membuat snapshot. Anda dapat menemukan nama disk dengan mencantumkan disk.

3. Gunakan snapshot image-snapshot untuk membuat disk baru bernama image-disk dengan menjalankan perintah berikut:

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

4. Buat disk sementara bernama temporary-disk untuk menyimpan file tar, dan tentukan SIZE disk agar setidaknya 50% lebih besar dari disk image.

   Anda dapat melepaskan dan menghapus disk setelahnya.

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

   dengan SIZE adalah ukuran, dalam gigabyte atau terabyte, dari disk sementara. Misalnya, tentukan 100GB untuk membuat disk 100 gigabyte.

5. Buat instance dan aktifkan cakupan storage-rw pada instance. Selain itu, pasang image-disk dan temporary-disk ke instance sebagai disk sekunder dengan atribut device-name tertentu. Ganti VM_NAME dengan nama instance yang akan dibuat.

   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

   Perhatikan bahwa Anda meneruskan cakupan akun layanan sehingga Anda dapat mengupload file ke Cloud Storage pada langkah-langkah berikutnya.

   Tinjau detail tentang memulai instance baru jika diperlukan.

6. Terhubung ke instance. Ganti VM_NAME dengan nama instance yang akan dihubungkan.

   gcloud compute ssh VM_NAME

7. Memformat dan memasang disk sementara. Memformat disk akan menghapus konten disk sementara.

   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. Opsional: Pasang disk image dan lakukan perubahan tambahan sebelum Anda membuat file tar. Misalnya, Anda mungkin ingin menghapus file yang ada dari direktori /home jika Anda tidak ingin file tersebut menjadi bagian dari gambar Anda. Pasang partisi disk yang perlu Anda ubah, ubah file di disk yang perlu Anda ubah, lalu lepaskan disk setelah selesai.

   1. Buat direktori tempat Anda dapat memasang disk atau partisi.

      sudo mkdir /mnt/image-disk

   2. Gunakan perintah ls untuk menentukan disk atau partisi disk yang perlu Anda pasang.

      ls /dev/disk/by-id/

      Perintah ini akan mencetak daftar ID dan partisi disk. Misalnya, disk berikut memiliki tabel partisi dengan satu partisi. ID google-image-disk mengarah ke disk lengkap tempat Anda ingin membuat image. ID google-image-disk-part1 mengarah ke partisi pertama pada disk ini. Pasang partisi jika Anda perlu membuat perubahan pada disk, lalu buat image dari disk penuh.

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

   3. Pasang disk atau partisi. Jika disk Anda memiliki tabel partisi, pasang partisi individual untuk disk Anda. Misalnya, pasang google-image-disk-part1.

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

      Atau, jika disk Anda diformat mentah tanpa tabel partisi, pasang disk google-image-disk penuh.

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

   4. Ubah file di direktori /mnt/image-disk untuk mengonfigurasi file di disk. Misalnya, Anda dapat menghapus file /mnt/image-disk/home/[USER]/.ssh/authorized_keys untuk melindungi kunci SSH Anda agar tidak dibagikan.

   5. Setelah selesai mengubah file, lepaskan disk.

      sudo umount /mnt/image-disk/

9. Buat file tar dari gambar Anda.

   Setelah selesai menyesuaikan file di disk image, buat file disk mentah di disk sementara Anda. Nama image disk mentah harus 'disk.raw':

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

   Kemudian, buat file tar.gz:

   cd /mnt/tmp

   sudo tar czvf myimage.tar.gz disk.raw

   Perintah ini akan membuat image instance di lokasi berikut:

   /mnt/tmp/myimage.tar.gz

10. Upload gambar ke Cloud Storage.

    Untuk mengupload file tar ke Cloud Storage, gunakan Google Cloud CLI yang sudah diinstal sebelumnya di instance Anda.

    1. Buat bucket menggunakan gcloud CLI.

       Pastikan untuk meninjau pedoman penamaan bucket dan objek sebelum Anda membuat bucket. Kemudian, buat bucket menggunakan perintah berikut. Ganti BUCKET_NAME dengan nama bucket yang akan dibuat.

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

    2. Salin file Anda ke bucket baru. Ganti BUCKET_NAME dengan nama bucket tempat file akan disalin.

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

Anda telah mengekspor file ke Cloud Storage. Sekarang Anda dapat membagikan gambar tersebut kepada orang lain, atau menggunakan file tar untuk menambahkan gambar baru ke project konsolTrusted Cloud .

Langkah berikutnya

• Membagikan gambar menggunakan peran pengguna gambar.
• Pelajari metode impor yang tersedia untuk Compute Engine.