Konfigurasi adalah kumpulan properti Distributed Cloud CLI bernama. Properti ini adalah pasangan nilai kunci, yang disusun dalam beberapa bagian, yang mengatur perilaku gdcloud CLI.
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. Selain itu, perhatikan bahwa direktori config harus dapat ditulis.
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 dan daftar lengkap properti yang tersedia serta bagiannya, jalankan gdcloud topic
configurations.
Konfigurasi default
gdcloud CLI awalnya membuat satu konfigurasi bernama
default. Anda dapat menetapkan properti dalam konfigurasi dengan menjalankan perintah gdcloud
init atau dengan menjalankan gdcloud config set secara langsung.
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. Konfigurasi default
awal dibuat untuk memudahkan, dan tidak diperlukan untuk digunakan. 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 NAME
Anda harus mengaktifkan konfigurasi baru setelah dibuat untuk menggunakannya.
Mengaktifkan konfigurasi
Hanya satu dari beberapa konfigurasi Anda yang dapat aktif pada waktu tertentu. Konfigurasi aktif adalah konfigurasi yang propertinya akan mengatur perilaku gdcloud CLI.
Untuk mengaktifkan konfigurasi baru atau beralih ke konfigurasi aktif baru, jalankan:
gdcloud config configurations activate NAME
gdcloud config list akan selalu menampilkan properti dalam konfigurasi aktif Anda.
Untuk mengubah konfigurasi aktif untuk satu pemanggilan perintah, terapkan
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:
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.