Distribution Support: Difference between revisions

From Yocto Project
Jump to navigationJump to search
Line 26: Line 26:


=== How to add a new entry or additional distro information ===
=== How to add a new entry or additional distro information ===
* Check if there is already a distribution listed on this page
* If there is no such distribution, you could add a new entry in above matrix for the distribution and add following information in the sub-page of this entry:


* Distribution (Fedora15/Ubuntu10.04/Opensuse11.4... etc):
The criteria for adding a distro to be supported is quite high. Obviously, any candidate distro would need to be production quality. That is, capable of being used in a production environment, on a Yocto Project Autobuilder build worker. There would also need to be a compelling reason for the Yocto Project to actually DO that. Obscure, poorly supported, or highly customized distros are not likely to be good candidates for submission. Major stable distros (Debian, Fedora, Ubunto, Centos, etc.) are generally already supported, or they are on the radar to be supported down the road when sufficient criteria are met. Please be sure to check the latest supported distros beforehand, to make sure it's not already supported.
* Arch (32/64):
* MACHINE (qemux86/qemuarm/qemuppc... etc):
* TARGET (core-image-sato/core-image-sato-sdk... etc):
* Commit/Release (7eea637db0.../master, 1.0.1 release):
* Validated by/DATE (user@email.com - 2011-09-14):
* Bug ID: (If the status of your testing is failure, pls. help to file a bug in our bugzilla, http://bugzilla.pokylinux.org)


* If there is already a distribution in above matrix, it's better for you to check if your test result is consistent with the old result in matrix. You could update the "Status" field and add additional information with above format into sub-page of the distribution.
If you have a compelling reason to suggest a distro to support, please submit your request to the Yocto mailing list for discussion. You will likely be asked to provide the reasoning behind your request, so relevant bug reports, failed test cases, etc., would be helpful to have ready in advance.  
<br>
 
If you are not already a member of the Yocto mailing list, you may find more information about the list, and subscribe, here: https://lists.yoctoproject.org/listinfo/yocto.


== Distro Testing ==
== Distro Testing ==

Revision as of 22:30, 31 July 2018

Distribution Support

Distribution Support

The poky.conf file tracks all the distros supported by the Yocto Project. (http://git.yoctoproject.org/cgit/cgit.cgi/poky/tree/meta-poky/conf/distro/poky.conf) The supported, and subsequently sanity tested, distros are listed in the "SANITY_TEST_DISTROS" section in poky.conf. Each supported distro is deployed and used as a Yocto Autobuilder build worker. For more information on supported distros, please refer to the "Supported Linux Distributions" section in the Yocto Project Reference Manual.


Example of distro list in poky.conf:

SANITY_TESTED_DISTROS ?= " \
            poky-2.4 \n \
            poky-2.5 \n \
            ubuntu-15.04 \n \
            ubuntu-16.04 \n \
            ubuntu-16.10 \n \
            ubuntu-17.04 \n \
            fedora-26 \n \
            centos-7 \n \
            debian-8 \n \
            debian-9 \n \
            opensuse-42.1 \n \
            opensuse-42.2 \n \
            "

Again, this is just an example, not meant to be a definitive reference.

How to add a new entry or additional distro information

The criteria for adding a distro to be supported is quite high. Obviously, any candidate distro would need to be production quality. That is, capable of being used in a production environment, on a Yocto Project Autobuilder build worker. There would also need to be a compelling reason for the Yocto Project to actually DO that. Obscure, poorly supported, or highly customized distros are not likely to be good candidates for submission. Major stable distros (Debian, Fedora, Ubunto, Centos, etc.) are generally already supported, or they are on the radar to be supported down the road when sufficient criteria are met. Please be sure to check the latest supported distros beforehand, to make sure it's not already supported.

If you have a compelling reason to suggest a distro to support, please submit your request to the Yocto mailing list for discussion. You will likely be asked to provide the reasoning behind your request, so relevant bug reports, failed test cases, etc., would be helpful to have ready in advance.

If you are not already a member of the Yocto mailing list, you may find more information about the list, and subscribe, here: https://lists.yoctoproject.org/listinfo/yocto.

Distro Testing

Distro test coverage

Distro Testing is intended to catch bugs that are distribution specific using the yocto-autobuilder. The tests are all run on identical hardware and with all OS-es updated. The distributions used will be Fedora, Ubuntu, CentOS, OpenSuse with their latest update.
This is the list of the builds that are performed on Distro testing:

Build-set Images Built Target machine
nightly-world world qemux86
buildtools buildtools-tarball qemux86-64
nightly-arm core-image-sato qemuarm
core-image-sato-dev
core-image-sato-sdk
core-image-minimal
core-image-minimal-dev
nightly-multilib lib32-core-image-minimal qemux86-64
lib32-core-image-sato
lib64-core-image-minimal qemux86
lib64-core-image-sato
nightly-qa-systemd core-image-sato qemux86-64
nightly-x86 core-image-sato qemux86
core-image-sato-dev
core-image-sato-sdk
core-image-minimal
core-image-minimal-dev
core-image-sato qemux86-64
core-image-sato-dev
core-image-sato-sdk
core-image-minimal
core-image-minimal-dev
nightly-x86-64 core-image-sato qemux86
core-image-sato-dev
core-image-sato-sdk
core-image-minimal
core-image-minimal-dev
core-image-sato qemux86-64
core-image-sato-dev
core-image-sato-sdk
core-image-minimal
core-image-minimal-dev