# STT プロジェクト テストのための VirtualBox セットアップ ガイド

このガイドでは、VirtualBox で安定したパフォーマンスの Ubuntu 24.04 仮想マシンをセットアップするための推奨手順を説明します。これらの手順に従うと、STT アプリケーションをテストするための一貫した環境が作成され、インストールの遅さ、システムのフリーズ、クリップボード機能の欠如などの一般的な問題が回避されます。

## 前提条件

- VirtualBox がホスト マシンにインストールされている。
- Ubuntu 24.04 デスクトップ ISO ファイルがダウンロードされました。

## リファレンス ホスト ハードウェア

この構成は、次のホスト システムでテストおよび検証されました。他のハードウェアではパフォーマンスが異なる場合がありますが、安定性の設定は普遍的に適用されるはずです。

- **オペレーティング システム:** Manjaro Linux
- **カーネル:** 6.6.94
- **プロセッサ:** 16 × AMD Ryzen 7 3700X
- **メモリ:** 31.3 GiB の RAM
- **グラフィックプロセッサ:** NVIDIA GeForce GTX 1050 Ti

---

## パート 1: VM の作成と構成

これらの設定は、パフォーマンスと安定性にとって重要です。

### ステップ 1.1: 新しい仮想マシンを作成する

1. VirtualBox で、[**新規**] をクリックします。
2. **名前:** `Ubuntu STT Tester` (または類似のもの)。
3. **ISO イメージ:** このフィールドは空白のままにします。
4. **「無人インストールをスキップする」** ボックスをオンにします。
5. [**次へ**] をクリックします。
6. **ハードウェア:**
- **ベース メモリ:** `4096 MB` 以上。
- **プロセッサ:** `4` 以上。
7. [**次へ**] をクリックします。

### ステップ 1.2: 仮想ハードディスクの作成 (重要)

これは、迅速なインストールとパフォーマンスにとって最も重要な手順です。

1. **「今すぐ仮想ハードディスクを作成する」** を選択します。
2. ディスク サイズを **40 GB** 以上に設定します。
3. 次の画面で、ストレージの種類を **「固定サイズ」** に変更します。
> **なぜですか?** 固定サイズのディスクは事前に割り当てられており、「動的に割り当てられた」ディスクのサイズがインストール中に常に変更される場合に発生する大規模な I/O ボトルネックを防ぎます。
4. [**作成**] をクリックし、プロセスが完了するまで待ちます。

### ステップ 1.3: VM の最終設定

新しく作成した VM を選択し、[**設定**] をクリックします。以下を設定します。

- **システム -> マザーボード:**
- **チップセット:** `ICH9`
- **「EFI を有効にする (特殊な OS のみ)」** にチェックを入れます。

- **ディスプレイ -> 画面:**
- **グラフィックス コントローラー:** `VMSVGA`
- **「3D アクセラレーションを有効にする」** のチェックを外します。
> **なぜですか?** 3D アクセラレーションは、Linux ゲストでのシステムのハングやフリーズの一般的な原因です。これを無効にすると、安定性が大幅に向上します。

-   **ストレージ：**
- **SATA コントローラー**を選択します。 **「ホスト I/O キャッシュを使用する」** チェックボックスをオンにします。
- 仮想ディスク ファイル (`.vdi`) を選択します。 **「ソリッド ステート ドライブ」** ボックスにチェックを入れます。
- **空**光学ドライブを選択します。右側の CD アイコンをクリックし、**「ディスク ファイルを選択...」** をクリックして、Ubuntu 24.04 ISO を添付します。

**OK** をクリックしてすべての設定を保存します。

---

## パート 2: Ubuntu OS のインストール

1. VM を起動します。
2. 言語とキーボードの設定を進めます。
3. [アップデートとその他のソフトウェア] に到達したら、次を選択します。
- **最小限のインストール**。
- **「Ubuntu のインストール中にアップデートをダウンロードする」のチェックを外します**。
4. 完了するまでインストールを続行します。
5. 完了したら、VM を再起動します。プロンプトが表示されたら、インストール メディアを取り出します (Enter キーを押します)。

---

## パート 3: インストール後 (ゲストの追加)

この手順により、クリップボードの共有、ドラッグ アンド ドロップ、および自動画面サイズ変更が有効になります。

### ステップ 3.1: ホストにゲスト追加 ISO をインストールする (必要な場合)

**ホスト マシン**に、Guest Additions ISO パッケージがインストールされていることを確認してください。

- **オン アーチ / マンジャロ:**
    ```bash
    sudo pacman -S virtualbox-guest-iso
    ```
- **Debian / Ubuntu の場合:**
    ```bash
    sudo apt install virtualbox-guest-additions-iso
    ```

### ステップ 3.2: Ubuntu VM 内にゲスト追加機能をインストールする

**実行中の Ubuntu VM 内**でこれらの手順を実行します。

1. **Ubuntu を準備します:** ターミナルを開き、次のコマンドを実行してビルドの依存関係をインストールします。
    ```bash
    sudo apt update
    sudo apt install build-essential dkms linux-headers-$(uname -r)
    ```
2. **CD を挿入します。** VirtualBox のトップ メニューから、**デバイス -> ゲスト追加 CD イメージの挿入...** に移動します。
3. **インストーラーを実行します:**
- ソフトウェアの実行を求めるダイアログが表示される場合があります。 [**実行**] をクリックします。
- ダイアログが表示されない場合は、ファイル マネージャーを開き、「VBox_GAs...」CD を右クリックして、**「ターミナルで開く」** を選択し、次のコマンドを実行します。
      ```bash
      sudo ./VBoxLinuxAdditions.run
      ```
4. **再起動:** インストールが完了したら、VM を再起動します。
    ```bash
    reboot
    ```
5. **機能を有効にする:** 再起動後、**デバイス** メニューに移動し、**共有クリップボード -> 双方向** および **ドラッグ アンド ドロップ -> 双方向** を有効にします。

安定したパフォーマンスのテスト環境が準備できました。