aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJaewan Kim <jaewan@google.com>2024-05-16 12:48:36 +0000
committerGerrit Code Review <noreply-gerritcodereview@google.com>2024-05-16 12:48:36 +0000
commitb90bee55cdb9643b50c4a5d75a56762c2ac8d537 (patch)
tree1f101bc779eb0093e7fbfd3c5a02ae6a7c6b5f79
parentf2b490da82127b76db67f181d83b006f00d0e1e1 (diff)
parent9948368ec95886d2f0d99bab6fbef9b46f5202b1 (diff)
downloadVirtualization-b90bee55cdb9643b50c4a5d75a56762c2ac8d537.tar.gz
Merge "doc: Update instruction for downloading ferrochrome image" into main
-rw-r--r--docs/custom_vm.md17
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