Membuat tutorial pribadi di Cloud Shell

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

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 Anda.

Mengadakan tutorial pribadi

Untuk membuat tutorial Anda bersifat pribadi, Anda memerlukan repositori Git pribadi untuk menghostingnya. Anda dapat menggunakan layanan hosting repositori Git apa pun 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. Buat clone repositori Anda ke Cloud Shell:

    gcloud source repos clone REPO_NAME

  4. Pindahkan file tutorial Anda 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 di-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. Melihat repositori dan isinya di konsol Google Cloud :

    Open Cloud Source Repositories

Untuk membantu pengguna mengakses tutorial Anda, Anda dapat menggunakan fitur Buka di Cloud Shell Cloud Shell yang memungkinkan Anda menentukan cara pengguna mengakses tutorial Anda. Untuk mengetahui detail 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 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 lebih lanjut pengalaman tutorial pribadi dengan menyediakan alat kustom bagi pengguna untuk berinteraksi dengan 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 bagi pengguna.