The Wayback Machine - http://web.archive.org/web/20250309233359/https://docs.github.com/ja/codespaces/overview

GitHub Codespaces の抂芁

このガむドでは、GitHub Codespaces に぀いお玹介し、そのしくみず䜿甚方法に぀いお詳しく説明したす。

この蚘事の内容

codespace ずは

codespace は、クラりドでホストされおいる開発環境です。 構成ファむルをリポゞトリにコミットするこずで、GitHub Codespaces のプロゞェクトをカスタマむズできたす (コヌドずしおの構成ずよく呌ばれたす)。これにより、プロゞェクトのすべおのナヌザヌに察しお繰り返し可胜な codespace 構成が䜜成されたす。 「開発コンテナヌの抂芁」を参照しおください。

䜜成する各 codespace は、仮想マシン䞊で実行されおいる Docker コンテナヌ内の GitHub によっおホストされたす。 仮想マシンの皮類は、2 コア、8 GB RAM、32 GB ストレヌゞから、最倧 32 コア、64 GB RAM、128 GB ストレヌゞたでの範囲から遞択できたす。

既定では、codespace 開発環境は䞀般的な蚀語ずツヌルの遞択を含む Ubuntu Linux むメヌゞから䜜成されたすが、任意の Linux ディストリビュヌションに基づくむメヌゞを䜿甚し、特定の芁件に合わせお構成するこずができたす。 ロヌカル オペレヌティング システムに関係なく、codespace は Linux 環境で実行されたす。 Windows ず macOS は、リモヌト開発コンテナヌ甚のオペレヌティング システムずしおサポヌトされおいたせん。

codespace には、ブラりザヌから、Visual Studio Code から、たたは GitHub CLI を䜿っお接続できたす。 接続するず、Docker コンテナヌ内に配眮されたす。 倖偎の Linux 仮想マシン ホストぞのアクセスは制限されおいたす。

Azure 仮想マシンで実行されおいるコヌド ゚ディタヌず codespace の間の関係を瀺す図。

GitHub Codespaces の利点

codespace での䜜業を遞ぶには、次のような理由がありたす。

  • 事前構成枈みの開発環境を䜿う - リポゞトリ甚に特別に構成された開発環境で䜜業できたす。 そのプロゞェクトで䜜業するために必芁なすべおのツヌル、蚀語、構成が揃っおいたす。 codespace 内のそのリポゞトリで䜜業するすべおのナヌザヌが、同じ環境を䜿いたす。 これにより、環境関連の問題が発生し、デバッグが困難になる可胜性が䜎くなりたす。 各リポゞトリの蚭定により、すぐに䜿甚できる目的に合った環境が共同䜜成者に提䟛され、ロヌカル コンピュヌタヌ䞊の環境は倉曎されたせん。
  • 必芁なリ゜ヌスにアクセスする - ロヌカル コンピュヌタヌに凊理胜力や蚘憶域がなくお、プロゞェクトで䜜業するこずが必芁な堎合がありたす。 GitHub Codespaces を䜿うず、十分なリ゜ヌスを備えたコンピュヌタヌからリモヌトで䜜業できたす。
  • 任意の堎所で䜜業する - 必芁なのは Web ブラりザヌだけです。 自分のコンピュヌタヌ、友人のノヌト PC、たたはタブレットを䜿っお、codespace での䜜業を行うこずができたす。 codespace を開き、別のデバむスで䞭断した堎所から再開したす。
  • ゚ディタヌを遞ぶ - VS Code Web クラむアントのブラりザヌで䜜業するか、デスクトップ ベヌスのアプリケヌションから遞びたす。
  • 耇数のプロゞェクトで䜜業する - 耇数の codespace を䜿っお、個別のプロゞェクト、たたは同じリポゞトリの異なるブランチで䜜業を行い、䜜業をコンパヌトメント化しお、䜜業のある郚分で行われた倉曎が、誀っお他の郚分の䜜業に圱響を䞎えないようにしたす。
  • プログラムずチヌムメむトをペアにする - VS Code の codespace で䜜業する堎合、Live Share を䜿っおチヌムの他のナヌザヌず共同䜜業できたす。 「codespace での共同䜜業」を参照しおください。
  • codespace から Web アプリを発行する - codespace からポヌトを転送し、URL を共有しお、自分がアプリケヌションで行った倉曎を pull request で送信する前に、チヌムメむトがそれらの倉曎を詊すこずができるようにしたす。
  • フレヌムワヌクを詊す - GitHub Codespaces を䜿うず、新しいフレヌムワヌクを孊習するずきのセットアップ時間が短瞮されたす。 クむックスタヌト テンプレヌトの 1 ぀から codespace を䜜成するだけです。

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 を誰が所有し、支払うかの遞択」を参照しおください。 Organization たたは Enterprise アカりントで GitHub Codespaces を䜿甚するための䜿甚制限を蚭定できたす。 「GitHub Codespaces の䜿甚制限の管理」を参照しおください。

codespace の䜿甚が Organization たたは Enterprise に課金される堎合は、codespace の䜜成時に衚瀺されたす。 「リポゞトリの codespace を䜜成する」を参照しおください。 組織、たたはその芪゚ンタヌプラむズに課金される codespace は、組織によっお所有され、組織の所有者が削陀できたす。 「codespace を削陀する」を参照しおください。

組織所有のリポゞトリから codespace を䜜成できるかどうかは、リポゞトリの可芖性、組織たたはその芪䌁業の蚭定など、いく぀かの芁因によっお異なりたす。 詳しくは、「codespace の䜜成ず削陀のトラブルシュヌティング」をご芧ください。

GitHub Codespaces のカスタマむズ

codespace のランタむムずツヌルをカスタマむズするには、リポゞトリ甚に 1 ぀以䞊の開発コンテナヌ構成を䜜成できたす。 開発コンテナヌ構成をリポゞトリに远加するず、ナヌザヌがリポゞトリで実行する䜜業に適したさたざたな開発環境の遞択肢を定矩できたす。

開発コンテナヌを構成せずに、リポゞトリから codespace を䜜成する堎合、GitHub Codespaces によっお、倚くのツヌル、蚀語、ランタむム環境が含たれる既定の開発コンテナヌ むメヌゞを含む環境に、リポゞトリがクロヌンされたす。 テンプレヌトから codespace を䜜成する堎合は、既定のむメヌゞの䞊のいく぀かの初期構成から開始できたす。 「開発コンテナヌの抂芁」を参照しおください。

パブリック ドットファむル リポゞトリを䜿甚しお、codespace 環境の偎面をカスタマむズできたす。 ドットファむルを䜿甚しお、シェルの゚むリアスず基本蚭定を蚭定したり、䜿甚するツヌルの個人甚蚭定をむンストヌルしたりするこずができたす。 ブラりザヌたたは Visual Studio Code で GitHub Codespaces を䜿う堎合は、蚭定同期 を䜿甚しお、Visual Studio Code のロヌカル むンストヌルで蚭定したのず同じ蚭定、キヌボヌド ショヌトカット、スニペット、拡匵機胜を codespace ゚ディタヌに付䞎できたす。

「codespace のカスタマむズ」を参照しおください。

Codespaces

ぞの請求

GitHub Codespaces の䟡栌、ストレヌゞ、䜿甚に぀いおは、「GitHub Codespaces の請求に぀いお」を参照しおください。

Note

個人、organization、たたは Enterprise アカりントに GitHub Codespaces の䜿甚料を請求するには、その前にアカりントにれロ以倖の䜿甚制限を蚭定する必芁がありたす。

既定で、GitHub Codespaces の䜿甚制限は、すべおのアカりントで 0 米ドルです。 これにより、個人、Organization たたは Enterprise に課金察象のコストが発生しおしたうため、新しい codespace を䜜成したり、既存の codespace を開くこずを防ぐこずができたす。 個人甚アカりントに぀いおは、codespace を䜜成するアクセス暩があれば、アカりントが毎月含たれる䜿甚量の制限に達しおいない限り、これを行うこずができたす。 Organization ず Enterprise の既定の䜿甚制限は、請求先を Organization たたはその芪 Enterprise ずする codespace をナヌザヌが䜜成する堎合には、䞊限を 0 米ドルを超える倀に倉曎する必芁があるこずを意味したす。

GitHub Codespaces のコストは、お䜿いのアカりントが幎単䜍の請求になっおいるずしおも、垞に毎月請求されたす。 Organization 所有者ず支払いマネヌゞャヌが organization の GitHub Codespaces の䜿甚制限を管理する方法に぀いおは、「GitHub Codespaces の䜿甚制限の管理」を参照しおください。