【Windows10+WSL2+Docker】ローカル環境を汚さずに使い捨ての開発環境を手に入れる

エンジニアとしてスタートアップのWebサービス開発に携わっています。

仕事でWindows10+WSL2+Dockerを使って開発をするようになって2か月経ちました。

WSL2だからといって仕事で困ることはなく、Windowsの使いやすいUIを活かしつつWindows上で100%Linuxが使えるという恩恵を受けており、むしろ快適に開発しておりました。

最近ではさらにLinuxディストリビューションをインポートする方法を覚えたことで

ついにローカル環境を汚さずに使い捨ての開発環境を手に入れることができました。

もっとWindows10+WSL2+Dockerの良さを伝えたいと思ったので、WSL2のメリット・デメリットに触れながらローカル環境を汚さずサクッと使い捨ての開発環境を作る方法について書こうと思います。

また、この方法であればいくらでも欲しい環境を好きなだけ作れてしまうので作りすぎには要注意ですね！笑

WSL2とは

Macをお使いの人にもWSL2の良さが伝わればなと思うので、簡単にWSL2について触れたいと思います。

WSLとは、「Windows Subsystem for Linux」の略で簡単にいうとWindows上でLinuxが動くというものです。

WSL1ではLinuxカーネルのシステムコールをWindowsカーネルが処理できるシステムコールに変換して実行していましたが一部のシステムコールには対応できておらず一部のLinuxアプリ(Dockerなど)は動作しませんでした。

そこでWSL2の登場です。

WSL2は2ではありますが、WSL1とは全く別物となっています。

WSL2の特徴：100%のLinuxシステムコールの互換性

WSL2ではWIndows上で軽量VM(仮想マシン)が起動し、その中で実際のLinuxカーネルが動作します。

つまり、全てのLinuxアプリが動作するため100%Linuxの資産が使えます。

ただし、仮想マシンといっても一般の仮想マシンとは違い非常に高速で1,2秒で起動しマシンの大量のリソースを占有することはありません。

また、すごいのが軽量VMはバックグラウンドで管理および実行されるため使う側は全く意識する必要はありません。

WSL2の特徴：ファイルI/O操作のパフォーマンスが高速

Microsoftの動画の2分7秒くらいからWSL1とWSL2のパフォーマンス比較が見れます。

(WSL2のアーキテクチャについては10分16秒くらいから見れます。)

WSL1に比べてWSL2は約3～6倍速くなっており、インストールなども高速です。

WSL1とWSL2のアーキテクチャ

WSL1とWSL2のアーキテクチャのイメージです。

参考：【連載】WSL2、Visual Studio Code、DockerでグッとよくなるWindows開発環境〜その2：WSL1＆2のしくみ〜

朗報：Windows10 HomeでもWSL2は使える！

一般家庭用だとWindows10 Homeの方が多いと思いますが、WSL2はなんとWindows10 Homeでも使えます！

(私も個人PCはWindows10 Homeです)

WSL 2 は、WSL を使用できるすべてのデスクトップ SKU で使用できます (WINDOWS 10 HOME)。最新バージョンの WSL では、仮想化を有効にするために、Hyper-V アーキテクチャが使用されます。このアーキテクチャは、"仮想マシンプラットフォーム" のオプションコンポーネントで使用できます。このオプションのコンポーネントは、すべての SKU 上で使用できます。 faq's about Linux 用 Windows サブシステム 2 | Microsoft Docs

WSL2が使えるということは、Dockerも使える！

Docker公式のドキュメントにもある通り、Windows HomeマシンでWSL2バックエンドを使うとDockerをインストールすることができます。

つまり、Windowsでも特に苦労なくDockerを使うことができます。

本題：Windows10+WSL2+Dockerでローカル環境を汚さずに使い捨ての開発環境を手に入れる

ここからが本題です(前置きが長くてすみません)。

まず、Windows10にWSL2をインストールする必要があります。

WSL2とLinuxディストリビューションのインストール

Microsoft公式にインストールガイドがあり、「簡略化されたインストール」と「手動インストール」の2つの手順があります。

ガイドに従ってインストールを進めてください。

なんと、「簡略化されたインストール」だとwsl --installするだけでWSL2をインストールできちゃいます。

Windows 10 に WSL をインストールする | Microsoft Docs

手順に従うと、Windowsオペレーティングシステムと完全に統合されたLinuxディストリビューションが手に入ります。

これでWindows上に隔離されたLinux環境の出来上がりです！

Docker Desktopのインストール

Docker公式のガイドに従ってインストールを進めてください。

Windows Home に Docker Desktop をインストール — Docker-docs-ja 19.03 ドキュメント

Windows Terminalのインストール

MacだとiTerm2などのターミナルがあると思いますが、

WindowsにはWindows Terminalがありますので、インストールしておきましょう。

Windows Terminalをインストールする | Microsoft Docs

Windows10+WSL2+Docker環境の出来上がり！

これだけでWindows10+WSL2+Docker環境が出来上がりました。

これが今までの私の環境でした。

詳しい話はWindows10+WSL2で開発するメリットの記事に書きました。

WSL2とLinuxディストリビューションの問題点

これだけでも開発環境はLinuxディストリビューションに構築すれば使い捨てできる完了の出来上がりなのですが、1つ問題がありました。

それはLinuxディストリビューション上に仕事で使う開発環境を構築してしまうと気軽に使い捨てできないという点です。

当たり前といえば当たり前の話ですが、これは使っていて最近気づきました…

Microsoft Store経由だと同一のLinuxディストリビューションは複数入れることができない問題

例えば、私の場合はMicrosoft Storeから「Ubuntu 20.04 LTS」をインストールして使っていました。

じゃあ、もう一つ同じLinuxディストリビューション入れよう！と思いましたが入れられませんでした。

全く同じLinuxディストリビューションは入れられませんが、例えば「Ubuntu 18.04 LTS」などバージョンが違えば入れられるみたいです。

ですが、私は全く同じLinuxディストリビューションを入れたかったので方法を調べてみました。

新しくLinuxディストリビューションをインポートする方法を覚えた！

Microsoft公式のドキュメントにやり方が載っていました！

CentOSをインポートする方法を参考にUbuntuでインポートを試してみました。

WSL で使用する Linux ディストリビューションをインポートする | Microsoft Docs

こちらの方法は、

1. Linuxディストリビューションのtarファイルをコンテナから取得する

2. 取得したtarファイルをWSLにインポートする

という手順になります。

1. Linuxディストリビューションのtarファイルをコンテナから取得する

1. すでにインストールしたLinuxディストリビューションのコマンドラインを開く(この例ではUbuntu)

2. DockerでUbuntuコンテナを実行

docker run -t ubuntu:20.04 bash ls /

ubuntuのイメージがなければイメージの取得が始まる。

Unable to find image 'ubuntu:20.04' locally
20.04: Pulling from library/ubuntu
16ec32c2132b: Pull complete
Digest: sha256:82becede498899ec668628e7cb0ad87b6e1c371cb8a1e597d83a47fac21d6af3
Status: Downloaded newer image for ubuntu:20.04
/usr/bin/ls: /usr/bin/ls: cannot execute binary file

3. grepとawkを使用してUbuntuのコンテナIDを取得します。

bash用のコマンド

dockerContainerID=$(docker container ls -a | grep -i ubuntu:20.04 | awk '{print $1}')

fish用のコマンド

set dockerContainerID (docker container ls -a | grep -i ubuntu:20.04 | awk '{print $1}')

4. Cドライブ上にtarファイルをエクスポートします。

docker export $dockerContainerID > /mnt/c/temp/ubuntu.tar

2. 取得したtarファイルをWSLにインポートする

1. 先ほどエクスポートしたtarファイルをWSLにインポートします。

cd C:\temp
wsl --import Ubuntu-20.04_dev C:\Users\snyt45\AppData\Local\Packages\Ubuntu-20.04_dev C:\temp\ubuntu.tar

--importの補足：

--import <Distro> <InstallLocation> <FileName>

<Distro> -- wsl -lで出てくるディストリビューション名
<InstallLocation> -- インストール先。ストレージであるext4.vhdxが配置される。
<FileName> -- インポートするtarファイル

2. Linuxディストリビューションのストレージext4.vhdxが作成されていることを確認します。

3. wsl -lでディストリビューション一覧に追加されていることを確認します。

4. Windows Terminalにディストリビューションが追加されていることを確認します。

追加されていない場合は、Windows Terminalを再起動します。

Ubuntuのユーザー作成、Windows Terminalの開始ディレクトリ設定、dockerコマンドを使えるにする

1. Ubuntuを起動します。

wsl -d Ubuntu-20.04_dev

Ubuntuを起動すると、\\wsl$に追加したLinuxディストリビューションのフォルダが出てくるようになります。

2. Ubuntuを諸々アップデートします。

この後、vimが必要になるためインストールしています。

apt update
apt upgrade
apt-get install vim

3. ユーザーを作成します。

adduser ユーザー名

4. 3で作成したユーザーをログイン時のデフォルトユーザーに指定します。

設定を反映するには、一度wslを再起動(wsl -t [ディストリビューション名])する必要があります。

vi /etc/wsl.conf
# 下記を追加
[user]
default=ユーザー名

5. Windows Terminalで追加したUbuntuを開いた際に開始ディレクトリを設定します。

settings.jsonを開き、下記のような場所を見つけてそこにstartingDirectoryを追記しましょう。

  {
      "guid": "{a32514ec-a5a8-556e-a6a1-a1d48b6f0d84}",
      "hidden": false,
      "name": "Ubuntu-20.04_dev",
      "source": "Windows.Terminal.Wsl",
      "startingDirectory": "//wsl$/Ubuntu-20.04_dev/home/ユーザー名"  // 追加
  }