Skip to content

Commit

Permalink
Merge remote-tracking branch 'upstream/pr/4'
Browse files Browse the repository at this point in the history
  • Loading branch information
Noah Meyerhans committed Dec 22, 2018
2 parents 0a3e7ab + 200d1bc commit 4d168ef
Showing 1 changed file with 44 additions and 0 deletions.
44 changes: 44 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,47 @@ 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 \
--kernel-opts="console=ttyS0 noapic reboot=k panic=1 pci=off nomodules rw"
```

0 comments on commit 4d168ef

Please sign in to comment.