プロジェクトの Codespace の設定

デフォルトの codespace 設定について

リポジトリのデフォルトのcodespace設定を作成し、そのリポジトリで作成されたすべての新しいcodespaceの環境を決定できます。 The configuration defines a development container that can include frameworks, tools, extensions, and port forwarding.

リポジトリで設定を定義しない場合、GitHub はベースの Linux イメージを使用して Codespaces を作成します。 The base Linux image includes tools for Python, Node.js, JavaScript, TypeScript, C++, Java, C#, F#, .NET Core, PHP, PowerShell, Go, Ruby, and Rust. ベースの Linux イメージの詳細については、microsoft/vscode-dev-containers リポジトリを参照してください。

自分のアカウントで作成したcodespaceについて、codespace環境の様々な側面をパーソナライズすることもできます。 パーソナライズには、シェルの環境設定や追加のツールが含まれます。dotfilesのパーソナライゼーションは、リポジトリのデフォルトのcodespace設定よりも先に適用されます。詳しい情報については、「アカウントの Codespaces をパーソナライズする」を参照してください。

プロジェクトタイプ用にビルド済みコンテナ設定を使用してデフォルトの codespace 設定を作成するか、プロジェクトのニーズに固有のカスタム設定を作成できます。

Codespaces は、devcontainer.json という名前の設定ファイルに含まれている設定を使用します。 This file can be located in the root of the repository or in a folder called .devcontainer. If the file is located in the root of the repository, the filename must begin with a period: .devcontainer.json.

devcontainer.json を使用して、Visual Studio Code エディタを含む Codespaces 環境全体のデフォルト設定を行うことができますが、.vscode/settings.json という名前のファイルでエディタ固有の設定を行うこともできます。

リポジトリの codespace 設定への変更は、すべての新しい codespace にのみ適用され、既存の codespace には影響しません。

ビルド済みのコンテナ設定を使用する

vscode-dev-containers リポジトリで利用可能な、Visual Studio Code 用のビルド済みコンテナ設定を使用できます。 ビルド済みコンテナの定義には、特定のプロジェクトタイプの共通設定が含まれており、適切なコンテナオプション、Visual Studio Code 設定、およびインストールする必要がある Visual Studio Code 拡張機能のすでに用意された設定を使用して素早く開始できます。

1. vscode-dev-containers リポジトリをクローンまたはダウンロードします。
2. vscode-dev-containers リポジトリで、コンテナフォルダに移動し、プロジェクトのニーズに合わせてコンテナ設定を選択します。 例として、Node.js & JavaScript コンテナ設定を使用します。
3. Node.js & JavaScript フォルダから、.devcontainer フォルダをプロジェクトのリポジトリのルートにコピーします。
4. 新しい設定をコミットして、GitHub のプロジェクトのリポジトリにプッシュします。

.devcontainer フォルダを含むブランチから作成された新しい codespace はそれぞれ、フォルダの内容に従って設定されます。 詳しい情報については、「codespace を作成する」を参照してください。

カスタム codespace 設定を作成する

ビルド済みの設定のいずれもニーズを満たさない場合は、devcontainer.json ファイルを追加してカスタム設定を作成できます。 This file can be located in the root of the repository or in a folder called .devcontainer. If the file is located in the root of the repository, the filename must begin with a period: .devcontainer.json.

このファイルでは、サポートされている設定キーを使用して、codespace の環境の要素を指定できます。たとえば、Visual Studio Code 拡張機能がインストールできます。

Visual Studio Codeのエディタ設定を行う際には、Workspace、Remote [Codespaces]、Userという3つのスコープが利用できます。 複数のスコープ内で定義された設定については、Workspaceの設定が優先され、次がRemote [Codespaces]、そしてUserとなります。

2 つの場所で Visual Studio Code のデフォルトのエディタ設定を定義できます。

• .vscode/settings.json で定義されたエディタ設定は、Workspace スコープの設定として codespace に適用されます。
• devcontainer.json の設定キーで定義されたエディタ設定は、codespace の リモート [Codespaces] スコープ設定として適用されます。

サポートされている codespace 設定キー

devcontainer.json の Codespaces でサポートされている設定キーを使用できます。

一般設定

• name
• settings
• extensions
• forwardPorts
• postCreateCommand

Docker、Dockerfile、またはイメージ設定

• image
• dockerFile
• context
• containerEnv
• remoteEnv
• containerUser
• remoteUser
• mounts
• runArgs
• overrideCommand
• dockerComposeFile

devcontainer.json で使用可能な設定の詳細については、Visual Studio Code ドキュメントの「devcontainer.json の参照」をご覧ください。