Skip to content

Commit e5994ca

Browse files
README and docs added
1 parent 91063d6 commit e5994ca

File tree

3 files changed

+86
-2
lines changed

3 files changed

+86
-2
lines changed

README.md

Lines changed: 82 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,82 @@
1-
# firecracker-vmbuilder
2-
VMBuilder for Firecracker based systems
1+
<div><img src="docs/img/img.png" width="100"/><h1>Firecracker RootFS Handler</h1></div>
2+
3+
Firecracker RootFS handler is a simple project to create root-file-system with Docker images in ext4 format and allows you to run them in micro-vms by Firecracker.
4+
5+
## Features
6+
- Convert Docker images to rootFS
7+
- Store them locally (Registry soon ...)
8+
9+
## Installation
10+
11+
To install OpenMetricMigrator, clone the repository and build the project:
12+
13+
```sh
14+
# Clone the repository
15+
git clone https://github.com/WoodProgrammer/firecracker-rootfs-builder.git
16+
17+
cd firecracker-rootfs-builder
18+
19+
go build -o fco .
20+
21+
mv fco /usr/local/bin
22+
```
23+
24+
## Usage
25+
26+
Run the tool with the required options:
27+
28+
```sh
29+
30+
cat <<EOF>config.yaml
31+
32+
image: alpine
33+
docker_file: Dockerfile
34+
context: "."
35+
target_directory: "alpine-rootfs"
36+
37+
EOF
38+
39+
./fco -C config.yaml
40+
```
41+
42+
Config file contains docker image spec and rootfs details.Apart from these details you can basically pass the rootFS size and name as well. (Needs to improve)
43+
44+
### Available Flags
45+
46+
47+
```sh
48+
49+
CLI tool to manage RootFS for firecracker micro VMs
50+
51+
Usage:
52+
rootfsCreator [flags]
53+
54+
Flags:
55+
-C, --config string Config file of RootFS creation (default "config.yaml")
56+
-F, --filesystem-name string Name of rootfs (default "rootfs")
57+
-S, --filesystem-size int Size of rootfs (default 10)
58+
-h, --help help for rootfsCreator
59+
60+
```
61+
62+
## Example
63+
64+
Convert an OpenMetrics file to a Prometheus-compatible format:
65+
66+
```sh
67+
fco -C config.yaml
68+
```
69+
70+
## Contributing
71+
72+
Contributions are welcome! Feel free to submit issues or pull requests to improve the tool.
73+
74+
## Contact
75+
76+
For any questions or feedback, feel free to open an issue on GitHub.
77+
78+
## TO DO ;
79+
80+
* Adjustable command args
81+
* Registry ability
82+
* More use cases on test suits

docs/img/config.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
image: alpine
2+
docker_file: Dockerfile
3+
context: "."
4+
target_directory: "alpine-rootfs"

docs/img/img.png

140 KB
Loading

0 commit comments

Comments
 (0)