はじめに
codespace は、クラウドでホストされている開発環境です。 GitHub Codespaces用にプロジェクトをカスタマイズするには、構成ファイルをリポジトリ (多くの場合、Configuration-as-Code) にコミットし、プロジェクトのすべてのユーザーに対して反復可能なコードスペース構成を作成します。 「開発コンテナーの概要」を参照してください。
作成する各コード空間は、仮想マシン上で実行されている Docker コンテナー内の GitHub によってホストされます。 仮想マシンの種類は、2 コア、8 GB RAM、32 GB ストレージから、最大 32 コア、128 GB RAM、128 GB ストレージまでの範囲から選択できます。
既定では、codespace 開発環境は一般的な言語とツールの選択を含む Ubuntu Linux イメージから作成されますが、単一の Linux ディストリビューションに基づくイメージを使用し、特定の要件に合わせて構成することができます。 ローカル オペレーティング システムに関係なく、codespace は Linux 環境で実行されます。 Windowsと macOS は、リモート開発コンテナーのオペレーティング システムではサポートされていません。
コードスペースには、ブラウザー、 Visual Studio Code、または GitHub CLI を使用して接続できます。 接続すると、Docker コンテナー内に配置されます。 外側の Linux 仮想マシン ホストへのアクセスは限定的です。
GitHub Codespaces の使用
クラウドベースのコンピューティング リソースを使用して開発を開始するには、テンプレートまたは任意のブランチから codespace を作成するか、リポジトリにコミットします。 テンプレートから codespace を作成する場合は、空白のテンプレートから開始するか、作業に適したテンプレートを選ぶことができます。
GitHub Codespaces の概要については、「GitHub Codespaces のクイックスタート」を参照してください。 codespace の作成の詳細については、「リポジトリの codespace を作成する」または「テンプレートから codespace を作成する」を参照してください。 既に作成した codespace に戻る場合は、「既存の codespace を開く」を参照してください。 GitHub Codespaces のしくみの詳細については、「GitHub Codespaces に深く迫る」を参照してください。
個人アカウントが所有する codespace の使用
すべての個人用 GitHub アカウントには、無料プランまたは Pro プランに含まれる GitHub Codespaces の無料使用の毎月のクォータがあります。 設定を変更したり、支払いの詳細を指定したりすることなく、個人用アカウントで GitHub Codespaces の使用を開始できます。
Organization 所有のリポジトリから codespace を作成した場合、codespace の使用は Organization (Organization がこれに対して構成されている場合) または個人アカウントに対して課金されます。
支払いの詳細を指定し、使用制限を設定することで、毎月のストレージとコンピューティング使用量を超える GitHub Codespaces を引き続き使用できます。 「GitHub Codespaces の課金」をご覧ください。
Organization 所有の codespace の使用
GitHub TeamおよびGitHub Enterpriseプランの組織の所有者は、メンバーとコラボレーターによるGitHub Codespacesの使用分を支払うことができます。 これは、Organization が所有するリポジトリから作成された codespace に適用されます。 「組織内の codespace を誰が所有し、支払うかの選択」を参照してください。 組織またはエンタープライズ アカウントで GitHub Codespaces を使用するための使用制限を設定できます。 「従量制課金製品の支出を管理するための予算を設定する」を参照してください。
codespace の使用が Organization または Enterprise に課金される場合は、codespace の作成時に表示されます。 「リポジトリの codespace を作成する」を参照してください。 組織、またはその親エンタープライズに課金される codespace は、組織によって所有され、組織の所有者が削除できます。 「codespace を削除する」を参照してください。
組織所有のリポジトリから codespace を作成できるかどうかは、リポジトリの可視性、組織またはその親企業の設定など、いくつかの要因によって異なります。 詳しくは、「codespace の作成と削除のトラブルシューティング」をご覧ください。
カスタマイズ GitHub Codespaces
codespace のランタイムとツールをカスタマイズするには、リポジトリ用に 1 つ以上の開発コンテナー構成を作成できます。 開発コンテナー構成をリポジトリに追加すると、ユーザーがリポジトリで実行する作業に適したさまざまな開発環境の選択肢を定義できます。
開発コンテナー構成なしでリポジトリからコードスペースを作成した場合、 GitHub Codespaces は、多くのツール、言語、ランタイム環境を含む既定の開発コンテナー イメージを使用して、リポジトリを環境に複製します。 テンプレートから codespace を作成する場合は、既定のイメージの上のいくつかの初期構成から開始できます。 「開発コンテナーの概要」を参照してください。
パブリック ドットファイル リポジトリを使用して、codespace 環境の側面をカスタマイズできます。 ドットファイルを使用して、シェルのエイリアスと基本設定を設定したり、使用するツールの個人用設定をインストールしたりすることができます。 ブラウザーまたはGitHub CodespacesでVisual Studio Codeを使用する場合は、設定同期を使用して、Visual Studio Codeのローカル インストールで設定したのと同じ設定、キーボード ショートカット、スニペット、拡張機能をコードスペース エディターに付与できます。
「codespace のカスタマイズ」を参照してください。
Codespaces の請求
GitHub Codespacesの価格、ストレージ、使用状況については、GitHub Codespaces の課金 を参照してください。
アカウントに有効な支払方法が登録されていない場合、クォータを使い切ると使用がブロックされます。
有効な支払方法を登録した場合、支出が 1 つ以上の予算により制限されることがあります。 アカウントに設定した予算が、使用量のニーズに適していることを確認してください。 「従量制課金製品の支出を管理するための予算を設定する」をご覧ください。
GitHub Codespaces のコストは、お使いのアカウントが年単位の請求になっているとしても、常に毎月請求されます。 組織の所有者と課金マネージャーが組織の GitHub Codespaces の使用制限を管理する方法については、 従量制課金製品の支出を管理するための予算を設定する を参照してください。