mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-08 21:54:42 +02:00
feat(openalice): déploiement in-cluster de l'agent IA financier (back-end finance d'Asa)
Déploie TraderAlice/OpenAlice (AGPL-3.0) dans le namespace ai comme back-end de connaissances financières pour Asa, consommé via le connecteur MCP Ask. - CI build-openalice.yml : rebuild depuis le Dockerfile amont (ref épinglée v0.60.0-beta.1) → ghcr.io/alkatrazz24/funk-openalice, bump manifest sur main - k8s/apps/openalice : Deployment (restricted + fsGroup, Recreate), PVC 5Gi NFS /data, Service web:47331 + mcpask:3003, IngressRoute openalice.lab.local - ArgoCD app + doc admin/ia/openalice.md (RAG) + MAJ CLAUDE.md - Cerveau hybride : LiteLLM/Qwen3-8B local (gratuit) + Claude basculable ; données TraderHub (sans clé) + FMP gratuit. Lecture/recherche seule — aucun broker, zéro trading. Onboarding premier boot (Web UI) imposé : credentials scellés dans /data par design. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
ebb2eec184
commit
08db9670da
9 changed files with 341 additions and 1 deletions
67
k8s/apps/openalice/README.md
Normal file
67
k8s/apps/openalice/README.md
Normal file
|
|
@ -0,0 +1,67 @@
|
|||
# OpenAlice — agent IA financier (in-cluster)
|
||||
|
||||
[TraderAlice/OpenAlice](https://github.com/TraderAlice/OpenAlice) — *"one-person Wall Street"* :
|
||||
agent autonome de recherche financière (actions, crypto, commodités, forex, macro). **AGPL-3.0**.
|
||||
Déployé in-cluster (namespace `ai`, `openalice.lab.local`) comme **back-end de connaissances
|
||||
financières d'Asa** : Asa lui parle via le connecteur **MCP Ask** (cf. PR outil `ask_alice`).
|
||||
|
||||
> ⚠️ **Logiciel beta, expérimental.** Ici on l'utilise en **lecture/recherche uniquement** :
|
||||
> **aucun broker (UTA) connecté → zéro trading réel.** Données de marché via **TraderHub**
|
||||
> (hébergé, sans clé) + clé **FMP** gratuite optionnelle pour les cours live.
|
||||
|
||||
## Image
|
||||
|
||||
Pas d'image publique : la CI (`.github/workflows/build-openalice.yml`) rebuild depuis le
|
||||
Dockerfile amont à une **ref épinglée** (`OPENALICE_REF`) → `ghcr.io/alkatrazz24/funk-openalice`.
|
||||
Changer de version = éditer `OPENALICE_REF` puis relancer le workflow (`workflow_dispatch`).
|
||||
|
||||
## Architecture du déploiement
|
||||
|
||||
| Composant | Détail |
|
||||
|---|---|
|
||||
| Deployment | 1 réplica, `Recreate` (volume RWO), PodSecurity *restricted* (uid 1000, `fsGroup` 1000) |
|
||||
| PVC `openalice-data` | 5Gi NFS → `/data` (auth CLIs, sessions, **config + credentials scellés**, caches) |
|
||||
| Service `openalice` | `web:47331` (Web UI) + `mcpask:3003` (MCP Ask, in-cluster, pour Asa) |
|
||||
| IngressRoute | `openalice.lab.local` → 47331 |
|
||||
|
||||
Le cerveau d'Alice **n'est pas** une clé Claude par défaut : on le pointe sur **LiteLLM
|
||||
(`storage-01:4000`) → Qwen3-8B** (gratuit), avec Claude basculable (hybride). Tout se règle
|
||||
au **premier boot** (voir ci-dessous) car OpenAlice **scelle ses credentials dans `/data`**
|
||||
(impossible à seeder en clair via ConfigMap — par design).
|
||||
|
||||
## Pré-requis manuels (une fois)
|
||||
|
||||
### 1. Secret de pull GHCR (si absent du ns `ai`)
|
||||
|
||||
```bash
|
||||
kubectl -n ai create secret docker-registry ghcr-pull \
|
||||
--docker-server=ghcr.io \
|
||||
--docker-username=Alkatrazz24 \
|
||||
--docker-password=<GHCR_PAT_read_packages>
|
||||
```
|
||||
|
||||
### 2. Premier boot — onboarding via la Web UI
|
||||
|
||||
OpenAlice génère un **token admin** (256 bits) au premier démarrage. Le récupérer :
|
||||
|
||||
```bash
|
||||
kubectl -n ai logs deploy/openalice | grep -i token
|
||||
```
|
||||
|
||||
Ouvrir **http://openalice.lab.local**, coller le token, puis configurer :
|
||||
|
||||
1. **Settings › AI Provider** — ajouter un credential **OpenAI-compatible** :
|
||||
- baseUrl `http://192.168.10.1:4000/v1` · modèle `hermes-default` (ou `qwen3-8b`) · apiKey `lm-studio`
|
||||
- (option **hybride**) ajouter aussi un credential **Anthropic** (Claude) avec ta clé pour basculer.
|
||||
2. **Settings › Market Data** — laisser **TraderHub** activé (par défaut). Ajouter la clé
|
||||
**FMP** (palier gratuit, [financialmodelingprep.com](https://site.financialmodelingprep.com))
|
||||
pour les cours/K-lines live (hors hub).
|
||||
3. **Connectors › MCP Ask** — **activer**, port **3003**. C'est l'entrée qu'Asa consomme
|
||||
(`askWithSession`) via `http://openalice:3003` in-cluster.
|
||||
|
||||
Tout ceci est **persisté + scellé** dans le volume → survit aux redémarrages et rebuilds d'image.
|
||||
|
||||
## Asa (STT-server)
|
||||
|
||||
L'outil `ask_alice(question)` de la boucle agentique d'Asa délègue à Alice via MCP Ask
|
||||
(`http://openalice:3003`). Voir `admin/ia/openalice.md` et le déploiement `stt`.
|
||||
81
k8s/apps/openalice/deployment.yaml
Normal file
81
k8s/apps/openalice/deployment.yaml
Normal file
|
|
@ -0,0 +1,81 @@
|
|||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: openalice
|
||||
namespace: ai
|
||||
spec:
|
||||
replicas: 1
|
||||
# OpenAlice écrit dans un volume RWO (NFS) — pas de rolling avec 2 pods sur le même volume.
|
||||
strategy:
|
||||
type: Recreate
|
||||
selector:
|
||||
matchLabels:
|
||||
app: openalice
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
app: openalice
|
||||
spec:
|
||||
# Image privée sur ghcr → secret de pull créé manuellement dans le ns ai
|
||||
# (cf. README : kubectl create secret docker-registry ghcr-pull ...)
|
||||
imagePullSecrets:
|
||||
- name: ghcr-pull
|
||||
# Conformité PodSecurity "restricted" (namespace ai). fsGroup 1000 → le volume NFS
|
||||
# (HOME des CLIs + /data) est inscriptible par l'uid non-root de l'image.
|
||||
securityContext:
|
||||
runAsNonRoot: true
|
||||
runAsUser: 1000
|
||||
runAsGroup: 1000
|
||||
fsGroup: 1000
|
||||
seccompProfile:
|
||||
type: RuntimeDefault
|
||||
containers:
|
||||
- name: openalice
|
||||
# Tag amont géré par la CI (build-openalice.yml) : bumpé en <ref> à chaque build main.
|
||||
image: ghcr.io/alkatrazz24/funk-openalice:v0.60.0-beta.1
|
||||
securityContext:
|
||||
allowPrivilegeEscalation: false
|
||||
capabilities:
|
||||
drop: ["ALL"]
|
||||
ports:
|
||||
- name: web
|
||||
containerPort: 47331
|
||||
# MCP Ask connector — consommé in-cluster par Asa (STT-server). À ACTIVER une fois
|
||||
# au premier boot (Web UI › Connectors) : { mcpAsk: { enabled: true, port: 3003 } }.
|
||||
- name: mcpask
|
||||
containerPort: 3003
|
||||
env:
|
||||
# OpenAlice stocke ses credentials (provider IA, clés vendor) SCELLÉS dans /data,
|
||||
# configurés au premier boot via la Web UI — voir README. Rien de secret en env ici.
|
||||
- name: TZ
|
||||
value: "Europe/Paris"
|
||||
# Derrière Traefik (entrypoint web) : on fait confiance au proxy in-cluster pour
|
||||
# les en-têtes (IP réelle / host). LAN privé, HTTP.
|
||||
- name: OPENALICE_TRUSTED_PROXIES
|
||||
value: "10.42.0.0/16"
|
||||
# Web UI Hono : le portail 47331 répond mais peut 401 derrière le gate admin →
|
||||
# sonde TCP plutôt qu'HTTP. Démarrage lent (runtime Node + CLIs agent embarqués).
|
||||
readinessProbe:
|
||||
tcpSocket:
|
||||
port: 47331
|
||||
initialDelaySeconds: 20
|
||||
periodSeconds: 15
|
||||
livenessProbe:
|
||||
tcpSocket:
|
||||
port: 47331
|
||||
initialDelaySeconds: 60
|
||||
periodSeconds: 30
|
||||
resources:
|
||||
requests:
|
||||
cpu: 200m
|
||||
memory: 512Mi
|
||||
limits:
|
||||
cpu: "1"
|
||||
memory: 1536Mi
|
||||
volumeMounts:
|
||||
- name: data
|
||||
mountPath: /data
|
||||
volumes:
|
||||
- name: data
|
||||
persistentVolumeClaim:
|
||||
claimName: openalice-data
|
||||
14
k8s/apps/openalice/ingress.yaml
Normal file
14
k8s/apps/openalice/ingress.yaml
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
apiVersion: traefik.io/v1alpha1
|
||||
kind: IngressRoute
|
||||
metadata:
|
||||
name: openalice
|
||||
namespace: ai
|
||||
spec:
|
||||
entryPoints:
|
||||
- web
|
||||
routes:
|
||||
- match: Host(`openalice.lab.local`)
|
||||
kind: Rule
|
||||
services:
|
||||
- name: openalice
|
||||
port: 47331
|
||||
14
k8s/apps/openalice/pvc.yaml
Normal file
14
k8s/apps/openalice/pvc.yaml
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
apiVersion: v1
|
||||
kind: PersistentVolumeClaim
|
||||
metadata:
|
||||
name: openalice-data
|
||||
namespace: ai
|
||||
spec:
|
||||
# /data : auth des CLIs agent, sessions, config (credentials SCELLÉES au repos),
|
||||
# caches, archive news, historique trading. Persiste config + onboarding premier boot.
|
||||
accessModes:
|
||||
- ReadWriteOnce
|
||||
storageClassName: nfs
|
||||
resources:
|
||||
requests:
|
||||
storage: 5Gi
|
||||
16
k8s/apps/openalice/service.yaml
Normal file
16
k8s/apps/openalice/service.yaml
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: openalice
|
||||
namespace: ai
|
||||
spec:
|
||||
selector:
|
||||
app: openalice
|
||||
ports:
|
||||
- name: web
|
||||
port: 47331
|
||||
targetPort: 47331
|
||||
# MCP Ask — consommé par le STT-server (Asa) : http://openalice:3003 (in-cluster).
|
||||
- name: mcpask
|
||||
port: 3003
|
||||
targetPort: 3003
|
||||
Loading…
Add table
Add a link
Reference in a new issue