Menyesuaikan gambar container Cloud Shell

Halaman ini menjelaskan cara membuat dan menggunakan image Docker kustom sebagai lingkungan Cloud Shell.

Untuk membuat pengalaman Cloud Shell kustom, buat image Docker yang berfungsi sebagai lingkungan Cloud Shell kustom dengan paket tambahan dan konfigurasi kustom yang telah Anda tentukan. Image Docker Anda harus didasarkan pada image Cloud Shell dasar dan dihosting di Container Registry.

Membuat image Docker kustom

Untuk mengikuti panduan langkah demi langkah tugas ini langsung di Cloud Shell Editor, klik Pandu saya:

Pandu saya

Buat image Docker kustom Anda sendiri dengan mengikuti petunjuk berikut:

Di tab terminal Cloud Shell, jalankan perintah berikut untuk membuat image kustom boilerplate dalam repositori yang dihosting oleh Cloud Source Repositories:
```
cloudshell env create-custom-image NEW_REPO_NAME
```
Catatan: Jika ingin menggunakan repositori yang ada, Anda dapat melihat daftar repositori dengan menjalankan gcloud source repos list.

Atau, jika lebih suka men-deploy secara manual ke Container Registry atau menggunakan alur otomatisasi Anda sendiri, Anda dapat membuat Dockerfile baru yang kosong dan langsung menuju ke langkah 3.
Buka Dockerfile baru Anda dengan mengikuti petunjuk yang tercetak pada command line:
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Tambahkan paket tambahan yang ingin Anda sediakan di pengalaman Cloud Shell Anda di bawah baris pertama. Contoh:
```
FROM gcr.io/cloudshell-images/cloudshell:latest
RUN apt-get -y install lsof
```
Baris pertama di Dockerfile Anda, FROM gcr.io/cloudshell-images/cloudshell:latest, mereferensikan image Cloud Shell dasar dan tidak boleh dihapus.
Bangun image Anda secara lokal dengan menjalankan:
```
cloudshell env build-local
```
Uji image Anda secara lokal dan pastikan paket yang diinstal ada dengan menjalankan:
```
cloudshell env run
```
Untuk keluar dari pengujian, jalankan:
```
exit
```

Commit perubahan kode Anda secara lokal:

git commit -a -m "Initial custom environment check-in."

Kirim perubahan kode Anda ke Cloud Source Repositories:
```
git push origin master
```
Terakhir, kirim image kustom Anda ke Container Registry:
```
cloudshell env push
```

Memperbarui link Buka di Cloud Shell

Untuk menggunakan gambar kustom dengan link Buka di Cloud Shell, Anda harus menjadikannya publik terlebih dahulu. Untuk mengetahui langkah-langkah membuat image kustom menjadi publik, ikuti panduan kontrol akses Container Registry.

Setelah menyiapkan setelan akses yang tepat, Anda dapat memperbarui link Open in Cloud Shell untuk menentukan parameter cloudshell_git_repo dan cloudshell_image. Misalnya, untuk menambahkan tombol Open in Cloud Shell, edit URL dalam contoh berikut, lalu tambahkan link yang serupa dengan berikut ke file Markdown Anda:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=REPO_URL&cloudshell_image=DOCKER_IMAGE_URL)

Ganti nilai berikut:

REPO_URL: URL ke lokasi repositori Anda
DOCKER_IMAGE_URL: URL ke image Docker

Untuk mengetahui informasi selengkapnya tentang parameter ini dan parameter lainnya, baca bagian Membuka di Cloud Shell.

Menjaga agar image container kustom tetap terbaru

Container kustom Anda harus didasarkan pada image Cloud Shell publik terbaru agar berfungsi di Cloud Shell. Sebaiknya lakukan rebuild setiap minggu agar image kustom tetap terbaru.