https://github.com/threefoldtech/cloud-container
A builder for a simple initramfs image to run container over virtiofs inside cloud-hypervisor
https://github.com/threefoldtech/cloud-container
Last synced: 9 months ago
JSON representation
A builder for a simple initramfs image to run container over virtiofs inside cloud-hypervisor
- Host: GitHub
- URL: https://github.com/threefoldtech/cloud-container
- Owner: threefoldtech
- License: apache-2.0
- Created: 2021-06-08T15:58:28.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-13T12:33:26.000Z (over 1 year ago)
- Last Synced: 2024-06-21T20:03:51.127Z (over 1 year ago)
- Language: Go
- Size: 125 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
## Introduction
cloud-container is only a builder for a custom initramfs image that allows running containers on `cloud-hypervisor`. The container root is served over `virtiofs`.
The image does the following for this to work:
- [x] Add all required `virtio` modules to support `virtiofs`, `pci`, and `disks`
- [x] Expose environment variables from `/etc/environment` to the container `entrypoint`. A container manager then can simply write down the /etc/environment file in the container root before booting.
- [x] Pre mount attached disks to configured endpoints
- [x] Configure network interface via cmdline argument passed to the kernel [setupnetwork](setupnetwork)
### kernel arguments
- `net_ethX=SPEC` argument to configure each interface *TO BE DEFINED*
- `mnt_vdX=/path` auto mount disk to given end point *TODO*
### Building
**pre-requirements**: `docker`
This will build the required initram-fs
Run
```bash
./build.sh
```
To build the kernel, use the `config` file from the repo to build the kernel. This is only tested with linux 5.12.9. This will be automated later in this repo as well. buf for now you have to do do it manually.
### Testing container
**pre-requirement**: `virtiofsd`, `cloud-hypervisor`
extract a container root (or mount a container flist)
> to edit the environment variables available to your entrypoint you have to edit `/etc/environment`
Run
```bash
./test.sh [entrypoint]
```
default entrypoint in `/bin/bash`