DOCS/troubleshooting/20250930_opensearch_hdd_migration.md
happybell80 ea39eeb391 docs: OpenSearch HDD 마이그레이션 최종 상태 업데이트
- 해결 과정 중 발생한 문제점 추가
- 최종 동작 상태 확인 내용 추가
- 커밋 이력 66b5ee8 추가

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 00:26:58 +09:00

1.8 KiB

OpenSearch HDD 마이그레이션

문제

  • OpenSearch 데이터가 SSD(/var/lib/opensearch)에 저장
  • SSD 용량 부족 우려

해결

1. 데이터 마이그레이션

sudo mkdir -p /mnt/hdd/opensearch
sudo cp -rp /var/lib/opensearch/* /mnt/hdd/opensearch/
sudo chown -R 1000:1000 /mnt/hdd/opensearch

2. 설정 파일 변경

파일: /home/admin/opensearch/docker-compose.yaml

  • 34번 라인: /var/lib/opensearch/mnt/hdd/opensearch

파일: /home/admin/opensearch/.gitea/workflows/cicd.yml

  • 17-19번 라인: /var/lib/opensearch/mnt/hdd/opensearch
  • 30-31번 라인: 기존 컨테이너 중복 방지 코드 추가

파일: /home/admin/opensearch/Dockerfile

  • 보안 인증서 COPY 라인 제거
  • ENV plugins.security.disabled=true 추가

3. 보안 플러그인 비활성화

  • docker-compose.yaml 15번 라인: DISABLE_SECURITY_PLUGIN=true
  • 내부 네트워크 전용 서비스로 TLS 불필요

4. 해결 과정 중 발생한 문제

  • Actions 실패: TLS 인증서 파일 없음 → 보안 플러그인 비활성화로 해결
  • 컨테이너 이름 충돌 → Actions에 기존 컨테이너 제거 코드 추가
  • 설정 중복 에러 → Dockerfile ENV 제거, docker-compose.yaml에서만 설정

5. 최종 상태

  • 데이터 경로: /mnt/hdd/opensearch (354MB)
  • 컨테이너: opensearch (opensearch-opensearch-node 이미지)
  • 포트: 9200, 9600
  • HDD 여유 공간: 869GB
  • API 응답: 정상
  • 로그 수집: fluent-bit → data-prepper → OpenSearch 정상

6. 커밋 이력

  • 7466068: HDD 경로 변경
  • 5f7bf49: Actions 워크플로우 경로 수정
  • 2df7afb: 보안 플러그인 비활성화
  • 8f667d3: DISABLE_SECURITY_PLUGIN 환경변수 수정
  • 66b5ee8: Dockerfile 중복 설정 제거