openeuler/edk2

EDK II Docker镜像文档

镜像概述

本镜像为官方EDK II Docker镜像，由https://gitee.com/openeuler/cloudnative维护，基于https://repo.openeuler.org/构建。EDK II是一个现代化、功能丰富的跨平台固件开发环境，遵循UEFI和PI规范，采用BSD+Patent开源许可证。该镜像可免费使用，且不受用户速率限制。

核心功能与特性

• 跨平台支持：适用于UEFI和PI规范的固件开发，支持多架构
• 开源许可：采用BSD+Patent许可证，允许自由使用和修改
• 环境完整：包含EDK II开发所需的工具链、依赖库和配置脚本
• 架构支持：当前支持amd64和arm64架构
• 基于openEuler：构建于稳定的openEuler基础镜像，确保环境一致性

支持的标签及Dockerfile链接

EDK II镜像标签由EDK II版本和基础镜像版本组成，具体信息如下：

使用场景

• UEFI应用程序开发与测试
• 固件组件编译与验证
• 跨平台固件开发环境搭建
• UEFI规范兼容性测试

使用方法

前提条件

• 已安装Docker引擎
• 支持KVM虚拟化（推荐，用于加速QEMU模拟）

步骤1：拉取镜像

根据需求选择对应的{Tag}标签拉取镜像：

bash
docker pull docker.xuanyuan.run/openeuler/edk2:{Tag}

例如，拉取202502-oe2403sp1版本：

bash
docker pull docker.xuanyuan.run/openeuler/edk2:202502-oe2403sp1

步骤2：启动EDK II容器实例

默认以交互式shell启动容器：

bash
docker run -it --privileged --device /dev/kvm --rm docker.xuanyuan.run/openeuler/edk2:{Tag}

参数说明：

• --privileged：授予容器高级权限，包括访问主机所有设备和内核能力，QEMU/KVM加速必需
• --device /dev/kvm：将主机的/dev/kvm设备传递给容器，允许QEMU使用硬件辅助虚拟化（更快的模拟速度）
• --rm：容器退出后自动删除

步骤3：初始化EDK II环境

在容器内执行以下命令初始化开发环境（以AArch64架构为例）：

bash
source edksetup.sh

该命令会：

• 配置必要路径（如WORKSPACE、EDK_TOOLS_PATH）
• 准备Python脚本和工具链变量，为后续构建做准备

步骤4：配置构建目标

修改构建配置（可通过编辑相关配置文件或直接设置环境变量）：

bash
TARGET_ARCH = AArch64
TOOL_CHAIN_TAG = GCC5

说明：

• TARGET_ARCH：目标架构，AArch64（ARM 64位）或X64（x86_64）
• TOOL_CHAIN_TAG：工具链标签，GCC5表示使用GCC工具链

步骤5：构建HelloWorld UEFI应用

以下示例演示构建HelloWorld应用：

bash
build -p MdeModulePkg/MdeModulePkg.dsc \
  -m MdeModulePkg/Application/HelloWorld/HelloWorld.inf \
  -a AARCH64

输出产物：

• 二进制文件：/opt/edk2/Build/MdeModule/DEBUG_GCC5/AARCH64/HelloWorld.efi
• 调试文件和日志：同一目录下

步骤6：安装QEMU及依赖

安装AArch64模拟所需工具：

bash
dnf install -y qemu-system-aarch64 wget 

下载UEFI固件：

bash
wget https://releases.linaro.org/components/kernel/uefi-linaro/latest/release/qemu64/QEMU_EFI.fd -O /opt/QEMU_EFI.fd

步骤7：在QEMU中运行HelloWorld

bash
qemu-system-aarch64 \
  -machine virt \
  -cpu cortex-a57 \
  -bios /opt/QEMU_EFI.fd \
  -kernel /opt/edk2/Build/MdeModule/DEBUG_GCC5/AARCH64/HelloWorld.efi \
  -nographic \
  -monitor none \
  -serial stdio

参数说明：

• -machine virt：模拟通用ARM虚拟机
• -cpu cortex-a57：指定CPU型号
• -bios：加载UEFI固件
• -kernel：直接引导HelloWorld.efi应用
• -nographic -serial stdio：将输出重定向到当前终端

预期输出：

UEFI Hello World!
.......

问题反馈

如有任何问题或需要使用特定功能，请在https://gitee.com/openeuler/openeuler-docker-images仓库提交issue或pull request。