use std::error::Error; use thiserror::Error; /// Type-erased cfgsync adapter error used to preserve source context. pub type DynCfgsyncError = Box; /// Per-node rendered config output used to build cfgsync bundles. #[derive(Debug, Clone)] pub struct CfgsyncNodeConfig { /// Stable node identifier resolved by the adapter. pub identifier: String, /// Serialized config payload for the node. pub config_yaml: String, } /// Adapter contract for converting an application deployment model into /// node-specific serialized config payloads. pub trait CfgsyncEnv { type Deployment; type Node; type NodeConfig; type Error: Error + Send + Sync + 'static; fn nodes(deployment: &Self::Deployment) -> &[Self::Node]; fn node_identifier(index: usize, node: &Self::Node) -> String; fn build_node_config( deployment: &Self::Deployment, node: &Self::Node, ) -> Result; fn rewrite_for_hostnames( deployment: &Self::Deployment, node_index: usize, hostnames: &[String], config: &mut Self::NodeConfig, ) -> Result<(), Self::Error>; fn serialize_node_config(config: &Self::NodeConfig) -> Result; } /// High-level failures while building adapter output for cfgsync. #[derive(Debug, Error)] pub enum BuildCfgsyncNodesError { #[error("cfgsync hostnames mismatch (nodes={nodes}, hostnames={hostnames})")] HostnameCountMismatch { nodes: usize, hostnames: usize }, #[error("cfgsync adapter failed: {source}")] Adapter { #[source] source: DynCfgsyncError, }, } fn adapter_error(source: E) -> BuildCfgsyncNodesError where E: Error + Send + Sync + 'static, { BuildCfgsyncNodesError::Adapter { source: Box::new(source), } } /// Builds cfgsync node configs for a deployment by: /// 1) validating hostname count, /// 2) building each node config, /// 3) rewriting host references, /// 4) serializing each node payload. pub fn build_cfgsync_node_configs( deployment: &E::Deployment, hostnames: &[String], ) -> Result, BuildCfgsyncNodesError> { let nodes = E::nodes(deployment); ensure_hostname_count(nodes.len(), hostnames.len())?; let mut output = Vec::with_capacity(nodes.len()); for (index, node) in nodes.iter().enumerate() { output.push(build_node_entry::(deployment, node, index, hostnames)?); } Ok(output) } fn ensure_hostname_count(nodes: usize, hostnames: usize) -> Result<(), BuildCfgsyncNodesError> { if nodes != hostnames { return Err(BuildCfgsyncNodesError::HostnameCountMismatch { nodes, hostnames }); } Ok(()) } fn build_node_entry( deployment: &E::Deployment, node: &E::Node, index: usize, hostnames: &[String], ) -> Result { let node_config = build_rewritten_node_config::(deployment, node, index, hostnames)?; let config_yaml = E::serialize_node_config(&node_config).map_err(adapter_error)?; Ok(CfgsyncNodeConfig { identifier: E::node_identifier(index, node), config_yaml, }) } fn build_rewritten_node_config( deployment: &E::Deployment, node: &E::Node, index: usize, hostnames: &[String], ) -> Result { let mut node_config = E::build_node_config(deployment, node).map_err(adapter_error)?; E::rewrite_for_hostnames(deployment, index, hostnames, &mut node_config) .map_err(adapter_error)?; Ok(node_config) }