PitchHut
Log in / Sign up
rallyup
6 views
Effortless power management for your infrastructure.
Pitch

rallyup is a lightweight Wake-On-LAN scheduler designed to streamline the startup of your business or homelab infrastructure. By managing the order in which services like firewalls and storage come online, it eliminates the hassle of manual reboots after power outages. With easy YAML configurations and VLAN support, rallyup ensures your environment is ready when you are.

Description

rallyup is an innovative Wake-On-LAN (WOL) scheduler and dependency manager tailored for small businesses and homelabs. With rallyup, your infrastructure services—such as firewalls, storage systems, and hypervisors—can be brought online efficiently in the correct sequence, particularly after unexpected events like power outages.

How It Works

To set up rallyup, configure most of your infrastructure for WOL, but not for Wake-On-Power. By setting rallyup to initiate on startup from a low-power device like a Raspberry Pi, you can easily power on your environment. Simply switch on the device running rallyup, and it will ensure the rest of your infrastructure powers up seamlessly in the appropriate order.

Key Features

  • VLAN Support: Send WOL packets to devices across various VLANs.
  • YAML Configuration: Effortlessly define server boot sequences, dependencies, and status checks.
  • Service Status Checks: Ensure that services are operational using built-in checks including HTTP health checks, NFS, SMB, and customizable shell commands.
  • Plugin-Friendly: Empower users to create their own custom status check plugins for tailored functionality.

Simple Usage

You can initiate rallyup with a single command:

rallyup servers.yaml

Configuration Flexibility

Define your server dependencies and health-check methods in a straightforward YAML configuration file. This enables enhanced control over the startup process of your infrastructure.

Example Server Configuration

Here’s an overview of how to configure your servers:

- name: "firewall"
  mac: "00:11:22:33:44:55"
  interface: "eth0"
  vlan: 100
  depends:
    - "storage"
  check: [... see below]

Each server can include multiple health checks tailored to ensure it's fully operational before booting the next device.

Health Check Options

  1. HTTP Health Checks: Monitor specific HTTP endpoints to ensure they return the expected responses.

    - type: http
      url: "http://192.168.1.1/health"
      status: 200
      retry: 5s
      timeout: 30s
    
  2. Port Health Checks: Verify open TCP ports, acting as placeholders for services like NFS and SMB until direct verification methods are established.

    - type: port
      ip: "192.168.1.1"
      port: 22
      retry: "10s"
      timeout: "1m"
    
  3. Shell Health Checks: Run user-defined shell commands to check service availability.

    - type: shell
      command: ping -c 1 192.168.1.1
      status: 0
      retry: 5s
      timeout: 20s
    

With rallyup, manage your WOL needs effectively, ensuring all systems come online in a controlled, dependable manner. Embrace the ease of infrastructure management with rallyup.