openeuler/ccb本地构建教程：local-build与local-rebuild命令实战

openeuler/ccb本地构建教程：local-build与local-rebuild命令实战

【免费下载链接】ccbThis repository serves as a client-side tool for EulerMaker, allowing users to perform command-line operations on EulerMaker from within their own environment.项目地址: https://gitcode.com/openeuler/ccb

前往项目官网免费下载：https://ar.openeuler.org/ar/

openEuler / ccb是一款EulerMaker客户端工具，帮助用户在本地环境中通过命令行操作EulerMaker平台。本文将详细介绍如何使用local-build与local-rebuild命令进行本地构建，让你轻松掌握开源项目的构建技巧！🚀

一、准备工作：安装与配置ccb工具

1.1 克隆项目仓库

首先，需要将openeuler/ccb项目克隆到本地环境：

git clone https://gitcode.com/openeuler/ccb

1.2 配置环境变量

进入项目目录后，通过以下命令加载环境配置：

source lib/env.sh

该脚本位于lib/env.sh，用于设置项目所需的环境变量和依赖路径。

二、local-rebuild命令详解：从Job ID到本地构建

2.1 命令基本用法

local-rebuild命令（可缩写为lr）通过Job ID在本地重建项目，基本语法如下：

ccb local-rebuild job_id=你的任务ID [选项] # 或使用缩写 ccb lr job_id=你的任务ID [选项]

示例：

ccb lr job_id=cbs.001 --showdocker

2.2 核心参数解析

• job_id：必填参数，指定EulerMaker平台上的任务ID，如cbs.001
• --showdocker：可选参数，显示Docker容器信息，便于调试构建过程

2.3 执行流程解析

local-rebuild命令的执行流程主要包含以下步骤（对应local-rebuild源码）：

1. 搜索任务信息：通过Job ID从EulerMaker平台获取构建配置（第85-99行）
2. 解析仓库地址：处理构建所需的软件仓库地址（第101-126行）
3. 生成配置文件：将构建参数写入临时配置文件（第170-177行）
4. 下载Docker镜像：拉取匹配架构的openEuler基础镜像（第179-194行）
5. 启动容器构建：在Docker容器中执行构建脚本（第196-223行）
6. 保存构建产物：将RPM包或热补丁文件复制到本地目录（第225-243行）

三、local-build命令实战：手动配置构建参数

3.1 命令功能概述

local-build命令允许用户手动指定构建参数，无需依赖EulerMaker平台的Job ID。该命令的实现逻辑可参考lib/local-rpmbuild脚本，主要用于RPM包的本地构建。

3.2 常用参数组合

# 基础构建命令 ccb local-build package=nginx os_variant=openEuler:22.03 arch=x86_64 # 带自定义宏定义的构建 ccb local-build package=kernel macros="%debug_package 0" skip_check=true

3.3 关键配置项说明

四、构建常见问题解决

4.1 架构不匹配错误

错误信息：

[ERROR] Local env architecture is x86_64, job id architecture is aarch64

解决方法：确保本地环境架构与Job ID要求一致，或通过arch参数指定兼容架构。

4.2 仓库访问失败

错误信息：

[ERROR] Not found some repo, job id: cbs.001

解决方法：检查lib/rpm.sh中的仓库配置（第18-26行），确保网络连接正常。

4.3 Docker镜像加载失败

解决方法：手动下载并加载镜像：

wget http://121.36.84.172/EulerMaker/openEuler-22.03/docker_img/x86_64/openEuler-docker.x86_64.tar.xz docker load -i openEuler-docker.x86_64.tar.xz

五、构建产物查看与管理

构建完成后，产物默认保存在/tmp/任务ID目录下：

• RPM包路径：/tmp/cbs.001/RPMS
• 源码包路径：/tmp/cbs.001/SRPMS
• 构建日志：/tmp/cbs.001/build.log

可通过--showdocker参数保留容器用于调试：

ccb lr job_id=cbs.001 --showdocker # 查看容器ID后进入调试 docker exec -it 容器ID /bin/bash

六、总结与进阶

通过local-build和local-rebuild命令，开发者可以轻松在本地环境复现EulerMaker平台的构建过程。关键文件路径总结：

• 核心命令实现：sbin/cli/
• RPM构建逻辑：lib/rpm.sh
• 热补丁构建：lib/local-hotpatch

建议结合项目文档进一步学习高级配置，探索更多定制化构建场景！

【免费下载链接】ccbThis repository serves as a client-side tool for EulerMaker, allowing users to perform command-line operations on EulerMaker from within their own environment.项目地址: https://gitcode.com/openeuler/ccb