CloudApp Framework

中文版

A unified multi-cloud abstraction framework designed for seamless application deployment across different cloud providers. The CloudApp Framework encapsulates cloud vendor services through a unified SDK, eliminating vendor lock-in and enabling flexible multi-cloud deployments with a single codebase.

🎯 Project Overview

The CloudApp Framework addresses the critical challenge of vendor lock-in in cloud computing by providing:

• Unified SDK: Single API interface for multiple cloud providers
• Zero Vendor Lock-in: Switch between cloud providers without code changes
• Multi-Cloud Support: Deploy the same application across different cloud platforms
• Spring Boot Integration: Native Spring Boot auto-configuration and starter support
• Comprehensive Services: Complete PaaS service abstractions including storage, messaging, caching, and more

✨ Key Features

🔧 Core Capabilities

• Automatic Configuration: Zero-configuration Spring Boot integration
• Dynamic Refresh: Runtime configuration updates without restart
• Observability: Built-in metrics, logging, and tracing with OpenTelemetry
• Multi-Version Support: Compatible with Java 8+ and multiple Spring Boot versions

🌐 Distributed Services

• Object Storage: Unified file storage across cloud providers
• Messaging: Abstract messaging with Kafka and RocketMQ support
• Caching: Distributed Redis caching abstraction
• Configuration: Centralized configuration management
• Search: Elasticsearch integration for full-text search
• API Gateway: Service gateway abstraction

🚀 Enterprise Features

• Microservice Governance: Service discovery, load balancing, and traffic management
• Transaction Management: Distributed transaction support with Seata
• Security: OAuth2 authentication and authorization
• Data Management: Connection pooling with Druid
• Global Sequences: Distributed ID generation
• Email Services: Template-based email with Freemarker and Thymeleaf
• Task Scheduling: Distributed task scheduling capabilities

🛠️ Supported Middleware & Technologies

Messaging

• Apache Kafka
• Apache RocketMQ (including Alibaba Cloud RocketMQ)
• Spring Cloud Stream integration

Storage & Databases

• Redis (distributed caching)
• Elasticsearch (search and analytics)
• Druid (connection pooling)
• Multiple database drivers support

Microservices & Governance

• Spring Cloud Alibaba (Nacos, Dubbo)
• Spring Cloud (Service Discovery, Config)
• OpenTelemetry (observability)
• Seata (distributed transactions)

Security & Authentication

• OAuth2 / JWT
• Spring Security integration
• RBAC support

Development & Monitoring

• Spring Boot 2.7.x
• Maven build system
• OpenTelemetry metrics and tracing
• Prometheus integration
• Log4j2 with trace correlation

🚀 Quick Start

Prerequisites

• Java 8 or higher
• Maven 3.x
• Spring Boot 2.7.x

1. Add Dependencies

<dependency>
    <groupId>com.alibaba.cloudapp</groupId>
    <artifactId>spring-boot-starter-cloudapp</artifactId>
    <version>1.0.3</version>
</dependency>

<!-- Add specific cloud provider implementations -->
<dependency>
    <groupId>com.alibaba.cloudapp</groupId>
    <artifactId>cloudapp-spring-filestore-aliyun</artifactId>
    <version>1.0.3</version>
</dependency>

2. Configuration

io:
  cloudapp:
    filestore:
      aliyun:
        endpoint: your-oss-endpoint
        access-key-id: your-access-key
        access-key-secret: your-secret-key
        bucket-name: your-bucket

3. Usage

@Autowired
private ObjectStorageService objectStorageService;

public void uploadFile(String key, InputStream inputStream) {
    objectStorageService.putObject(key, inputStream);
}

📋 Module Structure

Core Modules

• cloudapp-framework-core - Core abstractions and utilities
  • cloudapp-base-api - Unified service interfaces
  • cloudapp-base-utils - Common utilities
  • spring-boot-starter-cloudapp - Spring Boot auto-configuration

PaaS Services

• cloudapp-framework-paas - Platform service implementations
  • cloudapp-spring-config - Configuration management
  • cloudapp-spring-filestore - Object storage (OSS, OBS, MinIO)
  • cloudapp-spring-messaging - Messaging (Kafka, RocketMQ)
  • cloudapp-spring-redis - Distributed caching
  • cloudapp-spring-search - Search services (Elasticsearch)
  • cloudapp-spring-apigateway - API gateway integration
  • cloudapp-spring-scheduler - Task scheduling

Microservices

• cloudapp-framework-microservices - Microservice governance
  • cloudapp-microservice-aliyun - Alibaba Cloud microservice support
  • cloudapp-microservice-huawei - Huawei Cloud microservice support

Observability

• cloudapp-framework-observabilities - Monitoring and observability
  • cloudapp-observabilities-opentelemetry - OpenTelemetry integration

Tools & Extensions

• cloudapp-framework-tools - Additional tools and integrations
  • cloudapp-datasource-druid - Database connection pooling
  • cloudapp-spring-mail - Email services
  • cloudapp-spring-oauth2 - OAuth2 security
  • cloudapp-spring-seata - Distributed transactions
  • cloudapp-spring-sequence - Global sequence generation

Demos & Examples

• cloudapp-framework-demos - Complete demo applications for each service

🔧 Build & Development

Build from Source

git clone https://github.com/alibaba/cloudapp-framework.git
cd cloudapp-framework
mvn clean install

Run Tests

mvn test

Run Specific Demo

cd cloudapp-framework-demos/cloudapp-filestore-demo/cloudapp-filestore-demo-aliyun
mvn spring-boot:run

📖 Documentation

Comprehensive documentation for each service:

• Object Storage Design & Usage
• Messaging Design & Usage
• Caching Design & Usage
• Configuration Design & Usage
• Search Design & Usage
• API Gateway Design & Usage
• Microservice Governance
• Observability Design & Usage
• More Documentation...

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.