前提条件
ローカル Dev Container の前提条件
実際の Dev Container を記述する
devcontainer.json(英語) ファイルを含む.devcontainerフォルダーを含むプロジェクトがあります。現在、
devcontainer.jsonファイルのコード補完は制限されています。 ただし、次のプロパティは使用できます。ビルドプロパティ(英語)がサポートされています。
Docker compose プロパティ(英語)がサポートされています。
ライフサイクルスクリプト(英語)がサポートされています。
ポート属性(英語)では、
labelのみがサポートされます。ホストの最小要件(英語)はサポートされていません。
devcontainer.jsonの変数(英語)がサポートされています。
GitHub にアクセスできます。
マシンに Git 2.20.1 バージョン以降がインストールされています。
ローカルマシン上で SSH エージェントが実行されています。
たとえば、Windows では、SSH URL を使用して GitHub リポジトリから Dev Container をビルドする場合、SSH エージェントが実行されていないと、
- git clone操作 (補助コンテナーに接続された Docker ボリュームにリポジトリソースをクローンする) は実行できません。Dev Container が常駐するマシンに Docker(英語) がインストールされています。
ソースをマウントするための最小限のバックエンド要件は、インストールされている Docker です。 Colima(英語) などの Docker の代替品はまだサポートされていません。 Podman(英語) のサポートは開発中です。
これらの Docker の代替品の使用中に問題が発生した場合は、課題追跡システムにバグレポートを送信してください。
Docker リソースは、バックエンドの 最小システム要件を満たしています。
リモート Dev Container の追加前提条件
以下は、リモートサーバー上で Dev Container を実行するための追加の前提条件のリストです。
Docker (英語) は、リモートとローカルマシンの両方にインストールされます。
サーバーと Git への認証は、SSH キーを通じて行われます。 パスワードを使用してリモートサーバーに接続する場合は、ローカルでキーペアを生成し、それをリモートサーバーに転送します。 詳細については、 認証情報の共有 を参照してください。
リモートサーバーには Java 17 以降のバージョンが必要です。
Dev Container には追加の依存関係がいくつか必要になる場合があります。
Dev Container が起動しない場合は、
devcontainer.jsonファイルの Dev Container の OS に次の依存関係があることを確認してください。curlunzippslibxextlibxrenderlibxtstlibxifreetypeprocpsgcompat