Halaman ini diterjemahkan oleh Cloud Translation API.

Menyesuaikan image container Cloud Shell

Halaman ini menjelaskan cara membuat dan menggunakan image Docker kustom sebagai lingkungan Cloud Shell untuk tutorial dan aktivitas pembelajaran.

Untuk membuat pengalaman Cloud Shell kustom, buat 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 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 di 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 Anda lebih suka men-deploy secara manual ke Container Registry atau menggunakan alur otomatisasi Anda sendiri, Anda dapat membuat Dockerfile baru yang kosong dan langsung ke langkah 3.
Buka Dockerfile baru dengan mengikuti petunjuk yang dicetak ke command line Anda:
```
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
```
Tambahkan paket tambahan yang ingin Anda sediakan di pengalaman Cloud Shell 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.
Build image Anda secara lokal dengan menjalankan:
```
cloudshell env build-local
```
Uji image 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 image kustom dengan link Buka di Cloud Shell, Anda harus membuatnya publik terlebih dahulu. Untuk mengetahui langkah-langkah dalam membuat image kustom bersifat publik, ikuti panduan kontrol akses Container Registry.

Setelah menyiapkan setelan akses yang tepat, Anda dapat memperbarui link Buka di Cloud Shell untuk menentukan parameter cloudshell_git_repo dan cloudshell_image. Misalnya, untuk menambahkan tombol Buka di Cloud Shell, edit URL dalam contoh berikut, lalu tambahkan link yang mirip 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, lihat Membuka di Cloud Shell.

Menjaga image container kustom tetap terbaru

Penampung kustom Anda harus didasarkan pada image Cloud Shell publik terbaru agar dapat berfungsi di Cloud Shell. Sebaiknya Anda melakukan build ulang mingguan agar image kustom selalu yang terbaru.