Files
wild-cloud/api
Paul Payne 7a3ef65683 Refactor upgrade plan computation to support new app.yaml structure
- Updated `checkSourceDrift` to read version from app.yaml and corresponding slot manifest.
- Introduced `computeUpgradePlanFromMeta` to handle upgrade plans using centralized routing rules from app.yaml.
- Enhanced `ComputeUpgradePlan` to fallback to old-style manifest.yaml if app.yaml is not present.
- Added tests for both new and old upgrade plan computation methods, ensuring backward compatibility.
- Improved handling of upgrade paths, including waypoint resolution and circular dependency detection.
2026-05-24 18:30:00 +00:00
..
2026-01-09 09:43:12 -08:00
2026-05-24 03:59:36 +00:00
2026-01-09 09:43:12 -08:00
2026-02-28 20:51:46 +00:00
2026-01-09 09:43:12 -08:00
2026-02-28 20:51:46 +00:00
2026-02-28 20:51:46 +00:00
2026-01-09 09:43:12 -08:00
2026-01-09 09:43:12 -08:00
2026-05-17 19:11:10 +00:00

Wild Central API

The Wild Central API is a lightweight service that runs on a local machine (e.g., a Raspberry Pi) to manage Wild Cloud instances on the local network. It provides an interface for users to interact with and manage their Wild Cloud environments.

Development

Start the development server:

make dev

The API will be available at http://localhost:5055.

Environment Variables

  • WILD_API_DATA_DIR - Directory for instance data (default: /var/lib/wild-central)
  • WILD_DIRECTORY - Path to Wild Cloud apps directory (default: /opt/wild-cloud/apps)
  • WILD_API_DNSMASQ_CONFIG_PATH - Path to dnsmasq config file (default: /etc/dnsmasq.d/wild-cloud.conf)
  • WILD_CORS_ORIGINS - Comma-separated list of allowed CORS origins for production (default: localhost development origins)

API Endpoints

The API provides the following endpoint categories:

  • Instances - Create, list, get, and delete Wild Cloud instances
  • Configuration - Manage instance config.yaml
  • Secrets - Manage instance secrets.yaml (redacted by default)
  • Nodes - Discover, configure, and manage cluster nodes
  • Cluster - Bootstrap and manage Talos/Kubernetes clusters
  • Apps - Deploy and manage Wild Cloud packages (infrastructure services and applications)
  • PXE - Manage PXE boot assets for network installation
  • Operations - Track and stream long-running operations
  • Utilities - Helper functions and status endpoints
  • dnsmasq - Configure and manage dnsmasq for network services

See the API handler files in internal/api/v1/ for detailed endpoint documentation.