Azure上Debian 11使用cloud-init安装软件包失败如何解决？

故障原因 #

日志中apt-get update返回退出码100，属于apt工具通用错误码，代表无法完成软件源更新操作，结合Azure+Debian 11的场景，常见诱因如下：

• 网络限制：虚拟机所属网络安全组(NSG)未放开80/443端口出站规则，或虚拟网络配置的防火墙、代理拦截了apt对软件源的访问请求。
• 软件源失效：2021年5月Debian 11（bullseye）仍处于测试阶段，Azure默认镜像内置的官方源路径不稳定、或配置错误，导致apt无法拉取软件索引。
• apt锁冲突：虚拟机启动时系统自带的后台更新任务抢占了apt进程锁，导致cloud-init调用的apt命令无法正常执行。
• 版本兼容问题：当前使用的cloud-init v20.4.1与Debian 11的适配存在缺陷，调用apt的逻辑存在兼容性问题。

修复步骤 #

第一步：定位根因 #

先手动登录虚拟机，执行sudo apt-get update，根据返回的具体报错定位问题：

• 若返回网络连接超时：优先检查NSG出站规则、虚拟网络的防火墙/代理配置，确保apt可以正常访问软件源地址。
• 若返回源地址404/不存在：说明软件源配置失效，需更换为稳定可用的Debian bullseye源。
• 若返回/var/lib/dpkg/lock-frontend相关锁错误：说明是apt进程锁冲突导致的问题。

第二步：调整cloud-init配置 #

针对上述常见问题，优化后的cloud-init配置如下，可直接替换原有配置使用：

#cloud-config
# 启动延迟+清理apt锁，避免和系统后台更新任务冲突
bootcmd:
  - sleep 30
  - rm -rf /var/lib/dpkg/lock*
  - dpkg --configure -a

# 配置稳定的Debian bullseye软件源
apt:
  primary:
    - arches: [default]
      uri: http://mirrors.tuna.tsinghua.edu.cn/debian/
  security:
    - arches: [default]
      uri: http://mirrors.tuna.tsinghua.edu.cn/debian-security/
  suites: [bullseye, bullseye-updates, bullseye-backports]
  sources_list: |
    deb $PRIMARY bullseye main contrib non-free
    deb $PRIMARY bullseye-updates main contrib non-free
    deb $SECURITY bullseye-security main contrib non-free

package_update: true
package_upgrade: true
package_reboot_if_required: true
packages:
  - symlinks
  - wget
  - rsync
  - git

# 配置apt命令参数，降低安装失败概率
apt_get_command: ["apt-get", "-o", "Dpkg::Options::=--force-confold", "-o", "Dpkg::Options::=--force-confdef", "-y", "--allow-downgrades", "--allow-remove-essential", "--allow-change-held-packages"]

可选优化 #

如果是cloud-init版本兼容问题，可以更换Azure市场中更高版本的Debian 11镜像，或在bootcmd中增加提前升级cloud-init的逻辑。

内容的提问来源于stack exchange，提问作者xpt