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

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

您可以按照「教學課程風格指南」中的最佳做法，在 Cloud Shell 中編寫教學課程，並按照「在 Cloud Shell 中編寫教學課程」指南的說明，將教學課程代管在私人 Git 存放區中，讓使用者存取。

舉辦私人教學課程

如要將教學課程設為私人，您需要使用私人 Git 存放區來代管教學課程。您可以使用任何偏好的 Git 存放區代管服務。本指南使用 Cloud Source Repositories，這是在 Google Cloud上代管的私人 Git 存放區。

如要建立 Cloud Source Repositories 存放區，以便託管私人教學課程：

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

  2. 建立私人存放區：

    gcloud source repos create REPO_NAME

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

    gcloud source repos clone REPO_NAME

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

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

  5. 前往本機存放區：

    cd REPO_NAME

  6. 將教學課程加入版本：

    git add .

  7. 將檔案提交至存放區，並附上說明這項操作記錄的註解：

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

  8. 使用 git push 指令，將本機存放區的內容新增至 Cloud Source Repositories：

    git push origin master

  9. 在 Google Cloud 控制台中查看存放區及其內容：

    開啟 Cloud Source Repositories

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

如果教學課程是託管在 Cloud Source Repositories 存放區，您必須使用存放區的網址定義 cloudshell_git_repo 參數。

以下是已定義 cloudshell_git_repo 的連結範例：

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

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

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

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

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

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