WSL 環境でのビルドテスト環境の構築ガイド

前提条件

– すでに WSL 環境はセットアップ済み。
– まず WSL 上にインストールされている OS を確認して把握する。
– PowerShell を使用してインストールする。

WSL 環境の確認と準備

1. インストールされている WSL ディストリビューションの確認

PowerShell を開き、次のコマンドを実行して、現在インストールされている WSL ディストリビューションを確認します。

wsl -l -v 

このコマンドで、すべての WSL ディストリビューションがリスト表示されます。

2. Windows 側の準備

– インストールディレクトリの作成
– WSL 用のカスタムインストールを行うディレクトリを作成します。

mkdir C:\wsl 

– このディレクトリは、WSL のインストールディレクトリ兼インストール作業場所として使用します。

手動インストール方法

3. Ubuntu-22.04 のカスタムインストール (手動)

– Ubuntu-22.04 のダウンロード
– 以下のリンクから Ubuntu-22.04 の RootFS をダウンロードします。
– Ubuntu-22.04 RootFS – ダウンロードリンク
– PowerShell で以下のコマンドを実行して、RootFS をダウンロードしてください。

Invoke-WebRequest -Uri https://cloud-images.ubuntu.com/wsl/jammy/current/ubuntu-jammy-wsl-amd64-ubuntu22.04lts.rootfs.tar.gz -OutFile C:\wsl\ubuntu-22.04-server-cloudimg-amd64-wsl.rootfs.tar.gz

– カスタムインストールの実行
– ダウンロードした RootFS を使用して、WSL にカスタムインストールします。インスタンス名は Ubuntu-22.04-cubit とします。

wsl --import Ubuntu-22.04-cubit C:\wsl\Ubuntu-22.04-cubit C:\wsl\ubuntu-22.04-server-cloudimg-amd64-wsl.rootfs.tar.gz

– Ubuntu-22.04 の設定
– インストール後、新しい WSL インスタンスを起動します。

wsl -d Ubuntu-22.04-cubit 

– 起動後、cubit という名前のユーザーを手動で作成します。

adduser cubit 
usermod -aG sudo cubit 

– /etc/wsl.conf ファイルを作成して、デフォルトユーザーを cubit に設定します。

sudo nano /etc/wsl.conf 

– 以下の内容を追加します。

[user] 
default=cubit 

– ファイルを保存して終了し、WSL を再起動します。

wsl --shutdown 
wsl -d Ubuntu-22.04-cubit

完全自動インストール方法

4. Ubuntu-22.04 の設定 (PowerShell スクリプトで完全自動化)

– ユーザー cubit の作成と設定
– PowerShell スクリプトを使って自動的にユーザーを作成し、デフォルト設定を行います。以下のスクリプトを PowerShell で実行してください。

wsl -d Ubuntu-22.04-cubit --user root -- bash -c " 
adduser cubit --gecos "" --disabled-password 
echo 'cubit:password' | chpasswd 
usermod -aG sudo cubit 

echo -e '[user]\ndefault=cubit' > /etc/wsl.conf 
" 

– WSL のシャットダウンと再起動を行います。

wsl --shutdown 
wsl -d Ubuntu-22.04-cubit 

– このスクリプトでは、cubit ユーザーを作成し、デフォルトのログインユーザーに設定しています。
– adduser コマンドでユーザーを作成し、usermod コマンドで管理者権限を付与します。
– /etc/wsl.conf ファイルにデフォルトユーザーを設定することで、次回以降のログイン時に自動的に cubit ユーザーでログインされます。

初期化および削除方法

1. WSL インスタンスの初期化 (完全解除と再セットアップ)

– 初期化とは、インストール済みの WSL インスタンスを完全に解除し、すべての設定とデータを削除して最初のインストール状態に戻すことを指します。これは単なるディスクイメージのクリーンナップではなく、WSL インスタンスそのものを再セットアップするプロセスです。
– PowerShell で以下のコマンドを実行して、Ubuntu-22.04-cubit を初期化します。

wsl --unregister Ubuntu-22.04-cubit

2. WSL インスタンスの完全削除

– インスタンスを完全に削除するためには、まず上記の初期化コマンドを実行し、その後ディレクトリ内のファイルを削除します。

wsl --unregister Ubuntu-22.04-cubit 
Remove-Item -Recurse -Force C:\wsl\Ubuntu-22.04-cubit 

– wsl –unregister コマンドでインスタンスを削除した後、残ったファイルを手動で削除する必要があります。
– Remove-Item コマンドでディレクトリごと削除し、すべての関連ファイルをクリーンアップします。

3. 初期化後の再インストールと設定

– 初期化後、再度 Ubuntu-22.04-cubit をインストールし、必要な設定を行います。
– 再インストールには、以下のカスタムインストール手順を繰り返します。

wsl --import Ubuntu-22.04-cubit C:\wsl\Ubuntu-22.04-cubit C:\wsl\ubuntu-22.04-server-cloudimg-amd64-wsl.rootfs.tar.gz 

– その後、cubit ユーザーの設定を行います。完全自動化したスクリプトを再利用することで、迅速に設定を行えます。

wsl -d Ubuntu-22.04-cubit --user root -- bash -c `
"adduser cubit --gecos ' ' --disabled-password; `
echo 'cubit:password' | chpasswd; `
usermod -aG sudo cubit; `
echo -e '[user]\ndefault=cubit' > /etc/wsl.conf"

– この手順により、初期化後も迅速に設定を復元し、Ubuntu-22.04-cubit を通常通り使用できる状態に戻せます。

通常のインストール方法 (PowerShell を使用)

1. ダウンロード可能なディストリビューションのリストの確認

– PowerShell を使用して、WSL でダウンロード可能なディストリビューションのリストを確認します。

wsl --list --online 

– このコマンドで利用可能なディストリビューションのリストが表示されます。

2. ディストリビューションのインストール

– 例えば、Ubuntu 22.04 または 24.04 をインストールするには、以下のコマンドを使用します。

wsl --install -d Ubuntu-22.04