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 akan digunakan saat menggunakan resource Compute Engine, atau opsi untuk menonaktifkan pemeriksaan update komponen gcloud CLI otomatis. Properti juga dapat digunakan untuk menentukan preferensi gcloud CLI seperti tingkat panjang dan konfigurasi perintah untuk perintah gcloud CLI.

Properti dan flag

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 di seluruh eksekusi perintah, sedangkan flag memengaruhi perilaku perintah berdasarkan per pemanggilan. Perhatikan bahwa tanda akan menggantikan properti saat keduanya ditetapkan.

Konfigurasi

Konfigurasi adalah kumpulan properti gcloud CLI yang diberi nama. 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 di antara konfigurasi tersebut sesuai kebutuhan.

Mencantumkan properti

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

Menetapkan properti

Untuk menetapkan properti dalam konfigurasi aktif, jalankan gcloud config set. Contoh berikut menetapkan properti project, dengan PROJECT_ID adalah 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 yang sesuai yang dapat digunakan untuk menyetelnya. 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

Membatalkan penetapan properti

Untuk menghapus 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 dan mencari bagian Properti yang Tersedia.

Langkah selanjutnya