Cloud Shell で限定公開チュートリアルを作成する

Cloud Shell では限定公開チュートリアルを作成できるため、受講者専用のチュートリアルを設計できます。

Cloud Shell のチュートリアルの作成ガイドを使用してチュートリアルを作成し、チュートリアルスタイルガイドに記載されているベストプラクティスを実践すると、ユーザーが利用できるよう、プライベート Git リポジトリにチュートリアルをホストできます。

限定公開チュートリアルをホストする

チュートリアルを限定公開にするには、プライベート Git リポジトリでホストする必要があります。任意の Git リポジトリホスティングサービスを使用できます。このガイドでは、Google Cloud でホストされるプライベート Git リポジトリ、Cloud Source Repositories を使用します。

限定公開チュートリアルをホストする Cloud Source Repositories のリポジトリを作成するには:

Cloud Shell ターミナルを起動します。スタンドアロンの Cloud Shell セッションでは、shell.cloud.google.com を使用します。
プライベートリポジトリを作成します。
```
gcloud source repos create REPO_NAME
```
Cloud Shell にリポジトリのクローンを作成します。
```
gcloud source repos clone REPO_NAME
```
チュートリアルファイルをローカルに作成したリポジトリに移動します。
```
mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL
```
ローカルリポジトリに移動します。
```
cd REPO_NAME
```
commit するチュートリアルを追加します。
```
git add .
```
リポジトリにファイルを commit し、このアクションの履歴を記述したコメントを追加します。
```
git commit -m "Add private tutorial to Cloud Source Repositories"
```
git push コマンドを使用して、ローカルリポジトリの内容を Cloud Source Repositories に追加します。
```
git push origin master
```
Google Cloud Console でリポジトリとそのコンテンツを表示します。

Cloud Source Repositories を開く

[Cloud Shell で開く] リンクを作成する

ユーザーがチュートリアルにアクセスできるよう、Cloud Shell の [Cloud Shell で開く] 機能を使用して、ユーザーがチュートリアルにアクセスする方法を定義できます。リンクをカスタマイズする方法について詳しくは、[Cloud Shell で開く] ガイドをご覧ください。

Cloud Source Repositories リポジトリでホストされているチュートリアルの場合は、リポジトリの URL を指定して 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)

アドオンツールを使用してチュートリアルをカスタマイズする

チュートリアルを使用して作業するためのカスタムツールをユーザーに提供することで、限定公開のチュートリアルエクスペリエンスをさらにカスタマイズできます。

これを行うには、ユーザーに使用を許可する追加パッケージとカスタム構成をすべて使用して、カスタム Cloud Shell 環境として機能する Docker イメージを作成します。カスタムコンテナイメージを作成し、このコンテナイメージを参照するように [Cloud Shell で開く] リンクを更新する方法について詳しくは、コンテナイメージのカスタマイズガイドをご覧ください。