How apolloconfig/apollo works
Apollo is a centralized configuration-management system. Administrators manage applications, clusters, namespaces, and key/value items through the Portal; changes are published as versioned releases, then configuration clients can receive updates in real time. The tree and excerpts support the Portal search and business-service responsibilities, release/namespace handling, audit, and config-service notification/synchronization areas. Several server subsystems are represented at their exact tree paths but were not sampled, so their internal calls are not asserted.
Main entry points: controller Admin endpoints · ReleaseService.java Release management · NamespaceService.java App and namespace · AdminServiceAPI.java Admin API
Components 18
Portal and APIs
- Portal interface
apollo-portal/src/main/java/com/ctrip/framework/apollo/openapi/v1/controller/PortalManagementController.java - Global search
apollo-portal/src/main/java/com/ctrip/framework/apollo/portal/service/GlobalSearchService.java - Role permissions
apollo-portal/src/main/java/com/ctrip/framework/apollo/portal/service/SystemRoleManagerService.java - Open API consumers
apollo-portal/src/main/java/com/ctrip/framework/apollo/openapi/service/ConsumerService.java - Admin API
apollo-portal/src/main/java/com/ctrip/framework/apollo/portal/api/AdminServiceAPI.java
Configuration administration
- Admin endpoints
apollo-adminservice/src/main/java/com/ctrip/framework/apollo/adminservice/controller - App and namespace
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/service/NamespaceService.java - Configuration items
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/service/ItemService.java - Release management
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/service/ReleaseService.java - Business settings
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/config/BizConfig.java
Release delivery
- Config endpoints
apollo-configservice/src/main/java/com/ctrip/framework/apollo/configservice/controller - Incremental sync
apollo-configservice/src/main/java/com/ctrip/framework/apollo/configservice/service/config/DefaultIncrementalSyncService.java - Release messages
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/message/ReleaseMessageScanner.java
Audit and discovery
- Operation audit
apollo-audit/apollo-audit-impl/src/main/java/com/ctrip/framework/apollo/audit/service/ApolloAuditLogService.java - Service discovery
apollo-configservice/src/main/java/com/ctrip/framework/apollo/metaservice/service/DatabaseDiscoveryService.java
Other components
- Administrator
- MySQL
- Configuration clients
Connections 20
- Administrator → Portal interface: manages configuration
README.md - Portal interface → Admin API: uses admin API
- Admin API → Admin endpoints: routes requests
- Admin endpoints → App and namespace: manages namespaces
apollo-adminservice/src/main/java/com/ctrip/framework/apollo/adminservice/controller/ItemController.java - Admin endpoints → Configuration items: manages items
apollo-adminservice/src/main/java/com/ctrip/framework/apollo/adminservice/controller/ItemController.java - Admin endpoints → Release management: publishes changes
apollo-adminservice/src/main/java/com/ctrip/framework/apollo/adminservice/controller/ItemController.java - Admin endpoints → Role permissions: checks permissions
- Global search → Admin API: searches items
apollo-portal/src/main/java/com/ctrip/framework/apollo/portal/service/GlobalSearchService.java - Release management → App and namespace: uses namespace
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/service/ReleaseService.java - App and namespace → Release messages: sends invalidation
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/service/NamespaceService.java - App and namespace → MySQL: persists namespace
- Release management → MySQL: persists releases
- Configuration items → MySQL: persists items
- Release messages → Config endpoints: notifies changes
README.md - Config endpoints → Incremental sync: serves updates
- Incremental sync → Configuration clients: delivers configuration
README.md - Release management → Operation audit: records operations
- Service discovery → Config endpoints: locates services
- Business settings → Configuration items: sets item limits
apollo-biz/src/main/java/com/ctrip/framework/apollo/biz/service/ItemService.java - Open API consumers → Role permissions: uses role service
apollo-portal/src/main/java/com/ctrip/framework/apollo/openapi/service/ConsumerService.java