PROJECT

Team Personal

STUDY

Language Framework

PHOTO

마켓나와

👨🏻‍💻 내가 기여한 부분

📚 사용 기술

🧩 System Architecture

내가 기여한 부분

•

GitHub Actions와 AWS Elastic Beanstalk를 사용하여 지속적 통합 및 배포 파이프라인을 구축

•

CORS 처리

•

OpenAI API를 활용하여 PR 시 GPT가 코드리뷰 해주도록 설정

•

GitHub을 통한 형상 관리를 수행, 브랜치 전략 계획, 커밋 컨벤션, PR 컨벤션, 코드 컨벤션 설정

사용 기술

•

DataBase

◦

ElasticSearch

•

BackEnd

◦

Kotlin / Spring Boot / Spring Data JPA

•

DevOps

◦

Docker / GitHub Actions / AWS(Elastic Beanstalk, EC2, Lambda, S3, Route53)

•

Software Architecture Pattern

◦

Monolithic Architecture

•

FrontEnd

◦

HTML / CSS / JavaScript / Vue.js

•

Collaboration

◦

GitHub / Slack / Notion / Figma / Miro / Jira

System Architecture

MarketNawa System Architecture

트러블 슈팅 1

문제 배경

온라인 쇼핑몰 데이터를 크롤링하는 도중, 클라이언트 라이브러리에서 발생한 Unknown Host 에러를 경험하였습니다. 브라우저와 Test-NetConnection을 사용한 테스트에서는 정상적으로 동작하였으나, 클라이언트 라이브러리의 lookup 과정에서 DNS 쿼리가 제대로 처리되지 않는 문제를 확인했습니다.

윈도우에서 nslookup 명령어를 통해 DNS 서버와의 통신을 확인했으나, 기대한 응답을 얻지 못했으며, 네트워크 연결 및 인터넷 접속 테스트는 정상적으로 이루어졌습니다. 이 문제의 원인으로는 방화벽 설정이나 DNS 캐시 문제를 의심하게 되었습니다.

해결 방법

DNS 서버 설정 확인: DNS 서버 설정이 올바른지 확인하였고, 브라우저와 인터넷 접속 테스트를 통해 문제가 DNS 서버 자체에 있지는 않음을 확인했습니다.

방화벽 설정 확인: 방화벽이 DNS 쿼리 트래픽을 차단하는 상황을 고려하여, 특히 UDP 53번 포트가 차단되었을 가능성을 확인했습니다. 아웃바운드 규칙에서 이와 관련된 트래픽을 허용하기 위해 방화벽 설정을 점검하고 수정하였습니다.

DNS 캐시 문제 해결: 로컬에서 ipconfig/flushdns 명령어를 사용해 DNS 캐시를 비우고 다시 테스트하였으나 문제는 해결되지 않았습니다. 이로 인해 DNS 캐시 문제는 원인이 아님을 확인하였습니다.

보안 그룹 설정 확인: AWS 보안 그룹에서 아웃바운드 규칙이 모든 TCP 트래픽을 허용하도록 설정되어 있는지 확인하였고, 이를 통해 DNS 트래픽이 정상적으로 처리될 수 있도록 했습니다.

개선 결과

•

아웃바운드 규칙에서 모든 TCP 트래픽을 허용하도록 보안 그룹 설정을 수정한 후, DNS 쿼리가 정상적으로 처리되기 시작했습니다.

•

Unknown Host 에러는 더 이상 발생하지 않았고, 클라이언트 라이브러리를 통한 DNS 조회가 원활하게 이루어졌습니다.

•

방화벽 설정을 통해 네트워크 트래픽 흐름을 관리함으로써, DNS 쿼리 문제를 해결하여 크롤링 기능이 정상적으로 작동할 수 있게 되었습니다.

해당 경험을 통해 알게 된 점

이번 트러블 슈팅을 통해 네트워크 및 보안 설정이 애플리케이션의 안정성에 미치는 영향을 깊이 이해하게 되었습니다. 특히, DNS 쿼리와 관련된 네트워크 문제는 애플리케이션이 제대로 동작하지 못하게 만들 수 있으며, 이를 해결하기 위해서는 네트워크 트래픽 흐름에 대한 세심한 관리와 설정이 필요하다는 것을 배웠습니다.

처음 설정한 아웃바운드

변경된 아웃바운드

트러블 슈팅 2

문제 배경

Elasticsearch를 AWS EC2에 설정한 후, 프리티어(t2.micro) 인스턴스에서 실행하려 했지만 서비스가 시작되지 않고 계속해서 실패하는 문제가 발생했습니다. systemctl status elasticsearch와 journalctl 로그를 확인한 결과, Elasticsearch가 제대로 시작되지 않고 오류를 반환하는 것을 확인할 수 있었습니다. 프리티어의 제한된 리소스(RAM 1GB)로 인해 Elasticsearch가 요구하는 메모리 용량을 감당하지 못하는 것이 문제의 원인으로 추측했습니다.

해결 방법

RAM 확인 및 업그레이드: 메모리 부족이 문제의 원인일 가능성이 높아, 프리티어에서 제공되는 RAM(1GB) 대신 4GB RAM을 제공하는 인스턴스 타입(t2.medium)으로 변경했습니다.

Elasticsearch 재설치 및 설정 최적화: 기존 설치된 Elasticsearch를 완전히 제거하고, 다시 설치한 후 설정 파일을 최적화했습니다. network.host 설정을 0.0.0.0으로 설정하여 외부 접속을 허용하도록 했습니다.

서비스 재시작 및 상태 확인: 수정 사항을 적용한 후 Elasticsearch 서비스를 다시 시작하고 정상적으로 작동하는지 확인했습니다.

개선 결과

RAM을 4GB로 확장한 후 Elasticsearch는 성공적으로 시작되었고, 로그 파일에서 더 이상 메모리 부족 관련 오류가 나타나지 않았습니다. 서비스는 안정적으로 작동했고, 웹 브라우저를 통해 http://ec2-3-35-54-47.ap-northeast-2.compute.amazonaws.com:9200로 접속해 Elasticsearch가 정상적으로 작동하는 것을 확인할 수 있었습니다.

해당 경험을 통해 알게 된 점

리소스가 충분하지 않은 환경에서 메모리 집약적인 애플리케이션을 실행하면 불안정성이 발생할 수 있으며, 로그 분석과 설정 최적화를 통해 문제를 해결하고, 적절한 인프라 선택이 애플리케이션의 성능과 안정성에 중요한 영향을 미친다는 것을 배웠습니다.

트러블 슈팅 3

문제 배경

빌드 및 배포 과정에서 애플리케이션이 정상적으로 실행되지 않는 이슈가 발생했습니다. 구체적으로, AWS Elastic Beanstalk 환경에서 배포 시 Java 프로세스가 제대로 시작되지 않고, CORS 관련 오류로 인해 프론트엔드에서 API 요청이 차단되었습니다. 또한, 환경 변수 설정이 누락되어 일부 기능이 비활성화된 문제가 있었습니다.

해결 방법

프로세스 시작 문제 해결: 00-makeFiles.config 파일을 점검한 결과, 프로세스를 시작하는 부분에서 환경 변수가 제대로 설정되지 않았음을 발견했습니다. 이를 수정하기 위해 java -Dloader.main=marketnawa.be.ott.marketnawabe.MarketNawaBeApplicationKt -Dfile.encoding=UTF-8 -jar $JAR_PATH 명령을 사용하여 애플리케이션을 올바르게 시작하도록 설정을 변경했습니다.

CORS 문제 해결: Kotlin에서 CORS 설정을 추가하여 특정 도메인에서만 요청을 허용하도록 구성했습니다. 이 과정에서 CORS 설정이 누락되어 API 호출이 차단되었음을 인지하고, 설정 클래스를 추가했습니다.

환경 변수 설정 오류 수정: 배포 환경에 필요한 외부 서비스의 환경 변수를 제대로 설정하지 않아 일부 기능이 비활성화되었습니다. 이를 해결하기 위해 환경 변수 설정을 재검토하고, 필요한 값을 모두 지정하여 애플리케이션이 정상적으로 작동하도록 조치했습니다.

개선 결과

•

프론트엔드에서의 API 요청이 정상적으로 처리되었고, CORS 문제도 해결되었습니다.

•

모든 기능이 의도한 대로 작동하며, 빌드 및 배포 과정의 안정성이 크게 향상되었습니다.

해당 경험을 통해 알게 된 점

•

환경 변수 설정이 배포의 핵심 요소임을 다시 한번 깨달았습니다. 특히 외부 서비스와의 통합 시 환경 변수를 정확히 설정해야 예상치 못한 오류를 방지할 수 있습니다.

•

배포 환경의 특성을 고려한 설정이 매우 중요하다는 점을 알게 되었습니다. 로컬 개발 환경에서 정상 동작하더라도, 배포 환경에서는 추가적인 설정이 필요할 수 있음을 인지하게 되었습니다.

•

트러블슈팅 과정에서 로그와 설정 파일을 꼼꼼히 점검하는 것이 문제를 신속하게 해결하는 데 큰 도움이 되었습니다.

makeFiles.config파일

CorsConfig 파일

🫡 회고

“문제 해결의 본질을 깨달으며 성장하는 과정”

마켓나와 프로젝트는 다양한 기술과 환경에서의 문제를 경험하고 해결해 나가는 중요한 기회가 되었습니다. 이번 프로젝트를 통해 여러 기술적 도전과 장애를 겪었지만, 그 과정에서 배운 점은 앞으로의 개발자로서의 역량을 더욱 강화시켜주었습니다. 특히 네트워크 관련 문제 해결, 인프라 최적화, 그리고 배포 환경에서의 세부적인 설정 관리와 같은 중요한 요소들을 배울 수 있었던 값진 시간이었습니다.

마켓나와

트러블 슈팅 2

문제 배경

해결 방법

개선 결과

해당 경험을 통해 알게 된 점

트러블 슈팅 3

문제 배경

해결 방법

개선 결과

해당 경험을 통해 알게 된 점

.css-hopgjw{font-family:var(--emoji-font-family);white-space:nowrap;}🫡 회고

🫡 회고