Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/squat/modulus
Automatically compile kernel modules for Flatcar Linux / CoreOS Container Linux
https://github.com/squat/modulus
container-linux coreos drivers flatcar flatcar-linux gpu kernel-modules kubernetes nvidia
Last synced: 3 months ago
JSON representation
Automatically compile kernel modules for Flatcar Linux / CoreOS Container Linux
- Host: GitHub
- URL: https://github.com/squat/modulus
- Owner: squat
- License: mit
- Created: 2017-03-29T21:28:29.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2023-10-09T11:21:03.000Z (over 1 year ago)
- Last Synced: 2023-10-09T12:32:49.335Z (over 1 year ago)
- Topics: container-linux, coreos, drivers, flatcar, flatcar-linux, gpu, kernel-modules, kubernetes, nvidia
- Language: Shell
- Homepage:
- Size: 157 KB
- Stars: 35
- Watchers: 4
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# modulus
Automatically compile kernel modules for Flatcar Linux.
[](https://github.com/squat/modulus/actions?query=workflow%3ACI)
## Installation
To deploy Modulus to a Kubernetes cluster to install and maintain NVIDIA GPU drivers, run:
```sh
kubectl apply -f https://raw.githubusercontent.com/squat/modulus/main/nvidia/daemonset.yaml
```
## Background
Compiling drivers on Flatcar Linux is typically non-trivial because the OS ships without build tools and no obvious way to access the kernel sources.
Modulus works by compiling your kernel modules inside of a Flatcar Linux developer Flatcar as documented in [[1](https://github.com/coreos/docs/blob/master/os/kernel-modules.md)] and used in [[2](https://github.com/Clarifai/coreos-nvidia)].
Furthermore, because Flatcar Linux updates automatically to keep your machine secure, your kernel modules can easily become out of date.
Modulus automatically compiles kernel modules for the new version of Flatcar Linux when your OS is upgrading so that the new modules are available when your machine restarts.
Modulus can be used as a Kubernetes DaemonSet to maintain worker nodes up to date or as a systemd template unit and can be coupled with any script that compiles kernel modules.
This project currently supports generating NVIDIA and WireGuard kernel modules, however it can be extended to support any module.
[1] https://github.com/coreos/docs/blob/master/os/kernel-modules.md
[2] https://github.com/Clarifai/coreos-nvidia
## Compiling NVIDIA Kernel Modules
Modulus makes it easy to automatically compile kernel modules for NVIDIA GPUs. See the [NVIDIA README](https://github.com/squat/modulus/blob/main/nvidia/README.md) for detailed instructions.
## Compiling WireGuard Kernel Modules
See the [WireGuard README](https://github.com/squat/modulus/blob/main/wireguard/README.md) for detailed instructions.
## Distribution
After compiliation, Modulus installs all the compiled assets and caches them on disk. Modulus also automatically tries to upload your compiled kernel modules to S3 so that you can compile the drivers once and reuse them across multiple machines. To enable this functionality, provide the following environment variables to the Modulus DaemonSet:
```
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
MODULUS_S3_BUCKET=s3://your.s3/bucket-name/
```
## Systemd Installation
Modulus can also be used as a set of Systemd services without depending on Kubernetes:
```sh
sudo git clone https://github.com/squat/modulus.git /opt/modulus
sudo cp /opt/modulus/[email protected] /etc/systemd/system/[email protected]
```