Tips gcloud CLI

Daftar perintah yang harus digunakan untuk Google Cloud CLI, alat command line utama untuk Google Cloud.

(Juga disertakan: panduan pengantar, memahami perintah, dan PDF yang dapat dicetak.)

Tips praktis

Memulai

Mulai menggunakan gcloud CLI.

• gcloud init: Melakukan inisialisasi, otorisasi, dan konfigurasi gcloud CLI.
• gcloud version: Menampilkan versi dan komponen yang diinstal.
• gcloud components install: Menginstal komponen tertentu.
• gcloud components update: Update gcloud CLI Anda 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 siap membantu Anda.

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

Personalisasi

Buat gcloud CLI menjadi milik Anda; personalisasi konfigurasi Anda dengan properti.

• gcloud config set: Menentukan properti (seperti compute/zone) 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 baru yang diberi nama.
• gcloud config configurations list: Menampilkan daftar semua konfigurasi yang tersedia.
• gcloud config configurations activate: Beralih ke konfigurasi bernama yang ada.

Otorisasi dan Kredensial

Memberikan dan mencabut otorisasi ke gcloud CLI serta mengelola kredensial.

• gcloud auth login: Memberi otorisasi 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 mirip dengan gcloud auth login, tetapi dengan kredensial akun layanan.
• gcloud auth application-default: Kelola Kredensial Default Aplikasi (ADC) untuk Library Klien Cloud.
• gcloud auth list: Mencantumkan semua akun yang memiliki kredensial.
• 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: Membuat peran kustom 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: Mendaftarkan gcloud CLI sebagai pembantu kredensial Docker.
• gcloud container clusters create: Membuat cluster untuk menjalankan penampung GKE.
• gcloud container clusters list: Mencantumkan cluster untuk menjalankan penampung GKE.
• gcloud container clusters get-credentials: Memperbarui kubeconfig untuk membuat kubectl menggunakan cluster GKE.
• gcloud container images list-tags: Mencantumkan tag dan meringkas metadata untuk image penampung.

Virtual Machine & Compute Engine

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

• gcloud compute zones list: Mencantumkan 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.

Tanpa Server & App Engine

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

• gcloud app deploy: Men-deploy kode dan konfigurasi aplikasi ke server App Engine.
• gcloud app versions list: Mencantumkan semua versi dari semua layanan yang di-deploy ke server App Engine.
• gcloud app browse: Membuka aplikasi saat ini di browser web.
• gcloud app create: Membuat 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: Mencantumkan 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.

Artikel pengantar

Panduan singkat untuk memulai gcloud CLI.

Menginstal Google Cloud CLI

Instal Google Cloud CLI dengan petunjuk penginstalan ini.

Flag, argumen, dan tambahan luar biasa lainnya

Argumen dapat berupa argumen posisional atau flag:

• Argumen posisional: Ditetapkan setelah nama perintah; harus mengikuti urutan argumen posisional.

• Flag: Ditetapkan setelah argumen posisional; urutan flag tidak penting.

  Flag dapat berupa:

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

  Selain itu, flag 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 tidak yakin; tampilkan bantuan mendetail untuk perintah.
• --project: Jika menggunakan project selain project saat ini.
• --quiet: Menonaktifkan perintah interaktif (dan menerapkan nilai default untuk input).
• --verbosity: Dapat menetapkan level panjang pada debug, info, warning, error, critical, dan none.
• --version: Menampilkan informasi versi gcloud.
• --format: Tetapkan format output sebagai config, csv, default, diff, disable, flattened, get, json, list, multi, none, object, table, text, value, atau yaml.

Membersihkan hasil

Maksimalkan output Anda dengan flag filter, format, batas, dan urutkan menurut.

Untuk instance Compute Engine dengan awalan us, 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, yang diurutkan dari yang paling lama ke yang terbaru, yang ditampilkan 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 (berapapun nilainya):

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

Memahami perintah

Pola yang mendasari perintah gcloud CLI; untuk membantu menemukan perintah secara mandiri.

Menemukan perintah gcloud CLI

gcloud CLI adalah hierarki; node non-daun adalah grup perintah dan node daun adalah perintah. (Selain itu, pelengkapan tab 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

Tingkat rilis

Tingkat Rilis mengacu pada status rilis perintah.

Contoh: alpha untuk perintah alfa, beta untuk perintah beta, tidak ada level rilis yang diperlukan untuk perintah GA.

Komponen

Komponen mengacu pada berbagai layanan Google Cloud.

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

Entity

Entity mengacu pada bentuk jamak dari elemen atau kumpulan elemen dalam komponen.

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

Operasi

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

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

Argumen posisi

Argumen posisional mengacu pada argumen khusus urutan yang diperlukan untuk menjalankan perintah.

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

Flag

Flag mengacu 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.