WindowsでLinux(WSL2)+Docker+VSCodeでの開発環境を構築

目的

• Windows環境で、Linux+Docker+VSCodeを使って開発をする準備を整える
• イメージ
  

環境

• Windows 11 Home

手順

1. WSL2インストール

1. PowerShellを管理者として実行

   • Windowsキーを押下
   • 「PowerShell」と入力
   • 「管理者として実行する」をクリック
     

2. PowerShell上で下記のコマンドを実行
   wsl --install

3. PCを再起動

2. WSL2セットアップ

1. Ubuntuを開く
   • Windowsキーを押下、「Ubuntu」と入力
   • Ubuntu on Windowsを選択し、「開く」をクリック
2. ユーザー名、パスワードを設定
   • 表示された通りに設定

3. Dockerインストール

Ubuntuで下記のコマンドを順次実行

1. パッケージ一覧をアップデート
   $ sudo apt-get update
$ sudo apt-get install ca-certificates curl gnupg lsb-release
2. DockerのGPGキーを取得
   $ sudo mkdir -p /etc/apt/keyrings
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
3. リポジトリ更新
   $ echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
$ sudo apt-get update
4. Docker Engineのインストール
   $ sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin
$ sudo apt update
5. 権限設定
   $ sudo usermod -aG docker $USER
6. Ubuntuを終了
   $ exit

4. VSCodeの準備と動作確認

1. VSCodeをインストールしていなければ、下記のサイトからインストーラをダウンロードし、実行する
   Download Visual Studio Code
2. VSCodeの拡張機能「WSL」をインストール

   • VSCodeのウインドウ左側のExtension（拡張機能）のアイコンをクリック
     

   • 検索ボックスに「wsl」と入力し、下記のExtensionをインストールする
     

3. 左下の><マークをクリック
   
4. 「新しいWSLウインドウ」を選択
   • 左下が「><WSL: Ubuntu」の新しいウインドウが開くことを確認
     
5. 上のメニューバーから、Terminal > New Terminalを選択
   • VSCodeウインドウ下部にTerminalが現れる
   • 下記のコマンドを実行し、dockerの動作確認
     $ docker container run --rm hello-world
   • 成功の場合、下記のメッセージが出る

…（略）…
Hello from Docker!
This message shows that your installation appears to be working correctly.
…（略）…

1. VSCodeの拡張機能「Dev Containers」をインストール
   • VSCodeのウインドウ左側のExtension（拡張機能）のアイコンをクリック
   • 検索ボックスに「dev con」と入力し、下記のExtensionをインストールする
     

5. 開発開始

1. Dev Containers用のConfiguration Fileを作成
   • 左下の「><WSL: Ubuntu」をクリック
   • Add Dev Container Configuration Files …をクリック
   • 必要な環境を選んでいく
     　　　AdaloのCustom Componentを作成する際の環境例はこちら：Docker内でAdaloのカスタムコンポーネントを作成