gcloud compute


Dengan Google Cloud CLI, Anda dapat mengelola resource Compute Engine menggunakan grup perintah gcloud compute. gcloud compute adalah alternatif penggunaan Compute Engine API.

Gcloud CLI adalah bagian dari Google Cloud CLI dan merupakan alat command line terpadu yang mencakup fitur seperti pelengkapan otomatis pernyataan, pembaruan di tempat, bantuan command line, format {i>output<i} yang dapat dibaca dan yang dapat diuraikan mesin, serta integrasi dengan Google Cloud CLI.

Jika Anda belum pernah menggunakan Compute Engine, mulailah dengan panduan memulai Linux atau panduan memulai Windows.

Sebelum memulai

  • Jika Anda ingin menjalankan gcloud compute di command prompt, instal, update, dan inisialisasi Google Cloud CLI.
  • Jika Anda belum memiliki command prompt yang tersedia, coba gunakan gcloud compute di Cloud Shell. Cloud Shell diinstal, diupdate, dan diinisialisasi secara otomatis dengan Google Cloud CLI terbaru.

Properti default

Saat Anda membuat instance virtual machine, Compute Engine akan mengonfigurasi VM menggunakan properti default dari server metadata. Anda dapat memeriksa properti default VM dengan menjalankan perintah berikut:

gcloud compute project-info describe --project PROJECT_ID

Ganti PROJECT_ID dengan project ID Anda.

Project default

Jika Anda menetapkan project default saat menyiapkan dan menginisialisasi Google Cloud CLI, semua perintah gcloud compute akan menggunakan project ID tersebut secara default.

Anda dapat mengganti project ID default menggunakan salah satu metode berikut:

  • Jalankan setiap perintah gcloud compute dengan flag --project
  • Menetapkan variabel lingkungan CLOUDSDK_CORE_PROJECT

    Linux and macOS

    Gunakan perintah export untuk menetapkan variabel lingkungan project.

    export CLOUDSDK_CORE_PROJECT=PROJECT_ID
    

    Ganti PROJECT_ID dengan project ID project yang ingin Anda gunakan sebagai default.

    Membatalkan penetapan variabel lingkungan project

    Jika Anda perlu membatalkan penetapan variabel lingkungan project, gunakan perintah unset berikut:

    unset CLOUDSDK_CORE_PROJECT
    

    Windows

    Gunakan perintah set untuk menetapkan variabel lingkungan project.

    set CLOUDSDK_CORE_PROJECT=PROJECT_ID
    

    Ganti PROJECT_ID dengan project ID project yang ingin Anda gunakan sebagai default.

    Membatalkan penetapan variabel lingkungan project

    Jika Anda perlu membatalkan penetapan variabel lingkungan project, gunakan perintah berikut:

    set CLOUDSDK_CORE_PROJECT=
    

Jika tidak menetapkan project atau variabel lingkungan default, Anda harus menyertakan flag --project di setiap perintah gcloud compute yang dijalankan.

Region dan zona default

Beberapa perintah gcloud compute memerlukan tanda --region atau --zone. Daripada menyetel flag ini setiap kali menjalankan perintah, Anda dapat menyetel region dan zona default untuk project Anda. Jika Anda tidak menetapkan region atau zona default dan menjalankan perintah yang bergantung pada region atau zona, Google Cloud CLI mungkin akan meminta Anda untuk memberikan flag --region atau --zone, atau mengembalikan pesan error.

Anda dapat menetapkan region dan zona default dengan tiga cara:

  • Di server metadata. Region dan zona default yang ditetapkan di server metadata diterapkan ke klien lokal saat Anda menjalankan gcloud init.
  • Di klien lokal Anda. Region dan zona default yang ditetapkan di klien lokal Anda akan menggantikan region dan zona default yang ditetapkan di server metadata.
  • Dalam variabel lingkungan. Region dan zona default yang ditetapkan dalam variabel lingkungan akan menggantikan region dan zona default yang ditetapkan di klien lokal dan di server metadata.

Anda dapat override the default region and zone di server metadata, di klien lokal, atau di variabel lingkungan, dengan memberikan flag --region dan --zone saat menjalankan perintah.

Lihat region dan zona default

Untuk melihat region dan zona default, jalankan perintah berikut:

gcloud config get-value compute/region
gcloud config get-value compute/zone

Jika outputnya (unset), tidak ada region atau zona default yang ditetapkan.

Melihat region dan zona yang tersedia

Anda dapat melihat daftar region dan zona dengan menjalankan perintah berikut:

gcloud compute regions list
gcloud compute zones list

Menetapkan region dan zona default di server metadata

Region dan zona default di server metadata berlaku untuk semua konfigurasi di project Anda. Untuk menetapkan region dan zona default di server metadata, lakukan langkah berikut:

  1. Tetapkan region dan zona default:

    gcloud compute project-info add-metadata \
       --metadata google-compute-default-region=REGION,google-compute-default-zone=ZONE
    

    Contoh:

    gcloud compute project-info add-metadata \
       --metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b
    
  2. Lakukan inisialisasi perubahan pada klien lokal Anda:

    gcloud init

Anda dapat mengganti region dan zona default yang ditetapkan di server metadata dengan menetapkan region dan zona default di klien lokal, menetapkan region dan zona default dalam variabel lingkungan, atau dengan menyertakan --zone atau --region di perintah Anda.

Membatalkan penetapan region dan zona default di server metadata

Untuk membatalkan penetapan region dan zona default di server metadata, lakukan langkah berikut:

  1. Metadata yang tidak disetel:

    gcloud compute project-info remove-metadata \
       --keys=google-compute-default-region,google-compute-default-zone
    
  2. Lakukan inisialisasi perubahan pada klien lokal Anda:

    gcloud init

Menetapkan region dan zona default di klien lokal Anda

Region dan zona default yang ditetapkan di klien lokal Anda akan menggantikan region dan zona default yang ditetapkan di server metadata.

Untuk menetapkan region dan zona default di klien lokal Anda, jalankan perintah berikut:

gcloud config set compute/region REGION
gcloud config set compute/zone ZONE

Membatalkan penetapan region dan zona default di klien lokal Anda

Untuk membatalkan penetapan region atau zona default di klien lokal Anda, jalankan perintah berikut:

gcloud config unset compute/zone
gcloud config unset compute/region

Anda dapat mengganti region dan zona default yang ditetapkan di klien lokal dengan menetapkan region dan zona default dalam variabel lingkungan, atau dengan menyertakan flag --zone atau --region dalam perintah Anda.

Menetapkan region dan zona default dalam variabel lingkungan

Region dan zona default yang ditetapkan dalam variabel lingkungan akan menggantikan region dan zona default yang ditetapkan di klien lokal dan di server metadata.

Linux and macOS

Gunakan perintah export untuk menetapkan variabel region dan zona.

export CLOUDSDK_COMPUTE_REGION=REGION
export CLOUDSDK_COMPUTE_ZONE=ZONE

Agar variabel lingkungan ini bersifat permanen, sertakan perintah ini dalam file ~/.bashrc dan mulai ulang terminal Anda.

Windows

Gunakan perintah set untuk menetapkan variabel region dan zona.

set CLOUDSDK_COMPUTE_REGION=REGION
set CLOUDSDK_COMPUTE_ZONE=ZONE

Anda dapat mengganti variabel lingkungan dengan menyertakan flag --zone atau --region dalam perintah Anda.

Membatalkan penetapan region dan zona default dalam variabel lingkungan

Gunakan perintah berikut untuk membatalkan penetapan region dan zona default di variabel lingkungan.

Linux and macOS

Untuk membatalkan penetapan variabel lingkungan region dan zona, gunakan perintah unset berikut:

unset CLOUDSDK_COMPUTE_REGION
unset CLOUDSDK_COMPUTE_ZONE

Windows

Untuk membatalkan penetapan variabel lingkungan region dan zona, gunakan perintah berikut:

set CLOUDSDK_COMPUTE_REGION=
set CLOUDSDK_COMPUTE_ZONE=

Mengganti zona default dengan tanda

Gunakan flag --zone untuk mengganti zona default yang ditetapkan di server metadata, klien lokal, dan variabel lingkungan.

Contoh:

gcloud compute instances create example-instance \
    --zone=ZONE

Konfigurasi

gcloud topic configurations adalah fitur lanjutan yang dapat Anda gunakan untuk memengaruhi perilaku gcloud CLI. Bagi sebagian besar pengguna, menggunakan konfigurasi default sudah cukup.

Konfigurasi mungkin berguna bagi pengguna yang:

  • Bekerja dengan beberapa project. Anda dapat membuat konfigurasi terpisah untuk setiap project.
  • Menggunakan beberapa akun. Misalnya, akun pengguna dan akun layanan.
  • Melakukan berbagai tugas independen (mengerjakan aplikasi App Engine dalam satu project, mengelola cluster Compute Engine di zona us-central-1a, mengelola konfigurasi jaringan untuk region asia-east-1, dll.)

Untuk beralih antar-konfigurasi, jalankan perintah berikut:

gcloud config configurations activate CONFIGURATION_NAME

Untuk informasi selengkapnya tentang mengelola konfigurasi, lihat gcloud config configurations.

Apa langkah selanjutnya?