Update ragflow

This commit is contained in:
wbsong111
2025-08-13 17:41:45 +09:00
parent ec42db2d6e
commit a2b0682aaf
14 changed files with 380 additions and 174 deletions
+74 -6
View File
@@ -20,16 +20,19 @@
| Name | 설명 | 기본값 |
| ---------------------- | ------------------------------------------------------------ | ------ |
| `env.DOC_ENGINE` | 문서 엔진 타입 설정. `elasticsearch` 또는 `infinity` 선택 가능 | `infinity` |
| `env.DOC_ENGINE` | 문서 엔진 타입 설정. `elasticsearch`, `infinity`, `opensearch` 선택 가능 | `infinity` |
| `env.STACK_VERSION` | Elasticsearch 버전 설정 | `"8.11.3"` |
| `env.ELASTIC_PASSWORD` | Elasticsearch 비밀번호 | `infini_rag_flow_helm` |
| `env.OPENSEARCH_PASSWORD` | OpenSearch 비밀번호 (대소문자, 숫자, 특수문자 포함 필요) | `infini_rag_flow_OS_01` |
| `env.MYSQL_PASSWORD` | MySQL 비밀번호 | `infini_rag_flow_helm` |
| `env.MYSQL_DBNAME` | MySQL 데이터베이스 이름 | `rag_flow` |
| `env.MINIO_ROOT_USER` | MinIO 사용자명 | `rag_flow` |
| `env.MINIO_PASSWORD` | MinIO 비밀번호 | `infini_rag_flow_helm` |
| `env.REDIS_PASSWORD` | Redis 비밀번호 | `infini_rag_flow_helm` |
| `env.RAGFLOW_IMAGE` | RAGFlow Docker 이미지 | `infiniflow/ragflow:v0.19.0-slim` |
| `env.TIMEZONE` | 로컬 시간대 설정 | `"Asia/Shanghai"` |
| `env.RAGFLOW_IMAGE` | RAGFlow Docker 이미지 | `infiniflow/ragflow:v0.20.1-slim` |
| `env.TIMEZONE` | 로컬 시간대 설정 | `"Asia/Seoul"` |
| `env.DOC_BULK_SIZE` | 문서 파싱 시 단일 배치에서 처리되는 문서 청크 수 | `4` |
| `env.EMBEDDING_BATCH_SIZE` | 임베딩 벡터화 시 단일 배치에서 처리되는 텍스트 청크 수 | `16` |
@@ -43,6 +46,39 @@
| `ragflow.api.service.type` | API 서비스 타입 설정 | `ClusterIP` |
| `ragflow.deployment.strategy` | 배포 전략 설정 | `` |
| `ragflow.deployment.resources` | 리소스 제한 설정 | `` |
| `ragflow.service_conf.oauth.oidc` | OIDC 인증 설정 | 설정 예시 참조 |
| `ragflow.llm_factories` | LLM 팩토리 설정 | 설정 예시 참조 |
#### 2.1) OIDC 인증 설정 예시
```yaml
ragflow:
service_conf:
oauth:
oidc:
display_name: "OIDC"
client_id: "ragflow"
client_secret: "your-client-secret"
issuer: "https://your-keycloak-domain/realms/your-realm"
scope: "openid email profile"
redirect_uri: "https://your-ragflow-domain/v1/user/oauth/callback/oidc"
```
#### 2.2) LLM 팩토리 설정 예시
```yaml
ragflow:
llm_factories:
factory_llm_infos:
- name: OpenAI-API-Compatible
logo: ""
tags: "LLM,TEXT EMBEDDING,SPEECH2TEXT,MODERATION"
status: "1"
llm:
- llm_name: my-custom-llm
tags: "LLM,CHAT,"
max_tokens: 100000
model_type: chat
is_tools: false
```
@@ -52,9 +88,11 @@
| Name | 설명 | 기본값 |
| --------------------------- | ------------------------------------------------------------ | ----------------------- |
| `infinity.image.repository` | Infinity 이미지 저장소 | `infiniflow/infinity` |
| `infinity.image.tag` | Infinity 이미지 태그 | `v0.6.0-dev3` |
| `infinity.image.tag` | Infinity 이미지 태그 | `v0.6.0-dev5` |
| `infinity.storage.className` | 스토리지 클래스 이름 | `` |
| `infinity.storage.capacity` | 스토리지 용량 | `5Gi` |
| `infinity.deployment.strategy` | 배포 전략 설정 | `` |
| `infinity.deployment.resources` | 리소스 제한 설정 | `` |
| `infinity.service.type` | 서비스 타입 | `ClusterIP` |
@@ -151,17 +189,28 @@
cert-manager.io/cluster-issuer: "selfsigned-issuer"
cert-manager.io/duration: 8760h
cert-manager.io/renew-before: 720h
konghq.com/https-redirect-status-code: '301'
konghq.com/protocols: https
hosts:
- host: ragflow.example.org
paths:
- path: /
pathType: ImplementationSpecific
tls:
tls:
- hosts:
- ragflow.example.org
secretName: ragflow-tls
```
#### 8.4) Kong 관련 어노테이션
- Kong Ingress Controller 사용 시 추가 설정 옵션들:
| Name | 설명 | 기본값 |
| --------------------------------------- | ---------------------------------- | --------- |
| `konghq.com/https-redirect-status-code` | HTTPS 리다이렉트 상태 코드 | `'301'` |
| `konghq.com/protocols` | 허용할 프로토콜 | `https` |
## 3. 주요 설정 가이드
@@ -169,6 +218,7 @@
- `env.DOC_ENGINE`을 통해 문서 엔진을 선택할 수 있습니다.
- `elasticsearch`: 안정적이고 검증된 검색 엔진
- `infinity`: 고성능 벡터 검색 엔진 (권장)
- `opensearch`: Elasticsearch의 오픈소스 대안
### 3.2) 리소스 설정
- 각 서비스별로 `deployment.resources`에서 CPU/메모리 리소스를 설정할 수 있습니다.
@@ -180,4 +230,22 @@
### 3.4) 보안 설정
- 모든 비밀번호는 기본값에서 변경하여 사용하세요.
- OIDC를 통한 외부 인증 시스템 연동이 가능합니다.
- OIDC를 통한 외부 인증 시스템 연동이 가능합니다.
### 3.5) 성능 튜닝 설정
- 문서 처리 및 임베딩 성능을 조정할 수 있는 설정들입니다.
| Name | 설명 | 기본값 |
| --------------------------- | ------------------------------------------------------------ | ----------------------- |
| `env.DOC_BULK_SIZE` | 문서 파싱 시 단일 배치에서 처리되는 문서 청크 수 | `4` |
| `env.EMBEDDING_BATCH_SIZE` | 임베딩 벡터화 시 단일 배치에서 처리되는 텍스트 청크 수 | `16` |
### 3.6) 추가 환경 설정
- 기타 선택적 환경 설정들입니다.
| Name | 설명 | 기본값 |
| --------------------------- | ------------------------------------------------------------ | ----------------------- |
| `env.HF_ENDPOINT` | Hugging Face 엔드포인트 (접근 제한 시 미러 사용) | 설정하지 않음 |
| `env.MAX_CONTENT_LENGTH` | 업로드 파일 최대 크기 (바이트) | `134217728` (128MB) |
**참고**: `MAX_CONTENT_LENGTH` 변경 시 nginx 설정의 `client_max_body_size`도 함께 수정해야 합니다.