Ubuntu安装isulad时依赖包缺失如何解决？

Question

在Ubuntu系统中安装iSulad时，常因依赖包缺失导致安装失败，典型表现为“缺少libisulad-common或tini等组件”。这是由于Ubuntu默认源中未包含iSulad所需的所有依赖，且官方仓库可能未及时同步最新版本。用户直接使用apt install isulad时常提示无法定位软件包或依赖关系断裂。如何正确配置华为开源镜像源并手动补全依赖包，成为顺利安装的关键问题。

Answer 1

1. 问题背景与常见现象分析

在Ubuntu系统中安装iSulad时，用户常遇到“无法定位软件包”或“依赖关系断裂”的报错信息，例如提示缺少libisulad-common、tini等关键组件。这类问题的根本原因在于：Ubuntu官方APT源并未收录iSulad及其相关依赖包，而默认配置下系统仅从官方源拉取元数据。

此外，iSulad作为华为主导的轻量级容器运行时，其发布渠道主要依托于华为开源镜像站（Huawei Open Source Mirror），若未正确配置该镜像源，则apt update无法发现对应软件包索引，导致安装流程中断。

典型错误输出示例如下：

E: Unable to locate package isulad
E: Package 'libisulad-common' has no installation candidate

2. 根本原因剖析：依赖缺失与源同步延迟

• 源缺失：Ubuntu默认/etc/apt/sources.list中不包含iSulad所属的OpenEuler或iSulad专用仓库。
• 版本滞后：部分第三方镜像站点未及时同步最新版iSulad deb包及依赖树。
• 依赖闭环断裂：即使手动下载主包，也常因缺少libisulad-common、isulad-daemon、tini等子模块而无法完成安装。
• GPG密钥未导入：APT对非官方源存在安全校验机制，未添加签名密钥会导致“NO_PUBKEY”错误。

这些因素共同构成了一套典型的“Linux发行版兼容性陷阱”，尤其在跨生态（如OpenEuler → Ubuntu）部署时尤为突出。

3. 解决方案设计路径图

1. 确认系统架构与Ubuntu版本兼容性
2. 备份原始APT源列表
3. 添加华为开源镜像源条目
4. 导入GPG公钥以验证包完整性
5. 更新APT缓存并搜索可用包
6. 优先安装核心依赖项
7. 执行主程序安装
8. 验证服务状态与CLI可用性

graph TD
    A[开始] --> B{Ubuntu版本确认}
    B --> C[备份sources.list]
    C --> D[添加华为镜像源]
    D --> E[导入GPG密钥]
    E --> F[apt update]
    F --> G[检查libisulad-common是否存在]
    G --> H{存在?}
    H -->|是| I[安装tini和libisulad-common]
    H -->|否| J[手动下载deb包]
    I --> K[安装isulad主包]
    J --> K
    K --> L[启动isulad服务]
    L --> M[结束]

4. 实施步骤详解

步骤	命令/操作	说明
1. 查看系统版本	lsb_release -cs	获取Codename（如focal、jammy）用于构建源地址
2. 备份源文件	sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak	防止误操作导致APT不可用
3. 添加华为镜像源	echo "deb https://mirrors.huaweicloud.com/repository/debian isulad main" | sudo tee /etc/apt/sources.list.d/isulad.list	指向华为维护的Debian/iSulad仓库
4. 导入GPG密钥	wget -qO - https://mirrors.huaweicloud.com/repository/debian/key.gpg | sudo apt-key add -	确保包签名可验证
5. 更新APT索引	sudo apt update	拉取新源中的包元数据
6. 安装依赖包	sudo apt install -y libisulad-common tini	提前补全运行时依赖
7. 安装主程序	sudo apt install -y isulad	此时应无依赖冲突
8. 启动服务	sudo systemctl enable isulad --now	启用并立即启动守护进程
9. 验证安装	isula --version	确认CLI工具链正常
10. 检查服务状态	systemctl status isulad	观察是否处于active (running)

5. 常见异常处理与补救措施

若上述流程仍失败，可采取以下应急策略：

# 手动下载缺失的deb包（以libisulad-common为例）
wget https://mirrors.huaweicloud.com/repository/debian/pool/main/i/isulad/libisulad-common_1.0.0-1_amd64.deb
sudo dpkg -i libisulad-common_1.0.0-1_amd64.deb

# 修复可能的依赖断裂
sudo apt --fix-broken install

# 强制重新配置已安装包
sudo dpkg --configure -a

此外，建议定期清理旧源：

# 删除无效源条目
sudo rm /etc/apt/sources.list.d/isulad.list
# 或注释掉不用的行后再update