カスタムイメージに 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 インスタンスの作成時に一部のイメージが表示されない場合は、「特定のイメージが見つからない」をご参照ください。
操作手順
既存のカスタムイメージから ECS インスタンスを起動します。このインスタンスは、イメージを更新するための中間環境として機能します。インスタンスに接続します。
重要中間インスタンスには料金が発生します。継続的な課金を避けるため、新しいカスタムイメージを作成した後、インスタンスをリリースしてください。
インスタンスのオペレーティングシステムに応じて、NVMe ドライバーを検証およびインストールする方法を選択します。
コンソールでの設定
ECS コンソール - [インスタンス]で、対象のインスタンスを見つけて詳細ページに移動します。右上隅にある [すべての操作] をクリックし、[NVMe ドライバーのステータスを設定] を選択します。
[インストール] をクリックして NVMe ドライバーをインストールします。システムは NVMe ドライバーのステータスを自動的に [インストール済み] に設定します。

Cloud Assistant を使用した自動設定
Cloud Assistant (クラウドアシスタント) は、NVMe ドライバーを迅速に設定するための
ecs_nvme_configプラグインを提供します。このプラグインは、特定のオペレーティングシステムでのみサポートされています。Cloud Assistant エージェント がインストールされており、
ecs_nvme_configプラグインが利用可能かどうかを確認してください。acs-plugin-manager --list
Cloud Assistant 関連の出力が表示されない場合は、まずCloud Assistant エージェントをインストールしてください。
プラグインの一覧に
ecs_nvme_configが含まれている場合は、次のステップに進んでください。
ecs_nvme_configプラグインを使用して NVMe ドライバーを設定します。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;
チェック結果に基づいて NVMe ドライバーを設定してください。
sudo acs-plugin-manager --exec --plugin ecs_nvme_config --params --fix設定が完了したら、インスタンスを再起動してください。
sudo rebootインスタンスが再起動した後、設定が成功したことを確認してください。
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ドライバーをインストールしたインスタンスから新しいカスタムイメージを作成します。次に、新しいカスタムイメージの属性を変更し、[NVMe ドライバー]属性を [サポート] に設定してください。
重要NVMe ドライバー属性を [サポート] に設定しないと、そのイメージは NVMe 互換として認識されません。このイメージからインスタンスを作成する際に、NVMe 対応のインスタンスタイプを選択できなくなります。
手動設定 (CentOS/Alibaba Cloud Linux)
カーネルが NVMe ドライバーをロードしているか確認してください。
cat /boot/config-`uname -r` | grep -i nvme | grep -v "^#"
出力に
CONFIG_BLK_DEV_NVME=yが含まれている場合、オペレーティングシステムは NVMe 対応のインスタンスファミリーで直接起動できます。コンソールでの設定に進んでください。出力に
CONFIG_BLK_DEV_NVME=mが含まれている場合は、以下の手順を実行してください。
initramfs に NVMe ドライバーが含まれているか確認してください。
sudo lsinitrd /boot/initramfs-`uname -r`.img | grep -i nvme | awk '{print $NF}'
出力が図と一致する場合、オペレーティングシステムは NVMe 対応のインスタンスファミリーで起動できます。ステップ d に進んでください。
出力が返されない場合は、ステップ c を実行してください。
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 を実行してインストールしてください。
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 を使用したパラメーターの追加
grubbyが利用可能か確認してください。which grubby出力に
grubbyへのパス (例:/usr/sbin/grubby) が含まれている場合、システムはgrubbyをサポートしています。次のステップに進んでください。出力が表示されない場合、システムは
grubbyをサポートしていません。代わりに方法 2 を使用してください。
grubbyを使用してカーネルパラメーターを追加してください。sudo grubby --update-kernel=ALL --args="nvme_core.io_timeout=4294967295 nvme_core.admin_timeout=4294967295"
方法 2:GRUB 設定ファイルを編集してパラメーターを追加
grub ファイルを開いてください。
sudo vi /etc/default/grubi キーを押して挿入モードに入ってください。
GRUB_CMDLINE_LINUX=行を見つけ、nvme_core.io_timeout=4294967295 nvme_core.admin_timeout=4294967295パラメーターを追加してください。パラメーター追加後のファイル内容:
説明これらのパラメーターが設定ファイルにすでに存在する場合は、再度追加しないでください。
Esc キーを押して挿入モードを終了してください。
:wqと入力し、Enter キーを押してファイルを保存し、閉じてください。GRUB の設定を適用してください。
インスタンス起動モードに一致するコマンドを選択してください。
レガシー BIOS 起動モード
sudo grub2-mkconfig -o /boot/grub2/grub.cfgUEFI 起動モード
GRUB 設定ファイルを表示してください。
# CentOS の場合は、以下を実行します: cat /boot/efi/EFI/centos/grub.cfg # Alibaba Cloud Linux の場合は、以下を実行します: cat /boot/efi/EFI/alinux/grub.cfg出力に基づいて適切なコマンドを実行してください。
設定ファイルが別の設定ファイル (例:
/boot/grub/grub.cfg) を指している場合は、以下を実行してください。
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
ドライバーをインストールしたインスタンスから新しいカスタムイメージを作成します。次に、新しいカスタムイメージの属性を変更し、[NVMe ドライバー]属性を [サポート] に設定してください。
重要NVMe ドライバー属性を [サポート] に設定しないと、そのイメージは NVMe 互換として認識されません。このイメージからインスタンスを作成する際に、NVMe 対応のインスタンスタイプを選択できなくなります。
NVMe 関連の出力を確認してください。
sudo lsinitrd /boot/initramfs-`uname -r`.img | grep -i nvme | awk '{print $NF}'コマンドがドライバーファイル名 (例:nvme.ko) を返した場合、設定は完了です。これで、オペレーティングシステムは NVMe 対応の ECS インスタンスタイプで起動できます。

手動設定 (Ubuntu/Debian)
(オプション) initrd に NVMe ドライバーが含まれているか確認してください。
lsinitramfs /boot/initrd.img-`uname -r` | grep -i nvme以下の出力は、Ubuntu がデフォルトで initrd に NVMe ドライバーをロードすることを示しています。

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秒までしかサポートしていません。/etc/default/grub ファイルを開いてください。
sudo vi /etc/default/grubi キーを押して編集モードに入ってください。
GRUB_CMDLINE_LINUX=行に次のパラメーターを追加してください:nvme_core.multipath=n nvme_core.io_timeout=4294967295 nvme_core.admin_timeout=4294967295。パラメーター追加後のファイル内容:
説明これらのパラメーターが設定ファイルにすでに存在する場合は、再度追加しないでください。
Esc キーを押して挿入モードを終了してください。
:wqと入力し、Enter キーを押してファイルを保存し、閉じてください。
GRUB の設定を適用してください。
ECS インスタンスのインスタンス起動モードに基づき、次のいずれかのコマンドを選択してください。
このコマンドは、起動モードに関係なく Ubuntu と Debian で動作します。
sudo update-grub2レガシー BIOS 起動モード
sudo grub-mkconfig -o /boot/grub/grub.cfgUEFI 起動モード
sudo grub-mkconfig -o /boot/efi/EFI/debian/grub.cfg
ドライバーをインストールしたインスタンスから新しいカスタムイメージを作成します。次に、新しいカスタムイメージの属性を変更し、[NVMe ドライバー]属性を [サポート] に設定してください。
重要NVMe ドライバー属性を [サポート] に設定しないと、そのイメージは NVMe 互換として認識されません。このイメージからインスタンスを作成する際に、NVMe 対応のインスタンスタイプを選択できなくなります。
(オプション) 新しい NVMe 互換のカスタムイメージを使用してワークロードを再デプロイしてください。たとえば、カスタムイメージまたは共有イメージからインスタンスを作成し、NVMe 互換のインスタンスタイプを選択します。
デプロイを確認した後、アイドル状態のリソースに対する課金を避けるために、元のカスタムイメージを削除してください。
関連ドキュメント
NVMe ベースの ECS インスタンスタイプは、ESSD および ESSD AutoPL ディスクのみをサポートします。これらのディスクはマルチアタッチをサポートしており、複数の ECS インスタンスに同時にアタッチできます。詳細については、「複数の ECS インスタンスへのクラウドディスクのアタッチ (マルチアタッチ)」をご参照ください。
不適切な
io_timeout設定により、Linux ECS インスタンスで NVMe ディスクが利用できなくなった場合は、「無効な I/O タイムアウトパラメーターが原因で Linux ECS インスタンスの NVMe ディスクが利用できない場合の対処方法」をご参照ください。