Dengan fitur Buka di Cloud Shell, Anda dapat memublikasikan link yang membuka Google Cloud Console dengan repositori Git yang di-clone ke Cloud Shell dan/atau memulai Cloud Shell dengan gambar kustom. Anda juga dapat mencetak petunjuk ke terminal untuk membantu pengguna berinteraksi dengan konten.
Buka di link Cloud Shell membantu developer bereksperimen dengan contoh kode dan API tanpa harus mendownload Google Cloud CLI, menginstal dependensi yang diperlukan, atau menelusuri file sumber yang relevan. Halaman ini menjelaskan cara menambahkan link Open in Cloud Shell ke repositori Git Anda.
Parameter URL
Link Open in Cloud Shell, yang secara opsional disematkan dalam gambar tombol, dapat ditambahkan ke file README.md dari direktori mana pun di repositori Git Anda. Lokasi yang direkomendasikan untuk link ini adalah file README.md root dari repositori Git Anda.
Parameter URL wajib
Untuk membuat link ini, gunakan URL dasar shell.cloud.google.com (atau halaman apa pun di Konsol Google Cloud yang diawali dengan console.cloud.google.com) dengan parameter URL wajib berikut:
| Parameter URL | Deskripsi | Nilai yang Didukung |
|---|---|---|
cloudshell_git_repo |
URL repositori Git yang akan di-clone. Setelah repositori di-clone, root folder project akan terbuka, dan menampilkan kontennya di panel navigasi sebelah kiri. |
URL yang valid untuk repositori Git. URL ini terdiri dari domain yang diizinkan (GitHub atau Bitbucket) dan jalur. Karakter berikut ini diizinkan: huruf besar dan kecil, angka, garis bawah (_), tanda hubung (-), titik (.), dan garis miring (/). |
Parameter URL opsional
Anda juga dapat menentukan salah satu parameter opsional berikut:
| Parameter URL | Deskripsi | Nilai yang Didukung |
|---|---|---|
cloudshell_git_branch
|
Cabang dari repositori Git untuk melakukan clone. Hanya berlaku jika cloudshell_git_repo ditentukan. Cabang defaultnya adalah master. | Semua cabang yang valid di repositori. Karakter berikut ini diizinkan: huruf besar dan kecil, angka, tanda gelombang (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:). |
cloudshell_image
|
Image Docker kustom yang menjalankan lingkungan yang disesuaikan selama sesi. Dengan begitu, Anda dapat menyediakan alat kustom di Cloud Shell yang dapat digunakan pengguna untuk menangani repositori Anda. Membuka repositori di Cloud Shell dengan parameter yang ditentukan ini akan membuat lingkungan sementara dengan direktori beranda awal yang akan dihapus saat sesi berakhir. |
URL image Docker yang dihosting di Container Registry. Image Docker harus didasarkan pada image Cloud Shell dasar dan dapat diakses secara publik. Untuk membuat gambar yang valid, gunakan tutorial pembuatan gambar kustom yang dapat dimulai dengan menjalankan perintah berikut di Cloud Shell:
Perhatikan bahwa gambar berukuran besar memerlukan waktu beberapa saat untuk didownload ke VM Cloud Shell saat URL dibuka. |
cloudshell_open_in_editor
|
File yang akan dibuka di Cloud Shell Editor. Dapat diulang untuk menentukan beberapa file yang akan dibuka. Jika beberapa ditentukan, objek akan dibuka dalam urutan yang diberikan. File yang ditentukan akan dibuka di tab editor sebelah kanan, satu tab per file, di project yang dibuka. Jalur file bersifat relatif terhadap direktori saat ini. Jika parameter working_dir diberikan, jalur ke file ini diperlakukan sebagai relatif terhadap working_dir. |
Semua jalur file valid yang terdiri dari karakter yang diizinkan berikut: huruf besar dan kecil, angka, tanda gelombang (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:). |
cloudshell_print
|
File di repositori Git, biasanya terdiri dari petunjuk yang akan dicetak ke terminal untuk memandu langkah pengguna berikutnya. Jalur file relatif terhadap direktori saat ini. Jika parameter working_dir diberikan, jalur ke file ini diperlakukan sebagai relatif terhadap working_dir. |
Semua jalur file valid yang terdiri dari karakter yang diizinkan berikut: huruf besar dan kecil, angka, tanda gelombang (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:). |
cloudshell_tutorial
|
File Tutorial Markdown di repositori Git yang terdiri dari petunjuk untuk diluncurkan sebagai tutorial untuk memandu pengguna melalui suatu project. Jalur file relatif terhadap direktori saat ini. |
Setiap file Tutorial Markdown yang tersusun dengan baik dengan nama file yang valid. |
cloudshell_working_dir (Tidak digunakan lagi)
|
Parameter ini tidak digunakan lagi. Sebagai gantinya,
gunakan
|
Semua jalur file valid yang terdiri dari karakter yang diizinkan berikut: huruf besar dan kecil, angka, tanda gelombang (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:). |
cloudshell_workspace
|
Direktori yang berfungsi untuk Cloud Shell. Terminal akan terbuka di direktori yang ditentukan. Cloud Shell Editor akan membuka direktori sebagai ruang kerja. | Semua jalur file valid yang terkait dengan repositori yang di-clone. Anda dapat mengosongkan parameter value atau menggunakan . untuk menentukan root repositori yang di-clone. Jika tidak ada repositori yang ditentukan, jalurnya akan berhubungan dengan direktori beranda Cloud Shell. Karakter berikut diizinkan: huruf besar dan kecil, angka, tanda gelombang (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:).
|
ephemeral |
Membuka repositori di Cloud Shell dengan parameter yang ditentukan ini akan membuat lingkungan sementara dengan direktori beranda awal yang akan dihapus saat sesi berakhir. Untuk mengetahui informasi selengkapnya, lihat Memilih mode sementara. |
|
show
|
Buka hanya dengan terminal, Cloud Shell Editor, atau keduanya. |
|
Contoh
Untuk menyematkan tombol guna membuka sampel repositori Git di Cloud Shell, sertakan Markdown berikut di file README.md repositori Anda:
[](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git)
Untuk menyematkan fungsi yang sama ke dalam situs, gunakan cuplikan HTML yang setara ini:
<a href="https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git">
<img alt="Open in Cloud Shell" src ="https://gstatic.com/cloudssh/images/open-btn.svg">
</a>
Buka di generator link Cloud Shell
Untuk menentukan perilaku link Buka di Cloud Shell secara lebih spesifik, Anda dapat menggunakan formulir di bawah ini untuk bereksperimen dengan parameter yang diperlukan untuk membuka repositori di Cloud Shell.