Các Dịch vụ Hạ tầng Cốt lõi
Nền tảng VENI-AI dựa trên một bộ các dịch vụ hỗ trợ để xử lý định danh, lưu trữ và khả năng quan sát (observability). Tất cả các dịch vụ đều được điều phối thông qua Docker Compose cho môi trường phát triển local.
🏗️ Kiến trúc Dịch vụ
Hạ tầng sử dụng một mạng Docker riêng biệt: veni-network.
1. Định danh & Bảo mật
| Dịch vụ | Image | Cổng bên ngoài | Vai trò |
|---|---|---|---|
| Keycloak | quay.io/keycloak/keycloak | 18080 | Nhà cung cấp định danh OIDC & Trung tâm SSO. |
2. Lưu trữ Dữ liệu
| Dịch vụ | Image | Cổng bên ngoài | Vai trò |
|---|---|---|---|
| Shell DB | postgres:15-alpine | 15433 | CSDL đăng ký nền tảng & bộ đệm người dùng. |
| HRM DB | postgres:15-alpine | 15434 | CSDL cô lập cho ứng dụng satellite HRM. |
| Keycloak DB | postgres:15-alpine | - | Lưu trữ nội bộ cho trạng thái Keycloak. |
| Redis | redis:7-alpine | 16379 | Lớp đệm (cache) cho chính sách RBAC và trạng thái. |
| MinIO | minio/minio | 19000 / 19001 | Lưu trữ đối tượng tương thích S3 (ứng dụng Drive). |
3. Giám sát & Quan sát
| Dịch vụ | Image | Cổng bên ngoài | Vai trò |
|---|---|---|---|
| Grafana | grafana/grafana | 13000 | Dashboard hợp nhất cho log và metrics. |
| Prometheus | prom/prometheus | 19090 | CSDL chuỗi thời gian cho các thông số hệ thống. |
| Loki | grafana/loki | 13100 | Công cụ thu thập và quản lý log. |
| Promtail | grafana/promtail | - | Chuyển log từ Docker container đến Loki. |
🔑 Thông tin Đăng nhập Mặc định
| Dịch vụ | Tên đăng nhập | Mật khẩu |
|---|---|---|
| Keycloak Admin | admin | admin |
| Shell Database | shell | shell |
| MinIO Console | minioadmin | minioadmin |
| Grafana | admin | admin |
📊 Stack Khả năng quan sát (Observability)
Nền tảng được cấu hình sẵn với stack "LGP" (Loki, Grafana, Prometheus).
Truy cập Logs
- Mở Grafana tại
http://localhost:13000. - Đi đến mục Explore.
- Chọn Loki làm nguồn dữ liệu (data source).
- Sử dụng các nhãn như
{container_name="veni-shell-api"}để xem log thời gian thực.
Truy cập Metrics
- Mở Prometheus tại
http://localhost:19090. - Sử dụng trình duyệt biểu thức để truy vấn sức khỏe hệ thống (ví dụ:
up).
🛠️ Lệnh Quản lý
bash
# Khởi động toàn bộ hạ tầng
cd infrastructure && docker-compose up -d
# Xem trạng thái các dịch vụ hạ tầng
docker ps --filter "name=veni-"
# Kiểm tra log của một dịch vụ cụ thể
docker-compose logs -f grafana