Membuat tutorial pribadi di Cloud Shell

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

Setelah membuat 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.

Anda dapat menggunakan layanan hosting repositori Git apa pun yang Anda inginkan. Panduan ini menggunakan Secure Source Manager, repositori kode sumber terkelola satu tenant yang di-deploy secara regional dan dihosting di Google Cloud, untuk menunjukkan langkah-langkahnya.

Membuat repositori Git pribadi

Instance Secure Source Manager di-deploy ke region Google Cloud yang tersedia dan dapat diakses melalui URI instancenya. Repositori dibuat di instance Secure Source Manager menggunakan antarmuka web, atau Secure Source Manager API.

Untuk membuat repositori Secure Source Manager guna menghosting tutorial pribadi Anda, selesaikan langkah-langkah berikut.

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

  2. Buat instance Secure Source Manager jika Anda belum memilikinya:

    gcloud source-manager instances create INSTANCE_ID \
    --region=LOCATION

    Ganti kode berikut:

    • INSTANCE_ID: ID instance Secure Source Manager.
    • LOCATION: region tempat Anda membuat instance—misalnya, us-central1.

    Diperlukan waktu hingga 60 menit untuk membuat instance.

  3. Untuk mengakses instance Secure Source Manager melalui antarmuka webnya, salin URL berikut ke kolom URL browser Anda:

    INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

    Ganti PROJECT_NUMBER dengan nomor project Google Cloud instance.

  4. Buat repositori pribadi:

    gcloud source-manager repos create REPO_ID \
    --instance=INSTANCE_ID \
    --region=LOCATION

    Ganti REPO_ID dengan ID repositori Secure Source Manager.

    Untuk mengetahui informasi tentang izin yang diperlukan untuk membuat repositori, lihat Peran yang diperlukan.

  5. Tambahkan helper autentikasi Secure Source Manager ke konfigurasi Git global Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan kredensial Anda.

  6. Buat clone repositori Anda ke Cloud Shell:

    git clone https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git

    Ganti PROJECT_ID dengan project ID Google Cloud instance.

  7. Pindahkan file tutorial Anda ke repositori yang dibuat secara lokal:

    mv PATH_TO_TUTORIAL REPO_ID/PATH_TO_TUTORIAL

    Ganti PATH_TO_TUTORIAL dengan jalur ke tutorial pribadi Anda.

  8. Buka repositori lokal Anda:

    cd REPO_ID

  9. Tambahkan, commit, dan kirim file tutorial:

    git add .
git commit -m "Add private tutorial to Secure Source Manager"
git push origin main

  10. Anda dapat melihat repositori Secure Source Manager di antarmuka web. Untuk mengetahui informasi selengkapnya, lihat Mencantumkan dan melihat repositori.

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 Secure Source Manager, Anda harus menentukan parameter cloudshell_git_repo dengan URL HTTPS repositori Anda. Contoh:

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git

Anda dapat menata gaya link ini sebagai tombol dan menyematkannya dalam dokumentasi agar dapat ditemukan oleh pengguna. Contoh:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git)

Menyesuaikan tutorial dengan alat add-on

Anda dapat menyesuaikan lebih lanjut pengalaman tutorial pribadi dengan menyediakan alat kustom kepada 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.