Perintah komputasi gcloud umum

Dokumen ini mencantumkan beberapa perintah gcloud compute yang paling umum digunakan.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

Mendeskripsikan project

Jalankan perintah berikut untuk membuat kueri informasi tentang project Compute Engine Anda, seperti metadata project, kunci SSH, dan metrik kuota:

 gcloud compute project-info describe

Untuk informasi selengkapnya tentang cara mendeskripsikan project Anda, lihat dokumentasi referensi gcloud compute project-info describe.

Bekerja dengan VM

Contoh berikut menunjukkan tugas umum saat bekerja dengan instance mesin virtual (VM). Untuk informasi selengkapnya tentang instance mesin virtual (VM), lihat Instance mesin virtual.

Membuat VM

Jalankan perintah berikut untuk membuat VM:

gcloud compute instances create VM_NAME \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    --image-project IMAGE_PROJECT

Ganti kode berikut:

  • VM_NAME: nama VM baru.
  • IMAGE atau IMAGE_FAMILY: Tentukan salah satu opsi berikut:
    • IMAGE: versi image publik yang diperlukan. Contoh, --image debian-10-buster-v20200309.
    • IMAGE_FAMILY: kelompok gambar. Tindakan ini akan membuat VM dari image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukan --image-family debian-10, Compute Engine akan membuat VM dari versi image OS terbaru dalam kelompok image Debian 10.
  • IMAGE_PROJECT: project yang berisi image.

Untuk informasi selengkapnya tentang cara membuat VM, baca Membuat dan memulai instance VM serta dokumentasi referensi gcloud compute instances create.

Mencantumkan VM

Jalankan perintah berikut untuk menampilkan semua VM dalam satu project:

gcloud compute instances list

Untuk informasi selengkapnya tentang mencantumkan VM, baca dokumentasi referensi gcloud compute instances list.

Mencantumkan VM dengan GPU

Jalankan perintah berikut untuk menampilkan semua VM dengan GPU dalam sebuah project:

gcloud compute instances list --filter="guestAccelerators.acceleratorCount>0" --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Mencantumkan VM dengan SSD lokal

Jalankan perintah berikut untuk menampilkan semua VM dengan SSD lokal dalam sebuah project:

gcloud compute instances list  --filter="disks.type='SCRATCH'"  --format="table(name,zone,guestAccelerators.acceleratorType,guestAccelerators.acceleratorCount,disks.type)"

Mendeskripsikan VM

Jalankan perintah berikut untuk menampilkan semua data yang terkait dengan VM:

gcloud compute instances describe VM_NAME

Ganti VM_NAME dengan nama VM.

Untuk informasi selengkapnya tentang cara mendeskripsikan VM, baca dokumentasi referensi gcloud compute instances describe.

Memulai VM

Jalankan perintah berikut untuk memulai VM yang dihentikan:

gcloud compute instances start VM_NAME

Ganti VM_NAME dengan nama VM.

Untuk informasi selengkapnya tentang memulai VM, lihat Memulai dan menghentikan instance dan dokumentasi referensi gcloud compute instances start.

Menghentikan VM

Jalankan perintah berikut untuk menghentikan VM:

gcloud compute instances stop VM_NAME

Ganti VM_NAME dengan nama VM.

Untuk informasi selengkapnya tentang cara menghentikan VM, baca bagian Memulai dan menghentikan instance serta dokumentasi referensi gcloud compute instances stop.

Menambahkan label ke VM

Jalankan perintah berikut untuk menambahkan label ke VM:

gcloud compute instances add-labels VM_NAME \
    --labels=KEY=VALUE

Ganti kode berikut:

  • VM_NAME: nama VM.
  • KEY=VALUE: pasangan nilai kunci label.

Untuk informasi selengkapnya tentang pelabelan VM, lihat Resource pelabelan dan dokumentasi referensi gcloud compute instances add-labels.

Menghubungkan ke VM

Menggunakan SSH untuk terhubung ke instance

Jalankan perintah berikut agar terhubung ke VM menggunakan SSH:

gcloud compute ssh VM_NAME

Ganti VM_NAME dengan nama VM.

Untuk informasi selengkapnya tentang cara menghubungkan ke VM menggunakan SSH, baca Menghubungkan ke VM Linux dan dokumentasi referensi gcloud compute ssh.

Menggunakan SCP untuk mentransfer file ke instance

Jalankan perintah berikut untuk menyalin file ke VM:

gcloud compute scp LOCAL_FILE_PATH VM_NAME:REMOTE_DIRECTORY

Jalankan perintah berikut untuk menyalin file dari VM:

gcloud compute scp VM_NAME:REMOTE_DIRECTORY LOCAL_FILE_PATH

Ganti kode berikut:

  • LOCAL_FILE_PATH: Jalur ke file di workstation Anda.
  • VM_NAME: Nama VM Anda.
  • REMOTE_DIRECTORY: Jalur ke direktori di VM Anda.

Untuk informasi selengkapnya tentang cara mentransfer file ke dan dari VM menggunakan SCP, baca artikel Mentransfer file menggunakan Google Cloud CLI dan gcloud compute scp dokumentasi referensi.

Bekerja dengan disk

Contoh berikut menunjukkan tugas umum saat bekerja dengan disk. Untuk informasi selengkapnya tentang disk, lihat Opsi penyimpanan.

Mencantumkan disk

Jalankan perintah berikut untuk menampilkan semua disk dalam sebuah project:

gcloud compute disks list

Untuk informasi selengkapnya tentang mencantumkan disk, lihat dokumentasi referensi gcloud compute disks list.

Menangani snapshot

Contoh berikut menunjukkan tugas umum saat menggunakan snapshot. Untuk informasi selengkapnya tentang snapshot, lihat Snapshot persistent disk.

Snapshot listingan

Jalankan perintah berikut untuk menampilkan semua snapshot dalam sebuah project:

gcloud compute snapshots list

Untuk informasi selengkapnya tentang cara mendeskripsikan snapshot, lihat dokumentasi referensi gcloud compute snapshots list.

Mendeskripsikan snapshot

Jalankan perintah berikut untuk menampilkan semua data yang terkait dengan snapshot:

gcloud compute snapshots describe SNAPSHOT_NAME

Ganti SNAPSHOT_NAME dengan nama snapshot.

Untuk informasi selengkapnya tentang cara mendeskripsikan snapshot, lihat dokumentasi referensi gcloud compute snapshots describe.

Menghapus snapshot

Jalankan perintah berikut untuk menghapus snapshot:

gcloud compute snapshots delete SNAPSHOT_NAME

Ganti SNAPSHOT_NAME dengan nama snapshot.

Untuk informasi selengkapnya tentang cara menghapus snapshot, lihat Menghapus snapshot dan dokumentasi referensi gcloud compute snapshots delete.

Bekerja dengan aturan firewall

Contoh berikut menunjukkan tugas umum saat menggunakan aturan firewall. Untuk informasi selengkapnya tentang aturan firewall, lihat Ringkasan aturan firewall VPC.

Menjelaskan aturan firewall

Jalankan perintah berikut untuk menampilkan semua data yang terkait dengan aturan firewall:

gcloud compute firewall-rules describe FIREWALL_RULE_NAME

Ganti FIREWALL_RULE_NAME dengan nama aturan firewall.

Untuk informasi selengkapnya tentang cara menjelaskan aturan firewall, lihat dokumentasi referensi gcloud compute firewall-rules describe.

Membuat aturan firewall

Jalankan perintah berikut untuk membuat aturan firewall:

gcloud compute firewall-rules create FIREWALL_RULE_NAME \
    [--allow=PROTOCOL:PORT | --action=ACTION --rules=PROTOCOL:PORT]

Tentukan --allow atau --action dan --rules, lalu ganti:

  • FIREWALL_RULE_NAME: nama aturan firewall.
  • ACTION: tindakan saat mencocokkan. Berupa allow atau deny.
  • PROTOCOL:PORT: protokol dan port yang traffic-nya akan terpengaruh oleh aturan firewall.

Untuk informasi selengkapnya tentang cara membuat aturan firewall, lihat Membuat aturan firewall dan dokumentasi referensi gcloud compute firewall-rules create.

Bekerja dengan grup instance terkelola (MIG)

Contoh berikut menunjukkan tugas umum saat bekerja dengan MIG. Untuk informasi selengkapnya tentang MIG, lihat Grup instance terkelola (MIG).

Membuat grup instance terkelola

Jalankan perintah berikut untuk membuat MIG:

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --size=SIZE \
    --template=INSTANCE_TEMPLATE

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama untuk grup instance ini
  • SIZE: ukuran grup instance
  • INSTANCE_TEMPLATE: nama template instance yang akan digunakan untuk grup ini

Untuk informasi selengkapnya tentang cara membuat MIG, lihat Skenario dasar untuk membuat MIG dan dokumentasi referensi gcloud compute instance-groups managed create.

Menyetel penskalaan otomatis

Jalankan perintah berikut untuk menyetel penskalaan otomatis pada MIG, berdasarkan pemakaian CPU:

gcloud compute instance-groups managed set-autoscaling INSTANCE_GROUP_NAME \
    --max-num-replicas=MAX_NUM_REPLICAS \
    --target-cpu-utilization=TARGET_CPU_UTILIZATION

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama MIG
  • MAX_NUM_REPLICAS: jumlah maksimum replika yang dapat dibuat oleh autoscaler
  • TARGET_CPU_UTILIZATION: level CPU yang harus dipertahankan oleh autoscaler, antara 0.0 dan 1.0

Untuk informasi selengkapnya tentang cara menyetel penskalaan otomatis, lihat Penskalaan otomatis grup instance dan dokumentasi referensi gcloud compute instance-groups managed set-autoscaling.

Bekerja dengan metadata

Contoh berikut menunjukkan tugas umum saat bekerja dengan metadata. Untuk informasi selengkapnya tentang metadata, baca Menyimpan dan mengambil metadata.

Menambahkan metadata level project

Jalankan perintah berikut untuk menambahkan metadata ke project Anda:

gcloud compute project-info add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Ganti kode berikut:

  • VM_NAME: nama VM
  • KEY=VALUE: pasangan nilai kunci metadata

Untuk informasi selengkapnya tentang cara menambahkan metadata ke VM, baca artikel Menetapkan metadata kustom tingkat project dan dokumentasi referensi gcloud compute project-info add-metadata singkat ini.

Menambahkan metadata level instance

Jalankan perintah berikut untuk menambahkan metadata ke VM:

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,[KEY=VALUE]

Ganti kode berikut:

  • VM_NAME: nama VM
  • KEY=VALUE: pasangan nilai kunci metadata

Untuk informasi lebih lanjut mengenai cara menambahkan metadata ke VM, baca artikel Menetapkan metadata instance dan dokumentasi referensi gcloud compute instances add-metadata.

Mendapatkan halaman bantuan

Perintah berikut menunjukkan cara mengakses berbagai jenis bantuan, mulai dari bantuan umum tentang perintah gcloud compute, hingga bantuan spesifik tentang grup resource (instances) atau perintah (create ). Bantuan komprehensif untuk semua resource dan perintah mengikuti pola berikut:

gcloud compute --help
 
gcloud compute instances --help
 
gcloud compute instances create --help

Bantuan cepat dapat diperoleh menggunakan tanda -h, bukan tanda --help. Anda juga dapat meninjau semua bantuan komprehensif di Referensi Google Cloud CLI.

Untuk mendapatkan bantuan komprehensif terkait perintah, khususnya cara mengonfigurasi fitur gcloud CLI, jalankan:

gcloud topic TOPIC

Ganti TOPIC dengan topik yang memerlukan bantuan. Untuk daftar topik yang bantuannya dapat Anda dapatkan, lihat dokumentasi referensi gcloud topic.

Apa langkah selanjutnya?