heathcliff26/fleetlock repository overview

⁠FleetLock

Implements the FleetLock protocol⁠ of Zincati⁠ for coordinating upgrades of multiple Fedora CoreOS⁠ nodes.

⁠Table of Contents

• FleetLock⁠
  • Table of Contents⁠
  • Container Images⁠
    • Image location⁠
    • Tags⁠
  • Usage⁠
  • Examples⁠
    • Zincati configuration⁠
    • Deploying to kubernetes⁠
  • Links⁠

⁠Container Images

⁠Image location

⁠Tags

There are different flavors of the image:

⁠Usage

A simple example for testing:

podman run -d -p 8080:8080 ghcr.io/heathcliff26/fleetlock

A more advanced usage for production:

podman run -d -p 8080:8080 -v fleetlock-data:/data -v /path/to/config.yaml:/config/config.yaml ghcr.io/heathcliff26/fleetlock --config /config/config.yaml

⁠Examples

An example configuration can be found here⁠

⁠Zincati configuration

Here is an example Zincati configuration file /etc/zincati/config.d/50-updates-strategy.toml:

[identity]
group = "worker"
[updates]
strategy = "fleet_lock"
[updates.fleet_lock]
base_url = "http://fleetlock.example.org:8080/"

⁠Deploying to kubernetes

An example deployment can be found here⁠.

To deploy it to your cluster, run:

kubectl apply -f https://raw.githubusercontent.com/heathcliff26/fleetlock/main/examples/example-deployment.yaml

This will deploy the app to your cluster into the namespace fleetlock. You can then access the app under fleetlock.example.org

⁠Links

• Fedora CoreOS Auto Updates⁠
• FleetLock protocol⁠
• FleetLock update strategy⁠
• Zincati⁠