[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH v7 12/13] tests: Add README for vm tests
From: |
Alex Bennée |
Subject: |
Re: [Qemu-devel] [PATCH v7 12/13] tests: Add README for vm tests |
Date: |
Fri, 15 Sep 2017 15:24:43 +0100 |
User-agent: |
mu4e 0.9.19; emacs 25.2.50.3 |
Fam Zheng <address@hidden> writes:
> Signed-off-by: Fam Zheng <address@hidden>
> ---
> tests/vm/README | 63
> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
> 1 file changed, 63 insertions(+)
> create mode 100644 tests/vm/README
>
> diff --git a/tests/vm/README b/tests/vm/README
> new file mode 100644
> index 0000000000..7d2fe4ac8d
> --- /dev/null
> +++ b/tests/vm/README
> @@ -0,0 +1,63 @@
> +=== VM test suite to run build in guests ===
> +
> +== Intro ==
> +
> +This test suite contains scripts that bootstrap various guest images that
> have
> +necessary packages to build QEMU. The basic usage is documented in Makefile
> +help which is displayed with "make vm-test".
> +
> +== Quick start ==
> +
> +Run "make vm-test" to list available make targets.
Running make vm-build-netbsd I get several prompts for pass-phrase and
password:
Enter passphrase for key './vm-test-QdFtLJ.tmp/id_rsa':
Password for qemu@:
Enter passphrase for key './vm-test-QdFtLJ.tmp/id_rsa':
Password for qemu@:
ar: creating libfdt/libfdt.a
Which seems odd considering the private key isn't protected by a
passphrase and the build tools know what the password is.
We should also mention the images are added to ${QEMU_SRC}/tests/vm/
> +
> +== Manual invocation ==
> +
> +Each guest script is an executable script with the same command line options.
> +For example to work with the netbsd guest, use $QEMU_SRC/tests/vm/netbsd:
> +
> + $ cd $QEMU_SRC/tests/vm
> +
> + # To bootstrap the image
> + $ ./netbsd --build-image --image /var/tmp/netbsd.img
> + <...>
> +
> + # To run an arbitrary command in guest (the output will not be echoed
> unless
> + # --debug is added)
> + $ ./netbsd --debug --image /var/tmp/netbsd.img uname -a
> +
> + # To build QEMU in guest
> + $ ./netbsd --debug --image /var/tmp/netbsd.img --build-qemu $QEMU_SRC
> +
> + # To get to an interactive shell
> + $ ./netbsd --interactive --image /var/tmp/netbsd.img sh
> +
> +== Adding new guests ==
> +
> +Please look at existing guest scripts for how to add new guests.
> +
> +Most importantly, create a subclass of BaseVM and implement build_image()
> +method and define BUILD_SCRIPT, then finally call basevm.main() from the
> +script's main().
> +
> + - Usually in build_image(), a template image is downloaded from a
> predefined
> + URL. BaseVM._download_with_cache() takes care of the cache and the
> + checksum, so consider using it.
> +
> + - Once the image is downloaded, users, SSH server and QEMU build deps
> should
> + be set up:
> +
> + * Root password set to BaseVM.ROOT_PASS
> + * User BaseVM.GUEST_USER is created, and password set to
> BaseVM.GUEST_PASS
> + * SSH service is enabled and started on boot, BaseVM.SSH_PUB_KEY is added
> + to authorized_keys of both root and the normal user
> + * DHCP client service is enabled and started on boot, so that it can
> + automatically configure the virtio-net-pci NIC and communicate with
> QEMU
> + user net (10.0.2.2)
> + * Necessary packages are installed to untar the source tarball and build
> + QEMU
> +
> + - Write a proper BUILD_SCRIPT template, which should be a shell script that
> + untars a raw virtio-blk block device, which is the tarball data blob of
> the
> + QEMU source tree, then configure/build it. Running "make check" is also
> + recommended.
> +
--
Alex Bennée
- [Qemu-devel] [PATCH v7 05/13] tests: Add vm test lib, (continued)
- [Qemu-devel] [PATCH v7 05/13] tests: Add vm test lib, Fam Zheng, 2017/09/12
- [Qemu-devel] [PATCH v7 06/13] tests: Add ubuntu.i386 image, Fam Zheng, 2017/09/12
- [Qemu-devel] [PATCH v7 07/13] tests: Add FreeBSD image, Fam Zheng, 2017/09/12
- [Qemu-devel] [PATCH v7 08/13] tests: Add NetBSD image, Fam Zheng, 2017/09/12
- [Qemu-devel] [PATCH v7 09/13] tests: Add OpenBSD image, Fam Zheng, 2017/09/12
- [Qemu-devel] [PATCH v7 10/13] Makefile: Add rules to run vm tests, Fam Zheng, 2017/09/12
- [Qemu-devel] [PATCH v7 11/13] MAINTAINERS: Add tests/vm entry, Fam Zheng, 2017/09/12
- [Qemu-devel] [PATCH v7 12/13] tests: Add README for vm tests, Fam Zheng, 2017/09/12
- Re: [Qemu-devel] [PATCH v7 12/13] tests: Add README for vm tests,
Alex Bennée <=
- [Qemu-devel] [PATCH v7 13/13] docker: Use archive-source.py, Fam Zheng, 2017/09/12
- Re: [Qemu-devel] [PATCH v7 00/13] tests: Add VM based build tests (for non-x86_64 and/or non-Linux), no-reply, 2017/09/12