Mengelola konfigurasi gdcloud CLI

Konfigurasi adalah kumpulan properti Distributed Cloud CLI bernama. Properti ini adalah pasangan nilai kunci, yang disusun dalam beberapa bagian, yang mengatur perilaku gdcloud CLI.

Tips: Biasanya, jika Anda hanya mengerjakan satu project, konfigurasi default bernama default sudah cukup. Untuk mempelajari lebih lanjut cara menyetel properti dalam konfigurasi untuk menentukan setelan per organisasi atau per project seperti URL konsol organisasi atau project yang akan digunakan, preferensi aksesibilitas, lihat Mengelola properti.

Properti yang biasanya disimpan dalam konfigurasi mencakup URL konsol organisasi dan project ID. Konfigurasi memungkinkan Anda menentukan dan mengaktifkan setelan ini dan setelan lainnya secara bersamaan sebagai grup.

Konfigurasi disimpan di direktori konfigurasi pengguna Anda (biasanya ~/.config/gdcloud di MacOS dan Linux).

Catatan: Anda harus mengaktifkan direktori konfigurasi untuk penulisan.

Jika memiliki beberapa konfigurasi, Anda dapat memilih untuk beralih di antara konfigurasi tersebut, atau menjalankan perintah menggunakan konfigurasi tertentu dengan tanda --configuration. Untuk mengetahui informasi selengkapnya tentang cara mengganti konfigurasi, lihat bagian tentang Mengaktifkan konfigurasi.

Untuk membaca konfigurasi dari command line beserta daftar lengkap properti yang tersedia dan bagiannya, jalankan gdcloud topic configurations.

Konfigurasi default

gdcloud CLI akan memulai Anda dengan satu konfigurasi bernama default. Untuk menyetel properti dalam konfigurasi, jalankan perintah gdcloud init atau gdcloud config set.

Beberapa konfigurasi

Konfigurasi default tunggal cocok untuk banyak kasus penggunaan. Namun, Anda juga dapat membuat konfigurasi tambahan dan beralih di antara konfigurasi tersebut sesuai kebutuhan menggunakan gdcloud config configurations activate. Tidak ada yang spesial dengan konfigurasi default awal; konfigurasi ini dibuat untuk kenyamanan. Anda dapat memberi nama konfigurasi ini dan konfigurasi tambahan lainnya sesuai keinginan Anda.

Beberapa konfigurasi berguna jika Anda ingin:

• Menggunakan beberapa project: Anda dapat membuat konfigurasi terpisah untuk setiap project dan beralih di antara project tersebut sesuai kebutuhan.
• Gunakan beberapa URL konsol organisasi.
• Menjalankan tugas yang umumnya independen: Misalnya, Anda dapat menggunakan satu konfigurasi untuk mengerjakan layanan A dalam satu project dan mengelola layanan B yang tidak terkait dalam project lain.

Membuat konfigurasi

Untuk membuat konfigurasi, jalankan gdcloud config configurations create:

gdcloud config configurations create NAME

Anda harus mengaktifkan konfigurasi baru setelah dibuat agar dapat menggunakannya.

Mengaktifkan konfigurasi

Hanya satu dari beberapa konfigurasi Anda yang dapat aktif pada waktu tertentu. Konfigurasi aktif adalah konfigurasi yang propertinya mengatur perilaku gcloud CLI.

Untuk mengaktifkan konfigurasi baru atau beralih ke konfigurasi aktif baru, jalankan: gdcloud config configurations activate:

gdcloud config configurations activate NAME

gdcloud config list selalu menampilkan properti dalam konfigurasi aktif Anda.

Untuk mengubah konfigurasi aktif untuk satu pemanggilan perintah, Anda dapat menggunakan flag --configuration untuk perintah gdcloud CLI apa pun:

gdcloud auth print-identity-token --configuration=CONFIGURATION

Mencantumkan konfigurasi

Untuk mencantumkan konfigurasi di gdcloud CLI, jalankan:

gdcloud config configurations list

gdcloud CLI mencantumkan konfigurasi dan menunjukkan konfigurasi mana yang aktif:

NAME                ISACTIVE   PROPERTIES.CORE.PROJECT PROPERTIES.CORE.ORGANIZATIONCONSOLEURL
default             False      example-project-default https://console.default-org.example.com
config-project-1    False      example-project-1       https://console.org-1.example.com
config-project-2    False      example-project-2       https://console.org-2.example.com

Menetapkan properti konfigurasi

Untuk menetapkan dan membatalkan penetapan properti dalam konfigurasi aktif, jalankan:

gdcloud config set project PROJECT

Melihat properti konfigurasi

Untuk melihat properti dalam konfigurasi, jalankan:

gdcloud config configurations describe NAME

gdcloud CLI mencetak properti konfigurasi:

is_active: false
name: default
properties:
  accessibility:
    screen_reader: "false"
  auth:
    insecure_skip_tls_verify: "false"
    login_config_cert_path: /tmp/root-web-tls-ca.cert
  core:
    organization_console_url: https://console.example.com
    project: example-project

Untuk melihat properti dalam konfigurasi aktif, jalankan:

gdcloud config list

Menghapus konfigurasi

Untuk menghapus konfigurasi, jalankan:

gdcloud config configurations delete NAME

Anda tidak dapat menghapus konfigurasi yang aktif. Untuk beralih ke konfigurasi lain sebelum menghapus, gunakan gdcloud config configurations activate jika diperlukan.