mirror of
https://github.com/hwanny1128/HGZero.git
synced 2025-12-06 21:56:24 +00:00
98 lines
2.4 KiB
Markdown
98 lines
2.4 KiB
Markdown
# AI 서비스 환경변수 설정 가이드
|
|
|
|
## 필수 환경변수
|
|
|
|
### 데이터베이스 설정
|
|
```bash
|
|
export DB_HOST=20.249.153.213
|
|
export DB_NAME=aidb
|
|
export DB_USERNAME=hgzerouser
|
|
export DB_PASSWORD=Hi5Jessica!
|
|
export DB_PORT=5432
|
|
export DDL_AUTO=update
|
|
```
|
|
|
|
### Redis 설정
|
|
```bash
|
|
export REDIS_HOST=20.249.177.114
|
|
export REDIS_PORT=6379
|
|
export REDIS_PASSWORD=Hi5Jessica!
|
|
export REDIS_DATABASE=4
|
|
```
|
|
|
|
### 서버 설정
|
|
```bash
|
|
export SERVER_PORT=8083
|
|
export SPRING_PROFILES_ACTIVE=dev
|
|
```
|
|
|
|
### JWT 설정
|
|
```bash
|
|
export JWT_SECRET=dev-jwt-secret-key-for-development-only
|
|
export JWT_ACCESS_TOKEN_VALIDITY=1800
|
|
export JWT_REFRESH_TOKEN_VALIDITY=86400
|
|
```
|
|
|
|
### 로깅 설정
|
|
```bash
|
|
export LOG_LEVEL_ROOT=INFO
|
|
export LOG_LEVEL_APP=DEBUG
|
|
export LOG_FILE=logs/ai-service.log
|
|
export LOG_MAX_FILE_SIZE=10MB
|
|
export LOG_MAX_HISTORY=7
|
|
export LOG_TOTAL_SIZE_CAP=100MB
|
|
```
|
|
|
|
### 외부 API 키 설정
|
|
```bash
|
|
export CLAUDE_API_KEY=sk-ant-ap...
|
|
export OPENAI_API_KEY=sk-proj-An4Q...
|
|
export OPENWEATHER_API_KEY=1aa5b...
|
|
export KAKAO_API_KEY=5cdc24....
|
|
```
|
|
|
|
### Azure EventHub 설정
|
|
```bash
|
|
export AZURE_EVENTHUB_CONNECTION_STRING="Endpoint=sb://hgzero-eventhub-ns.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=VUqZ9vFgu35E3c6RiUzoOGVUP8IZpFvlV+AEhC6sUpo="
|
|
export AZURE_EVENTHUB_NAME=hgzero-eventhub-name
|
|
export AZURE_EVENTHUB_NAMESPACE=hgzero-eventhub-ns
|
|
```
|
|
|
|
### CORS 설정
|
|
```bash
|
|
export CORS_ALLOWED_ORIGINS=http://localhost:*
|
|
```
|
|
|
|
## 선택적 환경변수 (Azure AI 서비스 사용 시)
|
|
```bash
|
|
export AZURE_OPENAI_API_KEY=your-azure-openai-key
|
|
export AZURE_OPENAI_ENDPOINT=your-azure-openai-endpoint
|
|
export AZURE_AI_SEARCH_ENDPOINT=your-azure-search-endpoint
|
|
export AZURE_AI_SEARCH_API_KEY=your-azure-search-key
|
|
```
|
|
|
|
## 실행 방법
|
|
|
|
### 1. IntelliJ IDEA 실행 프로파일 사용
|
|
- IntelliJ에서 ai-service 실행 프로파일이 자동으로 설정됨
|
|
- 환경변수가 미리 설정되어 있어 바로 실행 가능
|
|
|
|
### 2. Gradle 직접 실행
|
|
```bash
|
|
cd ai
|
|
export 환경변수들...
|
|
./gradlew bootRun
|
|
```
|
|
|
|
### 3. 환경변수 파일 사용 (.env)
|
|
```bash
|
|
# .env 파일 생성 후 위 환경변수들 설정
|
|
source .env
|
|
./gradlew bootRun
|
|
```
|
|
|
|
## 주의사항
|
|
- API 키들은 보안을 위해 실제 값으로 교체해야 함
|
|
- 운영 환경에서는 JWT_SECRET을 반드시 변경
|
|
- 로그 파일 위치는 애플리케이션 실행 권한이 있는 경로로 설정
|
|
- EventHub Connection String은 실제 Azure 리소스에 맞게 설정 |