Tips praktis gcloud CLI

Daftar perintah andalan untuk Google Cloud CLI, alat command line utama untuk Google Cloud.

(Juga mencakup: primer pengantar, perintah pemahaman, dan PDF yang dapat dicetak.)

Tips praktis

Memulai

Memulai gcloud CLI.

• gcloud init: Melakukan inisialisasi, memberi otorisasi, dan mengonfigurasi gcloud CLI.
• gcloud version: Menampilkan versi dan komponen yang diinstal.
• gcloud components install: Menginstal komponen tertentu.
• gcloud components update: Update gcloud CLI ke versi terbaru.
• gcloud config set project: Menetapkan project Google Cloud default untuk dikerjakan.
• gcloud info: Menampilkan detail lingkungan gcloud CLI saat ini.

Bantuan

gcloud CLI akan membantu Anda dengan senang hati.

• gcloud help: Menelusuri dokumen referensi gcloud CLI untuk mencari persyaratan tertentu.
• gcloud feedback: Memberikan masukan kepada tim gcloud CLI.
• gcloud topic: Materi bantuan tambahan untuk topik non-perintah seperti aksesibilitas, pemfilteran, dan pemformatan.

Personalisasi

Jadikan gcloud CLI sesuai keinginan Anda; personalisasikan konfigurasi dengan properti.

• gcloud config set: Menentukan properti (seperti komputasi/zona) untuk konfigurasi saat ini.
• gcloud config get: Mengambil nilai properti gcloud CLI.
• gcloud config list: Menampilkan semua properti untuk konfigurasi saat ini.
• gcloud config configurations create: Membuat konfigurasi bernama baru.
• gcloud config configurations list: Menampilkan daftar semua konfigurasi yang tersedia.
• gcloud config configurations activate: Beralih ke konfigurasi bernama yang sudah ada.

Otorisasi dan Kredensial

Memberikan dan mencabut otorisasi ke gcloud CLI dan mengelola kredensial.

• gcloud auth login: Mengizinkan akses Google Cloud untuk gcloud CLI dengan kredensial pengguna Google Cloud dan menetapkan akun saat ini sebagai aktif.
• gcloud auth activate-service-account: Mengizinkan akses Google Cloud yang serupa dengan gcloud auth login tetapi dengan kredensial akun layanan.
• gcloud auth application-default: Mengelola Kredensial Default Aplikasi (ADC) untuk Library Klien Cloud.
• gcloud auth list: Menampilkan daftar semua akun berkredensial.
• gcloud auth print-access-token: Menampilkan token akses akun saat ini.
• gcloud auth revoke: Menghapus kredensial akses untuk akun.

Project

Mengelola kebijakan akses project.

• gcloud projects describe: Menampilkan metadata untuk project (termasuk ID-nya).
• gcloud projects add-iam-policy-binding: Menambahkan binding kebijakan IAM ke project yang ditentukan.

IAM

Mengonfigurasi preferensi Identity and Access Management (IAM) dan akun layanan.

• gcloud iam list-grantable-roles: Mencantumkan peran IAM yang dapat diberikan untuk resource.
• gcloud iam roles create: Buat peran khusus untuk project atau organisasi.
• gcloud iam service-accounts create: Membuat akun layanan untuk project.
• gcloud iam service-accounts add-iam-policy-binding: Menambahkan binding kebijakan IAM ke akun layanan.
• gcloud iam service-accounts set-iam-policy-binding: Mengganti binding kebijakan IAM yang ada.
• gcloud iam service-accounts keys list: Mencantumkan kunci akun layanan.

Docker & Google Kubernetes Engine (GKE)

Mengelola aplikasi dalam container di Kubernetes.

• gcloud auth configure-docker: Daftarkan gcloud CLI sebagai helper kredensial Docker.
• gcloud container clusters create: Membuat cluster untuk menjalankan container GKE.
• gcloud container clusters list: Membuat daftar cluster untuk menjalankan container GKE.
• gcloud container clusters get-credentials: Update kubeconfig untuk mendapatkan kubectl agar dapat menggunakan cluster GKE.
• gcloud container images list-tags: Mencantumkan metadata tag dan ringkasan untuk image container.

Virtual Machine & Compute Engine

Membuat, menjalankan, dan mengelola VM di infrastruktur Google Cloud.

• gcloud compute zones list: Buat daftar zona Compute Engine.
• gcloud compute instances create: Membuat instance VM.
• gcloud compute instances describe: Menampilkan detail instance VM.
• gcloud compute instances list: Mencantumkan semua instance VM dalam project.
• gcloud compute disks snapshot: Membuat snapshot persistent disk.
• gcloud compute snapshots describe: Menampilkan detail snapshot.
• gcloud compute snapshots delete: Menghapus snapshot.
• gcloud compute ssh: Menghubungkan ke instance VM menggunakan SSH.

Serverless & App Engine

Buat aplikasi yang sangat skalabel di platform tanpa server yang terkelola sepenuhnya

• gcloud app deploy: Deploy kode dan konfigurasi aplikasi Anda ke server App Engine.
• gcloud app versions list: Menampilkan daftar semua versi semua layanan yang di-deploy ke server App Engine.
• gcloud app browse: Membuka aplikasi saat ini di browser web.
• gcloud app create: Buat aplikasi App Engine dalam project Anda saat ini.
• gcloud app logs read: Menampilkan log aplikasi App Engine terbaru.

Lain-lain

Perintah yang mungkin berguna

• gcloud kms decrypt: Mendekripsi ciphertext (ke file teks biasa) menggunakan kunci Cloud Key Management Service.
• gcloud logging logs list: Menampilkan daftar log project Anda.
• gcloud sql backups describe: Menampilkan info tentang pencadangan instance Cloud SQL.
• gcloud sql export sql: Mengekspor data dari instance Cloud SQL ke file SQL.

Primer pengantar

Penjelasan singkat untuk memulai gcloud CLI.

Menginstal Google Cloud CLI

Instal Google Cloud CLI dengan petunjuk penginstalan ini.

Tanda, argumen, dan tambahan menakjubkan lainnya

Argumen dapat berupa argumen posisi atau flag:

• Positional args: Ditetapkan setelah nama perintah; harus mengikuti urutan argumen posisi.

• Tanda: Ditetapkan setelah argumen posisi; urutan tanda tidak menjadi masalah.

  Tanda dapat berupa:

  • Pasangan nama-nilai (--foo=bar), atau
  • Boolean (--force/no-force).

  Selain itu, tanda dapat berupa:

  • Wajib
  • Opsional: Jika tanda opsional tidak ditentukan, nilai default akan digunakan

Flag global

Beberapa flag tersedia di seluruh pengalaman gcloud CLI, seperti:

• --help: Jika ragu ; tampilkan bantuan mendetail untuk suatu perintah.
• --project: Jika menggunakan project selain project saat ini.
• --quiet: Menonaktifkan perintah interaktif (dan menerapkan nilai default untuk input).
• --verbosity: Dapat menyetel tingkat panjang pada debug, info, warning, error, critical, dan none.
• --version: Menampilkan informasi versi gcloud.
• --format: Setel format output sebagai config, csv, default, diff, disable, flattened, get, json, list, multi, none, object, table, text, value, atau yaml.

Membersihkan hasil

Dapatkan hasil maksimal dari output Anda dengan flag filter, format, batas, dan urutkan menurut.

Untuk instance Compute Engine dengan awalan us dan bukan jenis mesin f1-micro:

gcloud compute instances list --filter="zone ~ ^us AND -machineType:f1-micro"

Untuk daftar project yang dibuat pada atau setelah 15 Januari 2018, diurutkan dari yang terlama hingga terbaru, disajikan sebagai tabel dengan kolom nomor project, project ID, dan waktu pembuatan dengan tanggal dan waktu dalam zona waktu lokal:

gcloud projects list --format="table(projectNumber,projectId,createTime.date(tz=LOCAL))"
--filter="createTime>=2018-01-15T12:00:00" --sort-by=createTime

Untuk daftar sepuluh instance Compute Engine dengan label my-label (dari nilai apa pun):

gcloud compute instances list --filter="labels.my-label:*" --limit=10

Memahami perintah

Pola yang mendasari perintah gcloud CLI; untuk membantu penemuan perintah.

Menemukan perintah CLI gcloud

Gcloud CLI adalah hierarki; node non-leaf adalah grup perintah dan node leaf adalah perintah. (Selain itu, pelengkapan tab juga berfungsi untuk perintah dan resource.)

Sebagian besar perintah gcloud mengikuti format berikut:

gcloud + release level (optional) + component + entity + operation + positional args + flags

Contoh: gcloud + compute + instances + create + example-instance-1 + --zone=us-central1-a

Level rilis

Level Rilis mengacu pada status rilis perintah.

Contoh: alpha untuk perintah alfa, beta untuk perintah beta, tingkat rilis tidak diperlukan untuk perintah GA.

Komponen

Komponen mengacu pada berbagai layanan Google Cloud.

Contoh: compute untuk Compute Engine, app untuk App Engine, dll.

Entity

Entitas mengacu pada bentuk jamak dari elemen atau kumpulan elemen di bawah komponen.

Contoh: disks, firewalls, images, instances, regions, zones untuk komputasi

Operasi

Operasi mengacu pada bentuk kata kerja imperatif dari operasi yang akan dilakukan pada entitas.

Contoh: Operasi umum adalah describe, list, create/update, delete/clear, import, export, copy, remove, add, reset, restart, restore, run, dan deploy.

Argumen posisi

Argumen posisi adalah argumen yang diperlukan dan spesifik per urutan yang diperlukan untuk menjalankan perintah.

Contoh: <INSTANCE_NAMES> adalah argumen posisi yang diperlukan untuk gcloud compute instances create.

Flag

Flag merujuk pada argumen tambahan, --flag-name(=value), yang diteruskan ke perintah setelah argumen posisi.

Contoh: --machine-type=<MACHINE_TYPE> dan --preemptible adalah flag opsional untuk gcloud compute instances create.