docs: record Apache AGE 1.5.0 install on 51123 and PG14 EOL tech debt

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
happybell80 2026-03-20 18:22:21 +09:00
parent a8d80e0d34
commit dd9db507be

View File

@ -0,0 +1,55 @@
# 260320 51123 Apache AGE 설치 및 PG14 EOL 기술부채 기록
**작성일**: 2026-03-20
**대상**: 51123 서버 (192.168.0.100)
---
## 1. Apache AGE 1.5.0 설치
### 설치 내역
- **버전**: Apache AGE 1.5.0 (PG14용 공식 최신)
- **설치 방식**: 소스 컴파일 (`release/PG14/1.5.0` 브랜치)
- **소스 경로**: `/home/admin/apache-age-pg14`
- **설치 대상**: 기존 PostgreSQL 14.22 (Ubuntu 패키지)
### 빌드 의존성 추가 설치
- `flex`, `bison`, `libreadline-dev` (기존에 없어서 apt 설치)
- `build-essential`, `zlib1g-dev`, `postgresql-server-dev-14`는 기존 설치됨
### 동작 방식
- `LOAD 'age';` 세션별 로드로 동작 확인
- `shared_preload_libraries` 미등록 (PG 재시작 불필요)
- `ag_catalog` 스키마 USAGE + ALL TABLES 권한을 `robeings` 유저에 부여
### 검증 결과
- Cypher 쿼리 정상 (그래프 생성, 노드 생성/조회, 그래프 삭제)
- PGVector 회귀 테스트 통과 (team_document, team_document_chunk 정상 조회)
- 기존 확장 공존: plpgsql 1.0, vector 0.7.0, age 1.5.0
### 백업
- 설치 전 백업: `/mnt/hdd/backup/main_db_pre_age_20260320_180708.dump` (20MB)
---
## 2. PG14 EOL 기술부채
### 현황
- PostgreSQL 14.22, 지원 종료일 **2026-11-12** (약 8개월 남음)
- 최신 지원 메이저: PG18, 현재 4 메이저 뒤
- 출처: https://www.postgresql.org/support/versioning/
### 평가: 중상~높음
- 보안패치 가능 상태라 당장 위험 버전은 아님
- 남은 지원 기간이 짧고, AGE 등 신규 확장이 PG14 위에 쌓이는 중
- 미루면 AGE + 메이저 업그레이드를 이중 검증해야 하여 부채 이자 증가
### 필요 조치
- 2026 상반기 내 PG16 또는 17 업그레이드 계획·리허설 착수
- 업그레이드 시 AGE 호환 버전(PG16용 v1.6.0+) 함께 검증
---
## 3. 관련 문서
- `0_VALUE/20_Governance/system-and-infrastructure-overview.md` § 4), § 6)
- `robeing/DOCS/journey/research/rag/260320_PostgreSQL_그래프확장_설계_리서치.md`