From a63ecf7b3c35870bcf58dfa1941d0be017b638b6 Mon Sep 17 00:00:00 2001 From: Arun Gupta Date: Fri, 21 Dec 2018 14:36:12 -0800 Subject: [PATCH 1/2] adding instructions to get started on AWS Signed-off-by: Arun Gupta --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/README.md b/README.md index 77fe0de..b775841 100644 --- a/README.md +++ b/README.md @@ -57,3 +57,48 @@ firectl \ --vsock-device=root:3 \ --metadata='{"foo":"bar"}' ``` + +Getting Started on AWS +--- + +- Create an `i3.metal` instance using Amazon Linux 2 +- Build latest version of firectl: + + ``` + sudo yum install -y git + git clone https://github.com/firecracker-microvm/firectl + sudo amazon-linux-extras install -y golang1.11 + cd firectl + make + ``` + +- Get Firecracker binary: + + ``` + curl -LOJ https://github.com/firecracker-microvm/firecracker/releases/download/v0.12.0/firecracker-v0.12.0 + chmod +x firecracker-v0.12.0 + sudo mv firecracker-v0.12.0 /usr/local/bin/firecracker + ``` + +- Give read/write access to KVM: + + ``` + sudo setfacl -m u:${USER}:rw /dev/kvm + ``` + +- Download kernel and root filesystem: + + ``` + curl -fsSL -o hello-vmlinux.bin https://s3.amazonaws.com/spec.ccfc.min/img/hello/kernel/hello-vmlinux.bin + curl -fsSL -o hello-rootfs.ext4 https://s3.amazonaws.com/spec.ccfc.min/img/hello/fsfiles/hello-rootfs.ext4 + ``` + +- Create microVM: + + ``` + firectl \ + --kernel=hello-vmlinux.bin \ + --root-drive=hello-rootfs.ext4 \ + --firecracker-log=./firecracker-vmm.log \ + --kernel-opts="console=ttyS0 noapic reboot=k panic=1 pci=off nomodules rw" + ``` From 200d1bc56534e85bb7d87e20445d8bac2255229c Mon Sep 17 00:00:00 2001 From: Arun Gupta Date: Fri, 21 Dec 2018 16:42:35 -0800 Subject: [PATCH 2/2] addressing the comments Signed-off-by: Arun Gupta --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index b775841..473e2dd 100644 --- a/README.md +++ b/README.md @@ -96,9 +96,8 @@ Getting Started on AWS - Create microVM: ``` - firectl \ + ./firectl \ --kernel=hello-vmlinux.bin \ --root-drive=hello-rootfs.ext4 \ - --firecracker-log=./firecracker-vmm.log \ --kernel-opts="console=ttyS0 noapic reboot=k panic=1 pci=off nomodules rw" ```