Ringkasan gcloud CLI

Halaman ini berisi ringkasan Google Cloud CLI serta pola dan kemampuan perintah umumnya.

Apa yang dimaksud dengan gcloud CLI?

Google Cloud CLI adalah sekumpulan alat untuk membuat dan mengelola Google Cloud resource. 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 Managed Service for Apache Spark
• Zona terkelola dan kumpulan 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.

Mendownload dan menginstal gcloud CLI

Versi gcloud CLI saat ini adalah 565.0.0.

Perhatian: Pastikan Anda menggunakan gcloud CLI versi saat ini, versi 565.0.0. Hal ini memungkinkan Anda menggunakan fitur terbaru, termasuk mengotorisasi dengan gcloud init. Jika menggunakan gcloud CLI versi lama, Anda mungkin akan mengalami error. Untuk menemukan nomor versi gcloud CLI yang telah Anda instal, masukkan perintah berikut: gcloud version. Untuk mempelajari cara mengupgrade ke gcloud CLI versi saat ini, lihat Mengelola penginstalan.

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 akan 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 yang diberi nama alpha, beta, dan preview. 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.

Ringkasan gcloud CLI

Untuk mengetahui pengantar singkat tentang gcloud CLI, daftar perintah yang umum digunakan, dan melihat struktur perintah ini, lihat ringkasan 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 mengetahui pemberitahuan lanjutan tentang perubahan pada perintah yang merusak fungsi saat ini lihat catatan rilis.
Pratinjau	preview	Perintah berada di tingkat rilis pratinjau, yang digunakan untuk mengumpulkan masukan dari pelanggan. Penawaran Pratinjau sering kali diumumkan secara publik, tetapi belum tentu memiliki fitur lengkap, dan tidak ada SLA atau komitmen dukungan teknis yang disediakan untuk penawaran ini. Kecuali dinyatakan sebaliknya oleh Google, penawaran pratinjau hanya ditujukan untuk digunakan di lingkungan pengujian. Tahap pratinjau rata-rata berlangsung sekitar enam bulan.
Beta	beta	Perintah berfungsi sepenuhnya, tetapi mungkin masih memiliki beberapa masalah yang belum terselesaikan. Perubahan yang dapat menyebabkan gangguan pada perintah ini dapat dilakukan tanpa pemberitahuan.
Alfa	alpha	Perintah berada dalam rilis awal dan dapat berubah tanpa pemberitahuan.

Komponen alpha, beta, dan preview 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, beta, atau pratinjau dan komponen yang sesuai tidak diinstal, gcloud CLI akan meminta Anda untuk menginstalnya.

Grup perintah

Dalam setiap tingkat rilis, perintah gcloud CLI diatur ke dalam a hierarki bertingkat grup perintah, yang masing-masing mewakili produk atau fitur of Google Cloud atau subgrup fungsinya.

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 yang terkait dengan Compute Engine dalam versi Beta
gcloud preview	Perintah yang terkait dengan Google Cloud dalam versi Pratinjau
gcloud alpha app	Perintah yang terkait dengan pengelolaan deployment App Engine dalam versi Alfa

Menjalankan perintah gcloud CLI

Anda dapat menjalankan perintah gcloud CLI dari command line dan dari skrip serta otomatisasi lainnya—misalnya, saat menggunakan Jenkins untuk mengotomatiskan Google Cloud tugas.

Catatan: Dokumentasi referensi dan contoh gcloud CLI menggunakan garis miring terbalik, \, untuk menunjukkan perintah yang panjang. Anda dapat menjalankan perintah ini apa adanya (pengguna Windows dapat menggunakan ^ dan bukan \). Jika ingin menghapus garis miring terbalik, pastikan untuk menghapus baris baru juga agar perintah dibaca sebagai satu baris.

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 diprioritaskan.

Mengaktifkan fitur aksesibilitas

Untuk pengalaman pembaca layar yang lebih efisien, 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 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 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 penjelasan mendetail tentang konsep ini, lihat panduan Konfigurasi.

Opsi global

gcloud CLI menyediakan sekumpulan 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 dan opsi posisi memengaruhi output perintah gcloud CLI, ada perbedaan kecil dalam kasus penggunaannya. Argumen posisi digunakan untuk menentukan entity tempat perintah beroperasi, 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 akan mengonfirmasi niat Anda sebelum menjalankan perintah seperti gcloud projects delete.

Anda mungkin akan diminta saat informasi tambahan diperlukan. Misalnya, Anda akan diminta untuk memilih zona saat membuat instance virtual machine Compute Engine menggunakan gcloud compute instances create test-instance.

Untuk menonaktifkan penulisan perintah, gunakan opsi --quiet.

Jangan membuat skrip terhadap kata-kata perintah karena kata-kata tersebut dapat berubah.

Menekan penulisan perintah, menulis ke terminal, dan logging

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 verbositas log, tentukan tingkat verbositas (debug, info, peringatan, error, penting, atau tidak ada) menggunakan opsi --verbosity.

Menentukan struktur output

Secara default, saat perintah gcloud CLI menampilkan daftar resource, resource akan dicetak dengan format yang bagus 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 yang ditabulasi atau diratakan (untuk tampilan interaktif) atau output versi yang dapat dibaca mesin (json, csv, yaml, value).

Untuk memformat daftar kunci yang memilih nilai data resource, gunakan projections. Untuk lebih menyempurnakan output ke kriteria yang Anda tentukan, gunakan filter.

Untuk mempelajari fungsi filter dan format, Anda dapat menyelesaikan tutorial interaktif singkat dengan mengklik Open in Cloud Shell.

Langkah berikutnya

• Pelajari lebih lanjut perintah gcloud CLI di referensi gcloud CLI.