Ubuntu22.04实例启动后apt缓存无docker.io包的解决方法

问题场景 #

启动Ubuntu22.04云实例后，通过程序自动调用Ansible Playbook安装docker.io时，会触发报错：

No package matching 'docker.io' is available

但手动远程执行同一个Playbook却能成功。测试发现：实例刚启动时执行apt-cache search docker.io无任何结果，过一段时间后该包才会自动出现在apt缓存中。

已尝试过这些操作但未彻底解决：

• 关闭系统自动更新
• 等待dpkg锁释放
• 用Ansible ping模块验证连通性
  添加20秒固定延迟后问题暂时消失，但固定延迟不够可靠，需要精准的等待逻辑替代。

根本原因 #

云实例启动后，系统默认的apt源同步/初始化操作是后台异步执行的，此时apt本地缓存还没拉取到docker.io的包信息，导致Ansible的apt模块找不到对应包。固定延迟能蒙混过关，但遇到网络波动或系统负载高的情况依然会失败，必须等待apt源同步完成的明确信号。

解决方案 #

方案1：强制等待apt源缓存更新完成 #

在安装任务前添加apt update的重试任务，确保缓存同步完成：

- name: 强制更新apt源缓存，确保包信息同步
  apt:
    update_cache: yes
    cache_valid_time: 3600
  register: apt_update_status
  until: apt_update_status is succeeded
  retries: 10
  delay: 5

这个任务会每隔5秒重试一次apt update，最多重试10次，直到成功完成，确保apt缓存已经包含最新的包列表。

方案2：精准等待docker.io包出现在缓存中 #

直接检查apt缓存中是否存在目标包，直到检测到再执行安装：

- name: 等待docker.io包出现在apt缓存中
  shell: apt-cache search docker.io | grep -q "^docker.io"
  register: docker_package_check
  until: docker_package_check is succeeded
  retries: 10
  delay: 3
  changed_when: false

用grep -q静默检查缓存中是否有docker.io包，每次间隔3秒，最多重试10次，确保包可用后再执行安装。

方案3：禁用后台自动apt同步进程（按需选择） #

部分云厂商的Ubuntu镜像会在启动后自动跑apt同步，可直接禁用相关服务避免冲突：

- name: 停止并禁用apt自动同步相关服务
  systemd:
    name: "{{ item }}"
    state: stopped
    enabled: no
  loop:
    - apt-daily.service
    - apt-daily.timer
    - apt-daily-upgrade.service
    - apt-daily-upgrade.timer

⚠️ 注意：禁用这些服务会关闭系统自动更新，需根据业务需求权衡是否使用。

验证示例 #

把等待任务加到安装docker.io的前面，完整Playbook片段如下：

- hosts: ubuntu_cloud_instances
  become: yes
  tasks:
    - name: 强制更新apt源缓存
      apt:
        update_cache: yes
        cache_valid_time: 3600
      register: apt_update_status
      until: apt_update_status is succeeded
      retries: 10
      delay: 5

    - name: 安装docker.io
      apt:
        name: docker.io
        state: present

这样就能彻底避免时序问题，无需依赖固定延迟。

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