Fitur Buka di Cloud Shell memungkinkan Anda memublikasikan link yang membuka konsol Google Cloud dengan repositori Git yang di-clone ke Cloud Shell dan/atau memulai Cloud Shell dengan image kustom. Anda juga dapat mencetak petunjuk ke terminal untuk membantu pengguna berinteraksi dengan konten.
Link Buka di 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 Buka di Cloud Shell ke repositori Git Anda.
Parameter URL
Link Buka di Cloud Shell, yang dapat 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 yang diperlukan
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 yang diperlukan 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, yang menampilkan kontennya di panel navigasi kiri. |
URL yang valid untuk repositori Git. URL ini terdiri dari domain yang diizinkan (GitHub atau Bitbucket) dan jalur. Karakter berikut 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 yang akan di-clone. Hanya berlaku jika cloudshell_git_repo ditentukan. Cabang default-nya adalah master. | Cabang apa pun yang valid di repositori. Karakter berikut diizinkan: huruf besar dan kecil, angka, tilde (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:). |
cloudshell_image
|
Image Docker kustom yang menjalankan lingkungan yang disesuaikan selama sesi. Hal ini memungkinkan Anda menyediakan alat kustom di Cloud Shell yang dapat digunakan pengguna untuk menggunakan repositori Anda. Membuka repositori di Cloud Shell dengan parameter ini yang ditentukan akan membuat lingkungan sementara dengan direktori induk awal yang 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 image yang valid, gunakan tutorial pembuatan image 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 ada beberapa yang ditentukan, file tersebut akan dibuka dalam urutan yang diberikan. File yang ditentukan akan dibuka di tab editor sebelah kanan, satu tab per file, dalam project yang dibuka. Jalur file bersifat relatif terhadap direktori saat ini. Jika parameter working_dir diberikan, jalur ke file ini akan diperlakukan sebagai relatif terhadap working_dir. |
Setiap jalur file yang valid yang terdiri dari karakter yang diizinkan berikut: huruf besar dan kecil, angka, tilde (~), 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 berikutnya pengguna. Jalur file bersifat relatif terhadap direktori saat ini. Jika parameter working_dir diberikan, jalur ke file ini diperlakukan sebagai relatif terhadap working_dir. |
Setiap jalur file yang valid yang terdiri dari karakter yang diizinkan berikut: huruf besar dan kecil, angka, tilde (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:). |
cloudshell_tutorial
|
File Markdown Tutorial di repositori Git yang berisi petunjuk untuk diluncurkan sebagai tutorial untuk memandu pengguna melalui project. Jalur file bersifat relatif terhadap direktori saat ini. |
Setiap file Markdown Tutorial yang disusun dengan baik dengan nama file yang valid. |
cloudshell_working_dir (Tidak digunakan lagi)
|
Parameter ini tidak digunakan lagi. Sebagai gantinya, gunakan
|
Setiap jalur file yang valid yang terdiri dari karakter yang diizinkan berikut: huruf besar dan kecil, angka, tilde (~), garis bawah (_), tanda hubung (-), titik (.), garis miring (/), dan titik dua (:). |
cloudshell_workspace
|
Direktori kerja untuk Cloud Shell. Terminal akan terbuka di direktori yang ditentukan. Cloud Shell Editor akan membuka direktori sebagai ruang kerja. | Jalur file valid apa pun yang relatif terhadap repositori yang di-clone. Anda dapat membiarkan
nilai parameter kosong atau menggunakan . untuk menentukan root
repositori yang di-clone. Jika tidak ada repositori yang ditentukan, jalurnya
relatif terhadap direktori utama Cloud Shell. Karakter
berikut diizinkan: huruf besar dan kecil, angka,
tilde (~), garis bawah (_), tanda hubung (-), titik (.),
garis miring (/), dan titik dua (:).
|
ephemeral |
Membuka repositori di Cloud Shell dengan parameter ini yang ditentukan akan membuat lingkungan sementara dengan direktori induk awal yang dihapus saat sesi berakhir. Untuk mengetahui informasi selengkapnya, lihat Memilih mode sementara. |
|
show
|
Buka hanya dengan terminal, hanya dengan Cloud Shell Editor, atau keduanya. |
|
Contoh
Untuk menyematkan tombol guna membuka contoh repositori Git di Cloud Shell, sertakan Markdown berikut dalam 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 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 Cloud Shell link generator
Untuk menentukan perilaku link Buka di Cloud Shell secara lebih khusus, Anda dapat menggunakan formulir di bawah untuk bereksperimen dengan parameter yang diperlukan untuk membuka repositori di Cloud Shell.