Windows WSL Docker+Git 開発環境構築（Docker Desktop不使用）前編

はじめに

この記事では、Windows 11 環境において、WSL（Windows Subsystem for Linux） ¹ を活用し、Docker ² および Git³を使った開発環境を構築する手順を開発者向けに解説します。

WindowsでDockerを利用する場合はDocker Desktopなどを利用するのが一般的ですが、ファイルシステムの違いによりパフォーマンスが低下するケースがあるため、この記事では WSL上のLinuxディストリビューション（Ubuntu⁴）にDockerをインストール し、より高速で安定した開発環境を構築する方法をご紹介いたします。

前後編に分け、前編ではWSLのインストールからUbuntuのセットアップ、DockerとGitのインストールとGitのセットアップまでを解説します。

この記事がWindowsでの快適な環境構築の足がかりとなれば嬉しいです。

↓↓↓後編↓↓↓

目次

• はじめに
• 動作環境
• 操作手順
  • 1. WSLのインストール
  • 2. Ubuntuのインストールとセットアップ
  • 3. DockerとGitのインストール
  • 4. Gitのセットアップ
• 備考
  • WSL上のLinuxファイル操作
  • SSHの設定について
• 参考

動作環境

• OS: Windows 11
• PowerShell: 5.1
• WSL: WSL2
• Ubuntu: 24.04 LTS

操作手順

1. WSLのインストール

1. Windowsの「スタート」メニューを開き、「PowerShell」と入力して、PowerShellを管理者として実行します。
   
   
   

2. 以下のコマンドを入力して、WSLをインストールします。

   wsl --install
   

   
   

3. インストールが完了したら、PCを再起動します。
   
   

4. 再起動後、PowerShellを再度開き、以下のコマンドを入力してWSLのバージョンを確認します。

   wsl --version
   

2. Ubuntuのインストールとセットアップ

1. PowerShellを開き、以下のコマンドを入力してUbuntuをインストールします。

   wsl --install -d Ubuntu
   # バージョンを指定する場合は、wsl --install -d Ubuntu-24.04のようにします。
   # アンインストールする場合は、wsl --unregister Ubuntu のようにコマンドを実行します。
   

   
   

2. インストールが完了したら、以下のコマンドを入力してインストールされたUbuntuのバージョンを確認します。

   wsl --list --verbose
   # バージョンが確認できたら、PowerShellは終了して問題ありません。
   

   
   

3. Windowsの「スタート」メニューを開き、「Ubuntu」と入力して、インストールしたUbuntuを起動します。
   
   
   

4. 初回起動時に、画面の指示に従い任意のユーザー名とパスワードを設定します。
   このパスワードは頻繁に使用するため忘れないようにしてください。
   

WSL上のLinuxファイル操作

3. DockerとGitのインストール

1. Ubuntuを起動し、以下のコマンドを入力して筆者が作成したgithub上のスクリプトを実行し、DockerとGit関連パッケージをインストールします。

   wget -qO- https://raw.githubusercontent.com/joyrswd/setup/main/install_docker_git.sh | bash
   # wget がインストールされていない場合は、
   # sudo apt install wget のコマンドを実行してインストールしてください。
   

   
   

2. Dockerの実行権限を反映させるため、一旦Ubuntuを終了し再度起動します。
   
   

3. 以下のコマンドを入力して、Dockerが正しくインストールされているか確認します。

   docker run hello-world
   # 以下のようなメッセージが表示されたらOK。
   # ...
   # Hello from Docker!
   # This message shows that your installation appears to be working correctly.
   # ...
   

   
   

4. 以下のコマンドを入力して、Gitが正しくインストールされているか確認します。

   git --version
   

SSHの設定について

4. Gitのセットアップ

1. Ubuntuを起動し、以下のコマンドを入力してGitの初期設定を行います。

   git config --global user.name "YourName"
   git config --global user.email "youremail@address"
   # "YourName"と"youremail@address"は、実際のユーザー名とメールアドレスに置き換えてください。
   

   
   

2. 以下のコマンドを入力して、Gitの設定が正しく行われているか確認します。

   git config --global user.name
   # "YourName"（入力した値）が表示されればOK。
   git config --global user.email
   # "youremail@address"（入力した値）が表示されればOK。
   

↓↓↓後編↓↓↓

備考

• WSL上のLinuxファイル操作

  WSL上のファイルは以下の2つの方法でエクスプローラーからアクセスすることで、
  通常のWindowsのファイルと同じように操作できます。

  • A) Ubuntuのターミナルを使用する方法
    Ubuntuを起動し、以下のコマンドを入力してEnterキーを押します。

    explorer.exe .
    # 末尾の”.”は現在のディレクトリを指します。
    

    
    
  • B) Windowsのエクスプローラーを使用する方法
    Windowsのエクスプローラーを開き、アドレスバーに以下のパスを入力してEnterキーを押します。

    \\wsl$\Ubuntu-xx.xx\home\<ユーザー名>
    # xx.xxはインストールしたUbuntuのバージョン
    # <ユーザー名>はUbuntuの初回起動時に設定したユーザー名
    

    

• SSHの設定について

  GitHubやGitLabなどのソースホストにSSHの接続設定が必要な場合、
  すでに公開鍵を登録済みの場合は.sshディレクトリが作成されているためそちらに秘密鍵を配置してください。

  まだ公開鍵をソースホストに登録していない方は、以下のコマンドを実行して新たに秘密鍵ペアを作成し公開鍵の登録を行ってください。

  ssh-keygen -t ed25519
  # 対話形式でSSH鍵を生成します。
  # 秘密鍵の保存先を聞かれますがそのままEnterキーを押してください。
  # パスフレーズは任意ですが、セキュリティのために設定することをお勧めします。
  

参考

Docker＆Gitインストールスクリプト

1. WSL（Windows Subsystem for Linux） は、Windows上でLinux環境を実行できる機能です。これにより、Linuxのコマンドラインツールやアプリケーションを、Windows上でネイティブのように使用することができます。
   ↩

2. Docker は、アプリケーションをコンテナとしてパッケージ化することで、開発・実行環境の再現性と移植性を高めるプラットフォームです。
   ↩

3. Git は、ソースコードのバージョン管理システムです。複数人での開発や変更履歴の管理に広く利用されており、現代のソフトウェア開発に欠かせないツールです。
   ↩

4. Ubuntu（ウブントゥ）は、誰でも無料で使えるLinuxディストリビューションの1つで、使いやすさと安定性に優れており、開発やサーバー運用、教育など幅広い用途で利用されています。
   ↩