Mengelola properti gcloud CLI

Properti adalah setelan yang mengatur perilaku gcloud CLI.

Anda dapat menggunakan properti untuk menentukan setelan per produk atau per layanan seperti akun yang digunakan oleh gcloud CLI untuk otorisasi, region default yang digunakan saat menangani resource Compute Engine, atau opsi untuk menonaktifkan pemeriksaan update komponen gcloud CLI otomatis. Properti juga dapat digunakan untuk menentukan preferensi gcloud CLI seperti level panjang dan konfigurasi permintaan untuk perintah gcloud CLI.

Properti dan tanda

Gcloud CLI mendukung beberapa flag global dan flag perintah yang memiliki efek yang sama dengan properti gcloud CLI. Misalnya, gcloud CLI mendukung flag --project dan properti project. Properti memungkinkan Anda mempertahankan setelan yang sama pada seluruh eksekusi perintah, sementara flag memengaruhi perilaku perintah per pemanggilan. Perlu diperhatikan bahwa flag akan menggantikan properti jika keduanya ditetapkan.

Konfigurasi

Konfigurasi adalah kumpulan properti gcloud CLI bernama. Gcloud CLI menggunakan konfigurasi bernama default sebagai konfigurasi aktif awal. Konfigurasi default cocok untuk sebagian besar kasus penggunaan. Namun, Anda juga dapat membuat konfigurasi tambahan dan beralih antar-konfigurasi sesuai kebutuhan.

Properti listingan

Untuk mencantumkan properti dalam konfigurasi aktif, jalankan gcloud config list:

gcloud config list

Gcloud CLI menampilkan daftar properti:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

Properti setelan

Untuk menetapkan properti dalam konfigurasi aktif, jalankan gcloud config set. Contoh berikut menetapkan properti project, dengan PROJECT_ID sebagai ID unik untuk project Anda.

gcloud config set project PROJECT_ID

Untuk menetapkan properti yang tidak ada di bagian properti core, Anda harus menentukan bagian yang diikuti dengan garis miring sebelum nama properti. Contoh berikut menetapkan nama zona ke us-east1-b.

gcloud config set compute/zone us-east1-b

Menetapkan properti menggunakan variabel lingkungan

Anda juga dapat menetapkan properti menggunakan variabel lingkungan. Setiap properti memiliki variabel lingkungan terkait yang dapat digunakan untuk menetapkannya. Nama variabel lingkungan mengikuti pola CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Misalnya, Anda dapat menetapkan properti core/project dan compute/zone sebagai berikut:

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Properti pembatalan setelan

Untuk membatalkan penetapan properti dalam konfigurasi aktif, gunakan gcloud config unset:

gcloud config unset disable_usage_reporting

Properti yang Tersedia

Daftar semua properti dapat ditemukan dengan menjalankan gcloud topic configurations atau gcloud config set --help, lalu mencari bagian Properti yang Tersedia.

Langkah selanjutnya