QuantEngineByItz/docs/archive/ENVIRONMENT_DIAGNOSIS.md

🔍 원격 서버 환경 진단

목표: SSH로 접속하여 원격 서버의 정확한 구조와 설정을 파악한 후 배포 스크립트를 맞춤형으로 작성

---

📋 진단 절차

Step 1: SSH 접속

# 원격 서버에 SSH 접속
ssh kjh2064@178.104.200.7

# 또는 이미 내부 IP를 알고 있다면
ssh kjh2064@172.x.x.x

Step 2: 진단 스크립트 실행

# 로컬에서 스크립트를 원격으로 실행
ssh kjh2064@178.104.200.7 'bash -s' < diagnose-environment.sh

# 또는 원격에 접속한 후 실행
bash < <(curl -s https://raw.githubusercontent.com/.../diagnose-environment.sh)

# 또는 직접 실행
chmod +x diagnose-environment.sh
./diagnose-environment.sh

Step 3: 출력 결과 확인

진단 스크립트가 다음 정보를 제공합니다:

1. 네트워크 정보
   - 공인 IP: 178.104.200.7 (확인됨)
   - 내부 IP: 172.x.x.x (여기서 확인!)
   - 호스트명
   - 네트워크 인터페이스

2. 웹 서버 디렉토리 구조
   - /var/www 여부
   - /var/www/quant 여부
   - /var/www/quant/publish 여부
   - 실제 경로 (다를 수 있음)

3. Nginx 설정
   - Nginx 설치 확인
   - 설정 파일 위치
   - /quant 관련 설정

4. 파일 권한 및 소유자
   - 웹 서버 사용자 (www-data? nobody? 다른 사용자?)
   - 디렉토리 권한

5. 포트 상태
   - 80, 443 포트 상태
   - 바인딩된 주소

6. 시스템 정보
   - OS 종류 및 버전
   - 디스크 공간

7. Sudo 권한
   - 현재 사용자의 sudo 권한
   - systemctl 사용 가능 여부

8. Git/Gitea 정보
   - Gitea 설치 위치
   - Gitea 데이터 저장소

---

📊 진단 결과 분석

예상되는 출력 값들

항목	예상값	실제값
공인 IP	178.104.200.7	✓
내부 IP	172.x.x.x	?
웹 서버 경로	/var/www/quant	?
웹 서버 사용자	www-data	?
Nginx 설정	/etc/nginx/sites-available/default	?
OS	Ubuntu 20.04+	?

확인할 핵심 정보

1. 내부 IP 주소 (172로 시작)

   ip addr show | grep "inet"
   → inet 172.x.x.x/xx
   

2. 웹 서버 경로

   ls -la /var/www/quant/
   → 실제 배포 경로 확인
   

3. 웹 서버 사용자

   ps aux | grep nginx | head -1
   → nginx    12345  0.0  0.1 ...
   

4. Nginx 설정

   grep -r "quant" /etc/nginx/
   → location /quant 설정 확인
   

5. Sudo 권한

   sudo -l
   → systemctl restart nginx 권한 확인
   

---

🔧 스크립트 결과 보고 양식

진단 스크립트 실행 후 다음 정보를 제공해주세요:

네트워크 정보

• 내부 IP: 172.x.x.x 또는 다른 주소?
• 호스트명: ?
• 기본 게이트웨이: ?

디렉토리 구조

• /var/www 존재: O / X
• /var/www/quant 존재: O / X
• /var/www/quant/publish 존재: O / X
• 실제 웹 서빙 경로: ?

Nginx 설정

• Nginx 버전: ?
• 설정 파일: /etc/nginx/sites-available/default 또는 다른 경로?
• /quant 설정 있음: O / X
• 루트 경로: ?

파일 권한

• 웹 서버 사용자: www-data 또는 ?
• /var/www/quant 소유자: ?
• /var/www/quant 권한: ?

시스템 정보

• OS: Ubuntu 20.04 또는 ?
• 디스크 여유: ?MB

Sudo 권한

• sudo -l 출력:

  복사해주세요
  

---

📝 수집 후 수행할 작업

위 정보를 받은 후:

1. ✅ 정확한 내부 IP로 배포 스크립트 수정
2. ✅ 실제 경로로 deploy-manual.sh 수정
3. ✅ 웹 서버 사용자로 권한 설정 수정
4. ✅ Nginx 설정에 맞게 배포 절차 수정
5. ✅ 모든 문서 (DEPLOYMENT_SSH_GUIDE.md, CI_CD_PIPELINE.md 등) 업데이트

---

🚀 빠른 진단 (한 줄 명령어)

# SSH 접속 후 한 번에 필요한 정보만 추출
echo "=== 내부 IP ===" && ip addr show | grep "inet " | grep -v 127.0.0.1 && \
echo "=== 웹 서버 경로 ===" && ls -la /var/www/ && \
echo "=== Nginx 사용자 ===" && ps aux | grep nginx | head -1 && \
echo "=== Sudo 권한 ===" && sudo -l | head -5

---

⚡ 진단 후 다음 단계

1. 진단 결과 공유

   • 위의 "스크립트 결과 보고 양식" 내용을 제공해주세요

2. 배포 스크립트 수정

   • 정확한 정보를 바탕으로 deploy-manual.sh 맞춤 수정
   • 내부 IP, 경로, 사용자 등 정확히 반영

3. 배포 실행

   chmod +x deploy-manual.sh
   ./deploy-manual.sh [실제_내부_IP]
   

4. 검증

   curl -I http://178.104.200.7/quant/
   

---

진단을 완료한 후 결과를 공유해주세요!
정확한 환경 정보를 바탕으로 완벽하게 맞춤형 배포 스크립트를 작성하겠습니다. 🎯