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 dipasang 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 tetap ada, Anda dapat menginstal paket ke direktori utama.

Variabel lingkungan yang telah dikonfigurasi sebelumnya

Saat Cloud Shell dimulai, project aktif di Cloud Shell akan disebarkan ke konfigurasi gcloud Anda di dalam Cloud Shell untuk langsung 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 di folder tmp sementara, yang ditetapkan hanya untuk tab saat ini, dan tidak disimpan di seluruh sesi.

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

• Agar konfigurasi gcloud CLI 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.

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

• Untuk selalu menggunakan konfigurasi gcloud CLI yang sama, tambahkan export CLOUDSDK_CONFIG=$HOME/.config/gcloud ke 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 diperbarui untuk mencerminkan project yang saat ini aktif, dengan mengikuti 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 dalam lingkungan Cloud Shell saat dimulai.

Skrip penyesuaian lingkungan

Cloud Shell akan 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 satu kali 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 Anda 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 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 login 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 ditentukan. Image Docker Anda harus didasarkan pada image Cloud Shell dasar dan dihosting di Container Registry.

Untuk mengetahui detail tentang 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 image kustom dengan link Buka di 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 komputer lain, status sesi tidak akan hilang.

Cloud Shell mendukung binding tombol tmux default. Misalnya, jika Anda menekan Ctrl+b, lalu %, tmux akan memisahkan 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 diinstal sebelumnya di Cloud Shell. Metrik ini tidak dapat dikaitkan kembali ke akun Anda.

Metrik tidak dikumpulkan berdasarkan informasi identitas pribadi, seperti argumen yang diteruskan ke perintah ini.

Untuk mengubah preferensi pengumpulan metrik kapan saja, pilih Terminal Usage Statistics di menu Settings . Setiap perubahan pada preferensi Anda di menu Setelan akan berlaku pada 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 dalam sesi Cloud Shell Anda:

gcloud config set disable_usage_reporting true