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 resourceGoogle 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 terkelola dan set data 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.
Download dan instal gcloud CLI
Versi gcloud CLI saat ini adalah 530.0.0.
Meskipun kami sangat menyarankan Anda 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 lakukan inisialisasi.
Secara default, gcloud CLI menginstal
perintah yang berada di tingkat Ketersediaan Umum. Fungsi tambahan tersedia di
komponen gcloud CLI
bernama alpha dan beta. Komponen ini memungkinkan Anda menggunakan gcloud CLI untuk bekerja dengan Bigtable, Dataflow, dan bagian lain dari Google Cloud pada tingkat rilis yang lebih awal daripada Ketersediaan Umum.
Lembar contekan gcloud CLI
Untuk pengantar singkat tentang gcloud CLI, daftar perintah yang umum digunakan, dan cara perintah ini disusun, lihat cheat sheet gcloud CLI.
Tingkat rilis
Perintah gcloud CLI memiliki tingkat rilis berikut:
| Tingkat rilis | Label | Deskripsi |
|---|---|---|
| Ketersediaan Umum | Tidak ada | Perintah dianggap sepenuhnya stabil dan tersedia untuk penggunaan produksi. Untuk pemberitahuan awal tentang perubahan pada perintah yang merusak fungsi saat ini, lihat catatan rilis. |
| Beta | beta |
Perintah sudah selesai secara fungsional, tetapi masih dapat memiliki beberapa masalah yang belum terselesaikan. Perubahan yang 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 tingkat rilis, perintah gcloud CLI disusun ke dalam hierarki bertingkat grup perintah, yang masing-masing merepresentasikan produk atau fitur Google Cloud atau subgrup fungsionalnya.
Contoh:
| Grup perintah | Deskripsi |
|---|---|
gcloud compute |
Perintah yang terkait dengan Compute Engine dalam ketersediaan umum |
gcloud compute instances |
Perintah yang terkait dengan instance Compute Engine dalam ketersediaan umum |
gcloud beta compute |
Perintah terkait Compute Engine dalam versi Beta |
gcloud alpha app |
Perintah terkait pengelolaan deployment App Engine dalam versi Alpha |
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 ditetapkan oleh opsi global atau perintah—dalam hal ini, nilai yang ditetapkan oleh opsi akan lebih diprioritaskan.
Mengaktifkan fitur aksesibilitas
Untuk pengalaman pembaca layar yang lebih lancar, 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 sekumpulan properti gcloud CLI. Konfigurasi berfungsi seperti profil.
Saat mulai menggunakan gcloud CLI, Anda akan menggunakan satu
konfigurasi bernama default dan Anda dapat menetapkan properti dengan menjalankan
gcloud init atau gcloud config set. Konfigurasi default tunggal ini
cocok untuk sebagian besar kasus penggunaan.
Untuk menggunakan beberapa project atau akun otorisasi, Anda dapat menyiapkan beberapa konfigurasi dengan gcloud config configurations create dan beralih antar-konfigurasi. Dalam konfigurasi, Anda dapat menyesuaikan properti.
Misalnya, untuk menyetel project Anda dalam konfigurasi aktif, gunakan properti project:
gcloud config set project <project-id>
Untuk mengetahui penjelasan 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 menggantikan nilai yang ditetapkan di properti gcloud CLI.
Argumen dan opsi posisi
Meskipun argumen dan opsi posisi memengaruhi output perintah gcloud CLI, ada perbedaan kecil dalam kasus penggunaannya. Argumen posisi digunakan untuk menentukan entitas yang menjadi dasar pengoperasian perintah, sedangkan opsi diperlukan untuk menetapkan variasi dalam perilaku perintah.
Penggunaan stdout dan stderr
Output perintah gcloud CLI yang berhasil 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.
Penulisan Perintah
Untuk melindungi dari tindakan destruktif yang tidak disengaja, gcloud CLI mengonfirmasi niat Anda sebelum menjalankan perintah seperti gcloud projects delete.
Anda mungkin diminta memberikan informasi tambahan jika diperlukan.
Misalnya, Anda akan diminta 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 susunan kata perintah karena susunan kata dapat berubah.
Menekan perintah, menulis ke terminal, dan mencatat
Opsi --quiet (juga, -q) untuk
gcloud CLI
menonaktifkan semua perintah interaktif saat menjalankan perintah gcloud CLI
dan berguna untuk pembuatan skrip. Jika input diperlukan, input default akan digunakan. Jika tidak ada default, error akan muncul.
Untuk menekan pencetakan output perintah ke output standar dan error standar di
terminal, gunakan opsi --no-user-output-enabled.
Untuk menyesuaikan kejelasan log, tentukan tingkat kejelasan (debug, info, peringatan,
error, penting, atau tidak ada) menggunakan opsi
--verbosity.
Menentukan struktur output
Secara default, saat perintah gcloud CLI menampilkan daftar resource, resource tersebut dicetak dengan rapi ke output standar. Untuk menghasilkan output yang lebih bermakna, opsi format, filter, dan projection memungkinkan Anda menyempurnakan output.
Untuk menentukan format output saja, gunakan
opsi --format untuk menghasilkan output versi tabulasi
atau versi datar (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 menyempurnakan
output Anda sesuai dengan kriteria yang Anda tentukan, gunakan
filter.
Langkah berikutnya
- Pelajari lebih lanjut perintah gcloud CLI di referensi gcloud CLI.