Compare commits
2 Commits
7841bac39d
...
977a031393
| Author | SHA1 | Date | |
|---|---|---|---|
| 977a031393 | |||
| 5497dfc290 |
+131
@@ -0,0 +1,131 @@
|
|||||||
|
# Kubernetes Configuration for LPT Project
|
||||||
|
|
||||||
|
This directory contains the shared Kubernetes configuration files for the LPT (Learning Progress Tracker) project.
|
||||||
|
|
||||||
|
## Files
|
||||||
|
|
||||||
|
### ConfigMap
|
||||||
|
- **`configmap.yaml`** - Shared environment variables for all services
|
||||||
|
- LLM API configuration (URL, model, timeout)
|
||||||
|
- Database connection string
|
||||||
|
- Service URLs
|
||||||
|
|
||||||
|
### Secrets (Templates)
|
||||||
|
- **`lpt-secrets.yaml`** - Application secrets template
|
||||||
|
- LLM API key
|
||||||
|
- MySQL root password
|
||||||
|
- **⚠️ DO NOT commit real secrets!** Use the template to create secrets manually.
|
||||||
|
|
||||||
|
- **`regcred-secret.yaml`** - Docker registry authentication template
|
||||||
|
- Used for pulling images from private registry (192.168.123.199:5000)
|
||||||
|
- **⚠️ Managed by Gitea Actions workflow** - DO NOT commit real credentials!
|
||||||
|
|
||||||
|
### Service-Specific Configurations
|
||||||
|
Each service has its own `k8s/` directory with deployment and service configs:
|
||||||
|
- **`lpt-fe/k8s/`** - Frontend deployment (Nginx + Vue 3)
|
||||||
|
- **`lpt-be/k8s/`** - Backend deployment (Spring Boot)
|
||||||
|
- **`lpt-ai/k8s/`** - AI service deployment (Python FastAPI)
|
||||||
|
|
||||||
|
## Deployment
|
||||||
|
|
||||||
|
### Initial Setup
|
||||||
|
|
||||||
|
1. **Create namespace**:
|
||||||
|
```bash
|
||||||
|
kubectl create namespace lpt-dev
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Apply shared ConfigMap**:
|
||||||
|
```bash
|
||||||
|
kubectl apply -f k8s/configmap.yaml
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Create secrets** (replace with actual values):
|
||||||
|
```bash
|
||||||
|
# Application secrets
|
||||||
|
kubectl create secret generic lpt-secrets \
|
||||||
|
--from-literal=llm-api-key=<YOUR_LLM_API_KEY> \
|
||||||
|
--from-literal=mysql-root-password=<YOUR_MYSQL_ROOT_PASSWORD> \
|
||||||
|
--namespace=lpt-dev
|
||||||
|
|
||||||
|
# Registry credentials (for manual creation, or use Gitea workflow)
|
||||||
|
kubectl create secret docker-registry regcred \
|
||||||
|
--docker-server=192.168.123.199:5000 \
|
||||||
|
--docker-username=admin \
|
||||||
|
--docker-password=<REGISTRY_PASSWORD> \
|
||||||
|
--namespace=lpt-dev
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **Deploy services**:
|
||||||
|
```bash
|
||||||
|
# Frontend
|
||||||
|
kubectl apply -f lpt-fe/k8s/
|
||||||
|
|
||||||
|
# Backend
|
||||||
|
kubectl apply -f lpt-be/k8s/
|
||||||
|
|
||||||
|
# AI Service
|
||||||
|
kubectl apply -f lpt-ai/k8s/
|
||||||
|
```
|
||||||
|
|
||||||
|
### CI/CD Workflow
|
||||||
|
|
||||||
|
The Gitea Actions workflows (`.gitea/workflows/deploy.yml` in each service) automatically:
|
||||||
|
1. Build Docker images
|
||||||
|
2. Push to private registry (192.168.123.199:5000)
|
||||||
|
3. Create/update `regcred` secret with credentials from Gitea secrets
|
||||||
|
4. Update deployment image tags
|
||||||
|
|
||||||
|
**Required Gitea Secrets** (per repository):
|
||||||
|
- `REGISTRY_USERNAME`: Docker registry username (admin)
|
||||||
|
- `REGISTRY_PASSWORD`: Docker registry password
|
||||||
|
|
||||||
|
## Verification
|
||||||
|
|
||||||
|
Check deployment status:
|
||||||
|
```bash
|
||||||
|
kubectl get all -n lpt-dev
|
||||||
|
kubectl get configmap -n lpt-dev
|
||||||
|
kubectl get secret -n lpt-dev
|
||||||
|
```
|
||||||
|
|
||||||
|
View logs:
|
||||||
|
```bash
|
||||||
|
kubectl logs -f deployment/lpt-fe -n lpt-dev
|
||||||
|
kubectl logs -f deployment/lpt-be -n lpt-dev
|
||||||
|
kubectl logs -f deployment/lpt-ai -n lpt-dev
|
||||||
|
```
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────┐
|
||||||
|
│ lpt-fe:3000 │ (NodePort 30080)
|
||||||
|
│ Vue 3 + Nginx │
|
||||||
|
└────────┬────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────┐
|
||||||
|
│ lpt-be:8080 │ (NodePort 30088)
|
||||||
|
│ Spring Boot │
|
||||||
|
└────────┬────────┘
|
||||||
|
│
|
||||||
|
├─────────► MySQL (external)
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────┐
|
||||||
|
│ lpt-ai:5199 │ (ClusterIP)
|
||||||
|
│ FastAPI │
|
||||||
|
└─────────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
LLM API (external)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
- **Namespace**: All resources use `lpt-dev` namespace
|
||||||
|
- **Registry**: Private Docker registry at `192.168.123.199:5000`
|
||||||
|
- **Image Pull**: All deployments use `imagePullSecrets: [name: regcred]`
|
||||||
|
- **ConfigMap**: Shared config is mounted as environment variables
|
||||||
|
- **Secrets**: Sensitive data (API keys, passwords) stored in `lpt-secrets`
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
apiVersion: v1
|
||||||
|
kind: ConfigMap
|
||||||
|
metadata:
|
||||||
|
name: lpt-config
|
||||||
|
namespace: lpt-dev
|
||||||
|
data:
|
||||||
|
# LPT AI Service
|
||||||
|
LLM_API_URL: https://api.siliconflow.cn/v1/chat/completions
|
||||||
|
LLM_MODEL: Qwen/Qwen2.5-32B-Instruct
|
||||||
|
LLM_TIMEOUT_MS: "60000"
|
||||||
|
LPT_AI-SERVICE_URL: http://lpt-ai:5199
|
||||||
|
PORT: "5199"
|
||||||
|
|
||||||
|
# Spring Boot Database
|
||||||
|
SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/learning_progress_tracker?allowPublicKeyRetrieval=true&characterEncoding=utf-8&useSSL=false&serverTimezone=GMT%2B8
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
# LPT Application Secrets
|
||||||
|
#
|
||||||
|
# This file is a TEMPLATE - DO NOT commit real secrets to git!
|
||||||
|
#
|
||||||
|
# To create this secret:
|
||||||
|
# kubectl create secret generic lpt-secrets \
|
||||||
|
# --from-literal=llm-api-key=<YOUR_LLM_API_KEY> \
|
||||||
|
# --from-literal=mysql-root-password=<YOUR_MYSQL_ROOT_PASSWORD> \
|
||||||
|
# --namespace=lpt-dev
|
||||||
|
#
|
||||||
|
# Or use kubectl apply with stringData:
|
||||||
|
# kubectl apply -f - <<EOF
|
||||||
|
# apiVersion: v1
|
||||||
|
# kind: Secret
|
||||||
|
# metadata:
|
||||||
|
# name: lpt-secrets
|
||||||
|
# namespace: lpt-dev
|
||||||
|
# type: Opaque
|
||||||
|
# stringData:
|
||||||
|
# llm-api-key: "your-actual-api-key"
|
||||||
|
# mysql-root-password: "your-actual-mysql-password"
|
||||||
|
# EOF
|
||||||
|
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Secret
|
||||||
|
metadata:
|
||||||
|
name: lpt-secrets
|
||||||
|
namespace: lpt-dev
|
||||||
|
type: Opaque
|
||||||
|
data:
|
||||||
|
# Base64 encoded values - use stringData for plain text when applying
|
||||||
|
# llm-api-key: <base64-encoded-api-key>
|
||||||
|
# mysql-root-password: <base64-encoded-password>
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
# Docker Registry Secret for pulling images from private registry
|
||||||
|
#
|
||||||
|
# This file is a TEMPLATE - the actual secret is managed by Gitea Actions workflow
|
||||||
|
# and should NOT be committed with real credentials.
|
||||||
|
#
|
||||||
|
# To create this secret manually:
|
||||||
|
# kubectl create secret docker-registry regcred \
|
||||||
|
# --docker-server=192.168.123.199:5000 \
|
||||||
|
# --docker-username=admin \
|
||||||
|
# --docker-password=<REGISTRY_PASSWORD> \
|
||||||
|
# --namespace=lpt-dev
|
||||||
|
#
|
||||||
|
# Or use the workflow which reads from Gitea secrets:
|
||||||
|
# - REGISTRY_USERNAME
|
||||||
|
# - REGISTRY_PASSWORD
|
||||||
|
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Secret
|
||||||
|
metadata:
|
||||||
|
name: regcred
|
||||||
|
namespace: lpt-dev
|
||||||
|
type: kubernetes.io/dockerconfigjson
|
||||||
|
data:
|
||||||
|
# .dockerconfigjson: <base64-encoded-docker-config>
|
||||||
|
# This is generated by the workflow - DO NOT commit real values here
|
||||||
|
.dockerconfigjson: ""
|
||||||
Reference in New Issue
Block a user