From 09f8262bbe30d1749b9318fe945d39cb21358633 Mon Sep 17 00:00:00 2001 From: zhangweigang Date: Fri, 18 Mar 2022 11:38:57 +0800 Subject: [PATCH 1/2] update container build guidance modify getting_started docs Signed-off-by: zhangweigang --- .../source/docker/container_recover_guide.rst | 38 --- .../getting_started/container-build.rst | 101 ++++++++ docs/source/getting_started/index.rst | 237 +----------------- docs/source/getting_started/regular-build.rst | 225 +++++++++++++++++ 4 files changed, 338 insertions(+), 263 deletions(-) delete mode 100644 docs/source/docker/container_recover_guide.rst create mode 100644 docs/source/getting_started/container-build.rst create mode 100644 docs/source/getting_started/regular-build.rst diff --git a/docs/source/docker/container_recover_guide.rst b/docs/source/docker/container_recover_guide.rst deleted file mode 100644 index 5b3b4746d19..00000000000 --- a/docs/source/docker/container_recover_guide.rst +++ /dev/null @@ -1,38 +0,0 @@ -OpenEuler容器镜像使用指导 -========================= -1. 准备docker环境 -******************* -a) 检查当前环境是否已安装docker环境 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- docker version - -b) 如果没有安装，可参考官方链接安装 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -官网地址：http://www.dockerinfo.net/document - -openEuler环境可参考Centos安装Docker - -- sudo yum install docker - -2. 从华为云pull容器镜像到本地 -****************************** -- docker pull swr.cn-north-4.myhuaweicloud.com/openeuler-embedded/rtos-openeuler-21.03:v001 - -3. 使用pull下来的镜像启动容器（启动命令仅供参考） -************************************************ -a) 启动容器 -^^^^^^^^^^^^^ -- docker run -idt swr.cn-north-4.myhuaweicloud.com/openeuler-embedded/rtos-openeuler-21.03:v001 bash - -b) 查看已启动的容器id -^^^^^^^^^^^^^^^^^^^^^^^ -- docker ps - -例如容器id为xxxxxx - -c) 进入容器 -^^^^^^^^^^^^^ -- docker exec -it xxxxxx bash - -4. 开始构建，具体过程不再赘述。 -******************************* diff --git a/docs/source/getting_started/container-build.rst b/docs/source/getting_started/container-build.rst new file mode 100644 index 00000000000..1079931a8c7 --- /dev/null +++ b/docs/source/getting_started/container-build.rst @@ -0,0 +1,101 @@ +openEuler容器构建指导 +====================== + +1. 准备主机端docker工具 +************************ + +a) 检查当前环境是否已安装docker环境 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: console + + docker version + +b) 如果没有安装，可参考官方链接安装 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +官网地址：http://www.dockerinfo.net/document + +openEuler环境可参考Centos安装Docker + +.. code-block:: console + + sudo yum install docker + +2. 获取容器镜像 +**************** + +a) 从华为云pull镜像到宿主机 +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: console + + docker pull swr.cn-north-4.myhuaweicloud.com/openeuler-embedded/rtos-openeuler-21.03:v001 + +3. 拉起容器构建环境（启动命令仅供参考） +************************************* + +a) 启动容器 +^^^^^^^^^^^^^ + +.. code-block:: console + + docker run -idt swr.cn-north-4.myhuaweicloud.com/openeuler-embedded/rtos-openeuler-21.03:v001 bash + +b) 查看已启动的容器id +^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: console + + docker ps + +c) 进入容器 +^^^^^^^^^^^^ + +.. code-block:: console + + docker exec -it 容器id bash + +4. yocto一键式构建流程 +************************************* + +a) 下载代码 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: console + + git clone https://gitee.com/openeuler/yocto-meta-openeuler.git -b openEuler-21.09 + +b) bash执行scripts/download_code.sh脚本 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. code-block:: console + + sh scripts/download_code.sh + +c) bash执行scripts/compile.sh一键式构建脚本 +****************************************** + +.. code-block:: console + + sh scripts/compile.sh + +d) 获取结果件 +************** + +- /usr1/output + +5. 目录说明 +************* + +a) 源码目录 +^^^^^^^^^^^^ +- /usr1/openeuler/src + +b) 构建目录 +^^^^^^^^^^^^ +- /usr1/openeuler/src/build + +c) 结果件目录 +^^^^^^^^^^^^^^ +- /usr1/output diff --git a/docs/source/getting_started/index.rst b/docs/source/getting_started/index.rst index 00b2470d534..be690293862 100644 --- a/docs/source/getting_started/index.rst +++ b/docs/source/getting_started/index.rst @@ -1,225 +1,12 @@ -.. _getting_started: - -快速上手 -########## - -openEuler Embedded是基于openEuler社区面向嵌入式场景的Linux版本。由于嵌入式系统应用受到多个因素的约束，如资源、功耗、多样性等， -使得面向服务器领域的Linux及相应的构建系统很难满足嵌入式场景的要求，因此业界广泛采用 `Yocto `_ -来定制化构建嵌入式Linux。openEuler Embedded当前也采用的Yocto构建，但实现了与openEuler其他版本代码同源，具体的构建方法请参考 -`SIG-Yocto `_ -下相关代码仓中的内容。 - -本文档主要用于介绍如何获取预先构建好的镜像，如何运行镜像，以及如何基于镜像完成基本的嵌入式Linux应用开发。 - -获取镜像 -*********** - -当前发布的已构建好的镜像，只支持arm和aarch64两种架构，且只支持qemu中ARM virt-4.0平台，您可以通过如下链接获得相应的镜像： - -- `qemu_arm `_： 32位arm架构, ARM Cortex A15处理器 -- `qemu_aarch64 `_: 64位aarch64架构 ARM Cortex A57处理器 - -只要相应环境支持qemu仿真器（版本5.0以上），您可以将提供的openEuler Embedded镜像部署在物理裸机、云环境、容器或虚拟机上。 - -镜像内容 -*********** - -所下载的镜像，由以下几部分组成： - -- 内核镜像 **zImage**: 基于openEuler社区Linux 5.10代码构建得到。相应的内核配置可通过如下链接获取： - - - `arm(cortex a15) `_ - - `arm(cortex a57) `_, - 针对aarch64架构，额外增加了镜像自解压功能，可以参见相应的 `patch `_ - -- 根文件系统镜像（依据具体需求，以下二选一） - - - **initrd_tiny**：极简根文件系统镜像，只包含基本功能。包含 busybox 和基本的 glibc 库。该镜像功能简单，但内存消耗很小，适合探索 Linux内核相关功能。 - - **initrd**：标准根文件系统镜像，在极简根文件系统镜像的基础上，进行了必要安全加固，增加了audit、cracklib、OpenSSH、Linux PAM、shadow、iSula容器等软件包。该镜像适合进行更加丰富的功能探索。 - -运行镜像 -*********** - -通过运行镜像，一方面您可以体验openEuler Embedded的功能，一方面也可以完成基本的嵌入式Linux开发。 - -.. note:: - - - 建议使用QEMU5.0以上版本运行镜像，由于一些额外功能（网络、共享文件系统)需要依赖QEMU的virtio-net, virtio-fs等特性，如未在QEMU中使能，则运行时可能会产生错误，此时可能需要从源码重新编译QEMU。 - - - 运行镜像时，建议把内核镜像和根文件系统镜像放在同一目录下，后续说明以标准根文件系统为例(initrd)。 - - -极简运行场景 -============== - -该场景下，qemu未使能网络和共享文件系统，适合快速的功能体验。 - -针对arm(ARM Cortex A15)，运行如下命令： - -.. code-block:: console - - qemu-system-arm -M virt-4.0 -cpu cortex-a15 -nographic -kernel zImage -initrd initrd - -针对aarch64(ARM Cortex A57)，运行如下命令： - -.. code-block:: console - - qemu-system-aarch64 -M virt-4.0 -cpu cortex-a57 -nographic -kernel zImage -initrd initrd - - -由于标准根文件系统镜像进行了安全加固，因此第一次启动时，需要为登录用户名root设置密码，且密码强度有相应要求， 需要数字、字母、特殊字符组合最少8位，例如openEuler@2021。当使用极简根文件系统镜像时，系统会自动登录, 无需输入用户名和密码。 - -qemu运行成功并登录后，将会呈现openEuler Embedded的Shell。 - -使能共享文件系统场景 -========================== - -通过共享文件系统，可以使得运行qemu仿真器的宿主机和openEuler Embedded共享文件，这样在宿主机上交叉编译的程序，拷贝到共享目录中，即可在openEuler Embedded上运行。 - -假设将宿主机的/tmp目录作为共享目录，并事先在其中创建了名为hello_openeuler.txt的文件，使能共享文件系统功能的操作指导如下： - -1. **启动qemu** - -针对arm(ARM Cortex A15)，运行如下命令： - -.. code-block:: console - - qemu-system-arm -M virt-4.0 -cpu cortex-a15 -nographic -kernel zImage -initrd initrd -device virtio-9p-device,fsdev=fs1,mount_tag=host -fsdev local,security_model=passthrough,id=fs1,path=/tmp - -针对aarch64(ARM Cortex A57)，运行如下命令： - -.. code-block:: console - - qemu-system-aarch64 -M virt-4.0 -cpu cortex-a57 -nographic -kernel zImage -initrd initrd -device virtio-9p-device,fsdev=fs1,mount_tag=host -fsdev local,security_model=passthrough,id=fs1,path=/tmp - - -2. **映射文件系统** - -在openEuler Embedded启动并登录之后，需要运行如下命令，映射(mount)共享文件系统 - -.. code-block:: console - - cd /tmp - mkdir host - mount -t 9p -o trans=virtio,version=9p2000.L host /tmp/host - -即把共享文件系统映射到openEuler Embedded的/tmp/host目录下。 - -3. **检查共享是否成功** - -在openEuler Embedded中，运行如下命令: - -.. code-block:: console - - cd /tmp/host - ls - -如能发现hello_openeuler.txt，则共享成功。 - -使能网络场景 -=============== - -通过qemu的virtio-net和宿主机上的虚拟网卡，可以实现宿主机和openEuler embedded之间的网络通信。 - -1. **启动qemu** - -针对arm(ARM Cortex A15)，运行如下命令： - -.. code-block:: console - - qemu-system-arm -M virt-4.0 -cpu cortex-a15 -nographic -kernel zImage -initrd initrd -device virtio-net-device,netdev=tap0 -netdev tap,id=tap0,script=/etc/qemu-ifup - -针对aarch64(ARM Cortex A57)，运行如下命令： - -.. code-block:: console - - qemu-system-aarch64 -M virt-4.0 -cpu cortex-a57 -nographic -kernel zImage -initrd initrd -device virtio-net-device,netdev=tap0 -netdev tap,id=tap0,script=/etc/qemu-ifup - -2. **宿主上建立虚拟网卡** - -在宿主机上需要建立名为tap0的虚拟网卡，可以借助/etc/qemu-ifup脚本实现，其执行需要root权限，具体内容如下： - -.. code-block:: console - - #!/bin/bash - ifconfig $1 192.168.10.1 up - -通过qemu-ifup脚本，宿主机上将创建名为tap0的虚拟网卡，地址为192.168.10.1。 - -3. **配置openEuler embedded网卡** - -openEuler Embedded登陆后，执行如下命令： - -.. code-block:: console - - ifconfig eth0 192.168.10.2 - - -4. **确认网络连通** - -在openEuler Embedded中，执行如下命令： - -.. code-block:: console - - ping 192.168.10.1 - -如能ping通，则宿主机和openEuler Embedded之间的网络是连通的。 - -.. note:: - - 如需openEuler embedded借助宿主机访问互联网，则需要在宿主机上建立网桥，此处不详述，如有需要，请自行查阅相关资料。 - - - -基于openEuler embedded的用户态应用开发 -******************************************** - -当前发布的镜像除了体验openEuler Embedded的基本功能外，还可以进行基本的用户态应用开发，也即在openEuler embedded上运行用户自己的程序。 - - -1. **环境准备** - -由于当前镜像采用了linaro arm/aarch64 gcc 7.3.1工具链构建，因此建议应用开发也使用相同的工具链接进行，可以从如下链接中获取相应工具链： - -- `linaro arm `_ -- `linrao arm sysroot `_ -- `linaro aarch64 `_ -- `linrao aarch64 sysroot `_ - -下载并解压到指定的目录中，例如/opt/openEuler_toolchain。 - -2. **创建并编译用户态程序** - -以构建一个hello openEuler程序为例，运行在aarch64的标准根文件系统镜像中。 - -在宿主机中，创建一个hello.c文件，源码如下： - -.. code-block:: c - - #include - - int main(void) - { - printf("hello openEuler\r\n"); - } - -然后在宿主机上使用对应的工具链编译, 相应命令如下： - -.. code-block:: console - - export PATH=$PATH:/opt/openEuler_toolchain/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin - aarch64-linux-gnu-gcc --sysroot= hello.c -o hello - mv hello /temp - -把交叉编译好的hello程序拷贝到/tmp目录下，然后参照使能共享文件系统中的描述，使得openEuler embedded可以访问宿主机的目录。 - -3. **运行用户态程序** - -在openEuler embedded中运行hello程序。 - -.. code-block:: console - - cd /tmp/host - ./hello - -如运行成功，openEuler Embedded的shell中就会输出hello openEuler。 +.. _getting_started: + +openEuler Embedded快速构建指导 +============================ + +本章主要提供了两种方式准备构建环境，并描述了详细的构建流程，具体内容如下： + +.. toctree:: + :maxdepth: 1 + + regular-build.rst + container-build.rst diff --git a/docs/source/getting_started/regular-build.rst b/docs/source/getting_started/regular-build.rst new file mode 100644 index 00000000000..00b2470d534 --- /dev/null +++ b/docs/source/getting_started/regular-build.rst @@ -0,0 +1,225 @@ +.. _getting_started: + +快速上手 +########## + +openEuler Embedded是基于openEuler社区面向嵌入式场景的Linux版本。由于嵌入式系统应用受到多个因素的约束，如资源、功耗、多样性等， +使得面向服务器领域的Linux及相应的构建系统很难满足嵌入式场景的要求，因此业界广泛采用 `Yocto `_ +来定制化构建嵌入式Linux。openEuler Embedded当前也采用的Yocto构建，但实现了与openEuler其他版本代码同源，具体的构建方法请参考 +`SIG-Yocto `_ +下相关代码仓中的内容。 + +本文档主要用于介绍如何获取预先构建好的镜像，如何运行镜像，以及如何基于镜像完成基本的嵌入式Linux应用开发。 + +获取镜像 +*********** + +当前发布的已构建好的镜像，只支持arm和aarch64两种架构，且只支持qemu中ARM virt-4.0平台，您可以通过如下链接获得相应的镜像： + +- `qemu_arm `_： 32位arm架构, ARM Cortex A15处理器 +- `qemu_aarch64 `_: 64位aarch64架构 ARM Cortex A57处理器 + +只要相应环境支持qemu仿真器（版本5.0以上），您可以将提供的openEuler Embedded镜像部署在物理裸机、云环境、容器或虚拟机上。 + +镜像内容 +*********** + +所下载的镜像，由以下几部分组成： + +- 内核镜像 **zImage**: 基于openEuler社区Linux 5.10代码构建得到。相应的内核配置可通过如下链接获取： + + - `arm(cortex a15) `_ + - `arm(cortex a57) `_, + 针对aarch64架构，额外增加了镜像自解压功能，可以参见相应的 `patch `_ + +- 根文件系统镜像（依据具体需求，以下二选一） + + - **initrd_tiny**：极简根文件系统镜像，只包含基本功能。包含 busybox 和基本的 glibc 库。该镜像功能简单，但内存消耗很小，适合探索 Linux内核相关功能。 + - **initrd**：标准根文件系统镜像，在极简根文件系统镜像的基础上，进行了必要安全加固，增加了audit、cracklib、OpenSSH、Linux PAM、shadow、iSula容器等软件包。该镜像适合进行更加丰富的功能探索。 + +运行镜像 +*********** + +通过运行镜像，一方面您可以体验openEuler Embedded的功能，一方面也可以完成基本的嵌入式Linux开发。 + +.. note:: + + - 建议使用QEMU5.0以上版本运行镜像，由于一些额外功能（网络、共享文件系统)需要依赖QEMU的virtio-net, virtio-fs等特性，如未在QEMU中使能，则运行时可能会产生错误，此时可能需要从源码重新编译QEMU。 + + - 运行镜像时，建议把内核镜像和根文件系统镜像放在同一目录下，后续说明以标准根文件系统为例(initrd)。 + + +极简运行场景 +============== + +该场景下，qemu未使能网络和共享文件系统，适合快速的功能体验。 + +针对arm(ARM Cortex A15)，运行如下命令： + +.. code-block:: console + + qemu-system-arm -M virt-4.0 -cpu cortex-a15 -nographic -kernel zImage -initrd initrd + +针对aarch64(ARM Cortex A57)，运行如下命令： + +.. code-block:: console + + qemu-system-aarch64 -M virt-4.0 -cpu cortex-a57 -nographic -kernel zImage -initrd initrd + + +由于标准根文件系统镜像进行了安全加固，因此第一次启动时，需要为登录用户名root设置密码，且密码强度有相应要求， 需要数字、字母、特殊字符组合最少8位，例如openEuler@2021。当使用极简根文件系统镜像时，系统会自动登录, 无需输入用户名和密码。 + +qemu运行成功并登录后，将会呈现openEuler Embedded的Shell。 + +使能共享文件系统场景 +========================== + +通过共享文件系统，可以使得运行qemu仿真器的宿主机和openEuler Embedded共享文件，这样在宿主机上交叉编译的程序，拷贝到共享目录中，即可在openEuler Embedded上运行。 + +假设将宿主机的/tmp目录作为共享目录，并事先在其中创建了名为hello_openeuler.txt的文件，使能共享文件系统功能的操作指导如下： + +1. **启动qemu** + +针对arm(ARM Cortex A15)，运行如下命令： + +.. code-block:: console + + qemu-system-arm -M virt-4.0 -cpu cortex-a15 -nographic -kernel zImage -initrd initrd -device virtio-9p-device,fsdev=fs1,mount_tag=host -fsdev local,security_model=passthrough,id=fs1,path=/tmp + +针对aarch64(ARM Cortex A57)，运行如下命令： + +.. code-block:: console + + qemu-system-aarch64 -M virt-4.0 -cpu cortex-a57 -nographic -kernel zImage -initrd initrd -device virtio-9p-device,fsdev=fs1,mount_tag=host -fsdev local,security_model=passthrough,id=fs1,path=/tmp + + +2. **映射文件系统** + +在openEuler Embedded启动并登录之后，需要运行如下命令，映射(mount)共享文件系统 + +.. code-block:: console + + cd /tmp + mkdir host + mount -t 9p -o trans=virtio,version=9p2000.L host /tmp/host + +即把共享文件系统映射到openEuler Embedded的/tmp/host目录下。 + +3. **检查共享是否成功** + +在openEuler Embedded中，运行如下命令: + +.. code-block:: console + + cd /tmp/host + ls + +如能发现hello_openeuler.txt，则共享成功。 + +使能网络场景 +=============== + +通过qemu的virtio-net和宿主机上的虚拟网卡，可以实现宿主机和openEuler embedded之间的网络通信。 + +1. **启动qemu** + +针对arm(ARM Cortex A15)，运行如下命令： + +.. code-block:: console + + qemu-system-arm -M virt-4.0 -cpu cortex-a15 -nographic -kernel zImage -initrd initrd -device virtio-net-device,netdev=tap0 -netdev tap,id=tap0,script=/etc/qemu-ifup + +针对aarch64(ARM Cortex A57)，运行如下命令： + +.. code-block:: console + + qemu-system-aarch64 -M virt-4.0 -cpu cortex-a57 -nographic -kernel zImage -initrd initrd -device virtio-net-device,netdev=tap0 -netdev tap,id=tap0,script=/etc/qemu-ifup + +2. **宿主上建立虚拟网卡** + +在宿主机上需要建立名为tap0的虚拟网卡，可以借助/etc/qemu-ifup脚本实现，其执行需要root权限，具体内容如下： + +.. code-block:: console + + #!/bin/bash + ifconfig $1 192.168.10.1 up + +通过qemu-ifup脚本，宿主机上将创建名为tap0的虚拟网卡，地址为192.168.10.1。 + +3. **配置openEuler embedded网卡** + +openEuler Embedded登陆后，执行如下命令： + +.. code-block:: console + + ifconfig eth0 192.168.10.2 + + +4. **确认网络连通** + +在openEuler Embedded中，执行如下命令： + +.. code-block:: console + + ping 192.168.10.1 + +如能ping通，则宿主机和openEuler Embedded之间的网络是连通的。 + +.. note:: + + 如需openEuler embedded借助宿主机访问互联网，则需要在宿主机上建立网桥，此处不详述，如有需要，请自行查阅相关资料。 + + + +基于openEuler embedded的用户态应用开发 +******************************************** + +当前发布的镜像除了体验openEuler Embedded的基本功能外，还可以进行基本的用户态应用开发，也即在openEuler embedded上运行用户自己的程序。 + + +1. **环境准备** + +由于当前镜像采用了linaro arm/aarch64 gcc 7.3.1工具链构建，因此建议应用开发也使用相同的工具链接进行，可以从如下链接中获取相应工具链： + +- `linaro arm `_ +- `linrao arm sysroot `_ +- `linaro aarch64 `_ +- `linrao aarch64 sysroot `_ + +下载并解压到指定的目录中，例如/opt/openEuler_toolchain。 + +2. **创建并编译用户态程序** + +以构建一个hello openEuler程序为例，运行在aarch64的标准根文件系统镜像中。 + +在宿主机中，创建一个hello.c文件，源码如下： + +.. code-block:: c + + #include + + int main(void) + { + printf("hello openEuler\r\n"); + } + +然后在宿主机上使用对应的工具链编译, 相应命令如下： + +.. code-block:: console + + export PATH=$PATH:/opt/openEuler_toolchain/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin + aarch64-linux-gnu-gcc --sysroot= hello.c -o hello + mv hello /temp + +把交叉编译好的hello程序拷贝到/tmp目录下，然后参照使能共享文件系统中的描述，使得openEuler embedded可以访问宿主机的目录。 + +3. **运行用户态程序** + +在openEuler embedded中运行hello程序。 + +.. code-block:: console + + cd /tmp/host + ./hello + +如运行成功，openEuler Embedded的shell中就会输出hello openEuler。 -- Gitee From 040477d5a1deff0655d8980cf3d27c5bf9125af1 Mon Sep 17 00:00:00 2001 From: harvey-rtos Date: Fri, 18 Mar 2022 12:42:43 +0000 Subject: [PATCH 2/2] update docs/source/getting_started/container-build.rst. --- .../getting_started/container-build.rst | 51 ++++++++++++------- 1 file changed, 32 insertions(+), 19 deletions(-) diff --git a/docs/source/getting_started/container-build.rst b/docs/source/getting_started/container-build.rst index 1079931a8c7..eb95c93b668 100644 --- a/docs/source/getting_started/container-build.rst +++ b/docs/source/getting_started/container-build.rst @@ -59,43 +59,56 @@ c) 进入容器 4. yocto一键式构建流程 ************************************* -a) 下载代码 -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +a) clone yocto-meta-openeuler代码仓 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console - git clone https://gitee.com/openeuler/yocto-meta-openeuler.git -b openEuler-21.09 + git clone https://gitee.com/openeuler/yocto-meta-openeuler.git -b openEuler-22.03-LTS -v /usr1/yocto-meta-openeuler -b) bash执行scripts/download_code.sh脚本 +b) 下载源码 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console - sh scripts/download_code.sh + cd /usr1/yocto-meta-openeuler + sh scripts/download_code.sh /usr1/openeuler/src -c) bash执行scripts/compile.sh一键式构建脚本 +c) 开始编译 ****************************************** .. code-block:: console - sh scripts/compile.sh + chown -R huawei:users /usr1 + su huawei + cd /usr1/openeuler/src/yocto-meta-openeuler/scripts + source compile.sh aarch64-std /usr1/build /usr1/openeuler/src /usr1/openeuler/gcc/openeuler_gcc_arm64le + +- 编译架构: 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编译器 d) 获取结果件 ************** -- /usr1/output +结果件默认生成在构建目录下的output -5. 目录说明 -************* +如aarch64-std编译完成后产物如下： -a) 源码目录 -^^^^^^^^^^^^ -- /usr1/openeuler/src +- openeuler镜像: Image-5.10.0 -b) 构建目录 -^^^^^^^^^^^^ -- /usr1/openeuler/src/build +- 工具链: openeuler-glibc-x86_64-openeuler-image-aarch64-qemu-aarch64-toolchain-21.09.30.sh + +- 文件系统: openeuler-image-qemu-aarch64-20220318114250.rootfs.cpio.gz + +- 内核文件: vmlinux-5.10.0 -c) 结果件目录 -^^^^^^^^^^^^^^ -- /usr1/output +- 压缩的镜像: zImage -- Gitee