Amazon Elastic Compute Cloud
用户指南(适用于 Linux 实例)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

Linux 实例上启用 Elastic Network Adapter (ENA) 增强联网

Amazon EC2 通过 Elastic Network Adapter (ENA) 提供增强联网功能。

要求

要使用 ENA 准备增强联网,请按如下方式设置您的实例:

  • 从以下支持的实例类型中选择:A1, C5, C5d, C5n, F1, G3, H1, I3, m4.16xlarge, M5, M5a, M5ad, M5d, P2, P3, R4, R5, R5a, R5ad, R5d, T3, T3a, u-6tb1.metal, u-9tb1.metal, u-12tb1.metal, X1, X1e, and z1d。

  • 使用支持的 Linux 内核版本及支持的发行版启动实例,以便为实例自动启用 ENA 增强联网。有关更多信息,请参阅 ENA Linux 内核驱动程序发行说明

  • 确保实例具有 Internet 连接。

  • AWS CLI适用于 Windows PowerShell 的 AWS 工具 安装到您选择的任意计算机上(最好是您的本地台式计算机或笔记本电脑)并进行配置。有关更多信息,请参阅访问 Amazon EC2。不能从 Amazon EC2 控制台管理增强联网。

  • 如果您的实例上有重要的数据需要保留,则应立即从您的实例创建 AMI,来备份这些数据。更新内核和内核模块以及启用 enaSupport 属性可能会导致实例不兼容或操作系统无法访问;如果您有最新备份,则可在发生这种情况时保留数据。

数据加密

AWS 在 EC2 实例之间提供安全的私有连接。此外,我们将 AEAD 算法与 256 位加密一起使用,以便自动对同一 VPC 或对等 VPC 中的 C5n、I3en 和 P3dn 实例之间传输的流量进行加密。此加密功能将使用基础硬件的卸载功能,对网络性能不会造成影响。

测试是否启用了增强联网功能

若要测试是否已启用了增强联网,请确认实例上已安装 ena 模块且设置了 enaSupport 属性如果实例满足这两个条件,则 ethtool -i ethn 命令应显示该模块已在网络接口上使用。

内核模块 (ena)

要确认已安装 ena 模块,请使用 modinfo 命令,如下所示:

[ec2-user ~]$ modinfo ena filename: /lib/modules/4.14.33-59.37.amzn2.x86_64/kernel/drivers/amazon/net/ena/ena.ko version: 1.5.0g license: GPL description: Elastic Network Adapter (ENA) author: Amazon.com, Inc. or its affiliates srcversion: 692C7C68B8A9001CB3F31D0 alias: pci:v00001D0Fd0000EC21sv*sd*bc*sc*i* alias: pci:v00001D0Fd0000EC20sv*sd*bc*sc*i* alias: pci:v00001D0Fd00001EC2sv*sd*bc*sc*i* alias: pci:v00001D0Fd00000EC2sv*sd*bc*sc*i* depends: retpoline: Y intree: Y name: ena ...

在上述 Amazon Linux 情况中,ena 模块已安装。

ubuntu:~$ modinfo ena ERROR: modinfo: could not find module ena

在上述 Ubuntu 实例中,此模块未安装,因此您必须首先安装它。有关更多信息,请参阅 在 Ubuntu 上启用增强联网

实例属性 (enaSupport)

要检查实例是否设置了增强联网 enaSupport 属性,请使用以下任一命令。如果该属性已设置,则响应为 true。

  • describe-instances (AWS CLI)

    aws ec2 describe-instances --instance-ids instance_id --query "Reservations[].Instances[].EnaSupport"
  • Get-EC2InstanceWindows PowerShell 工具

    (Get-EC2Instance -InstanceId instance-id).Instances.EnaSupport

映像属性 (enaSupport)

要检查 AMI 是否设置了增强联网 enaSupport 属性,请使用以下任一命令。如果该属性已设置,则响应为 true。

  • describe-images (AWS CLI)

    aws ec2 describe-images --image-id ami_id --query "Images[].EnaSupport"
  • Get-EC2Image (Windows PowerShell 工具)

    (Get-EC2Image -ImageId ami_id).EnaSupport

网络接口驱动程序

使用以下命令验证 ena 模块是否在特定接口上使用 (替换为要检查的接口的名称)。如果您使用单个接口 (默认设置),则它是 eth0

[ec2-user ~]$ ethtool -i eth0 driver: vif version: firmware-version: bus-info: vif-0 supports-statistics: yes supports-test: no supports-eeprom-access: no supports-register-dump: no supports-priv-flags: no

在上例中,ena 模块未加载,因为列出的驱动程序是 vif

[ec2-user ~]$ ethtool -i eth0 driver: ena version: 1.5.0g firmware-version: expansion-rom-version: bus-info: 0000:00:05.0 supports-statistics: yes supports-test: no supports-eeprom-access: no supports-register-dump: no supports-priv-flags: no

在此例中,ena 模块进行加载并具有推荐的最低版本。此实例正确配置了增强联网。

在 Amazon Linux AMI 上启用增强联网

Amazon Linux 2 和最新版本的 Amazon Linux AMI 安装有增强联网所需的模块,并已设置所需的 enaSupport 属性。因此,如果使用 HVM 版本的 Amazon Linux 在支持的实例类型上启动实例,则已为您的实例启用增强联网。有关更多信息,请参阅 测试是否启用了增强联网功能

如果您使用较旧的 Amazon Linux AMI 启动了实例,并且实例尚未启用增强联网,请通过以下步骤启用增强联网。

在 Amazon Linux AMI 上启用增强联网

  1. 连接到您的实例。

  2. 从实例运行以下命令以使用最新内核和内核模块 (包括 ena) 更新实例:

    [ec2-user ~]$ sudo yum update
  3. 使用 Amazon EC2 控制台或以下任一命令从本地计算机重启实例:reboot-instances (AWS CLI)、Restart-EC2Instance (适用于 Windows PowerShell 的 AWS 工具)。

  4. 再次连接到您的实例,并使用测试是否启用了增强联网功能中的 modinfo ena 命令验证 ena 模块是否已安装并具有推荐的最低版本。

  5. [由 EBS 支持的实例] 使用 Amazon EC2 控制台或以下任一命令从您的本地计算机停止实例:stop-instances (AWS CLI)、Stop-EC2Instance (适用于 Windows PowerShell 的 AWS 工具)。如果您的实例由 AWS OpsWorks 管理,则应在 AWS OpsWorks 控制台中停止该实例,以便使实例状态保持同步。

    [实例存储支持的实例] 您无法停止实例来修改属性。请执行此过程:在 Amazon Linux AMI 上启用增强联网(实例存储支持的实例)

  6. 使用以下任一命令从本地计算机启用增强联网属性:

  7. (可选)从实例创建 AMI,如创建 Amazon EBS 支持的 Linux AMI中所述。该 AMI 从实例继承增强联网 enaSupport 属性。因此,您可以使用此 AMI 启动默认情况下启用了增强联网功能的其他实例。

  8. 使用 Amazon EC2 控制台或以下任一命令从您的本地计算机启动实例:start-instances (AWS CLI)、Start-EC2Instance (适用于 Windows PowerShell 的 AWS 工具)。如果您的实例由 AWS OpsWorks 管理,则应在 AWS OpsWorks 控制台中启动该实例,以便使实例状态保持同步。

  9. 连接到您的实例,并使用测试是否启用了增强联网功能中的 ethtool -i ethn 命令验证是否在网络接口上安装并加载了 ena 模块。

    如果您在启用增强联网之后无法连接到实例,请参阅对 Elastic Network Adapter (ENA) 进行故障排除

在 Amazon Linux AMI 上启用增强联网(实例存储支持的实例)

按照上述过程操作,直到您停止实例的步骤。按照创建由实例存储支持的 Linux AMI中所述创建新 AMI,确保在注册 AMI 时启用增强联网属性。

  • register-image (AWS CLI)

    aws ec2 register-image --ena-support ...
  • Register-EC2Image (适用于 Windows PowerShell 的 AWS 工具)

    Register-EC2Image -EnaSupport $true ...

在 Ubuntu 上启用增强联网

最新的 Ubuntu HVM AMI 安装有 ENA 增强联网所需的模块,并已设置所需的 enaSupport 属性。因此,如果使用最新的 Ubuntu HVM AMI 在支持的实例类型上启动实例,则已为您的实例启用增强联网。有关更多信息,请参阅测试是否启用了增强联网功能

如果您使用较旧的 AMI 启动了实例,并且实例尚未启用增强联网,则可以安装 linux-aws 内核程序包以获取最新的增强联网功能驱动程序并更新所需的属性。

安装 linux-aws 内核程序包(Ubuntu 16.04 或更高版本)

Ubuntu 16.04 和 18.04 随附 Ubuntu 自定义内核(linux-aws 内核程序包)。要使用不同的内核,请联系 AWS Support

安装 linux-aws 内核程序包 (Ubuntu Trusty 14.04)

  1. 连接到您的实例。

  2. 更新包缓存和包。

    ubuntu:~$ sudo apt-get update && sudo apt-get upgrade -y linux-aws

    重要

    如果在更新过程中系统提示您安装 grub,请使用 /dev/xvda 安装 grub,然后选择保留当前版本的 /boot/grub/menu.lst

  3. [由 EBS 支持的实例] 使用 Amazon EC2 控制台或以下任一命令从您的本地计算机停止实例:stop-instances (AWS CLI)、Stop-EC2Instance (适用于 Windows PowerShell 的 AWS 工具)。如果您的实例由 AWS OpsWorks 管理,则应在 AWS OpsWorks 控制台中停止该实例,以便使实例状态保持同步。

    [实例存储支持的实例] 您无法停止实例来修改属性。请执行此过程:在 Ubuntu 上启用增强联网(由实例存储支持的实例)

  4. 使用以下任一命令从本地计算机启用增强联网属性:

  5. (可选)从实例创建 AMI,如创建 Amazon EBS 支持的 Linux AMI中所述。该 AMI 从实例继承增强联网 enaSupport 属性。因此,您可以使用此 AMI 启动默认情况下启用了增强联网功能的其他实例。

  6. 使用 Amazon EC2 控制台或以下任一命令从您的本地计算机启动实例:start-instances (AWS CLI)、Start-EC2Instance (适用于 Windows PowerShell 的 AWS 工具)。如果您的实例由 AWS OpsWorks 管理,则应在 AWS OpsWorks 控制台中启动该实例,以便使实例状态保持同步。

在 Ubuntu 上启用增强联网(由实例存储支持的实例)

按照上述过程操作,直到您停止实例的步骤。按照创建由实例存储支持的 Linux AMI中所述创建新 AMI,确保在注册 AMI 时启用增强联网属性。

  • register-image (AWS CLI)

    aws ec2 register-image --ena-support ...
  • Register-EC2Image (适用于 Windows PowerShell 的 AWS 工具)

    Register-EC2Image -EnaSupport $true ...

在 Linux 上启用增强联网

下面的过程提供了在 Amazon Linux AMI 或 Ubuntu 之外的 Linux 发行版(如 SUSE Linux Enterprise Server (SLES)、Red Hat Enterprise Linux 或 CentOS)上启用增强联网的一般步骤。在开始之前,请参阅测试是否启用了增强联网功能以检查是否已对您的实例启用增强联网。有关更多信息 (如命令的详细语法、文件位置或包和工具支持),请参阅您的 Linux 分发版的特定文档。

对 Linux 启用增强联网

  1. 连接到您的实例。

  2. 从位于以下网址的 GitHub 克隆您实例上的 ena 模块的源代码:https://github.com/amzn/amzn-drivers。(SUSE SLES 12 SP2 及更高版本默认情况下包括 ENA 2.02,因此,您无需下载和编译 ENA 驱动程序。对于 SLES 12 SP2 及更高版本,您应提出请求以将希望的驱动程序版本添加到备用内核)。

    git clone https://github.com/amzn/amzn-drivers
  3. 在实例上编译并安装 ena 模块。

  4. 运行 sudo depmod 命令以更新模块依赖项。

  5. 在实例上更新 initramfs 以确保在启动时加载新模块。例如,如果您的分发版支持 dracut,则可使用以下命令:

    dracut -f -v
  6. 确定您的系统是否默认使用可预测的网络接口名称。使用 systemdudev 版本 197 或更高版本的系统可以重命名以太网设备,它们不保证单个网络接口将命名为 eth0。此行为可能导致连接到实例时出现问题。要获取更多信息并查看其他配置选项,请参阅 freedesktop.org 网站上的可预测的网络接口名称

    1. 您可以使用以下命令在基于 RPM 的系统上检查 systemdudev 版本:

      rpm -qa | grep -e '^systemd-[0-9]\+\|^udev-[0-9]\+' systemd-208-11.el7_0.2.x86_64

      在以上 Red Hat Enterprise Linux 7 示例中,systemd 版本是 208,因此必须禁用可预测的网络接口名称。

    2. 通过将 net.ifnames=0 选项添加到 GRUB_CMDLINE_LINUX 中的 /etc/default/grub 行,可禁用可预测的网络接口名称。

      sudo sed -i '/^GRUB\_CMDLINE\_LINUX/s/\"$/\ net\.ifnames\=0\"/' /etc/default/grub
    3. 重新构建 grub 配置文件。

      sudo grub2-mkconfig -o /boot/grub2/grub.cfg
  7. [由 EBS 支持的实例] 使用 Amazon EC2 控制台或以下任一命令从您的本地计算机停止实例:stop-instances (AWS CLI)、Stop-EC2Instance (适用于 Windows PowerShell 的 AWS 工具)。如果您的实例由 AWS OpsWorks 管理,则应在 AWS OpsWorks 控制台中停止该实例,以便使实例状态保持同步。

    [实例存储支持的实例] 您无法停止实例来修改属性。请执行此过程:在 Linux 上启用增强联网(–由实例存储支持的实例)

  8. 使用以下任一命令从本地计算机启用增强联网 enaSupport 属性:

  9. (可选) 从实例创建 AMI,如 创建 Amazon EBS 支持的 Linux AMI 中所述。该 AMI 从实例继承增强联网 enaSupport 属性。因此,您可以使用此 AMI 启动默认情况下启用了增强联网功能的其他实例。

    重要

    如果您的实例操作系统包含 /etc/udev/rules.d/70-persistent-net.rules 文件,则必须在创建 AMI 之前将其删除。此文件包含原始实例的以太网适配器 MAC 地址。如果其他实例使用此文件启动,操作系统将找不到设备,eth0 会失败,从而导致启动问题。此文件将在下次启动过程中重新生成,从 AMI 启动的任意实例都会创建这个文件的自有版本。

  10. 使用 Amazon EC2 控制台或以下任一命令从您的本地计算机启动实例:start-instances (AWS CLI)、Start-EC2Instance (适用于 Windows PowerShell 的 AWS 工具)。如果您的实例由 AWS OpsWorks 管理,则应在 AWS OpsWorks 控制台中启动该实例,以便使实例状态保持同步。

  11. (可选) 连接到实例并确认已安装模块。

    如果您在启用增强联网之后无法连接到实例,请参阅对 Elastic Network Adapter (ENA) 进行故障排除

在 Linux 上启用增强联网(–由实例存储支持的实例)

按照上述过程操作,直到您停止实例的步骤。按照创建由实例存储支持的 Linux AMI中所述创建新 AMI,确保在注册 AMI 时启用增强联网属性。

  • register-image (AWS CLI)

    aws ec2 register-image --ena-support ...
  • Register-EC2Image (适用于 Windows PowerShell 的 AWS 工具)

    Register-EC2Image -EnaSupport ...

利用 DKMS 在 Ubuntu 上启用增强联网

此方法仅用于测试和反馈目的。它不供生产部署使用。有关生产部署,请参阅在 Ubuntu 上启用增强联网

重要

使用 DKMS 可避免您的订阅的支持协议。使用 kmod 配置是运行最新可用的内核模块的可接受替代方案。

在 Ubuntu 上启用 ENA 增强联网 (EBS 支持的实例)

  1. 按照在 Ubuntu 上启用增强联网中的步骤 1 和 2 操作。

  2. 安装 build-essential 包以编译内核模块和 dkms 包,这样每次更新内核时都会重建 ena 模块。

    ubuntu:~$ sudo apt-get install -y build-essential dkms
  3. 从位于以下网址的 GitHub 克隆您实例上的 ena 模块的源代码:https://github.com/amzn/amzn-drivers

    ubuntu:~$ git clone https://github.com/amzn/amzn-drivers
  4. amzn-drivers 包移动到 /usr/src/ 目录,以便 dkms 可以在每次内核更新中找到并构建该模块。将源代码的版本号 (您可在发行说明中找到当前版本号) 附加到目录名称。例如,版本 1.0.0 显示在以下示例中。

    ubuntu:~$ sudo mv amzn-drivers /usr/src/amzn-drivers-1.0.0
  5. 使用以下值创建 dkms 配置文件(替换为您的 ena 版本)。

    创建文件。

    ubuntu:~$ sudo touch /usr/src/amzn-drivers-1.0.0/dkms.conf

    编辑文件并添加以下值。

    ubuntu:~$ sudo vim /usr/src/amzn-drivers-1.0.0/dkms.conf PACKAGE_NAME="ena" PACKAGE_VERSION="1.0.0" CLEAN="make -C kernel/linux/ena clean" MAKE="make -C kernel/linux/ena/ BUILD_KERNEL=${kernelver}" BUILT_MODULE_NAME[0]="ena" BUILT_MODULE_LOCATION="kernel/linux/ena" DEST_MODULE_LOCATION[0]="/updates" DEST_MODULE_NAME[0]="ena" AUTOINSTALL="yes"
  6. 使用 dkms 在实例上添加、构建和安装 ena 模块。

    将该模块添加到 dkms

    ubuntu:~$ sudo dkms add -m amzn-drivers -v 1.0.0

    使用 dkms 构建该模块。

    ubuntu:~$ sudo dkms build -m amzn-drivers -v 1.0.0

    使用 dkms 安装该模块。

    ubuntu:~$ sudo dkms install -m amzn-drivers -v 1.0.0
  7. 重新构建 initramfs,以便在启动时加载正确的模块。

    ubuntu:~$ sudo update-initramfs -u -k all
  8. 使用测试是否启用了增强联网功能中的 modinfo ena 命令验证是否安装了 ena 模块。

    ubuntu:~$ modinfo ena filename: /lib/modules/3.13.0-74-generic/updates/dkms/ena.ko version: 1.0.0 license: GPL description: Elastic Network Adapter (ENA) author: Amazon.com, Inc. or its affiliates srcversion: 9693C876C54CA64AE48F0CA alias: pci:v00001D0Fd0000EC21sv*sd*bc*sc*i* alias: pci:v00001D0Fd0000EC20sv*sd*bc*sc*i* alias: pci:v00001D0Fd00001EC2sv*sd*bc*sc*i* alias: pci:v00001D0Fd00000EC2sv*sd*bc*sc*i* depends: vermagic: 3.13.0-74-generic SMP mod_unload modversions parm: debug:Debug level (0=none,...,16=all) (int) parm: push_mode:Descriptor / header push mode (0=automatic,1=disable,3=enable) 0 - Automatically choose according to device capability (default) 1 - Don't push anything to device memory 3 - Push descriptors and header buffer to device memory (int) parm: enable_wd:Enable keepalive watchdog (0=disable,1=enable,default=1) (int) parm: enable_missing_tx_detection:Enable missing Tx completions. (default=1) (int) parm: numa_node_override_array:Numa node override map (array of int) parm: numa_node_override:Enable/Disable numa node override (0=disable) (int)
  9. 继续执行在 Ubuntu 上启用增强联网中的步骤 3。

故障排除

有关对 ENA 适配器进行故障排除的其他信息,请参阅对 Elastic Network Adapter (ENA) 进行故障排除