X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2F0_Getting_Started%2F2_Building_AGL_Image%2F1_Preparing_Your_Build_Host.md;fp=docs%2F0_Getting_Started%2F2_Developing_an_AGL_Image%2F1_Preparing_Your_Build_Host.md;h=2c4a3f10e6e3dcd5d3e00750f666e15d2bc80232;hb=refs%2Fchanges%2F11%2F25411%2F4;hp=e609e4c282b5e8966de120ce804a620c7824a34a;hpb=11d46ac01cf2b4bbc2e8ffe9b70ca27783af0137;p=AGL%2Fdocumentation.git diff --git a/docs/0_Getting_Started/2_Developing_an_AGL_Image/1_Preparing_Your_Build_Host.md b/docs/0_Getting_Started/2_Building_AGL_Image/1_Preparing_Your_Build_Host.md similarity index 74% rename from docs/0_Getting_Started/2_Developing_an_AGL_Image/1_Preparing_Your_Build_Host.md rename to docs/0_Getting_Started/2_Building_AGL_Image/1_Preparing_Your_Build_Host.md index e609e4c..2c4a3f1 100644 --- a/docs/0_Getting_Started/2_Developing_an_AGL_Image/1_Preparing_Your_Build_Host.md +++ b/docs/0_Getting_Started/2_Building_AGL_Image/1_Preparing_Your_Build_Host.md @@ -1,22 +1,15 @@ --- -edit_link: '' title: Preparing Your Build Host -origin_url: >- - https://raw.githubusercontent.com/automotive-grade-linux/docs-sources/master/docs/getting-started/image-workflow-prep-host.md --- - - -# 1. Preparing Your Build Host - Preparing your build host so that it can build an AGL image means making sure your system is set up to use the [Yocto Project](https://yoctoproject.org) OpenEmbedded build system, which is based on -[BitBake](https://yoctoproject.org/docs/2.4.4/bitbake-user-manual/bitbake-user-manual.html). +[BitBake](https://yoctoproject.org/docs/3.1.2/bitbake-user-manual/bitbake-user-manual.html). This section presents minimal information so you can prepare the build host -to use the "Rocko" version of the Yocto Project (i.e. version 2.4.4). +to use the "Dunfell" version of the Yocto Project (i.e. version 3.1.2). If you want more details on how the Yocto Project works, you can reference the Yocto Project documentation [here](https://www.yoctoproject.org/docs/). @@ -24,17 +17,16 @@ the Yocto Project documentation **NOTE:** This entire section presumes you want to build an image. You can skip the entire build process if you want to use a ready-made development image. -The -[supported images][AGL snapshots master latest] exist for several boards as +The [supported images](https://download.automotivelinux.org/AGL/release/jellyfish/latest/) exist for several boards as well as for the Quick EMUlator (QEMU). See the -"[Downloading an Image](./app-workflow-image.html#downloading-an-image)" +"[Quickstart](../1_Quickstart/Quickstart.md)" section for more information on the ready-made images. 1. **Use a Supported Linux Distribution:** To use the AGL software, it is recommended that your build host is a native Linux machine that runs a Yocto Project supported distribution as described by the - "[Supported Linux Distributions](https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#detailed-supported-distros)" + "[Supported Linux Distributions](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#detailed-supported-distros)" section in the Yocto Project Reference Manual. Basically, you should be running a recent version of Ubuntu, Fedora, openSUSE, CentOS, or Debian. @@ -46,11 +38,11 @@ section for more information on the ready-made images. and so forth) as would a properly prepared build host running a supported Linux distribution. For information on how to install and set up this Docker container, see the - "[Setting Up a Docker Container](./docker-container-setup.html)" + "[Setting Up a Docker Container -- FIX ME](./docker-container-setup.html)" section. 2. **Be Sure Your Build Host Has Enough Free Disk Space:** - Your build host should have at least 50 Gbytes. + Your build host should have at least 100 Gbytes. 3. **Be Sure Tools are Recent:** You need to have recent versions for the following tools: @@ -60,7 +52,7 @@ section for more information on the ready-made images. * Python 3.4.0 or greater If your distribution does not meet these minimal requirements, see the - "[Required Git, tar, and Python Versions](https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#required-git-tar-and-python-versions)" + "[Required Git, tar, and Python Versions](https://www.yoctoproject.org/docs/3.1.2/ref-manual/ref-manual.html#required-git-tar-and-python-versions)" section in the Yocto Project Reference Manual for steps that you can take to be sure you have these tools. @@ -69,13 +61,13 @@ section for more information on the ready-made images. Depending on the Linux distribution you are using, the list of host packages differ. See - "[The Build Host Packages](https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html#packages)" + "[The Build Host Packages](https://www.yoctoproject.org/docs/3.1.2/yocto-project-qs/yocto-project-qs.html#packages)" section of the Yocto Project Quick Start for information on the packages you need. **NOTE:** If you are using the CentOS distribution, you need to separately install the epel-release package and run the `makecache` command as described in - "[The Build Host Packages](https://www.yoctoproject.org/docs/2.4.4/yocto-project-qs/yocto-project-qs.html#packages)" + "[The Build Host Packages](https://www.yoctoproject.org/docs/3.1.2/yocto-project-qs/yocto-project-qs.html#packages)" section of the Yocto Project Quick Start. Aside from the packages listed in the previous section, you need the following: