Struct CloudApp 

pub struct CloudApp { /* private fields */ }

Cloud application builder — one-line bootstrap for all cloud capabilities.

CloudApp::start() internally executes:

1. Connect to Nacos (gRPC)
2. Register service instance
3. Assemble Axum Router (business routes + actuator routes)
4. Bind port, start HTTP server
5. Listen for SIGINT/SIGTERM → graceful shutdown → deregister

Implementations

impl CloudApp

pub fn new() -> Self

Create a new CloudApp builder with sensible defaults.

pub fn nacos(self, addr: impl Into<String>) -> Self

Set the Nacos server address (e.g. “127.0.0.1:8848”).

pub fn consul(self, addr: impl Into<String>) -> Self

Set the Consul server address (e.g. “127.0.0.1:8500”).

pub fn namespace(self, ns: impl Into<String>) -> Self

Set the Nacos namespace.

pub fn service_name(self, name: impl Into<String>) -> Self

Set the service name for registration.

pub fn ip(self, ip: impl Into<String>) -> Self

Set the bind IP address (default: “0.0.0.0”).

pub fn port(self, port: u16) -> Self

Set the HTTP port (default: 8080).

pub fn routes(self, routes: Router) -> Self

Set the business routes.

pub fn health_indicator(self, indicator: Arc<dyn HealthIndicator>) -> Self

Add a health indicator.

pub fn metrics_collector(self, collector: Arc<dyn MetricsCollector>) -> Self

Add a metrics collector.

pub fn version(self, version: impl Into<String>) -> Self

Set the service version.

pub fn auth( self, username: impl Into<String>, password: impl Into<String>, ) -> Self

Set the Nacos authentication credentials.

pub fn group(self, group: impl Into<String>) -> Self

Set the Nacos group.

pub fn service_info(self, info: ServiceInfo) -> Self

Set the service info (build metadata).

pub async fn start(self) -> Result<(), CloudError>

Start the cloud application.

This method:

1. Connects to Nacos via gRPC
2. Registers the service instance
3. Merges business routes with actuator routes
4. Starts the HTTP server
5. Waits for shutdown signal, then gracefully shuts down

This method blocks until the application shuts down.

Trait Implementations

impl Default for CloudApp

fn default() -> Self

Returns the “default value” for a type.