Mengonfigurasi Cloud Shell

Halaman ini menjelaskan cara mengonfigurasi Cloud Shell untuk menyesuaikan pengalaman Anda.

File konfigurasi di direktori beranda Cloud Shell Anda

Cloud Shell menyediakan 5 GB penyimpanan persistent disk gratis yang terpasang sebagai direktori $HOME Anda. Semua file yang Anda simpan di direktori beranda, termasuk software yang diinstal, skrip, dan file konfigurasi pengguna seperti .bashrc dan .vimrc, tetap ada untuk sesi lainnya. Karena .bashrc Anda tetap ada di seluruh sesi, ini adalah cara yang bagus untuk menyesuaikan perilaku Cloud Shell Anda. Demikian pula, agar penginstalan Anda tetap ada, Anda dapat menginstal paket ke direktori beranda.

Variabel lingkungan yang telah dikonfigurasi sebelumnya

Saat Cloud Shell dimulai, project aktif di Cloud Shell akan disebarkan ke konfigurasi gcloud di dalam Cloud Shell untuk segera digunakan. GOOGLE_CLOUD_PROJECT, variabel lingkungan yang digunakan oleh dukungan library Kredensial Default Aplikasi untuk menentukan project ID, juga ditetapkan untuk mengarah ke project aktif di Cloud Shell.

Variabel lingkungan CLOUD_SHELL ditetapkan ke true. Variabel ini dapat diperiksa dari aplikasi untuk menentukan apakah aplikasi berjalan di Cloud Shell.

Preferensi gcloud CLI

Saat menggunakan Cloud Shell, preferensi gcloud CLI Anda disimpan dalam folder tmp sementara, yang ditetapkan hanya untuk tab saat ini, dan tidak dipertahankan di seluruh sesi.

Agar konfigurasi gcloud CLI Anda tetap ada, Anda dapat menyetelnya menggunakan salah satu metode berikut:

• Untuk menjaga konfigurasi gcloud CLI Anda tetap dapat disesuaikan per tab, tetapi menyesuaikan konfigurasi default itu sendiri, Anda dapat menambahkan perintah konfigurasi gcloud (seperti gcloud config set compute/region us-central1 untuk menetapkan region default) ke akhir file $HOME/.bashrc Anda.

  Tindakan ini memastikan bahwa setiap tab baru mewarisi project konsol Google Cloud dan konfigurasi default yang disesuaikan, tetapi juga memungkinkan Anda menyesuaikan lebih lanjut konfigurasi setiap tab.

• Untuk selalu menggunakan konfigurasi gcloud CLI yang sama, tambahkan export CLOUDSDK_CONFIG=$HOME/.config/gcloud di akhir file .bashrc Anda, lalu jalankan gcloud config configurations create CONFIG_NAME untuk membuat konfigurasi yang ingin Anda gunakan.

Properti umum

Untuk menetapkan project yang ingin Anda kerjakan, jalankan:

gcloud config set project [PROJECT_NAME]

Command prompt Anda akan diperbarui untuk mencerminkan project yang saat ini aktif, dengan format ini: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Untuk memilih wilayah pilihan Anda, jalankan:

gcloud config set compute/region us-east1

Perintah di atas adalah contoh konfigurasi gcloud CLI yang dapat Anda tetapkan; untuk mengetahui daftar lengkap dan detail selengkapnya tentang cara menetapkan properti, lihat panduan properti gcloud CLI.

Penyesuaian lingkungan

Catatan: Jika Anda ingin paket tertentu disertakan dengan Cloud Shell secara default, kirimkan saran Anda sebagai masukan.

Penyesuaian lingkungan memungkinkan Anda menginstal paket tambahan ke lingkungan Cloud Shell saat dimulai.

Skrip penyesuaian lingkungan

Cloud Shell akan otomatis menjalankan skrip, $HOME/.customize_environment, saat instance Anda di-boot. Tidak seperti .profile atau .bashrc, skrip ini berjalan sekali saat Cloud Shell di-boot (bukan sekali untuk setiap login shell).

Skrip ini berjalan sebagai root dan Anda dapat menginstal paket apa pun yang ingin ada di setiap sesi Cloud Shell menggunakan perintah pengelolaan paket Debian.

Misalnya, jika Anda ingin menginstal erlang di Cloud Shell, file .customize_environment Anda akan terlihat seperti ini:

#!/bin/sh
apt-get update
apt-get -y install erlang

Log eksekusi skrip .customize_environment dapat ditemukan di /var/log/customize_environment. Skrip .customize_environment berjalan sebagai proses latar belakang dan jika berhasil dieksekusi, akan menyentuh /google/devshell/customize_environment_done. Karena penginstalan paket berjalan secara paralel dengan proses login Anda, paket yang diinstal mungkin tersedia beberapa saat setelah Anda mencapai perintah login.

Membuka Cloud Shell dengan akun pengguna tertentu

Parameter authuser memungkinkan Anda menentukan akun pengguna yang akan digunakan dengan Cloud Shell. Anda harus login dengan akun pengguna yang ditentukan. Jika Anda tidak login ke akun yang ditentukan, Cloud Shell akan terbuka dengan akun yang login secara default. Misalnya, Anda dapat membuka Cloud Shell yang login sebagai [e-mail] menggunakan URL shell.cloud.google.com?authuser=[e-mail].

Penyesuaian image container

Penyesuaian image container memungkinkan Anda membuat image Docker yang berfungsi sebagai lingkungan Cloud Shell kustom dengan paket tambahan dan konfigurasi kustom yang Anda tentukan. Image Docker Anda harus didasarkan pada image Cloud Shell dasar dan dihosting di Artifact Registry.

Tidak seperti penyesuaian lingkungan, penyesuaian image container tidak memengaruhi pengalaman Cloud Shell default Anda. Anda dapat menggunakan dan membagikan image kustom dengan link Open in Cloud Shell.

Dukungan tmux

Cloud Shell menggunakan tmux, yang memungkinkannya meningkatkan persistensi di seluruh sesi tab browser. Misalnya, jika Anda memuat ulang konsol Google Cloud di tab atau terhubung ke Cloud Shell dari mesin lain, status sesi tidak akan hilang.

Cloud Shell mendukung pengikatan tombol tmux default. Misalnya, jika Anda menekan Ctrl+b, lalu %, tmux akan membagi jendela sesi saat ini menjadi panel kiri dan kanan, yang dapat berguna untuk proses debug.

Statistik penggunaan

Cloud Shell mengumpulkan statistik penggunaan anonim terkait perintah yang dijalankan di dalam terminal Cloud Shell. Statistik hanya dikumpulkan pada perintah yang telah terinstal sebelumnya di Cloud Shell. Metrik ini tidak dapat dikaitkan kembali dengan akun Anda.

Metrik tidak dikumpulkan pada informasi identitas pribadi apa pun, seperti argumen yang dikirimkan ke perintah ini.

Untuk mengubah preferensi pengumpulan metrik kapan saja, pilih Statistik Penggunaan Terminal di menu Setelan . Setiap perubahan preferensi Anda di menu Setelan akan berlaku pada sesi berikutnya. Untuk mengaktifkan atau menonaktifkan pengumpulan metrik, tutup tab Anda dan buka tab lain setelah Anda melakukan perubahan.

Catatan: Ini terpisah dari statistik penggunaan gcloud, yang diaktifkan secara default di Cloud Shell.

Untuk menonaktifkan pengumpulan metrik gcloud CLI, jalankan perintah berikut dalam sesi Cloud Shell Anda:

gcloud config set disable_usage_reporting true