检测镜像是否符合规范并自动修复镜像_云服务器 ECS(ECS)-阿里云帮助中心

将自定义镜像导入阿里云平台前，建议您使用镜像检测工具sersi检测镜像是否符合导入条件，并针对异常镜像进行修复，确保自定义镜像的质量，以便在阿里云平台上顺利部署功能齐全、兼容性良好的ECS实例。本文为您介绍如何使用sersi工具检测并修复镜像。

sersi工具介绍

sersi工具是阿里云平台推出的镜像检测修复工具。sersi工具在检测并修复镜像过程中，自动完成以下任务：

扫描镜像中的系统及服务配置并输出检测报告，检测报告中会详细描述镜像系统信息以及检测出的异常信息。
结合异常信息自动生成相应的修复脚本，执行修复命令修复镜像。

使用限制

不支持FreeBSD、Fedora CoreOS以及Windows Server系统。

操作步骤

步骤1：检测镜像

使用root用户登录制作镜像的虚拟机。
依次运行以下命令，下载并解压sersi工具。
```
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/imagecheck/sersi.tar.gz
tar -xf sersi.tar.gz
```
如果您的虚拟机可以访问公网，您也可以通过浏览器下载sersi工具。

执行以下命令，运行检测工具。

./main.sh  --target=image  --diagnostic

检测工具主要检查以下配置项：

检测项说明

检测项	等级	检测项说明	不合规影响
Virtio	高	检测镜像中是否安装virtio驱动。阿里云ECS通常为基于KVM的虚拟机，因此依赖镜像中安装虚拟磁盘的virtio驱动。	ECS启动异常。
Nvme	高	检测镜像中是否安装NVMe驱动。 ECS部分规格使用NVMe协议云盘，例如ecs.g7se，要求镜像包含NVMe驱动。NVMe相比SCSI、virtio-blk等传统驱动协议速度更快、传输带宽更高，因此建议您在镜像中安装NVMe驱动，以支持相关实例规格。更多信息，请参见NVMe协议概述。	无法使用NVMe协议云盘的实例规格，例如ecs.g7se。
Fstab	高	检测/etc/fstab配置是否正常。错误的配置会导致系统启动异常，例如配置的挂载设备信息不存在、设备UUID错误等。	系统启动异常。
Grub	高	检测grub配置文件是否正常。 grub引导内核的加载和启动，是系统的重要配置。错误的配置将导致系统启动异常，建议您检查系统中的配置文件是否正确，例如grub文件中不要使用设备名来指定启动分区，如root=/dev/sda1，在不同的环境中设备名称可能发生变化，建议您使用UUID来指定启动分区。	系统启动异常。
Dhcp	高	检测网络配置是否为DHCP。建议您为网络设备配置DHCP的方式，static静态方式会导致网络配置失败，连接异常。我们还建议您在grub内核启动参数中增加配置选项`net.ifnames=0`来禁用内核网络接口重命名行为，使网卡名称为eth0。	系统网络异常。
Selinux	中	检测是否禁用SELinux，阿里云建议您关闭SELinux。	无法正常启动ECS实例。
OnlineResizeFS	高	检测镜像是否支持在线扩容文件系统。例如您的镜像虚拟磁盘空间大小为10 GB，您购买ECS实例的系统盘为100 GB，如果您安装了cloud-init、growpart等组件，相关组件在实例初始化时会将根分区及文件系统扩容，扩容至您系统盘的大小100 GB。更多信息，请参见扩容分区和文件系统（Linux）。	实例根分区无法扩容。
CloudInit	高	检测是否安装cloud-init服务。 cloud-init能在ECS实例启动阶段完成系统初始化配置，包括NTP、软件源、主机名和SSH密钥对等，同时执行实例自定义数据（User data）脚本。	系统初始化配置缺失。
DiskUsage	高	检测磁盘空间使用率是否正常。您可以执行`df -h`命令来检查您磁盘空间的使用率，确保有充足空间。	系统启动异常。
InodeUsage	高	检测磁盘inode使用率是否正常。您可以执行`df -i`命令来检查磁盘inode的使用率。	系统启动异常。
SystemFileAttribute	高	检测系统中关键配置文件的文件属性是否正常。	实例启动异常、功能异常。
CriticalUser	高	检测系统中关键用户（例如root）是否存在。关键用户的缺失会导致系统启动异常，实例功能使用异常，例如无法使用用户名和密码远程连接ECS实例。	实例启动异常、功能异常。
QemuGuestAgent	中	检测系统中是否安装qemu-guest-agent。该软件是运行在虚拟机上，和宿主机交互通信，会导致ECS所需要的部分服务不可用，实例功能不全。	实例功能异常。
SshConfig	高	检测sshd服务的配置文件（通常是/etc/ssh/sshd_config）是否正常。 sshd配置文件异常会导致sshd服务启动失败，进而导致SSH连接ECS失败，因此检查sshd配置文件的正确性和有效性非常重要。通常您可以执行以下命令：执行`sudo sshd -T`命令展示您所有的sshd配置选项。执行`sudo sshd -t` 命令验证sshd配置文件的合法性；若合法，则没有信息输出。	实例SSH连接失败。
Firewall	中	检测防火墙服务是否开启。阿里云建议您关闭系统中的防火墙服务，使用ECS安全组统一管理您云上实例的出入流量。更多信息，请参见安全组概述。	系统防火墙应用可能导致您访问实例失败。
LibDirectory	高	在RedHat系列Linux系统中，/lib和/lib64通常为一个链接文件，指向/usr/lib及/usr/lib64，请不要随意修改该链接文件，否则可能导致系统异常。	系统功能异常。
SupportMocInstanceTypes	高	检测镜像是否支持阿里云ECS神龙规格。阿里云最新的ECS实例通常为神龙规格，例如ecs.g6、ecs.g7等，如果镜像的系统和内核版本过低，在相关规格上启动会有异常。具体的实例规格信息，请参见实例规格族。	不能使用ecs.g6、ecs.g7等神龙规格族。
CloudAssistant	中	检测镜像是否安装云助手。云助手是专为云服务器ECS打造的原生自动化运维工具，阿里云建议您为镜像安装云助手服务，实现云上ECS高效运维。更多信息，请参见云助手概述。	云上运维不便。
SecurityCenterAgent	中	检测是否安装云安全中心Agent。安装云安全中心的Agent插件后，您的服务器才能受到云安全中心的保护。	无法识别实例中的漏洞问题，缺少云安全中心的保护。

等待检测工具检测完成，检测结果类似如下信息。

检测结果示例

------------------------------------------------------------

            OS: Alibaba Cloud Linux 3   Kernel: 5.10.134-16.3.al8.x86_64 
            Arch: x86_64       RTC-Mode: utc       Boot-Mode: UEFI
        
------------------------------------------------------------
Image Check Result
Virtio                                                                                 [OK]
Nvme                                                                                   [OK]
Fstab                                                                                  [OK]
Grub                                                                                   [OK]
Dhcp                                                                                   [OK]
Selinux                                                                                [OK]
OnlineResizeFS                                                                         [OK]
CloudAssistant                                                                         [OK]
CloudInit                                                                              [OK]
SecurityCenterAgent                                                                    [OK]
SupportMocInstanceTypes                                                                [OK]
DiskUsage                                                                              [OK]
InodeUsage                                                                             [OK]
SystemFileAttribute                                                                    [OK]
CriticalUser                                                                           [OK]
QemuGuestAgent                                                                         [OK]
SshConfig                                                                              [OK]
Firewall                                                                               [OK]

         Total case Count                18
            Successes:                   18
            Failures:                    0
            Warnings:                    0
        
------------------------------------------------------------

检测工具会根据检测项的等级给出OK、FAILED或WARNING检测结果。

OK：检测项均符合要求。
FAILED：检测项不符合要求，使用该自定义镜像创建的ECS实例会出现无法正常启动、网络异常等严重问题，建议您参考步骤2：修复镜像，修复报错项后再导入镜像。
WARNING：检测项不符合要求，使用该自定义镜像创建的ECS实例缺少云安全中心保护、无法使用云助手自动化运维等问题，建议您参考步骤2：修复镜像，修复报错项后再导入镜像，以提高您云上的运维效率。

步骤2：修复镜像

执行以下命令，自动修复镜像。

./main.sh --target=image --run <case> [--debug] [--dry-run] [-y]

上述命令涉及的参数说明如下表所示，请您根据实际情况进行配置：

参数	是否必选	说明
`run <case>`	是	表示运行需要修复的检测项目。当前支持的检测项有`cloudinit`、`virtio`、`nvme`、`fstab`、`grub`、`dhcp`、`selinux`、`growpart`、`aegis`、`assist`、`firewall`、`sshd`、`fileattribute`、`qemuguestagent`。全部检测并修复：`./main.sh --target=image --run all`。只针对某一项进行检测并修复，例如检测镜像是否安装cloud-init：`./main.sh --target=image --run cloudinit`。同时针对多项检测，各检测项之间需要空格分隔，例如：`./main.sh --target=image --run cloudinit virtio assist`。
`[--debug]`	否	添加该参数表示增加debug日志打印。
`[--dry-run]`	否	添加该参数表示只打印修复脚本，不执行修复脚本。不添加该参数表示直接执行修复脚本。
`[-y]`	否	添加该参数表示执行修复脚本时不进行交互确认。不添加该参数表示执行修复脚本时进行交互确认，需要输入`y`确认执行。

重要

sersi工具修复镜像时执行的脚本无法回滚，对系统的修改无法撤销，因此强烈建议您：

先添加[--dry-run]参数，仅查看修复脚本，不执行修复脚本，sersi工具会将修复脚本保存至cache目录中，您可以查看或调试。确保无误后，无需添加[--dry-run]参数即可执行修复脚本，进行修复操作。
先不要添加-y参数，表示进行交互确认后再执行修复脚本，避免修复脚本导致的意外更改或数据丢失。

修复命令示例

说明

对于不支持通过sersi工具自动修复的检测项，您也可以手动进行修复。

检测项	工具自动修复	工具修复命令	手动修复方法
Virtio	工具在dracut配置文件中增加virtio驱动配置，重新生成带有virtio驱动的initrd文件。	`./main.sh --target=image --run virtio --debug --dry-run`	安装virtio驱动
Nvme	工具在dracut配置文件中增加NVMe驱动配置，重新生成带有NVMe驱动的initrd文件。同时会在grub配置中增加`nvme`或`nvme_core`内核模块的timeout参数，提高NVMe I/O处理的可靠性。重要修复完成后，需要您手动重启系统才能生效。	`./main.sh --target=image --run nvme --debug`	如何为已有自定义镜像安装NVMe驱动？
Fstab	工具会注释/etc/fstab异常的挂载项。	`./main.sh --target=image --run fstab --debug`	如何正确配置/etc/fstab，请参见在fstab文件中配置UUID方式自动挂载数据盘。
Grub	工具会修改grub中`rootdevice`为正确值。	`./main.sh --target=image --run grub --debug`	如何为镜像生成正确的配置grub文件，请参见Linux实例的grub启动配置错误。
Dhcp	工具会配置网络服务配置文件，配置文件中网卡设备命名是eth0，设置`dhcp=true`等。同时在grub中添加内核启动参数 `biosdevname=0 net.ifnames=0`，确保网卡设备命名为eth0。重要修复完成后，需要您手动重启系统才能生效。	`./main.sh --target=image --run dhcp --debug`	如何设置镜像网络配置模式为DHCP，请参见如何在Linux镜像中配置网络为DHCP。
Selinux	工具会修改配置文件`/etc/selinux/config`模式为 `disabled`，同时在grub中添加内核启动参数 `selinux=0`关闭selinux。重要修复完成后，需要您手动重启系统才能生效。	`./main.sh --target=image --run selinux --debug`	如何关闭SELinux，请参见开启或关闭SELinux。
OnlineResizeFS	工具会在系统中配置growpart脚本，实例支持根分区扩容。	`./main.sh --target=image --run growpart --debug`	安装cloud-init 安装growpart工具。工具安装方法请参见安装cloud-init文档中在创建实例时对系统盘进行扩容，但在实例内部发现根分区大小并没有自动扩容，如何处理？问题的操作。
CloudInit	工具会为系统临时配置软件仓库源，通过系统中的包管理器安装cloud-init软件包，并设置cloud-init配置文件，设置数据源为阿里云。	`./main.sh --target=image --run cloudinit --debug`	安装cloud-init
DiskUsage	不支持，只能通过手动修复。	不涉及	手动删除不必要文件。
InodeUsage	不支持，只能通过手动修复。	不涉及	手动删除不必要文件。
SystemFileAttribute	支持。工具会删除检测出来的异常文件的属性。	`./main.sh --target=image --run fileattribute --debug`	不要使用`chattr`命令锁定/etc/shadow等文件。
CriticalUser	不支持，只能通过手动修复。	不涉及	保留root账号。
QemuGuestAgent	支持。工具会卸载qemu-guestos-agent。	`./main.sh --target=image --run qemuguestagent --debug`	卸载qemu-guestos-agent。
SshConfig	支持。工具会开启sshd中的密码认证和root用户登录。	`./main.sh --target=image --run sshd --debug`	检查sshd配置文件。
Firewall	支持。工具会关闭防火墙服务。	`./main.sh --target=image --run firewalld --debug`	关闭系统防火墙服务。
LibDirectory	不支持，只能通过手动修复。	不涉及	链接文件/lib和/lib64的指向位置不能为绝对路径，修改指向位置为相对路径。
SupportMocInstanceTypes	不支持，只能通过手动修复。	不涉及	不支持神龙规格的系统通常是已经EOL不再维护的低版本系统，阿里云建议您尽早更新升级，使用各发行厂商正在维护更新的操作系统版本。
CloudAssistant	支持。工具会安装云助手。	`./main.sh --target=image --run assist --debug`	安装云助手Agent
SecurityCenterAgent	支持。工具会安装阿里云云安全中心客户端。	`./main.sh --target=image --run aegis --debug`	安装Agent

修复结果示例

2024-07-19 17:20:54,480 root [INFO]: sersi run finished, print summary report
2024-07-19 17:20:54,480 root [INFO]: casename: cloudinit                            NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: virtio                               OK
2024-07-19 17:20:54,480 root [INFO]: casename: nvme                                 OK_Need_Reboot
2024-07-19 17:20:54,480 root [INFO]: casename: fstab                                NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: grub                                 NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: dhcp                                 NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: selinux                              NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: growpart                             NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: aegis                                NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: assist                               DRY_RUN
2024-07-19 17:20:54,480 root [INFO]: casename: firewall                             NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: sshd                                 NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: systemfileattribute                  NO_FOUND_RISK
2024-07-19 17:20:54,480 root [INFO]: casename: qemu_guest_agent                     FAILED

修复结束后，工具会根据修复情况生成以下修复结果：

OK：表示该项修复成功。
NO_FOUND_RISK：表示检测镜像中未找到该项的异常。
OK_Need_Reboot：表示该项修复完成需重启系统才能生效。
DRY_RUN：表示找到该项的异常并通过dry-run模式运行仅打印修复脚本，但未执行修复。
FAILED：表示该项修复失败。

使用镜像检测工具检测并修复镜像

sersi工具介绍

使用限制

操作步骤

步骤1：检测镜像

步骤2：修复镜像

相关文档