Mengelola konfigurasi gcloud CLI

Konfigurasi adalah kumpulan properti Google Cloud CLI yang bernama. 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, pelaporan penggunaan, project ID, dan pengguna aktif atau akun layanan. Dengan konfigurasi, Anda dapat menentukan dan mengaktifkan setelan ini dan setelan lainnya bersama-sama sebagai satu 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 config harus mendukung penulisan. Namun, jika Anda menggunakan Cloud Shell, preferensi gcloud CLI akan disimpan dalam folder tmp sementara, ditetapkan hanya untuk tab Cloud Shell saat ini, dan tidak dipertahankan di seluruh sesi.

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

Untuk membaca konfigurasi dari command line (beserta daftar lengkap properti yang tersedia dan bagian tempatnya 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 permintaan 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 antar-konfigurasi sesuai kebutuhan menggunakan gcloud config configurations activate. Tidak ada yang spesial dengan konfigurasi default awal; konfigurasi ini dibuat untuk kenyamanan. Anda dapat memberi nama ini dan konfigurasi tambahan sesuai keinginan.

Beberapa konfigurasi berguna jika Anda ingin:

  • Menggunakan beberapa project: Anda dapat membuat konfigurasi terpisah untuk setiap project dan beralih antar-project sesuai kebutuhan.
  • Menggunakan beberapa akun otorisasi
  • Melakukan tugas-tugas yang bersifat independen secara umum: Misalnya, Anda dapat menggunakan satu konfigurasi untuk mengerjakan aplikasi App Engine di 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 pembuatan 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 yang baru, jalankan: gcloud config configurations activate:

gcloud config configurations activate [NAME]

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

Guna mengubah konfigurasi aktif untuk pemanggilan perintah tunggal, Anda dapat menggunakan flag --configuration pada perintah gcloud CLI:

gcloud auth list --configuration=[CONFIGURATION_NAME]

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

Mengotomatiskan pengalihan konfigurasi

Agar perubahan konfigurasi menjadi lancar, Anda dapat memanfaatkan alat seperti direnv dan ondir untuk otomatis beralih antar-konfigurasi saat beralih direktori yang sedang dikerjakan. 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 menampilkan daftar 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 seperti berikut:

CLOUDSDK_CORE_PROJECT=[YOUR_PROJECT_NAME]

CLOUDSDK_COMPUTE_ZONE=[YOUR_ZONE_NAME]

Menampilkan 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 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