在 Cloud Shell 中建立私人教學課程

Cloud Shell 支援建立私人教學課程，讓您專為目標對象設計教學課程。

使用「在 Cloud Shell 中編寫教學課程」指南撰寫教學課程，並遵循「教學課程樣式指南」中詳述的最佳做法後，您可以在私人 Git 存放區中託管教學課程，供使用者存取。

您可以依喜好使用任何 Git 存放區代管服務。本指南使用Secure Source Manager，這是在 Google Cloud上託管的單一租戶代管程式碼存放區，部署於特定區域，用來示範相關步驟。

建立私人 Git 存放區

Secure Source Manager 執行個體會部署至可用 Google Cloud區域，並可透過執行個體 URI 存取。存放區是在 Secure Source Manager 執行個體中建立，可透過網頁介面或 Secure Source Manager API 建立。

如要建立 Secure Source Manager 存放區來存放私人教學課程，請完成下列步驟。

  1. 啟動 Cloud Shell 終端機。 如要使用獨立的 Cloud Shell 工作階段，請前往 shell.cloud.google.com。

  2. 如果沒有 Secure Source Manager 執行個體，請先建立：

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

    更改下列內容：

    • INSTANCE_ID：Secure Source Manager 執行個體的 ID。
    • LOCATION：要建立執行個體的區域，例如 us-central1。

    建立執行個體最多可能需要 60 分鐘。

  3. 如要透過網頁介面存取 Secure Source Manager 執行個體，請將下列網址複製到瀏覽器的網址列：

    INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

    將 PROJECT_NUMBER 替換為執行個體的 Google Cloud 專案編號。

  4. 建立私人存放區：

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

    將 REPO_ID 替換為 Secure Source Manager 存放區的 ID。

    如要瞭解建立存放區所需的權限，請參閱「必要角色」。

  5. 將 Secure Source Manager 驗證輔助程式新增至全域 Git 設定。 詳情請參閱「設定憑證」。

  6. 將存放區複製到 Cloud Shell：

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

    將 PROJECT_ID 替換為執行個體的 Google Cloud 專案 ID。

  7. 將教學課程檔案移至您在本機建立的存放區：

    mv PATH_TO_TUTORIAL REPO_ID/PATH_TO_TUTORIAL

    將 PATH_TO_TUTORIAL 替換為私人教學課程的路徑。

  8. 前往本機存放區：

    cd REPO_ID

  9. 新增、修訂及推送教學課程檔案：

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

  10. 您可以在網頁介面中查看 Secure Source Manager 存放區。詳情請參閱「列出及查看存放區」。

如要協助使用者存取教學課程，可以使用 Cloud Shell 的「在 Cloud Shell 中開啟」功能，定義使用者存取教學課程的方式。如要瞭解如何自訂連結，請參閱「在 Cloud Shell 中開啟」指南。

如果是儲存在 Secure Source Manager 存放區的教學課程，您需要使用存放區的 HTTPS 網址定義 cloudshell_git_repo 參數。例如：

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

您可以將這個連結設為按鈕，並嵌入說明文件中，方便使用者找到。例如：

[![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)

使用外掛工具自訂教學課程

您可以為使用者提供自訂工具，讓他們使用您的私人教學課程，進一步自訂私人教學課程體驗。

如要這麼做，您可以建立 Docker 映像檔，做為自訂 Cloud Shell 殼層環境，並提供所有額外套件和自訂設定給使用者。