ref-manual: move runtime-testing section to the test-manual

In the same fashion as the previous commit ("ref-manual/packages: move
ptest section to the test-manual"), move the runtime testing section of
the development tasks manual to the test environment manual.

Add a link to it from the test-manual/intro document.

(From yocto-docs rev: 3128bf149f40928e6c2a3e264590a0c6c9778c6a)

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
(cherry picked from commit 6b44257874858db3aa426d3e84a79c41cb4937a3)
Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
Signed-off-by: Steve Sakoman <steve@sakoman.com>
This commit is contained in:
Antonin Godard 2024-12-26 16:20:17 +01:00 committed by Steve Sakoman
parent 2497f29afd
commit ac2d3a5377
10 changed files with 29 additions and 26 deletions

View File

@ -39,7 +39,6 @@ Yocto Project Development Tasks Manual
external-scm external-scm
read-only-rootfs read-only-rootfs
build-quality build-quality
runtime-testing
debugging debugging
licenses licenses
security-subjects security-subjects

View File

@ -243,8 +243,8 @@ A new automated image testing framework has been added through the
framework replaces the older ``imagetest-qemu`` framework. framework replaces the older ``imagetest-qemu`` framework.
You can learn more about performing automated image tests in the You can learn more about performing automated image tests in the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
.. _migration-1.5-build-history: .. _migration-1.5-build-history:

View File

@ -3064,8 +3064,8 @@ after it is built, you can set :term:`TESTIMAGE_AUTO`::
TESTIMAGE_AUTO = "1" TESTIMAGE_AUTO = "1"
For information on how to enable, run, and create new tests, see the For information on how to enable, run, and create new tests, see the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
.. _ref-classes-testsdk: .. _ref-classes-testsdk:

View File

@ -119,8 +119,8 @@ Here is a list of supported recipes:
deployed to a separate partition so that you can boot into it and use deployed to a separate partition so that you can boot into it and use
it to deploy a second image to be tested. You can find more it to deploy a second image to be tested. You can find more
information about runtime testing in the information about runtime testing in the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
- ``core-image-testmaster-initramfs``: A RAM-based Initial Root - ``core-image-testmaster-initramfs``: A RAM-based Initial Root
Filesystem (initramfs) image tailored for use with the Filesystem (initramfs) image tailored for use with the

View File

@ -148,8 +148,8 @@ Additionally, because the test strategies are visible to you as a
developer, you can validate your projects. This section overviews the developer, you can validate your projects. This section overviews the
available test infrastructure used in the Yocto Project. For information available test infrastructure used in the Yocto Project. For information
on how to run available tests on your projects, see the on how to run available tests on your projects, see the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
The QA/testing infrastructure is woven into the project to the point The QA/testing infrastructure is woven into the project to the point
where core developers take some of it for granted. The infrastructure where core developers take some of it for granted. The infrastructure

View File

@ -629,8 +629,8 @@ information on how the root filesystem is created.
Boots an image and performs runtime tests within the image. For Boots an image and performs runtime tests within the image. For
information on automatically testing images, see the information on automatically testing images, see the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
.. _ref-tasks-testimage_auto: .. _ref-tasks-testimage_auto:
@ -642,8 +642,8 @@ after it has been built. This task is enabled when you set
:term:`TESTIMAGE_AUTO` equal to "1". :term:`TESTIMAGE_AUTO` equal to "1".
For information on automatically testing images, see the For information on automatically testing images, see the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
Kernel-Related Tasks Kernel-Related Tasks
==================== ====================

View File

@ -8688,8 +8688,8 @@ system and gives an overview of their function and contents.
file. file.
For more information on testing images, see the For more information on testing images, see the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
:term:`TEST_SERIALCONTROL_CMD` :term:`TEST_SERIALCONTROL_CMD`
For automated hardware testing, specifies the command to use to For automated hardware testing, specifies the command to use to
@ -8761,8 +8761,8 @@ system and gives an overview of their function and contents.
TEST_SUITES = "test_A test_B" TEST_SUITES = "test_A test_B"
For more information on testing images, see the For more information on testing images, see the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
:term:`TEST_TARGET` :term:`TEST_TARGET`
Specifies the target controller to use when running tests against a Specifies the target controller to use when running tests against a
@ -8780,8 +8780,8 @@ system and gives an overview of their function and contents.
You can provide the following arguments with :term:`TEST_TARGET`: You can provide the following arguments with :term:`TEST_TARGET`:
- *"qemu":* Boots a QEMU image and runs the tests. See the - *"qemu":* Boots a QEMU image and runs the tests. See the
":ref:`dev-manual/runtime-testing:enabling runtime tests on qemu`" section ":ref:`test-manual/runtime-testing:enabling runtime tests on qemu`" section
in the Yocto Project Development Tasks Manual for more in the Yocto Project Test Environment Manual for more
information. information.
- *"simpleremote":* Runs the tests on target hardware that is - *"simpleremote":* Runs the tests on target hardware that is
@ -8796,8 +8796,8 @@ system and gives an overview of their function and contents.
``meta/lib/oeqa/controllers/simpleremote.py``. ``meta/lib/oeqa/controllers/simpleremote.py``.
For information on running tests on hardware, see the For information on running tests on hardware, see the
":ref:`dev-manual/runtime-testing:enabling runtime tests on hardware`" ":ref:`test-manual/runtime-testing:enabling runtime tests on hardware`"
section in the Yocto Project Development Tasks Manual. section in the Yocto Project Test Environment Manual.
:term:`TEST_TARGET_IP` :term:`TEST_TARGET_IP`
The IP address of your hardware under test. The :term:`TEST_TARGET_IP` The IP address of your hardware under test. The :term:`TEST_TARGET_IP`
@ -8833,8 +8833,8 @@ system and gives an overview of their function and contents.
For more information For more information
on enabling, running, and writing these tests, see the on enabling, running, and writing these tests, see the
":ref:`dev-manual/runtime-testing:performing automated runtime testing`" ":ref:`test-manual/runtime-testing:performing automated runtime testing`"
section in the Yocto Project Development Tasks Manual and the section in the Yocto Project Test Environment Manual and the
":ref:`ref-classes-testimage`" section. ":ref:`ref-classes-testimage`" section.
:term:`THISDIR` :term:`THISDIR`

View File

@ -13,6 +13,7 @@ Yocto Project Test Environment Manual
intro intro
test-process test-process
ptest ptest
runtime-testing
understand-autobuilder understand-autobuilder
reproducible-builds reproducible-builds
yocto-project-compatible yocto-project-compatible

View File

@ -131,7 +131,9 @@ the following types of tests:
$ bitbake image -c testimage $ bitbake image -c testimage
The tests use the :ref:`ref-classes-testimage` The tests use the :ref:`ref-classes-testimage`
class and the :ref:`ref-tasks-testimage` task. class and the :ref:`ref-tasks-testimage` task. See the
:ref:`test-manual/runtime-testing:Performing Automated Runtime Testing`
section of the Yocto Project Test Environment Manual for more information.
- *Layer Testing:* The Autobuilder has the possibility to test whether - *Layer Testing:* The Autobuilder has the possibility to test whether
specific layers work with the test of the system. The layers tested specific layers work with the test of the system. The layers tested

View File

@ -1,5 +1,6 @@
.. SPDX-License-Identifier: CC-BY-SA-2.0-UK .. SPDX-License-Identifier: CC-BY-SA-2.0-UK
************************************
Performing Automated Runtime Testing Performing Automated Runtime Testing
************************************ ************************************
@ -153,7 +154,7 @@ options are available:
If you choose "SystemdbootTarget", there are additional requirements If you choose "SystemdbootTarget", there are additional requirements
and considerations. See the and considerations. See the
":ref:`dev-manual/runtime-testing:selecting systemdboottarget`" section, which ":ref:`test-manual/runtime-testing:selecting systemdboottarget`" section, which
follows, for more information. follows, for more information.
- *"BeagleBoneTarget":* Choose "BeagleBoneTarget" if you are deploying - *"BeagleBoneTarget":* Choose "BeagleBoneTarget" if you are deploying
@ -185,7 +186,7 @@ Selecting SystemdbootTarget
If you did not set :term:`TEST_TARGET` to "SystemdbootTarget", then you do If you did not set :term:`TEST_TARGET` to "SystemdbootTarget", then you do
not need any information in this section. You can skip down to the not need any information in this section. You can skip down to the
":ref:`dev-manual/runtime-testing:running tests`" section. ":ref:`test-manual/runtime-testing:running tests`" section.
If you did set :term:`TEST_TARGET` to "SystemdbootTarget", you also need to If you did set :term:`TEST_TARGET` to "SystemdbootTarget", you also need to
perform a one-time setup of your controller image by doing the following: perform a one-time setup of your controller image by doing the following: