@@ -4,7 +4,7 @@ Thanks for your interest in using containerd and Firecracker together! This
4
4
project is currently in a very early state, and things are not yet as
5
5
plug-and-play as we'd like. This guide contains general instructions for
6
6
getting started, but is more descriptive than a concrete set of step-by-step
7
- instructions.
7
+ instructions.
8
8
9
9
If you prefer to follow a script, you can use the
10
10
[ quickstart guide] ( quickstart.md ) instead.
@@ -16,12 +16,12 @@ You need to have the following things in order to use firecracker-containerd:
16
16
* A computer with a recent-enough version of Linux (4.14+), an Intel x86_64
17
17
processor (AMD and Arm are on the roadmap, but not yet supported), and KVM
18
18
enabled. An i3.metal running Amazon Linux 2 is a good candidate.
19
-
19
+
20
20
<details >
21
-
21
+
22
22
<summary >Click here to see a bash script that will check if your system meets
23
23
the basic requirements to run Firecracker.</summary >
24
-
24
+
25
25
``` bash
26
26
#! /bin/bash
27
27
err=" " ; \
@@ -35,12 +35,12 @@ You need to have the following things in order to use firecracker-containerd:
35
35
&& echo " WARNING: you are running in a virtual machine. Firecracker is not well tested under nested virtualization." ; \
36
36
[ -z " $err " ] && echo " Your system looks ready for Firecracker!" || echo -e " $err "
37
37
```
38
-
38
+
39
39
</details >
40
40
* git
41
41
* A root filesystem image (you can use the one
42
42
[ described here] ( https://github.com/firecracker-microvm/firecracker/blob/main/docs/getting-started.md#running-firecracker )
43
- as ` hello-rootfs.ext4 ` ).
43
+ as ` hello-rootfs.ext4 ` ).
44
44
* A recent installation of [ Docker CE] ( https://docker.com ) .
45
45
* Go 1.13 or later, which you can download from [ here] ( https://golang.org/dl/ ) .
46
46
@@ -226,8 +226,6 @@ configuration file has the following fields:
226
226
* ` root_drive ` (optional) - A path where the root drive image file is located. A
227
227
fully-qualified path is recommended. If left undefined, the runtime looks for
228
228
a file named ` /var/lib/firecracker-containerd/runtime/default-rootfs.img ` .
229
- * ` cpu_count ` (optional) - The number of vCPUs to make available to a microVM.
230
- If left undefined, the default is 1.
231
229
* ` cpu_template ` (required) - The Firecracker CPU emulation template. Supported
232
230
values are "C3" and "T2".
233
231
* ` additional_drives ` (unused)
@@ -295,7 +293,7 @@ $ sudo firecracker-ctr --address /run/firecracker-containerd/containerd.sock \
295
293
docker.io/library/busybox:latest busybox-test
296
294
```
297
295
298
- Alternatively you can specify ` --runtime ` and ` --snapshotter ` just once when
296
+ Alternatively you can specify ` --runtime ` and ` --snapshotter ` just once when
299
297
creating a new namespace using containerd's default labels:
300
298
301
299
``` bash
@@ -313,11 +311,11 @@ $ sudo firecracker-ctr --address /run/firecracker-containerd/containerd.sock \
313
311
docker.io/library/busybox:latest busybox-test
314
312
```
315
313
316
- ## Networking support
317
- Firecracker-containerd supports the same networking options as provided by the
314
+ ## Networking support
315
+ Firecracker-containerd supports the same networking options as provided by the
318
316
Firecracker Go SDK, [ documented here] ( https://github.com/firecracker-microvm/firecracker-go-sdk#network-configuration ) .
319
317
This includes support for configuring VM network interfaces both with
320
- pre-created tap devices and with tap devices created automatically by
318
+ pre-created tap devices and with tap devices created automatically by
321
319
[ CNI] ( https://github.com/containernetworking/cni ) plugins.
322
320
323
321
### CNI Setup
@@ -330,7 +328,7 @@ Production deployments should be sure to choose a network configuration suitale
330
328
to the specifics of the environment and workloads being hosting, with particular
331
329
attention being given to network isolation between tasks.
332
330
333
- To install the required CNI dependencies, run the following make target from the
331
+ To install the required CNI dependencies, run the following make target from the
334
332
previously cloned firecracker-containerd repository:
335
333
336
334
``` bash
0 commit comments