Bertransisi dari gcutil ke gcloud compute

Dengan gcloud compute dalam Ketersediaan Umum, Compute Engine merekomendasikan agar semua pengguna beralih ke alat gcloud compute dari gcutil. gcloud compute adalah alat command line terpadu yang memiliki sejumlah peningkatan dibandingkan gcutil, termasuk:

  • Pelengkapan tab
  • Upgrade langsung
  • Bantuan dengan format buku manual yang ekstensif
  • Pilihan format output yang berbeda

Untuk membantu pengguna bertransisi dari gcutil ke gcloud compute, panduan ini menjelaskan secara singkat perubahan utama antara kedua alat tersebut. Untuk deskripsi mendetail alat gcloud compute, lihat dokumentasi gcloud compute.

Perintah gcloud baru

Semua perintah gcutil yang ada memiliki perintah yang setara di alat gcloud compute, dengan beberapa pengecualian. Anda bisa mendapatkan daftar lengkap perintah gcloud dengan mengunjungi halaman referensi atau dengan menjalankan gcloud compute --help. Tabel di bawah ini menguraikan secara singkat perubahan dari perintah gcutil populer.

perintah gcutil perintah gcloud compute 
gcutil addinstance INSTANCE
 
gcloud compute instances create INSTANCE
Catatan

Membuat instance.

  • Zona/region default dapat ditetapkan. Jika tidak, `gcloud compute` akan menanyakan zona/region.
  • Membuat mesin virtual dengan properti default, seperti:
    • machine-type: n1-standard-1
    • gambar: debian-10

Lihat Membuat dan memulai instance.

perintah gcutil perintah gcloud compute 
gcutil deleteinstance INSTANCE
 
gcloud compute instances delete INSTANCE \
       [--keep-disks {boot,all,none}]
Catatan

Menghapus instance. Lihat Menghapus instance.
perintah gcutil perintah gcloud compute 
gcutil ... --cache_flag_values
 
gcloud configs set project PROJECT
gcloud configs set compute/zone ZONE
gcloud configs set compute/region REGION
Catatan

Menetapkan nilai default untuk project, zona, dan region. Lihat Menetapkan zona dan region default.
perintah gcutil perintah gcloud compute 
gcutil push/pull
 
gcloud compute scp
Catatan

Menyalin file antara komputer lokal dan mesin virtual. Lihat Mentransfer file menggunakan Google Cloud CLI.
perintah gcutil perintah gcloud compute 
gcutil deleteRESOURCE
 
gcloud compute RESOURCES delete
Catatan

Menghapus resource, misalnya: 

gcloud compute instances delete example-instance
perintah gcutil perintah gcloud compute 
gcutil getRESOURCES
 
gcloud compute RESOURCES describe
Catatan

Menjelaskan satu resource, misalnya: 

gcloud compute instances describe example-instance
perintah gcutil perintah gcloud compute 
gcutil listRESOURCES
 
gcloud compute RESOURCES list
Catatan

Mencantumkan semua resource dari jenis tersebut. Misalnya, untuk membuat daftar instance: 

gcloud compute instances list
perintah gcutil perintah gcloud compute 
gcutil setmetadata
 
gcloud compute instances add-metadata
gcloud compute instances remove-metadata
gcloud compute project-info add-metadata
gcloud compute project-info remove-metadata
Catatan

Penguncian optimistis kini dilakukan oleh alat, sehingga tidak perlu menentukan sidik jari secara manual. Baca bagian Menyetel metadata instance kustom.
perintah gcutil perintah gcloud compute 
gcutil … --dump_request_response

Belum tersedia.
perintah gcutil perintah gcloud compute 
gcutil … --log_level=DEBUG
 
gcloud … --verbosity debug
Catatan

Selain itu, log disimpan dalam file untuk setiap perintah di ~/.config/gcloud/logs.
perintah gcutil perintah gcloud compute 
gcutil ssh INSTANCE --ssh_user
 
gcloud compute ssh USER@INSTANCE
Catatan

Lihat Menghubungkan ke Instance.
perintah gcutil perintah gcloud compute 
gcutil … \
--image=projects/project-id/global/images/image

gcloud compute … --image image-name \
       --image-project image-project
Catatan

Lihat Memulai instance dari gambar.
perintah gcutil perintah gcloud compute 
gcutil deleteinstances --[no]delete_pd
gcutil deleteinstances --[no]delete_boot_pd

gcloud compute instances delete … \
       --delete-disks {all,none,boot}
gcloud compute instances delete … \
       --keep-disks {all,none,boot}
Catatan

Jika disk ditandai sebagai dihapus secara otomatis, disk tersebut akan otomatis dihapus kecuali jika ditentukan menggunakan flag --keep-disks.

Setelan instance default

Pembuatan instance di gcloud compute kini memiliki beberapa nilai default yang disediakan untuk jenis image dan mesin untuk VM Anda. Anda dapat memilih untuk menggunakan nilai default ini dengan menghilangkan tanda --image dan --machine-type, atau Anda dapat mengganti setelan dengan memberikan tanda yang sesuai. Setelan virtual machine default-nya adalah:

  • Gambar default: gambar debian-10 terbaru
  • Jenis mesin default: n1-standard-1

Misalnya, Anda cukup menjalankan:

gcloud compute instances create example-instance --zone us-central1-a

Dan gcloud compute akan membuat instance menggunakan image dan jenis mesin yang dijelaskan di atas.

Pemformatan output

Format output default telah berubah dan berbeda, bergantung pada perintah yang Anda jalankan. Misalnya, jika Anda menjalankan perintah describe untuk mendapatkan informasi tentang satu resource, output responsnya akan menggunakan format YAML. Anda dapat menampilkan respons dalam berbagai format output, seperti JSON atau teks, menggunakan flag --format:

gcloud compute instances list --format {json,yaml,text}

Memperbarui metadata kini bersifat tambahan

Saat menyetel atau memperbarui metadata, Anda tidak perlu lagi memberikan sidik jari. Secara default, semua perubahan metadata dianggap sebagai tambahan. Anda dapat menambahkan satu entri metadata atau mengupdate entri tanpa perlu melakukan update massal untuk semua metadata. Hanya kunci metadata yang diteruskan yang akan berubah.

gcloud compute instances add-metadata example-instance \
         --metadata cookies=chocolate

Menentukan project image

Sebelumnya, untuk menentukan image yang tepat, Anda perlu memberikan URI image parsial yang menyertakan nama project, seperti berikut:

gcutil addinstance example-instance \
         --image=projects/debian-cloud/global/images/debian-9

Di gcloud compute, sekarang Anda harus menentukan project image menggunakan flag --image-project baru:

gcloud compute instances create example-instance \
         --image debian-9-stretch-vYYYMMDD
         --image-project debian-cloud

Anda juga dapat memberikan URI lengkap:

gcloud compute instances create example-instance \
         --image https://compute.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-9-stretch-vYYYMMDD