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 penyimpanan persistent disk gratis sebesar 5 GB yang terpasang sebagai direktori $HOME. Semua file yang Anda simpan di direktori utama, termasuk software yang diinstal, skrip, dan file konfigurasi pengguna seperti .bashrc dan .vimrc, akan tetap ada untuk sesi lainnya. Karena .bashrc Anda tetap ada di seluruh sesi, ini adalah cara yang tepat untuk menyesuaikan perilaku Cloud Shell Anda. Demikian pula, agar instalasi Anda bertahan, Anda dapat menginstal paket ke direktori {i>home<i} Anda.

Variabel lingkungan yang telah dikonfigurasi sebelumnya

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

Variabel lingkungan CLOUD_SHELL disetel 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 di folder tmp sementara, ditetapkan hanya untuk tab Anda saat ini, dan tidak dipertahankan di seluruh sesi.

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

  • Agar konfigurasi gcloud CLI tetap dapat disesuaikan per tab, tetapi juga untuk menyesuaikan konfigurasi default-nya, Anda dapat menambahkan perintah konfigurasi gcloud (seperti gcloud config set compute/region us-central1 untuk menyetel region default) ke akhir file $HOME/.bashrc.

    Hal ini memastikan bahwa setiap tab baru mewarisi project Google Cloud Console Anda dan konfigurasi default yang disesuaikan. Selain itu, Anda juga dapat menyesuaikan setiap konfigurasi tab lebih lanjut.

  • Agar selalu menggunakan konfigurasi gcloud CLI yang sama, tambahkan export CLOUDSDK_CONFIG=$HOME/.config/gcloud di akhir file .bashrc, 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 sedang aktif, dengan mematuhi format berikut: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Untuk memilih region yang diinginkan, 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 lebih lengkap tentang properti setelan, baca panduan properti gcloud CLI.

Penyesuaian lingkungan

Dengan penyesuaian lingkungan, Anda dapat menginstal paket tambahan ke lingkungan Cloud Shell saat dimulai.

Skrip penyesuaian lingkungan

Cloud Shell secara otomatis menjalankan skrip, $HOME/.customize_environment, saat instance Anda melakukan booting. Tidak seperti .profile atau .bashrc, skrip ini berjalan satu kali saat Cloud Shell melakukan booting (bukan sekali untuk setiap login shell).

Skrip ini dijalankan 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 pada 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 Anda dapat ditemukan di /var/log/customize_environment. Skrip .customize_environment berjalan sebagai proses latar belakang dan jika eksekusi berhasil, skrip akan menyentuh /google/devshell/customize_environment_done. Karena penginstalan paket dijalankan secara paralel dengan login Anda, paket yang diinstal mungkin tersedia beberapa saat setelah Anda mencapai perintah login.

Membuka Cloud Shell dengan akun pengguna yang ditentukan

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 default yang digunakan untuk login. Misalnya, Anda dapat membuka Cloud Shell dan login sebagai client1@example.com menggunakan URL shell.cloud.google.com?authuser=client1@example.com.

Penyesuaian image container

Dengan penyesuaian image container, Anda dapat membuat image Docker yang berfungsi sebagai lingkungan Cloud Shell kustom dengan paket tambahan yang ditentukan dan konfigurasi kustom. Image Docker Anda harus didasarkan pada image Cloud Shell dasar dan dihosting di Container Registry.

Untuk mengetahui detail cara membuat image container kustom, lihat panduan Menyesuaikan image container.

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

dukungan tmux

Cloud Shell menggunakan tmux secara default sehingga dapat meningkatkan persistensi di seluruh sesi tab browser. Misalnya, jika Anda memuat ulang Google Cloud Console di tab atau terhubung ke Cloud Shell dari komputer yang berbeda, status sesi tidak akan hilang.

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

Untuk menonaktifkan tmux di Cloud Shell, klik tombol Terminal Settings (ikon kunci pas), pilih Tmux Settings, lalu batalkan pilihan opsi Enable Tmux Integration.

Statistik penggunaan

Cloud Shell mengumpulkan statistik penggunaan anonim terkait perintah yang dijalankan di dalam terminal Cloud Shell. Statistik hanya dikumpulkan berdasarkan perintah yang telah diinstal 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 diteruskan ke perintah ini.

Untuk mengubah preferensi pengumpulan metrik kapan saja, pilih Terminal Usage Statistics di menu Settings Tombol Setelan. Perubahan apa pun pada preferensi Anda di menu Setelan akan berlaku di sesi berikutnya. Untuk mengaktifkan atau menonaktifkan pengumpulan metrik, tutup tab 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 di sesi Cloud Shell Anda:

gcloud config set disable_usage_reporting true