CloudStack中Rocky Linux和Ubuntu模板的cloud-init密码重置问题解析

问题背景

在CloudStack 4.19.1.1环境中，使用Rocky Linux 9.4和Ubuntu 24.04创建带有cloud-init支持的虚拟机模板时，发现密码重置功能存在异常。具体表现为：首次启动时随机密码生成正常，但后续通过UI"重置密码"功能后，新密码无法在实例重启后生效。

问题分析

经过深入排查，发现这是由cloud-init的工作机制导致的。cloud-init默认会在首次启动时获取元数据并应用配置，但后续启动会使用缓存数据而非重新获取。在Rocky Linux 9.4和Ubuntu 24.04中，这个问题尤为明显。

解决方案

1. 基础配置方法

对于Rocky Linux/AlmaLinux系列，通过以下配置可解决问题：

1. 确保安装必要组件：

   dnf install -y cloud-init cloud-utils-growpart
   

2. 配置cloud-init数据源：

   # /etc/cloud/cloud.cfg.d/99_cloudstack.cfg
   datasource_list: [ ConfigDrive, CloudStack, None ]
   datasource:
     CloudStack: {}
     None: {}
   

3. 强制密码模块每次启动运行：

   sed -i 's/ - set_passwords/ - [set_passwords, always]/' /etc/cloud/cloud.cfg
   

4. 允许root密码登录：

   # /etc/cloud/cloud.cfg.d/80_user.cfg
   system_info:
     default_user:
       name: root
       lock_passwd: false
   disable_root: false
   ssh_pwauth: true
   

2. Ubuntu系统的特殊处理

对于Ubuntu系统，特别是22.04及24.04版本，需要额外创建一个systemd服务来确保密码重置：

1. 创建服务脚本/etc/init.d/reset-cloud-password：

   #!/bin/bash
   ### BEGIN INIT INFO
   # Provides:          password
   # Required-Start:    $all
   # Required-Stop:
   # Default-Start:     2 3 4 5
   # Default-Stop:
   # Short-Description: Reset cloud-init password
   ### END INIT INFO
   
   cloud-init clean
   cloud-init init --local
   cloud-init init
   cloud-init modules --mode config
   cloud-init modules --mode final
   

2. 设置权限并启用服务：

   chmod +x /etc/init.d/reset-cloud-password
   systemctl enable reset-cloud-password
   

3. 分区扩展配置

为确保存储扩展功能正常工作，还需配置以下内容：

# /etc/cloud/cloud.cfg.d/50_growpartion.cfg
growpart:
  mode: auto
  devices: ['/dev/vda2']
  ignore_growroot_disabled: false

# /etc/cloud/cloud.cfg.d/51_extend_volume.cfg
runcmd:
  - [ cloud-init-per, always, grow_VG, pvresize, /dev/vda2 ]
  - [ cloud-init-per, always, grow_LV, lvresize, -l, '+100%FREE', /dev/rocky/root ]
  - [ cloud-init-per, always, grow_FS, xfs_growfs, /dev/rocky/root ]

最佳实践建议

1. 模板制作完成后，务必执行cloud-init clean --machine-id清理缓存
2. 对于Ubuntu系统，推荐使用官方云镜像而非标准ISO
3. 定期检查cloud-init版本，确保使用最新稳定版
4. 在模板制作过程中，验证密码重置功能是否正常工作

技术原理

cloud-init的设计初衷是在实例首次启动时完成初始化配置。默认情况下，它会将获取的元数据缓存起来，后续启动不再重新获取。这种行为在大多数云平台上是合理的，但在需要动态重置密码的场景下就会产生问题。

通过配置[set_passwords, always]可以强制密码模块每次启动都运行，但某些情况下仍需要配合cloud-init clean命令清除缓存才能真正生效。这也是为什么在Ubuntu系统中需要额外创建服务来确保密码重置的原因。

总结

CloudStack与cloud-init的集成在大多数情况下工作良好，但在特定Linux发行版和新版本中可能需要额外配置。通过本文提供的解决方案，管理员可以确保密码重置功能在各种情况下都能正常工作，同时保持其他cloud-init功能如存储扩展的完整性。