teaql-cloud-starter

One-line cloud bootstrap for TeaQL Rust services — the Spring Boot Starter equivalent.

Overview

Packages all cloud capabilities into a single CloudApp builder:

• Nacos v2 gRPC or Consul HTTP connection
• Service registration & discovery
• Configuration center (Nacos)
• Spring Boot Actuator-compatible endpoints (health/info/metrics)
• Graceful shutdown (SIGINT/SIGTERM)

Usage

use teaql_cloud_starter::CloudApp;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    CloudApp::new()
        // Use .nacos("127.0.0.1:8848") for Nacos or .consul("127.0.0.1:8500") for Consul
        .consul("127.0.0.1:8500")
        .namespace("production")
        .service_name("order-service-rust")
        .port(8080)
        .routes(my_business_routes())
        .start()
        .await?;
    // Graceful shutdown is handled automatically
    Ok(())
}

What start() Does

1. Connect to Nacos or Consul
2. Register service instance
3. Assemble Axum Router (your routes + actuator routes)
4. Start HTTP server
5. Wait for SIGINT/SIGTERM
6. Shutdown: readiness → OUT_OF_SERVICE → deregister → drain → exit

Auto-injected Components

• NacosCloud / ConsulCloud as HealthIndicator (registry connection health)
• NacosCloud / ConsulCloud as MetricsCollector (connection alive gauge)