WSL2 の環境構築と運用ガイド

Windows 11 上で Linux 開発環境を構築する際、WSL 2 (Windows Subsystem for Linux) は標準的なソリューションとして推奨されます。本ガイドでは、GUI に依存しないコマンドベースのセットアップと、より効率的な運用のための設定変更方法について解説します。

1. 必須機能の有効化

環境構築の最初のステップとして、Windows の「Windows Subsystem for Linux」と「仮想マシンプラットフォーム」機能を有効にする必要があります。PowerShell を管理者権限で実行し、以下のコマンドを使用して機能をオンにします。

# WSL 機能の有効化
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart

# 仮想マシンプラットフォームの有効化
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart

コマンド実行後、システムを再起動して変更を反映させてください。

2. WSL カーネルの更新とデフォルト設定

再起動後、最新の WSL2 カーネルを適用し、新しいディストリビューションが WSL 2 としてデフォルトで動作するように設定します。

# WSL コンポーネントの更新
wsl --update

# デフォルトのバージョンを WSL 2 に設定
wsl --set-default-version 2

3. Ubuntu のインストール

Microsoft Store を介する方法の代わりに、コマンドラインから直接インストールを行うことで、自動化と再現性を確保します。

# CLI を使用した Ubuntu のインストール
wsl --install -d Ubuntu

インストール完了後、初期ユーザー名とパスワードの設定が求められます。

4. 運用の自動化と設定

一般的なコマンド操作を、より堅牢な設定ファイルやスクリプトに置き換えることで、運用効率を向上させることができます。

ユーザー設定の永続化

wsl -u <username> のような一時的なフラグを使用する代わりに、wsl.conf を使用してデフォルトユーザーを定義します。

ファイル: /etc/wsl.conf

[user]
default = devops_user

これにより、WSL 起動時に毎回ユーザーを指定する必要がなくなります。

ファイルシステムパスのエイリアス

Linux パスと Windows パスの変換を行う wslpath コマンドを、Bash プロファイルにエイリアスとして登録します。

ファイル: ~/.bashrc

# WindowsパスをLinuxパスに変換
alias tolinux='wslpath -u'

# LinuxパスをWindowsパスに変換
alias towin='wslpath -w'

設定後は source ~/.bashrc を実行して反映させます。

WSL インスタンスの管理

WSL のシャットダウンや状態確認をスクリプト化します。

# 全インスタンスの停止
function stop-wsl() {
    wsl --shutdown
    echo "WSL instances have been terminated."
}

Ctrl + D または exit コマンドを使用して、現在のターミナルセッションを終了できます。