Membuat tutorial pribadi di Cloud Shell

Cloud Shell mendukung pembuatan tutorial pribadi, sehingga Anda dapat mendesain tutorial khusus untuk audiens.

Setelah menulis tutorial menggunakan panduan Menulis tutorial di Cloud Shell dan mengikuti praktik terbaik yang dijelaskan dalam panduan Gaya Tutorial, Anda dapat menghosting tutorial di repositori Git pribadi agar tersedia bagi pengguna.

Mengadakan tutorial pribadi

Untuk membuat tutorial bersifat pribadi, Anda memerlukan repositori Git pribadi untuk menghostingnya. Anda dapat menggunakan layanan hosting repositori Git yang Anda inginkan. Panduan ini menggunakan Cloud Source Repositories; repositori Git pribadi yang dihosting di Google Cloud.

Untuk membuat repositori Cloud Source Repositories guna menghosting tutorial pribadi Anda:

  1. Luncurkan terminal Cloud Shell. Untuk sesi Cloud Shell mandiri, gunakan shell.cloud.google.com.

  2. Buat repositori pribadi:

    gcloud source repos create REPO_NAME

  3. Clone repositori Anda ke Cloud Shell:

    gcloud source repos clone REPO_NAME

  4. Pindahkan file tutorial ke repositori yang dibuat secara lokal:

    mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL

  5. Buka repositori lokal Anda:

    cd REPO_NAME

  6. Tambahkan tutorial untuk melakukan commit:

    git add .

  7. Lakukan commit file ke repositori dengan komentar yang menjelaskan histori tindakan ini:

    git commit -m "Add private tutorial to Cloud Source Repositories"

  8. Dengan menggunakan perintah git push, tambahkan konten repositori lokal ke Cloud Source Repositories:

    git push origin master

  9. Lihat repositori dan kontennya di konsol Google Cloud:

    Buka Cloud Source Repositories

Untuk membantu pengguna membuka tutorial, Anda dapat menggunakan fitur Buka di Cloud Shell di Cloud Shell yang memungkinkan Anda menentukan cara pengguna mengakses tutorial. Untuk mengetahui detail tentang cara menyesuaikan link, lihat Panduan Buka di Cloud Shell.

Untuk tutorial yang dihosting di repositori Cloud Source Repositories, Anda harus menentukan parameter cloudshell_git_repo dengan URL repositori Anda.

Contoh link dengan cloudshell_git_repo yang ditentukan:

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name

Anda dapat menata gaya link ini sebagai tombol untuk disematkan dalam dokumentasi agar pengguna dapat menemukannya dengan mudah:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name)

Menyesuaikan tutorial dengan alat add-on

Anda dapat menyesuaikan pengalaman tutorial pribadi lebih lanjut dengan menyediakan alat kustom kepada pengguna untuk menggunakan tutorial Anda.

Untuk melakukannya, Anda dapat membuat image Docker yang berfungsi sebagai lingkungan Cloud Shell kustom dengan semua paket tambahan dan konfigurasi kustom yang ingin Anda sediakan untuk pengguna. Untuk mengetahui detail tentang cara membuat image container kustom dan memperbarui link Buka di Cloud Shell untuk mereferensikan image container ini, lihat Panduan menyesuaikan image container.