すべてのプロダクト
Search
ドキュメントセンター

:カスタムイメージへの NVMe ドライバーのインストール

最終更新日:Sep 01, 2026

カスタムイメージに NVMe ドライバーのサポートを追加することで、拡張ストレージパフォーマンスを持つ NVMe ベースの Elastic Compute Service (ECS) インスタンスタイプでそのイメージを起動できるようになります。

NVMe は、フラッシュベースの SSD などのソリッドステートストレージ向けに設計された高速プロトコルです。SCSI や virtio-blk と比較して、NVMe はより高い速度と広い帯域幅を提供します。

ユースケース

次のような場合は、この手順に従ってください。

  • カスタムイメージを Alibaba Cloud にインポートし、イメージチェックで NVMe ドライバーが見つからないと報告された場合。

  • イメージの NVMe 属性がインスタンスタイプの要件と一致しないため、NVMe をサポートする ECS インスタンスタイプを作成する際にカスタムイメージを選択できない場合。

    説明
    • NVMe 互換のインスタンスファミリーについては、「インスタンスファミリー概要」をご参照ください。DescribeInstanceTypes API の NvmeSupport パラメーターで確認することもできます。

    • カスタムイメージが NVMe をサポートしているかどうかを確認するには、DescribeImages API の NvmeSupport パラメーターを確認してください。

    • ECS インスタンスの作成時に一部のイメージが表示されない場合は、「特定のイメージが見つからない」をご参照ください。

操作手順

  1. 既存のカスタムイメージから ECS インスタンスを起動します。このインスタンスは、イメージを更新するための中間環境として機能します。インスタンスに接続します。

    重要

    中間インスタンスには料金が発生します。継続的な課金を避けるため、新しいカスタムイメージを作成した後、インスタンスをリリースしてください。

  2. インスタンスのオペレーティングシステムに応じて、NVMe ドライバーを検証およびインストールする方法を選択します。

    コンソールでの設定

    1. ECS コンソール - [インスタンス]で、対象のインスタンスを見つけて詳細ページに移動します。右上隅にある [すべての操作] をクリックし、[NVMe ドライバーのステータスを設定] を選択します。

    2. [インストール] をクリックして NVMe ドライバーをインストールします。システムは NVMe ドライバーのステータスを自動的に [インストール済み] に設定します。image

    Cloud Assistant を使用した自動設定

    Cloud Assistant (クラウドアシスタント) は、NVMe ドライバーを迅速に設定するための ecs_nvme_config プラグインを提供します。このプラグインは、特定のオペレーティングシステムでのみサポートされています。

    ecs_nvme_config がサポートするオペレーティングシステム

    • ecs_nvme_config プラグインは、以下のオペレーティングシステムをサポートします。

      • Alibaba Cloud Linux

      • Anolis OS

      • CentOS 6.6 以降

      • CentOS Stream

      • Debian 9 以降

      • Ubuntu 16 以降

      • OpenSUSE 42 以降

      • SUSE Linux Enterprise Server 11.4 以降

      • Red Hat Enterprise Linux

      • Fedora

      • Rocky Linux

      • AlmaLinux

    1. Cloud Assistant エージェント がインストールされており、ecs_nvme_config プラグインが利用可能かどうかを確認してください。

      acs-plugin-manager --list

      image

    2. ecs_nvme_config プラグインを使用して NVMe ドライバーを設定します。

      1. ecs_nvme_config プラグインを使用して、NVMe モジュールが存在し、設定可能かどうかを確認してください。

        sudo acs-plugin-manager --exec --plugin ecs_nvme_config --params --check
        • 出力に次のメッセージが含まれている場合、NVMe ドライバーはすでにインストールされています。カスタムイメージの作成に進んでください。

          [SUCCESS]  Summary: Your image can Runnig on nvme instance
        • 出力に次のような [ERROR] メッセージが含まれている場合は、次のステップに進んでください。

          [ERROR]  1.initrd/initramfs not has nvme module, Please run acs-plugin-manager --exec --plugin ecs_nvme_config --params -f/--fix to enable nvme;
      2. チェック結果に基づいて NVMe ドライバーを設定してください。

        sudo acs-plugin-manager --exec --plugin ecs_nvme_config --params --fix
      3. 設定が完了したら、インスタンスを再起動してください。

        sudo reboot
      4. インスタンスが再起動した後、設定が成功したことを確認してください。

        sudo acs-plugin-manager --exec --plugin ecs_nvme_config --params --check

        成功時の出力例:

        [OK]  1.initrd/initramfs already contain nvme module;
        
        [OK]  2.fstab file looks fine and does not contain any device names;
        
        [OK]  3.The nvme parameters already included.
        
        [SUCCESS]  Summary: Your image can Runnig on nvme instance
      5. ドライバーをインストールしたインスタンスから新しいカスタムイメージを作成します。次に、新しいカスタムイメージの属性を変更し、[NVMe ドライバー]属性を [サポート] に設定してください。

        重要

        NVMe ドライバー属性を [サポート] に設定しないと、そのイメージは NVMe 互換として認識されません。このイメージからインスタンスを作成する際に、NVMe 対応のインスタンスタイプを選択できなくなります。

    手動設定 (CentOS/Alibaba Cloud Linux)

    1. カーネルが NVMe ドライバーをロードしているか確認してください。

      cat /boot/config-`uname -r` | grep -i nvme | grep -v "^#"

      image

      • 出力に CONFIG_BLK_DEV_NVME=y が含まれている場合、オペレーティングシステムは NVMe 対応のインスタンスファミリーで直接起動できます。コンソールでの設定に進んでください。

      • 出力に CONFIG_BLK_DEV_NVME=m が含まれている場合は、以下の手順を実行してください。

    2. initramfs に NVMe ドライバーが含まれているか確認してください。

      sudo lsinitrd /boot/initramfs-`uname -r`.img | grep -i nvme | awk '{print $NF}'

      image

      • 出力が図と一致する場合、オペレーティングシステムは NVMe 対応のインスタンスファミリーで起動できます。ステップ d に進んでください。

      • 出力が返されない場合は、ステップ c を実行してください。

    3. NVMe ドライバーを initramfs に追加してください。

      mkdir -p /etc/dracut.conf.d
      echo 'add_drivers+=" nvme nvme-core "' | sudo tee /etc/dracut.conf.d/nvme.conf > /dev/null
      sudo dracut -v -f
      説明

      dracut ツールがインストールされていない場合は、sudo yum -y install dracut を実行してインストールしてください。

    4. GRUB で NVMe の io_timeout パラメーターを追加してください。

      説明

      デバイスのタイムアウトによる I/O 障害を防ぐために、GRUB で NVMe の io_timeout パラメーターを追加します。この値をサポートされている最大値に設定することで、システムは早期の障害なしに I/O リクエストの処理を継続できます。

      ほとんどの Linux ディストリビューションでは、io_timeout パラメーターのデフォルト値は30秒です。io_timeout パラメーターの値を追加する前に、echo 4294967295 > /sys/module/nvme_core/parameters/io_timeout または echo 4294967295 > /sys/module/nvme/parameters/io_timeout を実行して、io_timeout が最大値の 4,294,967,295秒に設定できるか確認してください。コマンドが -bash: echo: write error: Invalid argument を返す場合、その Linux バージョンは 255秒までしかサポートしていません。

      方法 1:grubby を使用したパラメーターの追加
      1. grubby が利用可能か確認してください。

        which grubby
        • 出力に grubby へのパス (例:/usr/sbin/grubby) が含まれている場合、システムは grubby をサポートしています。次のステップに進んでください。

        • 出力が表示されない場合、システムは grubby をサポートしていません。代わりに方法 2 を使用してください。

      2. grubby を使用してカーネルパラメーターを追加してください。

        sudo grubby --update-kernel=ALL --args="nvme_core.io_timeout=4294967295 nvme_core.admin_timeout=4294967295"
      方法 2:GRUB 設定ファイルを編集してパラメーターを追加
      1. grub ファイルを開いてください。

        sudo vi /etc/default/grub
      2. i キーを押して挿入モードに入ってください。GRUB_CMDLINE_LINUX= 行を見つけ、nvme_core.io_timeout=4294967295 nvme_core.admin_timeout=4294967295 パラメーターを追加してください。

        パラメーター追加後のファイル内容:

        image

        説明

        これらのパラメーターが設定ファイルにすでに存在する場合は、再度追加しないでください。

      3. Esc キーを押して挿入モードを終了してください。:wq と入力し、Enter キーを押してファイルを保存し、閉じてください。

      4. GRUB の設定を適用してください。

        インスタンス起動モードに一致するコマンドを選択してください。

        • レガシー BIOS 起動モード

          sudo grub2-mkconfig -o /boot/grub2/grub.cfg
        • UEFI 起動モード

          1. GRUB 設定ファイルを表示してください。

            # CentOS の場合は、以下を実行します:
            cat /boot/efi/EFI/centos/grub.cfg
            # Alibaba Cloud Linux の場合は、以下を実行します:
            cat /boot/efi/EFI/alinux/grub.cfg
          2. 出力に基づいて適切なコマンドを実行してください。

            • 設定ファイルが別の設定ファイル (例:/boot/grub/grub.cfg) を指している場合は、以下を実行してください。image

              sudo grub2-mkconfig -o /boot/grub2/grub.cfg
            • それ以外の場合は、お使いのシステムに適したコマンドを実行してください。

              # CentOS の場合
              sudo grub2-mkconfig -o /boot/efi/EFI/centos/grub.cfg
              # Alibaba Cloud Linux の場合
              sudo grub2-mkconfig -o /boot/efi/EFI/alinux/grub.cfg
      5. ドライバーをインストールしたインスタンスから新しいカスタムイメージを作成します。次に、新しいカスタムイメージの属性を変更し、[NVMe ドライバー]属性を [サポート] に設定してください。

        重要

        NVMe ドライバー属性を [サポート] に設定しないと、そのイメージは NVMe 互換として認識されません。このイメージからインスタンスを作成する際に、NVMe 対応のインスタンスタイプを選択できなくなります。

    5. NVMe 関連の出力を確認してください。

      sudo lsinitrd /boot/initramfs-`uname -r`.img | grep -i nvme | awk '{print $NF}'

      コマンドがドライバーファイル名 (例:nvme.ko) を返した場合、設定は完了です。これで、オペレーティングシステムは NVMe 対応の ECS インスタンスタイプで起動できます。

      image

    手動設定 (Ubuntu/Debian)

    1. (オプション) initrd に NVMe ドライバーが含まれているか確認してください。

      lsinitramfs /boot/initrd.img-`uname -r` | grep -i nvme

      以下の出力は、Ubuntu がデフォルトで initrd に NVMe ドライバーをロードすることを示しています。image

    2. GRUB で NVMe の io_timeout パラメーターを追加してください。

      説明

      デバイスのタイムアウトによる I/O 障害を防ぐために、GRUB で NVMe の io_timeout パラメーターを追加します。この値をサポートされている最大値に設定することで、システムは早期の障害なしに I/O リクエストの処理を継続できます。

      ほとんどの Linux ディストリビューションでは、io_timeout パラメーターのデフォルト値は30秒です。io_timeout パラメーターの値を追加する前に、echo 4294967295 > /sys/module/nvme_core/parameters/io_timeout または echo 4294967295 > /sys/module/nvme/parameters/io_timeout を実行して、io_timeout が最大値の 4,294,967,295秒に設定できるか確認してください。コマンドが -bash: echo: write error: Invalid argument を返す場合、その Linux ディストリビューションは 255秒までしかサポートしていません。

      1. /etc/default/grub ファイルを開いてください。

        sudo vi /etc/default/grub
      2. i キーを押して編集モードに入ってください。GRUB_CMDLINE_LINUX= 行に次のパラメーターを追加してください: nvme_core.multipath=n nvme_core.io_timeout=4294967295 nvme_core.admin_timeout=4294967295。

        パラメーター追加後のファイル内容:image

        説明

        これらのパラメーターが設定ファイルにすでに存在する場合は、再度追加しないでください。

      3. Esc キーを押して挿入モードを終了してください。:wq と入力し、Enter キーを押してファイルを保存し、閉じてください。

    3. GRUB の設定を適用してください。

      ECS インスタンスのインスタンス起動モードに基づき、次のいずれかのコマンドを選択してください。

      • このコマンドは、起動モードに関係なく Ubuntu と Debian で動作します。

        sudo update-grub2
      • レガシー BIOS 起動モード

        sudo grub-mkconfig -o /boot/grub/grub.cfg
      • UEFI 起動モード

        sudo grub-mkconfig -o /boot/efi/EFI/debian/grub.cfg
    4. ドライバーをインストールしたインスタンスから新しいカスタムイメージを作成します。次に、新しいカスタムイメージの属性を変更し、[NVMe ドライバー]属性を [サポート] に設定してください。

      重要

      NVMe ドライバー属性を [サポート] に設定しないと、そのイメージは NVMe 互換として認識されません。このイメージからインスタンスを作成する際に、NVMe 対応のインスタンスタイプを選択できなくなります。

  3. (オプション) 新しい NVMe 互換のカスタムイメージを使用してワークロードを再デプロイしてください。たとえば、カスタムイメージまたは共有イメージからインスタンスを作成し、NVMe 互換のインスタンスタイプを選択します。

説明

デプロイを確認した後、アイドル状態のリソースに対する課金を避けるために、元のカスタムイメージを削除してください。

関連ドキュメント