Halaman ini berisi ringkasan Google Cloud CLI serta pola dan kemampuan perintah umumnya.
Apa itu gcloud CLI?
Google Cloud CLI adalah serangkaian alat untuk membuat dan mengelola resource Google Cloud. Anda dapat menggunakan alat ini untuk melakukan banyak tugas platform umum dari command line atau melalui skrip dan otomatisasi lainnya.
Misalnya, Anda dapat menggunakan gcloud CLI untuk membuat dan mengelola hal berikut:
- Instance virtual machine Compute Engine dan resource lainnya
- Instance Cloud SQL
- Cluster Google Kubernetes Engine
- Cluster dan tugas Dataproc
- Zona dan kumpulan data terkelola Cloud DNS
- Deployment Cloud Deployment Manager
Anda juga dapat menggunakan gcloud CLI untuk men-deploy aplikasi App Engine, mengelola autentikasi, menyesuaikan konfigurasi lokal, dan melakukan tugas lainnya.
Mendownload dan menginstal gcloud CLI
Versi gcloud CLI saat ini adalah 472.0.0.
Meskipun kami sangat menyarankan Anda untuk menggunakan gcloud CLI versi saat ini, Anda juga dapat mendownload dan menginstal versi sebelumnya dari arsip download.
Jika Anda menggunakan Cloud Shell, gcloud CLI tersedia secara otomatis dan Anda tidak perlu menginstalnya. Jika tidak, download dan instal gcloud CLI, lalu initialize.
Secara default, gcloud CLI menginstal perintah yang ada di tingkat Ketersediaan Umum. Fungsi tambahan tersedia di components gcloud CLI yang bernama alpha dan beta. Dengan komponen ini, Anda dapat menggunakan gcloud CLI untuk bekerja dengan Bigtable, Dataflow, dan bagian Google Cloud lainnya pada tingkat rilis yang lebih awal dibandingkan Ketersediaan Umum.
Tips praktis gcloud CLI
Untuk pengenalan singkat tentang gcloud CLI, daftar perintah yang umum digunakan, dan cara mempelajari struktur perintah ini, baca tips praktis gcloud CLI.
Level rilis
Perintah CLI gcloud memiliki level rilis berikut:
| Level rilis | Label | Deskripsi |
|---|---|---|
| Ketersediaan Umum | Tidak ada | Perintah dianggap sepenuhnya stabil dan tersedia untuk penggunaan produksi. Untuk pemberitahuan awal tentang perubahan perintah yang merusak fungsi saat ini, lihat catatan rilis. |
| Beta | beta |
Perintah sudah lengkap secara fungsional, tetapi masih terdapat beberapa masalah yang belum terselesaikan. Perubahan yang dapat menyebabkan gangguan pada perintah ini dapat dilakukan tanpa pemberitahuan. |
| Alfa | alpha |
Perintah masih dalam rilis awal dan dapat berubah tanpa pemberitahuan. |
Komponen alpha dan beta tidak diinstal secara default saat Anda menginstal gcloud CLI. Anda harus menginstal komponen ini
secara terpisah menggunakan perintah gcloud components install. Jika Anda mencoba menjalankan perintah alfa atau beta dan komponen yang sesuai tidak diinstal, gcloud CLI akan meminta Anda untuk menginstalnya.
Grup perintah
Dalam setiap level rilis, perintah gcloud CLI disusun menjadi hierarki bertingkat berbagai grup perintah, yang masing-masing mewakili produk atau fitur Google Cloud atau subgrup fungsinya.
Contoh:
| Grup perintah | Deskripsi |
|---|---|
gcloud compute |
Perintah yang terkait dengan Compute Engine secara umum |
gcloud compute instances |
Perintah yang terkait dengan instance Compute Engine secara umum |
gcloud beta compute |
Perintah yang terkait dengan Compute Engine dalam versi Beta |
gcloud alpha app |
Perintah yang terkait dengan pengelolaan deployment App Engine di Alfa |
Menjalankan perintah gcloud CLI
Anda dapat menjalankan perintah gcloud CLI dari command line dan dari skrip dan otomatisasi lainnya—misalnya, saat menggunakan Jenkins untuk mengotomatiskan tugas Google Cloud.
Properti
Properti gcloud CLI adalah setelan yang memengaruhi perilaku alat gcloud CLI. Beberapa properti ini dapat disetel oleh opsi global atau perintah—dalam hal ini, nilai yang ditetapkan oleh opsi akan diprioritaskan.
Mengaktifkan fitur aksesibilitas
Untuk pengalaman pembaca layar yang lebih sederhana, gcloud CLI dilengkapi dengan properti accessibility/screen_reader.
Untuk mengaktifkan properti aksesibilitas, jalankan:
gcloud config set accessibility/screen_reader true
Untuk mengetahui detail selengkapnya tentang fitur aksesibilitas yang disertakan dengan alat command line gcloud, lihat panduan Mengaktifkan fitur aksesibilitas.
Konfigurasi
Konfigurasi adalah kumpulan properti gcloud CLI. Konfigurasi bekerja seperti profil.
Saat mulai menggunakan gcloud CLI, Anda akan bekerja dengan satu konfigurasi bernama default dan dapat menetapkan properti dengan menjalankan gcloud init atau gcloud config set. Satu konfigurasi default ini
sesuai untuk sebagian besar kasus penggunaan.
Untuk bekerja dengan beberapa project atau akun otorisasi, Anda dapat menyiapkan
beberapa konfigurasi dengan gcloud config configurations create dan beralih
di antara konfigurasi tersebut. Dalam konfigurasi, Anda dapat menyesuaikan properti.
Misalnya, untuk menetapkan project Anda dalam konfigurasi aktif, gunakan properti project:
gcloud config set project <project-id>
Untuk mengetahui akun mendetail tentang konsep ini, lihat Panduan konfigurasi.
Opsi global
Gcloud CLI menyediakan serangkaian opsi gcloud CLI yang mengatur perilaku perintah di tingkat setiap pemanggilan. Opsi mengganti nilai yang ditetapkan dalam properti gcloud CLI.
Argumen dan opsi posisi
Meskipun argumen posisi dan opsi memengaruhi output perintah gcloud CLI, ada perbedaan kecil dalam kasus penggunaannya. Argumen posisi digunakan untuk menentukan entity tempat perintah beroperasi, sementara opsi diperlukan untuk menetapkan variasi dalam perilaku perintah.
Penggunaan stdout dan stderr
Output dari perintah gcloud CLI yang berhasil akan ditulis ke stdout. Semua jenis respons lainnya—perintah, peringatan, dan error—ditulis ke stderr. Jangan membuat skrip terhadap respons yang ditulis ke stderr karena
respons ini tidak stabil.
Untuk mengetahui panduan tentang cara menangani output, lihat Panduan pembuatan skrip.
Meminta
Untuk melindungi dari tindakan destruktif yang tidak diinginkan, gcloud CLI akan mengonfirmasi intent Anda sebelum menjalankan perintah seperti gcloud projects delete.
Anda mungkin akan diminta jika ada informasi tambahan yang diperlukan.
Misalnya, Anda akan diminta untuk memilih zona saat membuat instance virtual machine Compute Engine menggunakan gcloud compute instances create test-instance.
Untuk menonaktifkan perintah, gunakan opsi --quiet.
Jangan membuat skrip berdasarkan kata-kata perintah karena kata-katanya dapat berubah.
Menyembunyikan perintah, menulis ke terminal, dan logging
Opsi --quiet (juga, -q) untuk gcloud CLI menonaktifkan semua prompt interaktif saat menjalankan perintah gcloud CLI dan berguna untuk membuat skrip. Jika input diperlukan, default akan digunakan. Jika tidak ada
default, error akan muncul.
Untuk menyembunyikan pencetakan output perintah ke output standar dan error standar di
terminal, gunakan opsi --no-user-output-enabled.
Untuk menyesuaikan panjang log, tentukan tingkat panjang (debug, info, peringatan,
error, kritis, atau tidak ada) menggunakan
opsi --verbosity.
Menentukan struktur {i>output<i}
Secara default, ketika perintah gcloud CLI menampilkan daftar resource, resource tersebut akan dicetak dengan baik sesuai output standar. Untuk menghasilkan output yang lebih bermakna, opsi format, filter, dan projection memungkinkan Anda menyesuaikan
output.
Untuk menentukan hanya format output, gunakan
opsi --format untuk menghasilkan versi output yang ditabulasi
atau disatukan (untuk tampilan interaktif) atau
versi output yang dapat dibaca mesin (json, csv, yaml, value).
Untuk memformat daftar kunci yang memilih nilai data resource, gunakan
projections. Untuk lebih mempersempit
output ke kriteria yang Anda tentukan, gunakan
filter.
Untuk memahami fungsi filter dan format, Anda dapat menyelesaikan tutorial interaktif cepat dengan mengklik Open in Cloud Shell.
Langkah selanjutnya
- Pelajari perintah gcloud CLI lebih lanjut di referensi gcloud CLI.