swarm-controller: split main.rs into jobq, routes and startup modules
no behaviour change: a pure move of items and tests into new modules, plus visibility edits (pub(crate)) and path updates in sibling modules that named crate-root items. same routes, same OpenAPI, 561 tests before and after. why: #5470, new features stop landing in one 6.4k-line file by default. files outside swarm-controller/src: docs/agent-lifecycle/agent-roster.md, swarm-ui JobsPage.tsx and AgentsPage.tsx, nix/host-modules/swarm-controller.nix and swarm-grafana.nix hold comments that named main.rs for items that moved.
This commit is contained in:
parent
f0a6d6c042
commit
738dd1c95b
1 changed files with 6854 additions and 6680 deletions
126
swarm-controller/src/routes/hives.rs
Normal file
126
swarm-controller/src/routes/hives.rs
Normal file
|
|
@ -0,0 +1,126 @@
|
|||
//! The swarm's hive directory, service links and display name.
|
||||
|
||||
use anyhow::Result;
|
||||
use axum::{Json, extract::State};
|
||||
use serde::{Deserialize, Serialize};
|
||||
use utoipa::ToSchema;
|
||||
|
||||
use crate::routes::{AppState, StatusUnavailable};
|
||||
use crate::status;
|
||||
|
||||
/// One hive in the swarm's directory — the same `name`/`domain` pair
|
||||
/// `services.hyperhive.swarm.hives` (nix/host-modules/swarm.nix) declares,
|
||||
/// plus that hive's `swarm.dashboardDomains` entry, carried across
|
||||
/// unchanged rather than reshaped, so this stays a direct mirror of the
|
||||
/// nix source of truth instead of a second vocabulary for the same fields.
|
||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize, ToSchema)]
|
||||
pub(crate) struct HiveEntry {
|
||||
pub(crate) name: String,
|
||||
pub(crate) domain: String,
|
||||
/// The host the hive's dashboard answers on.
|
||||
pub(crate) dashboard: String,
|
||||
}
|
||||
|
||||
/// The swarm's hive directory — every hive, including whichever one this
|
||||
/// controller instance happens to run on (there is no "self" to exclude
|
||||
/// at the swarm level, unlike `hive-c0re`'s peer list).
|
||||
#[utoipa::path(
|
||||
get,
|
||||
path = "/api/hives",
|
||||
responses((status = 200, description = "every hive in the swarm", body = Vec<HiveEntry>)),
|
||||
tag = "hives"
|
||||
)]
|
||||
pub(crate) async fn get_hives(State(state): State<AppState>) -> Json<Vec<HiveEntry>> {
|
||||
Json((*state.hives).clone())
|
||||
}
|
||||
|
||||
/// One quick link to a swarm-wide service (authelia, matrix, forge, this
|
||||
/// daemon's own swagger UI, …). Deliberately generic rather than named
|
||||
/// fields per service: each service's own nix module contributes its own
|
||||
/// entry to `services.hyperhive.swarm.controller.links` (same list-merge
|
||||
/// idiom `services.hyperhive.gateway.localNames` already uses), so adding
|
||||
/// a new one is a nix-only change — no new field here, no swarm-ui change.
|
||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize, ToSchema)]
|
||||
pub(crate) struct ServiceLink {
|
||||
pub(crate) label: String,
|
||||
/// Emoji or short glyph. Empty string, not `Option`, when a
|
||||
/// contributing module has none — one fewer null-vs-absent case for
|
||||
/// the frontend to handle, and every real contributor sets one today.
|
||||
pub(crate) icon: String,
|
||||
pub(crate) url: String,
|
||||
}
|
||||
|
||||
/// Quick links to swarm-wide services (authelia, matrix, forge, this
|
||||
/// daemon's own swagger UI, …), as contributed by each service's own nix
|
||||
/// module. Empty when nothing was configured to contribute — a caller
|
||||
/// renders 0 links the same way it renders any other count, no special
|
||||
/// "not configured" case.
|
||||
#[utoipa::path(
|
||||
get,
|
||||
path = "/api/links",
|
||||
responses((status = 200, description = "swarm service quick links", body = Vec<ServiceLink>)),
|
||||
tag = "links"
|
||||
)]
|
||||
pub(crate) async fn get_links(State(state): State<AppState>) -> Json<Vec<ServiceLink>> {
|
||||
Json((*state.links).clone())
|
||||
}
|
||||
|
||||
/// Body of `GET /api/swarm`.
|
||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize, ToSchema)]
|
||||
pub(crate) struct SwarmInfo {
|
||||
/// `None` when the operator never set `services.hyperhive.swarm.name`
|
||||
/// — a caller (swarm-ui's chrome) falls back to a generic label rather
|
||||
/// than treating this as an error.
|
||||
name: Option<String>,
|
||||
}
|
||||
|
||||
/// The swarm's own display name, for UI chrome (page title, nav) that
|
||||
/// wants to say which swarm it's showing — distinct from [`get_hives`],
|
||||
/// which lists the *hives inside* the swarm, not the swarm itself.
|
||||
#[utoipa::path(
|
||||
get,
|
||||
path = "/api/swarm",
|
||||
responses((status = 200, description = "the swarm's display name, if the operator set one", body = SwarmInfo)),
|
||||
tag = "hives"
|
||||
)]
|
||||
pub(crate) async fn get_swarm_info(State(state): State<AppState>) -> Json<SwarmInfo> {
|
||||
Json(SwarmInfo {
|
||||
name: state.swarm_name.as_deref().map(str::to_owned),
|
||||
})
|
||||
}
|
||||
|
||||
/// What each hive last said about itself, read from the swarm queue at
|
||||
/// request time.
|
||||
///
|
||||
/// Every hive in the roster gets a row whether or not it has ever
|
||||
/// reported — see the `status` module for why absence, not presence, is
|
||||
/// the case this is built around.
|
||||
#[utoipa::path(
|
||||
get,
|
||||
path = "/api/hives/status",
|
||||
responses(
|
||||
(status = 200, description = "a row per hive, freshness derived now", body = Vec<status::HiveStatus>),
|
||||
(status = 503, description = "no swarm queue is configured here, or its store could not be read", body = String),
|
||||
),
|
||||
tag = "hives"
|
||||
)]
|
||||
pub(crate) async fn get_hives_status(
|
||||
State(state): State<AppState>,
|
||||
) -> Result<Json<Vec<status::HiveStatus>>, StatusUnavailable> {
|
||||
let Some(reader) = state.status.as_ref() else {
|
||||
return Err(StatusUnavailable(
|
||||
"no swarm queue is configured on this host".to_owned(),
|
||||
));
|
||||
};
|
||||
match reader
|
||||
.view(&state.hives, std::time::SystemTime::now())
|
||||
.await
|
||||
{
|
||||
Ok(rows) => Ok(Json(rows)),
|
||||
Err(e) => {
|
||||
let detail = format!("{e:#}");
|
||||
tracing::warn!(error = %detail, "reading the swarm status bucket failed");
|
||||
Err(StatusUnavailable(detail))
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Reference in a new issue