Mengelola konfigurasi gcloud CLI

Konfigurasi adalah kumpulan properti Google Cloud CLI yang diberi nama. Properti ini adalah pasangan nilai kunci, yang diatur dalam bagian, yang mengatur perilaku gcloud CLI.

Properti yang biasanya disimpan dalam konfigurasi mencakup zona Compute Engine default, tingkat kedetailan, pelaporan penggunaan, project ID, dan pengguna atau akun layanan aktif. Konfigurasi memungkinkan Anda menentukan dan mengaktifkan setelan ini dan setelan lainnya secara bersamaan sebagai grup.

Konfigurasi disimpan di direktori konfigurasi pengguna (biasanya ~/.config/gcloud di MacOS dan Linux, atau %APPDATA%\gcloud di Windows); Anda dapat menemukan lokasi direktori konfigurasi dengan menjalankan gcloud info --format='value(config.paths.global_config_dir)'. Direktori konfigurasi dapat diubah dengan menetapkan variabel lingkungan CLOUDSDK_CONFIG. Selain itu, perhatikan bahwa direktori konfigurasi harus diaktifkan untuk ditulis. Namun, jika Anda menggunakan Cloud Shell, preferensi gcloud CLI Anda akan disimpan di folder tmp sementara, yang ditetapkan hanya untuk tab Cloud Shell saat ini, dan tidak akan tetap ada di seluruh sesi.

Jika memiliki beberapa konfigurasi, Anda dapat memilih untuk beralih antar-konfigurasi atau menjalankan perintah menggunakan konfigurasi tertentu (dengan bantuan flag --configuration). Untuk informasi selengkapnya tentang cara beralih konfigurasi, lihat bagian di bawah tentang Mengaktifkan konfigurasi.

Untuk membaca konfigurasi dari command line (beserta daftar lengkap properti yang tersedia dan bagian tempatnya), jalankan gcloud topic configurations.

Konfigurasi default

gcloud CLI memulai Anda dengan satu konfigurasi bernama default. Anda dapat menetapkan properti dalam konfigurasi dengan menjalankan perintah gcloud init atau dengan menjalankan gcloud config set secara langsung.

Misalnya, untuk menonaktifkan perintah pembuatan skrip, jalankan:

gcloud config set disable_prompts true

Beberapa konfigurasi

Satu konfigurasi default cocok untuk banyak kasus penggunaan. Namun, Anda juga dapat membuat konfigurasi tambahan dan beralih di antara konfigurasi tersebut sesuai kebutuhan menggunakan gcloud config configurations activate. Tidak ada yang spesial dengan konfigurasi default awal; konfigurasi ini dibuat untuk memudahkan. Anda dapat memberi nama ini dan konfigurasi tambahan apa pun sesuai keinginan.

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.
  • Menggunakan beberapa akun otorisasi
  • Melakukan tugas yang umumnya independen: Misalnya, Anda dapat menggunakan satu konfigurasi untuk mengerjakan aplikasi App Engine dalam satu project dan mengelola instance Compute Engine yang tidak terkait dalam project lain.

Membuat konfigurasi

Untuk membuat konfigurasi, jalankan gcloud config configurations create:

gcloud config configurations create [NAME]

Anda harus mengaktifkan konfigurasi baru setelah pembuatan 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 gcloud CLI.

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

gcloud config configurations activate [NAME]

gcloud config list akan selalu menampilkan properti dalam konfigurasi aktif Anda.

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

gcloud auth list --configuration=[CONFIGURATION_NAME]

Untuk mengubah konfigurasi aktif untuk semua perintah di terminal saat ini, Anda dapat menetapkan variabel lingkungan CLOUDSDK_ACTIVE_CONFIG_NAME ke nama konfigurasi yang ingin digunakan.

Mengotomatiskan pengalihan konfigurasi

Untuk membantu membuat perubahan konfigurasi menjadi lancar, Anda dapat memanfaatkan alat seperti direnv dan ondir untuk beralih antar-konfigurasi secara otomatis saat Anda beralih direktori kerja. Salah satu cara untuk melakukannya adalah dengan menetapkan variabel lingkungan yang diperlukan (seperti CLOUDSDK_ACTIVE_CONFIG_NAME) dalam file .envrc di direktori utama project Anda.

Konfigurasi listingan

Untuk mencantumkan konfigurasi dalam penginstalan gcloud CLI, jalankan gcloud config configurations list:

gcloud config configurations list

gcloud CLI mencantumkan konfigurasi dan menampilkan konfigurasi mana yang aktif:

NAME         IS_ACTIVE     ACCOUNT            PROJECT               DEFAULT_ZONE  DEFAULT_REGION
default      False         user@gmail.com     example-project-1     us-east1-b    us-east1
project-1    False         user@gmail.com     example-project-2     us-east1-c    us-east1
project-2    True          user@gmail.com     example-project-3     us-east1-b    us-east1

Menetapkan properti konfigurasi

Untuk menetapkan dan membatalkan penetapan properti dalam konfigurasi aktif, jalankan gcloud config set dan gcloud config unset:

gcloud config set project [PROJECT]

gcloud config unset project

Properti juga dapat ditetapkan melalui variabel lingkungan bernama CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Misalnya, Anda dapat menetapkan properti core/project dan compute/zone sebagai berikut:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]

CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Melihat properti konfigurasi

Untuk melihat properti dalam konfigurasi, jalankan: gcloud config configurations describe:

gcloud config configurations describe [NAME]

Atau, untuk melihat properti dalam konfigurasi aktif:

gcloud config list

gcloud CLI akan mencetak properti konfigurasi:

is_active: false
name: default
properties:
  compute:
    region: us-east1
    zone: us-east1-b
  core:
    account: user@google.com
    project: example-project

Menghapus konfigurasi

Untuk menghapus konfigurasi, jalankan: gcloud config configurations delete:

gcloud config configurations delete [NAME]

Anda tidak dapat menghapus konfigurasi aktif. Gunakan gcloud config configurations activate jika diperlukan untuk beralih ke konfigurasi lain sebelum menghapus.

Langkah selanjutnya