https://github.com/welteki/nix-faas

Tools for building (and deploying) OpenFaaS functions with Nix/NixOS.
https://github.com/welteki/nix-faas

Last synced: 19 days ago
JSON representation

Tools for building (and deploying) OpenFaaS functions with Nix/NixOS.

• Host: GitHub
• URL: https://github.com/welteki/nix-faas
• Owner: welteki
• License: mit
• Created: 2022-01-18T17:53:20.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-03-10T14:55:27.000Z (8 months ago)
• Last Synced: 2024-04-18T00:00:50.610Z (7 months ago)
• Language: Nix
• Size: 12.3 MB
• Stars: 8
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
> 🛠 **Status: Early experimental phase**

>

> This project is very much a work in progress. What you see here is only an early preview of the project.

## Part one: nix openfaas tools

Build [OpenFaas](https://www.openfaas.com/) function images with Nix.

```nix

{pkgs, ...}:

let

    inherit (pkgs.pkgsStatic) figlet;

in

pkgs.ofTools.buildOfImage {

    name = "figlet";

    tag = "latest";

    watchdog = "of-watchdog";

    watchdogMode = "serializing";

    fprocess = "${figlet}/bin/figlet";

}

```

This example recreates the figlet image from the openfaas store but uses the `of-watchdog` instead of the `classic-watchdog` used in the original image.

## Part two: CLI and NixOS modules

> Not yet part of the repo but hope to publish it soon.

Instead of configuring functions in YAML files `nix-faas` will use the Nix language to build and configure functions (similar to what [Arion](https://github.com/hercules-ci/arion) does for docker-compose).

The `nix-faas` cli will be a wrapper around the [faas-cli](https://github.com/openfaas/faas-cli) making it possible to deploy Nix defined function to any system running [OpenFaaS](https://www.openfaas.com/).