50 lines
1.3 KiB
Markdown
50 lines
1.3 KiB
Markdown
# cloud-services
|
|
|
|
Go microservices for the vehicle cloud platform.
|
|
|
|
## Quick Start
|
|
```bash
|
|
# Install devbox (if needed)
|
|
curl -fsSL https://get.jetify.com/devbox | bash
|
|
|
|
# Enter dev environment
|
|
devbox shell
|
|
|
|
# Run a service locally
|
|
cd services/gateway
|
|
go run .
|
|
```
|
|
|
|
## Structure
|
|
```
|
|
services/ # Individual Go microservices
|
|
shared/ # Shared Go modules
|
|
deploy/ # Kubernetes manifests (kustomize)
|
|
base/ # Base configs
|
|
overlays/ # Environment-specific (development, etc.)
|
|
```
|
|
|
|
## Services
|
|
| Service | Description |
|
|
|---------|-------------|
|
|
| gateway | API gateway, routes requests |
|
|
| auth | Authentication (Keycloak integration) |
|
|
| ota | OTA update management |
|
|
| depot | Vehicle registration & management |
|
|
| attendant | Event processing |
|
|
| cargo | Data ingestion to storage |
|
|
| ditto | Digital twin state |
|
|
| manufacture | Manufacturing integration |
|
|
| aftersales | Aftersales/diagnostic services |
|
|
|
|
## Local Development
|
|
Services connect to:
|
|
- PostgreSQL: `cloud-dev-rw.cnpg-system.svc:5432`
|
|
- MongoDB: `cloud-dev-svc.mongodb.svc:27017`
|
|
- Redis: `cloud-dev.redis.svc:6379`
|
|
- Kafka: `cloud-dev-kafka-bootstrap.kafka.svc:9092`
|
|
- Keycloak: `https://keycloak.mini.cloud.fiskerinc.com`
|
|
|
|
## Deployment
|
|
ArgoCD syncs from this repo. Push to main → auto-deploy to mini cluster.
|