README.md
1# Crosvm Integration Tests
2
3These tests run a crosvm VM on the host to verify end to end behavior. They use a prebuilt guest
4kernel and rootfs, which is downloaded from google cloud storage.
5
6## Running with locally built kernel/rootfs
7
8If the test needs to run offline, or you want to make changes to the kernel or rootfs, you have to
9specify the environment variables `CROSVM_CARGO_TEST_KERNEL_BINARY` and
10`CROSVM_CARGO_TEST_ROOTFS_IMAGE` to point to the right files.
11
12The use_local_build.sh script does this for you:
13
14`$ source guest_under_test/use_local_build.sh`
15
16## Uploading prebuilts
17
18Note: Only Googlers with access to the crosvm-testing cloud storage bin can upload prebuilts.
19
20To upload the modified rootfs, you will have to uprev the `PREBUILT_VERSION` variable in:
21
22- `./guest_under_test/PREBUILT_VERSION`
23- `src/third_party/chromiumos-overlay/chromeos-base/crosvm/crosvm-9999.ebuild`
24
25Then run the upload script to build and upload the new prebuilts. **Never** try to modify an
26existing prebuilt as the new images may break tests in older versions.
27