容器构建指导

由于openEuler Embedded构建过程需要基于openEuler操作系统，且需要安装较多系统工具和构建工具。为方便开发人员快速搭建构建环境，我们将构建过程所依赖的操作系统和工具封装到一个容器中，这就使得开发人员可以快速搭建一个构建环境，进而投入到代码开发中去，避免在准备环境阶段消耗大量时间。

• 环境准备
  • 安装docker
  • 获取容器镜像
  • 准备容器构建环境
• 版本构建
  • 下载源码
  • 编译构建
  • 构建结果说明

环境准备

需要使用docker创建容器环境，为了确保docker成功安装，需满足以下软件硬件要求：

• 操作系统: 推荐使用openEuler 20.03/22.03、Ubuntu 20.04/22.04、Debian 11、Suse 12.05
• 内核: 推荐3.8及以上的内核
• 驱动: 内核必须支持一种合适的存储驱动，例如: Device Mapper、AUFS、vfs、btrfs、ZFS
• 架构: 运行64位架构的计算机（目前只支持x86_64和amd64）

安装docker

1. 检查当前环境是否已安装docker工具

运行如下命令，可以看到当前docker版本信息，则说明当前环境已安装docker，无需再次安装。

docker version

2. 如果没有安装，可参考官方链接安装

官网地址: http://www.dockerinfo.net/document，openEuler环境可参考Centos安装Docker。

例如openEuler环境docker安装命令如下：

sudo yum install docker

获取容器镜像

通过docker pull命令拉取华为云中的镜像到宿主机。命令如下：

docker pull swr.cn-north-4.myhuaweicloud.com/openeuler-embedded/openeuler-container:22.03-lts

准备容器构建环境

1.启动容器

可通过docker run命令启动容器，为了保证容器启动后可以在后台运行，且可以正常访问网络，建议使用如下命令启动：

docker run -idt --network host swr.cn-north-4.myhuaweicloud.com/openeuler-embedded/openeuler-container:22.03-lts bash

参数说明:

• -i 让容器的标准输入保持打开
• -d 让 Docker 容器在后台以守护态（Daemonized）形式运行
• -t 选项让Docker分配一个伪终端（pseudo-tty）并绑定到容器的标准输入上
• --network 将容器连接到（host）网络
• swr.cn-north-4.myhuaweicloud.com/openeuler-embedded/openeuler-container 指定镜像名称
• bash 进入容器的方式

2.查看已启动的容器id

docker ps

3.进入容器

docker exec -it 容器id bash

构建环境已准备完成，下面就可以在容器中进行构建了。

版本构建

下载源码

1. 获取源码下载脚本

git clone https://gitee.com/openeuler/yocto-meta-openeuler.git -b openEuler-22.03-LTS -v /usr1/openeuler/src/yocto-meta-openeuler

2. 通过脚本下载源码

cd /usr1/openeuler/src/yocto-meta-openeuler/scripts
sh download_code.sh /usr1/openeuler/src

编译构建

• 编译架构: aarch64-std、aarch64-pro、arm-std、raspberrypi4-64
• 构建目录: /usr1/build
• 源码目录: /usr1/openeuler/src
• 编译器所在路径: /usr1/openeuler/gcc/openeuler_gcc_arm64le

说明：

• 不同的编译架构使用不同的编译器，aarch64-std、aarch64-pro、raspberrypi4-64使用openeuler_gcc_arm64le编译器，arm-std使用openeuler_gcc_arm32le编译器。
• 下面以以aarch64-std目标架构编译为例。

1. 将/usr1目录所属群组改为openeuler，否则切换至openeuler用户构建会存在权限问题。

chown -R openeuler:users /usr1

2. 切换至openeuler用户。

su openeuler

3. 进入构建脚本所在路径，运行编译脚本。

cd /usr1/openeuler/src/yocto-meta-openeuler/scripts
source compile.sh aarch64-std /usr1/build /usr1/openeuler/gcc/openeuler_gcc_arm64le
bitbake openeuler-image

构建结果说明

结果件默认生成在构建目录下的output目录下，例如上面aarch64-std的构建结果件生成在/usr1/build/output目录下，如下表：