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:
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
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:
Metadata yang tidak disetel:
gcloud compute project-info remove-metadata \ --keys=google-compute-default-region,google-compute-default-zone
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?
- Ikuti panduan Panduan memulai untuk Google Cloud CLI.
- Tinjau tips penggunaan
gcloud compute
. - Pelajari
perintah
gcloud compute
umum.