From dd9db507bec27724efa000a520c4d9347f2fc786 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Fri, 20 Mar 2026 18:22:21 +0900 Subject: [PATCH] docs: record Apache AGE 1.5.0 install on 51123 and PG14 EOL tech debt Co-Authored-By: Claude Opus 4.6 --- ...설치_및_pg14_eol_기술부채_기록.md | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 journey/worklog/260320_51123_apache_age_설치_및_pg14_eol_기술부채_기록.md diff --git a/journey/worklog/260320_51123_apache_age_설치_및_pg14_eol_기술부채_기록.md b/journey/worklog/260320_51123_apache_age_설치_및_pg14_eol_기술부채_기록.md new file mode 100644 index 0000000..e71c681 --- /dev/null +++ b/journey/worklog/260320_51123_apache_age_설치_및_pg14_eol_기술부채_기록.md @@ -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`