WindowsでDocker環境構築｜ブログ｜株式会社リヴァイト

Windows 11でLinux環境を整えるためにWSL2(Windows Subsystem for Linux)を活用し、その上でDocker環境を構築する手順を解説します。このガイドを通じて、日本語対応の開発環境を構築し、スムーズに作業を進めるための設定を行います。 環境 Windows11 Docker wsl2(Windows Subsystem for Linux) 参考サイト WSL を使用して Windows に Linux をインストールする方法 WSL 開発環境を設定する Windows に Docker Desktop をインストールする Dockerとは？なぜDockerを使うのか？ Dockerとは、アプリケーションとその動作に必要なすべてのものをまとめて「コンテナ」という形式でパッケージ化できるツールのことです。これを使うと、開発を行っている環境（たとえば自分のパソコン）と、実際にアプリケーションが動く本番の環境（たとえばサーバー）との違いによって発生する問題を少なくすることができます。 具体的には、Dockerを使えば、どこで動かしても同じように動作する一貫した環境を作りやすくなります。これにより、アプリケーションの開発やデプロイ（実際に運用するために配置すること）、そしてスケーリング（必要に応じて規模を大きくしたり小さくしたりすること）が効率的に行えるようになります。 要するに、Dockerを使うと、アプリケーションがどこでも同じように動くようにできるので、開発から本番運用までの作業がスムーズに進む、ということです。 WSLとは WSLとは「Windows Subsystem for Linux（Linux用Windowsサブシステム）」のことです。WSLを使うと、Windowsパソコンの中でLinuxの環境を直接実行することができます。 通常、Linuxを使うには、別の仮想マシンを用意したり、WindowsとLinuxをデュアルブート（パソコンを起動するたびにどちらのOSを使うか選ぶ方法）にしたりする必要がありますが、WSLを使えば、これらの手間をかけずに、Windows上でそのままLinuxを動かせるというのが大きなポイントです。 簡単に言うと、WSLを使うと、Windowsパソコンを使いながら、同時にLinuxも動かせる便利な機能です。 WSL 1 と WSL 2 の違い WSL 1 と WSL 2 にはいくつかの重要な違いがあります。主な違いは、WSL 2 では実際のLinuxカーネルを使用している点です。これにより、システムコールの互換性が向上し、LinuxとWindows間のパフォーマンスが改善されています。 WSL 2は、Linuxディストリビューションを軽量な仮想マシン（VM）内で実行し、現在のデフォルトバージョンとなっています。一方、WSL 1は仮想化を使用せず、軽量なエミュレーションでLinuxを実行します。 Windows Terminalのダウンロードとインストール 開発作業を効率化するために、まずWindows Terminalをインストールします。Windows Terminalは、コマンド プロンプト、PowerShell、bash（Linux用Windowsサブシステム（WSL）経由）などのコマンドラインシェルを一つのアプリケーションで管理できる最新のホストアプリケーションです。主な機能として、以下が挙げられます。 複数のタブ管理: 複数のシェルをタブで管理でき、作業の効率が向上します。 ペイン分割: 一つのウィンドウ内で複数のシェルを同時に操作可能です。 UnicodeおよびUTF-8文字のサポート: 多言語対応で、文字化けの心配がありません。 高速なテキストレンダリング: GPUで高速化されたテキストレンダリングエンジンにより、スムーズな操作感を実現します。 カスタマイズ性: テーマ、テキスト、カラー、背景、ショートカットなどをカスタマイズ可能です。 これらの特徴を活用することで、Windows Terminalは強力な開発ツールとなります。 Windows Terminalのインストール インストール手順 システム要件の確認 まず、システムがWindows Terminalに対応しているかを確認します。 スクリーンショット 2024-08-18 003501.png 対応していたらダウンロード システムが対応していることを確認したら、Windows Terminalをダウンロードします。 スクリーンショット 2024-08-18 003144.png WSLのインストール 次に、Windows Subsystem for Linux (WSL) をインストールします。以下の手順に従ってください。 管理者権限でのPowerShell起動 まず、管理者権限でPowerShellを起動します。ターミナルを開き、右上のタブからPowerShellを選択。任意の場所で以下のコマンドを実行します。 Start-Process powershell -Verb RunAs | コマンド | 意味 | | --- | --- | | Start-Process powershell | PowerShellセッションを新しく開始する | | -Verb RunAs | 管理者権限で実行する | \[スタート\] メニューを開き、「Windows PowerShell」->「管理者として実行」を選択することでも管理者権限で起動できます。管理者で起動すると、以下のように青い画面になります。 注: 最新のPowerShellをインストールすることが推奨されていますが、現状のままでも作業を進めることが可能です。 WSLのインストール 管理者権限でPowerShellを起動したら、以下のコマンドを実行してWSLをインストールします。 wsl --install このコマンドを実行すると、WSLで設定するためのユーザー名とパスワードの入力を求められます。 スクリーンショット 2024-08-18 071608.png 入力後数秒でインストールが完了します。 スクリーンショット 2024-08-18 010123.png インストールが成功したら、ターミナルを開き、タブにUbuntuが選択できるか確認してください。 Windows側の設定 WSLを使用するために、Windows側で以下の設定を行います。 「Linux用Windowsサブシステム」と「仮想マシンプラットフォーム」にチェックを入れます。 検索バーに「Windowsの機能の有効化または無効化」と入力し、該当する機能を見つけて設定を有効にします。 スクリーンショット 2024-09-02 160744.png スクリーンショット 2024-09-02 160752.png ※ 管理者権限のコマンドラインから以下のコマンドを入力でも設定可能です。 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart Dockerのインストール Docker Desktopをインストールします。Docker Desktopをインストールすることで、Windows上で簡単にDocker環境を構築できます。インストール後、Docker Desktopを起動し、WSL2を設定することを確認してください。 Docker Desktopのインストール手順はこちら ※上記は日本語に翻訳したイメージです それぞれの環境に合うデスクトップをダウンロードし、それぞれの手順に従って環境構築をおこなってください。(WSL 2 バックエンド、x8664で環境構築を行っていきます。) インストール後、Setting -> General に移動し以下の箇所にチェックが入っていることを確認する。 スクリーンショット 2024-09-02 161406.png スクリーンショット 2024-09-02 161237.png PowerShellで以下のコマンドを入力し、Ubuntuとdockerが起動しているか確認してください。 wsl -l -v STATEがRunningになっていれば OK です。 現行バージョンの確認とアップデート(省略可) バージョン確認 まず、現在使用しているUbuntuのバージョンを確認します。これにより、必要であればシステムのアップデートを行います。 cat /etc/os-release 出力例: PRETTYNAME="Ubuntu 22.04.3 LTS" NAME="Ubuntu" VERSIONID="22.04" VERSION="22.04.3 LTS (Jammy Jellyfish)" VERSIONCODENAME=jammy ID=ubuntu IDLIKE=debian HOMEURL="https://www.ubuntu.com/" SUPPORTURL="https://help.ubuntu.com/" BUGREPORTURL="https://bugs.launchpad.net/ubuntu/" PRIVACYPOLICYURL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy" UBUNTUCODENAME=jammy パッケージのアップデートと依存解決 Ubuntuシステムの全体を最新の状態に保つために、パッケージのアップデートと依存関係の解決を行います。以下のコマンドで実行可能です。 sudo apt update && sudo apt upgrade このコマンドで、パッケージリストを更新し、インストール済みのパッケージを最新バージョンにアップグレードします。 ディストリビューションアップグレードの確認 ディストリビューションのアップグレードを確認するために、以下のコマンドを実行します。 sudo apt dist-upgrade && sudo apt install update-manager-core dist-upgrade は、システム内のパッケージの依存関係をさらに詳細に解決し、必要に応じて新しいバージョンにアップグレードします。update-manager-coreがインストールされていない場合、このコマンドでインストールが行われます。 エラーや警告が表示されないことを確認し、次のステップに進みます。 release-upgradesの設定 次に、システムのアップグレード設定を行います。release-upgrades設定ファイルを編集します。 sudo vim /etc/update-manager/release-upgrades Prompt=ltsと設定することで、LTSバージョンに対してのみアップグレードが促されます。すでにLTSリリースを使用している場合は、この設定がデフォルトで有効になっている可能性があります。 アップグレードの実行 ここまでの設定が完了したら、最新のLTSバージョンへのアップグレードを実行します。アップグレードの前に、重要なファイルや個人設定をバックアップしておくことをおすすめします。 以下のコマンドを実行して、アップグレードを開始します。 sudo do-release-upgrade -d アップグレードの過程でパッケージの依存関係が解決され、プロセスが進行します。途中で同意を求められる場合がありますので、指示に従って進めてください。 完了したら再度アップデートされているかを確認するため以下のコマンドを入力します。 cat /etc/os-release システムのアップデート (アップデートを行った場合は不要) 次に、システムのパッケージリストを更新し、インストール済みパッケージをアップグレードします。 sudo apt update && sudo apt upgrade このステップでは、使用可能なパッケージのリストを更新し、その後、アップグレードを行います。システムの最新状態を維持するために重要な手順です。 使用可能なロケールの確認と日本語ロケールのインストール(省略可) システムにインストールされているロケールを確認します。現時点では日本語ロケールが含まれていない場合があります。 日本語ロケールが含まれている場合は、 jaJP.utf8 と記載があります。 locale -a 日本語ロケールを使用するために、以下のコマンドで日本語の言語パックをインストールします。 sudo apt install language-pack-ja -y パスワードを求められた場合は、初回に設定したroot権限のパスワードを入力してください。再度、ロケールを確認して、日本語ロケールが追加されたことを確認します。 locale -a 出力例 C C.UTF-8 POSIX enUS.utf8 jaJP.utf8 一番下にjaJP.UTF-8が追加されていれば成功です。 日本語ロケールの設定 日本語ロケールをデフォルトに設定するには、以下のコマンドを実行します。 sudo update-locale LANG=jaJP.UTF8 設定が完了したら、シェルを終了し、再起動します。これにより、日本語ロケールが有効になります。 注意: デフォルトのロケールを再度英語（enUS.UTF-8）に戻したい場合は、以下のコマンドを使用します。 sudo update-locale LANG=enUS.UTF8 タイムゾーンの変更 次に、タイムゾーンを日本時間（JST）に変更します。以下のコマンドを使用して設定します。 sudo dpkg-reconfigure tzdata GUIが表示されるので、「アジア」→「東京」を選択します。設定後、現在の時刻を確認するために、以下のコマンドを実行します。 date 出力例 しっかりと日本時間（JST）で表示されていることを確認してください。 コマンドのマニュアル表示を日本語化 最後に、コマンドのマニュアルを日本語で表示できるようにします。以下のコマンドを実行してください。 sudo apt install manpages-ja manpages-ja-dev -y これにより、manコマンドで表示されるマニュアルが日本語で提供されるようになります。 man コマンドは、Linux におけるコマンドやシステムコール (関数)、ライブラリなどの各マニュアルを表示するコマンドです。 man apt 出力例（日本語マニュアルの一部） スクリーンショット 2024-09-02 160333.png これで、システム環境が日本語に対応し、タイムゾーンも正しく設定された状態で、Dockerでの開発が進められるようになります。