diff options
author | Jaewan Kim <jaewan@google.com> | 2024-05-16 12:48:36 +0000 |
---|---|---|
committer | Gerrit Code Review <noreply-gerritcodereview@google.com> | 2024-05-16 12:48:36 +0000 |
commit | b90bee55cdb9643b50c4a5d75a56762c2ac8d537 (patch) | |
tree | 1f101bc779eb0093e7fbfd3c5a02ae6a7c6b5f79 | |
parent | f2b490da82127b76db67f181d83b006f00d0e1e1 (diff) | |
parent | 9948368ec95886d2f0d99bab6fbef9b46f5202b1 (diff) | |
download | Virtualization-b90bee55cdb9643b50c4a5d75a56762c2ac8d537.tar.gz |
Merge "doc: Update instruction for downloading ferrochrome image" into main
-rw-r--r-- | docs/custom_vm.md | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/docs/custom_vm.md b/docs/custom_vm.md index 57a1b0d5..36f5998e 100644 --- a/docs/custom_vm.md +++ b/docs/custom_vm.md @@ -34,6 +34,21 @@ To run OSes with graphics support, follow the instruction below. As of today (April 2024), ChromiumOS is the only officially supported guest payload. We will be adding more OSes in the future. +#### Download from build server + + - Step 1) Go to the link https://ci.chromium.org/ui/p/chromeos/builders/chromiumos/ferrochrome-public-main/ + - Note: I 'searched' the ferrochrome target with builder search. + - Step 2) Click a build number + - Step 3) Expand steps and find `48. upload artifacts`. + - Step 4) Click `gs upload dir`. You'll see Cloud storage with comprehensive artifacts (e.g. [Here](https://pantheon.corp.google.com/storage/browser/chromiumos-image-archive/ferrochrome-public/R126-15883.0.0) is the initial build of ferrochrome) + - Step 5) Download `image.zip`, which contains working vmlinuz. + - Note: DO NOT DOWNLOAD `vmlinuz.tar.xz` from the CI. + - Step 6) Uncompress `image.zip`, and boot with `chromiumos_test_image.bin` and `boot_images/vmlinuz`. + - Note: DO NOT USE `vmlinuz.bin`. + +IMPORTANT: DO NOT USE `vmlinuz.bin` for passing to crosvm. It doesn't pick-up the correct `init` process (picks `/init` instead of `/sbin/init`, and `cfg80211` keeps crashing (i.e. no network) + + #### Build ChromiumOS for VM First, check out source code from the ChromiumOS and Chromium projects. @@ -122,7 +137,7 @@ Don’t forget to call `build-image` afterwards. You need two outputs: * ChromiumOS disk image: ~/chromiumos/src/build/images/ferrochrome/latest/chromiumos_test_image.bin -* The kernel: ~/chromiumos/out/build/ferrochrome/boot/vmlinuz +* The kernel: ~/chromiumos/src/build/images/ferrochrome/latest/boot_images/vmlinuz ### Create a guest VM configuration |