GitHub Classroom で GitHub codespace を使用する

GitHub Codespaces の概要

GitHub Codespaces は、コンテナーを使用して開発用の共通言語、ツール、ユーティリティを提供する、クラウドベースのインスタント開発環境です。 GitHub Codespaces も構成可能で、プロジェクトのすべてのユーザーに対して同じカスタマイズされた開発環境を作成できます。 「GitHub Codespaces のクイックスタート」を参照してください。

組織または企業で GitHub Codespaces が有効になると、ユーザーは任意のブランチからコードスペースを作成したり、組織またはエンタープライズ リポジトリでコミットしたりして、クラウドベースのコンピューティング リソースを使用した開発を開始できます。 Visual Studio Codeを使用して、ブラウザーから、またはローカルでコード空間に接続できます。

GitHub Codespaces の概要については、「GitHub Codespaces のクイックスタート」を参照してください。 codespace の作成の詳細については、「リポジトリの codespace を作成する」または「テンプレートから codespace を作成する」を参照してください。 既に作成した codespace に戻る場合は、「既存の codespace を開く」を参照してください。 GitHub Codespaces のしくみの詳細については、「GitHub Codespaces に深く迫る」を参照してください。

GitHub CodespacesをGitHub Classroom の課題の優先エディターとして設定することは、学生と教師の両方にとって有益です。 GitHub Codespaces は、貸与されたデバイスを使用している学生や、ローカル IDE セットアップにアクセスできない学生に適したオプションです。各コードスペースはクラウドベースであり、ローカルセットアップは必要ないためです。 学生は、 Visual Studio Code の課題リポジトリのコードスペースをブラウザーで直接起動し、追加の構成を必要とせずにすぐに開発を開始できます。

複雑な設定環境を使用する課題の場合、教師はリポジトリの codespace 向け開発コンテナーの構成をカスタマイズできます。 これにより、学生が codespace を作成する際、教師が構成した開発環境で codespace が自動的に開くようになります。 開発コンテナーの詳細については、「開発コンテナーの概要」を参照してください。

確認済みの学生は、個人アカウントに対して、1 か月あたり最大 180 コア時間の GitHub Codespacesを無料で使用できます。 学生が使用できるストレージの毎月の量とコア時間は、 GitHub Pro アカウントに含まれる量と同じです。 詳しくは、「GitHub Codespaces の課金」をご覧ください。

検証済み教師の Codespaces 教育特典について

Codespaces教育向け特典では、認証済みの教員はGitHub Codespacesで利用できるGitHub Classroom時間分を毎月無料で利用できます。 この無料利用枠は、学生ごとに 1 つの codespace が保存されている 2 コアのマシンで、毎月 5 つの課題がある 50 人のクラスを目安としています。

認証済み教師になるには、教育者特典または教師特典の承認を受ける必要があります。 「教師として GitHub Education に応募する」を参照してください。

自分が検証済みの教師であることを確認したら、教師のGitHub Educationにアクセスして、組織を GitHub Team にアップグレードします。 「GitHub の製品」を参照してください。

Codespaces Education 特典の対象となる場合、組織のGitHub CodespacesでGitHub Classroomを有効にすると、GitHub自動的に Codespace ポリシーが追加され、組織内のすべてのコードスペースのコンピューターの種類が 2 つのコア コンピューターに制限されます。 これは、無料の GitHub Codespaces の使用を最大限に活用するのに役立ちます。 ただし、これらのポリシーは、Organization の設定で変更または削除できます。 「コンピューターの種類へのアクセスを制限する」を参照してください。

Codespaces Education 特典がパブリック プレビューの対象外になると、組織のGitHub Codespaces使用量が無料利用枠を超えた場合、超過利用分が請求されます。 「GitHub Codespaces の課金」を参照してください。

組織の Codespaces を有効にする

GitHub Codespacesを使用している組織では、GitHub ClassroomをGitHub Teamと併用できます。 Codespaces 教育向け特典の対象である場合は、組織の設定で直接有効にするのではなく、GitHub Codespaces を通じて GitHub Classroom を有効にする必要があります。 それ以外の場合、組織は GitHub Codespacesのすべての使用に対して直接課金されます。

新しいクラスルームを作成する際に、組織のCodespacesを有効にする

1. GitHub Classroomにサインインしてください。
2. ページの右側にある [新しいクラスルーム] をクリックします。
3. Organizationのリスト中で、クラスルームに使いたいOrganizationをクリックしてください。 GitHub Codespacesの対象となる組織には、資格があることを示すメモが表示されます。 あるいは、新しいOrganizationを作成することもできます。 「新しい Organization をゼロから作成」を参照してください。
4. [教室に名前を付けます] ページの [クラスルームのCodespaces ] で、[ 有効にする] をクリックします。 これにより、組織内のすべてのリポジトリとユーザーの GitHub Codespaces が有効になります。
5. 新しいクラスルームを作成する準備ができたら、 [クラスルームの作成] をクリックします。

既存のクラスルームを使用して Organization の codespace を有効にする

1. GitHub Classroomにサインインしてください。

2. クラスルームのリストで、表示したいクラスルームをクリックしてください。

3. クラスルーム名の下にある [Settings] をクリックします。

   

4. 「GitHub Codespaces」の下で、有効にする をクリックします。 これにより、組織内のすべてのリポジトリとユーザーの GitHub Codespaces が有効になります。 新しい Codespace ポリシーも追加され、Organization 内のすべて codespace のマシンの種類が 2 コア マシンに制限されます。

上記と同じ方法を使用して、組織の GitHub Codespaces を無効にすることもできます。 これにより、組織内のすべてのユーザーとリポジトリの GitHub Codespaces が無効になります。

Codespaces を使用する割り当ての構成

学生が課題 GitHub Codespaces 使用できるようにするには、課題のサポートされているエディターとして GitHub Codespaces を選択します。 新しい割り当てを作成するときに、[スタート コードの追加とオプションのオンライン IDE の選択] ページの [サポートされているエディターの追加] で、ドロップダウン メニューから GitHub Codespaces を選択します。

課題のテンプレート リポジトリを使用する場合、リポジトリ内の開発コンテナーを定義して、学生が codespace を起動して課題に取り組むときに使用できるツールとランタイムをカスタマイズできます。 開発コンテナーを定義しない場合、 GitHub Codespaces は既定の構成を使用します。この構成には、学生が開発に必要とする可能性がある一般的なツールの多くが含まれています。 開発コンテナーの定義の詳細については、「開発コンテナー構成のリポジトリへの追加」を参照してください。

GitHub Codespaces を使用した割り当ての起動

学生が課題を開くと、リポジトリの README ファイルに、学生が作業に使用する必要がある IDE に関する教師の推奨事項が含まれます。

学生は、README の [GitHub Codespace で開く] ボタンをクリックするか、割り当てリポジトリのメイン ページにある [ コード] ボタンをクリックして、[Codespaces] タブを選択することで、新規または既存のコード空間を起動できます。[Codespaces](コードスペース) タブから既存のコードスペースを選択するか、新しいコードスペースを作成できます。 「リポジトリの codespace を作成する」を参照してください。

教師は、[課題の概要] ページで各学生の課題の codespace を表示できます。 各学生行の右側にある [codespace] アイコンをクリックして codespace を起動できます。

ブラウザーを使用して codespace に接続する場合は、自動保存が自動的に有効になります。 リポジトリに対する変更を保存する場合、変更をコミットしてリモート ブランチにプッシュする必要があります。 既定では、30 分間操作することなく codespace を実行したままにした場合、codespace はタイムアウトになり、実行が停止されます。 データは、最後に変更した時点の状態で保持されます。 codespace のライフサイクルの詳細については、「codespace ライフサイクルについて」を参照してください。