teaql-cloud-starter 4.2.1

One-line cloud bootstrap for TeaQL Rust services (Spring Boot Starter equivalent)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# 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

```rust
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)