Ubuntu自动安装未生效source.id配置及文档说明疑问

你提到官方文档里关于source.id的描述：

source
[search_drivers stuff omitted]
id
type: string
default: identifier of the first available source.
Identifier of the source to install (e.g., "ubuntu-server-minimized").

但按照这个配置source.id: "ubuntu-server-minimized"在cloud-config user-data里却报错，试了各种引号格式都没用，崩溃日志还显示"kind": "UNKNOWN"——我碰到过不少用户踩这个坑，下面帮你拆解问题和对文档的疑问：

一、先搞懂“Identifier of the source to install”到底指什么 #

官方文档这里的描述确实太模糊，很容易误导人。这个“标识符”不是你以为的公开镜像名称（比如ubuntu-server-minimized），而是安装介质内部预定义的源标识符——简单说，就是Ubuntu安装镜像里自带的、供安装程序识别不同安装源的内部ID。这些ID和你用的具体安装镜像绑定，不同镜像（比如标准Server镜像、Minimized镜像、Live Server镜像）支持的ID可能完全不一样。

二、为什么你的配置会报错？ #

崩溃日志里的UNKNOWN说明安装程序根本识别不了你写的ubuntu-server-minimized这个ID，核心原因大概率是下面其中一个：

• 你的安装镜像里没有这个源：如果你用的是标准Ubuntu Server镜像，它可能没预载minimized版本的安装源，自然识别不了对应的ID；
• ID格式或配置结构不对：虽然你试了各种引号，但有时候需要完整的source配置块（比如配合search_drivers参数），比如：

  source:
    id: "正确的源ID"
    search_drivers: false
  

这里给你两个排查方向：

1. 查看当前镜像支持的ID：挂载你的安装镜像，查看dists/<你的发行版版本号>/目录下的结构，或者查看安装日志（/var/log/installer/autoinstall.log）——日志里通常会列出安装程序能识别的所有可用source ID，你选一个匹配的就行；
2. 用对应版本的专属镜像：如果要安装minimized版本，直接用Ubuntu Server Minimized的专属安装镜像，而不是标准Server镜像，专属镜像里才会有对应的源ID。

三、对文档更新的建议 #

官方文档这里确实需要补充关键细节，才能帮用户避开这类坑：

• 明确说明source.id是安装介质内部的预定义标识符，而非公开的镜像名称；
• 告诉用户如何查看当前镜像支持的所有source ID；
• 给出和常用镜像匹配的实际可用ID例子（比如标准Server镜像的ID可能是main，Minimized镜像的ID可能是server-minimized等）。

备注：内容来源于stack exchange，提问作者Spacerat