Mengelola konfigurasi gcloud CLI

Konfigurasi adalah kumpulan properti Google Cloud CLI yang diberi nama. Properti ini adalah key-value pair, yang diatur dalam beberapa bagian, yang mengatur perilaku gcloud CLI.

Properti yang biasanya disimpan dalam konfigurasi mencakup zona Compute Engine default, tingkat panjang respons, pelaporan penggunaan, project ID, dan akun pengguna atau layanan yang aktif. Konfigurasi memungkinkan Anda menentukan dan mengaktifkan setelan ini dan setelan lainnya bersama-sama 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 penulisan. Namun, jika Anda menggunakan Cloud Shell, preferensi gcloud CLI Anda disimpan dalam folder tmp sementara, yang ditetapkan hanya untuk tab Cloud Shell saat ini, dan tidak dipertahankan di seluruh sesi.

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

Untuk membaca tentang konfigurasi dari command line (beserta daftar lengkap properti yang tersedia dan bagian tempat properti tersebut berada), 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 untuk pembuatan skrip, jalankan:

gcloud config set disable_prompts true

Beberapa konfigurasi

Konfigurasi default tunggal cocok untuk banyak kasus penggunaan. Namun, Anda juga dapat membuat konfigurasi tambahan dan beralih di antaranya sesuai kebutuhan menggunakan gcloud 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.

Beberapa konfigurasi berguna jika Anda ingin:

  • Menggunakan beberapa project: Anda dapat membuat konfigurasi terpisah untuk setiap project dan beralih di antaranya 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 di project lain.

Membuat konfigurasi

Untuk membuat konfigurasi, jalankan gcloud config configurations create:

gcloud 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 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 Anda gunakan.

Mengotomatiskan pengalihan konfigurasi

Untuk membantu mengubah konfigurasi dengan 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 root 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 menunjukkan 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 berikutnya