前提条件

ローカル 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 に次の依存関係があることを確認してください。

  • curl

  • unzip

  • ps

  • libxext

  • libxrender

  • libxtst

  • libxi

  • freetype

  • procps

  • gcompat