GitHub Codespaces のテンプレートについて
新しいプロジェクトを開始する場合、テンプレートから codespace を作成すると、開発作業をすばやく開始できます。 クラウドベースの開発環境でプロジェクトに取り組み、ファイルをクラウドに保存し、新しいリモート リポジトリに作業内容を公開することで、他のユーザーと共有したり、ローカル コンピューターに複製したりできます。
空のテンプレートから開始する、GitHub が管理するテンプレートから React や Jupyter Notebook などの一般的なテクノロジを選ぶ、または GitHub 上の任意のテンプレート リポジトリから codespace を起動できます。
注: マネージド ユーザー アカウント がある場合、GitHub Codespaces には GitHub のパブリック テンプレートは使用できません。組織か企業が所有しているか、お金を払っている codespace しか作成できないためです。 詳しくは、「Enterprise Managed Users について」を参照してください。
空のテンプレートを使う場合は、まず空のディレクトリから始めます。クラウドベースのコンピューティング リソースと、デフォルトの開発者コンテナー イメージにプレインストールされているツール、言語、ランタイム環境にアクセスできます。 他のテンプレートを使う場合は、扱うテクノロジのスターター ファイルに加え、通常は、README ファイル、.gitignore
ファイル、カスタム環境構成を含む開発コンテナー構成ファイルなどの追加ファイルをいくつか取得します。 開発コンテナーと既定のイメージについて詳しくは、「開発コンテナーの概要」を参照してください。
たとえば、GitHub の React テンプレートから codespace を作成すると、index.js
、app.js
、package.json
など、シンプルなアプリケーション向けのテンプレート ファイルが用意されているワークスペースが表示されます。 codespace が開いた直後に、開発サーバーが自動的に起動し、VS Code Web クライアント内のシンプルなブラウザー タブで、実行中のアプリケーションを表示できるようになります。
テンプレートに含まれるファイルと構成は、テンプレート リポジトリで定義されています。 codespace を作成すると、テンプレート リポジトリは codespace に複製されます。 その後、リンクは切断され、公開するまで codespace はリモート リポジトリにリンクされないようになります。
ヒント: ユーザーがフレームワーク、ライブラリ、またはその他のプロジェクトを使い始められるように、GitHub Codespaces で使うテンプレート リポジトリを設定できます。 詳しくは、「GitHub Codespaces 用のテンプレート リポジトリを設定する」を参照してください。
GitHub テンプレートから codespace を作成する
空のテンプレートなど、GitHub が管理するテンプレートは、"自分の codespace" ページから入手できます。
-
GitHub の左上隅にある を選択し、 コードスペース をクリックして、github.com/codespaces のページに移動します。
-
テンプレートの完全な一覧を表示するには、[クイック スタート テンプレートの探索] セクションで [すべて表示] をクリックします。
-
必要に応じて、テンプレートのファイルを含むテンプレート リポジトリを表示するには、テンプレートの名前をクリックします。
-
起動するテンプレートの名前の下にある [このテンプレートを使用] をクリックします。
新しい codespace をテンプレートから作成すると、常に Visual Studio Code Web クライアントで開きます。 サポートされているエディターでは、既存の codespace を開くことができます。 詳しくは、「既存の codespace を開く」を参照してください。
テンプレート リポジトリから codespace を作成する
任意のテンプレート リポジトリから codespace を作成し、準備ができたら新しいリポジトリに作業内容を公開できます。 テンプレート リポジトリについて詳しくは、「テンプレートからリポジトリを作成する」を参照してください。
-
GitHub で、リポジトリのメイン ページに移動します。
-
[このテンプレートを使用する] をクリックし、 [codespace で開く] を選びます。
注: ご自分がテンプレート リポジトリの保守管理者で、テンプレート リポジトリ自体に変更をコミットしたい場合は、 [ コード] ドロップダウンから codespace を作成する必要があります。 詳しくは、「リポジトリの codespace を作成する」を参照してください。
新しい codespace をテンプレートから作成すると、常に Visual Studio Code Web クライアントで開きます。 サポートされているエディターでは、既存の codespace を開くことができます。 詳しくは、「既存の codespace を開く」を参照してください。
GitHub Enterprise Cloud
のリポジトリに公開する
テンプレートから作成された codespace で作業する場合、作業はクラウド内の仮想マシンに保存されますが、GitHub のリポジトリには保存されません。
ファイルを保存し、codespace を閉じて停止し、後で作業に戻ることができます。 通常、Git はプレインストールされ、GitHub の空のテンプレートから開始しない限り、作業ディレクトリは Git リポジトリとして自動的に初期化されます。 つまり、ファイルの追加やコミットなど、ローカル ソース管理に Git をすぐに使用できます。
しかし、発行されていない codespace を削除した場合、または保持期間の間に未使用のままで自動的に削除された場合は、作業も削除されます。 作業を永続化し、他のユーザーがあなたのプロジェクトで作業できるようにするには、ご自分の codespace を GitHub のリポジトリに発行する必要があります。
注: 公開されていない codespace が現在組織に課金されている場合、codespace を公開すると、codespace の所有権と課金が個人アカウントに転送されます。 「GitHub Codespaces の請求について」を参照してください。
VS Code から公開する
codespace で作業している場合は、VS Code Web クライアントまたはデスクトップ アプリケーションから発行できます。
-
アクティビティ バーで、 [ソース管理] ビューをクリックします。
-
変更をステージングするには、追加または変更したファイルの横の [+] をクリックします。複数のファイルを変更してすべてをステージングする場合は、 [変更] の横のものをクリックします。
注: GitHub の空のテンプレートから開始した場合、ディレクトリを Git リポジトリとして既に初期化していない限り、変更の一覧は表示されません。 空のテンプレートから作成された codespace を発行するには、[ソース管理] ビューで [GitHub に発行] をクリックし、手順 5 に進みます。
-
ステージングされた変更をコミットするには、行った変更を説明するコミット メッセージを入力し、 [コミット] をクリックします。
-
[ブランチを公開する] をクリックします。
-
[リポジトリ名] ドロップダウンで、新しいリポジトリの名前を入力し、 [GitHub プライベート リポジトリに発行] または [GitHub パブリック リポジトリに発行] を選びます。
新しいリポジトリの所有者は、codespace を作成した GitHub アカウントになります。
-
必要に応じて、エディターの右下隅に表示されるポップアップで、 [GitHub で開く] をクリックして、GitHub の新しいリポジトリを表示します。
codespace が公開されると、自分の GitHub Codespaces エクスペリエンスをカスタマイズするためのさまざまなオプションにアクセスできます。 たとえば、次のように操作できます。
- codespace のコンピューターの種類を変更して、作業に適したリソースを使っていることを確認します (「codespace のマシンの種類を変更する」を参照)。
- GitHub が自動的に GPG を使って、自分が codespace で行ったコミットに署名できるようにします (「GitHub Codespaces の GPG 検証を管理する」を参照)。
- シークレットを codespace と共有します (「GitHub Codespaces のアカウント固有のシークレットの管理」を参照)。
GitHub
から公開
GitHub の「codespace」ページから公開されていない codespace を公開できます。 これは、ブラウザー内で現在開いていない codespace を公開する場合に便利です。 これを行うと、作業内容はリポジトリに保持されますが、既存の codespace と新しいリポジトリの間のリンクはなくなります。 ただし、新しいリポジトリに移動し、そこから codespace を作成すると、この codespace はそのリポジトリに接続されるようになります。
-
GitHub の左上隅にある を選択し、 コードスペース をクリックして、github.com/codespaces のページに移動します。
-
公開されていない codespace の横にある省略記号 ( ... ) をクリックし、 [新しいリポジトリに公開する] を選びます。
-
新しいリポジトリの名前を選び、 [パブリック] または [プライベート] に設定して、 [リポジトリの作成] をクリックします。
-
必要に応じて、新しいリポジトリを表示するには、 [リポジトリの表示] をクリックします。