본문 바로가기
728x90
반응형

전체 글348

Rust Cargo workspace로 API와 배치의 책임 분리하기 개인 프로젝트의 백엔드는 처음에 하나의 실행 파일에서 HTTP API와 배치 작업을 함께 처리했습니다. 이후 API와 배치를 별도 바이너리로 나눴지만, 공통 크레이트에는 여전히 API 라우트와 배치 전용 작업 코드가 섞여 있었습니다. 이번에는 실행 파일을 나누는 수준을 넘어, 각 바이너리가 실제로 소유해야 할 코드까지 역할에 맞게 옮겼습니다. API 크레이트는 HTTP 서버와 API 기능을, 배치 크레이트는 배치 실행에 필요한 클라이언트·작업·저장소·서비스를 담당하도록 정리했습니다.바이너리 분리만으로는 부족했던 이유API 서버와 배치 작업은 실행 수명이 다릅니다. API 서버는 계속 실행되며 요청을 처리하고, 배치는 명령을 받아 작업을 수행한 뒤 종료됩니다. 처음에는 이 차이에 맞춰 실행 파일만 분리했습.. 2026. 11. 17.
[책 리뷰] SQL 레벨업 이번 포스팅에서는 SQL 레벨업 이라는 책에 대하여 다뤄보고자 합니다.책을 선택한 이유학부생 시절, MySQL을 활용하여 웹 풀스택 게시판 프로젝트를 진행한 경험이 있습니다. 당시에는 프로젝트를 구현하는 데 필요한 기본적인 SQL 문법을 익히고 활용하는 데 집중했습니다. 이후에는 알고리즘에 관심이 생기면서 SQL 학습에는 상대적으로 소홀해졌습니다. 첫 회사에서는 검색엔진 관련 개발 업무를 담당했습니다. SQL보다는 검색 로직이나 애플리케이션 내부의 처리 과정에서 발생하는 성능 문제를 해결하는 데 더 많은 관심을 가지고 학습했습니다. 이후에도 주로 기능 개발을 중심으로 업무를 진행하다 보니 SQL을 직접 최적화하거나 데이터베이스 설정을 변경할 기회는 많지 않았습니다. 그러던 중 최근 개인 프로젝트로 웹 서.. 2026. 11. 16.
Cargo와 pnpm으로 의존성 관리 기준 세우기 이전에 cargo update가 만든 의외의 함정이라는 글을 작성했습니다. 이 글에서는 cargo update가 여러 의존성을 한 번에 갱신하면서 빌드 오류로 이어졌던 경험을 다뤘습니다. 그 뒤로 개인 프로젝트에서는 cargo update를 바로 실행하지 않았습니다. 먼저 cargo update --dry-run으로 변경 예정인 항목을 확인하고, 실제 업데이트가 필요할 때는 cargo update -p {library}로 대상을 지정했습니다. 한 번에 바뀌는 범위를 작게 유지하면 빌드나 테스트가 실패했을 때 원인을 확인하기 쉬웠습니다. 그러던 중 pnpm에도 새 릴리스의 반영 시점을 조절하는 기능이 있다는 점을 확인했습니다. Cargo와 pnpm의 기능은 같은 이름은 아니지만, 새 의존성을 바로 반영하지.. 2026. 11. 13.
Vite 8과 Rolldown을 적용하며 달라진 점 Vite의 Rust로 만든 Rolldown이 도입되었다는 사실을 듣고, Vite를 8버전으로 업그레이드 했었습니다. 이번 포스팅에서는 Rolldown이 무엇인지, 그리고 Vite 8을 적용하면서 실제로 어떤 변화가 있었는지를 간단히 정리해 봤습니다.Rolldown이란 무엇인가Rolldown은 JavaScript와 TypeScript 프로젝트를 위한 번들러입니다. 여러 파일과 의존성을 분석해 브라우저가 실행할 수 있는 파일로 묶고, 필요한 경우 여러 청크로 나누는 역할을 합니다. Vite 8부터는 이 Rolldown이 Vite의 빌드 엔진으로 사용됩니다. 개발자는 별도의 Rolldown 설정 파일이나 CLI를 새로 도입하지 않아도 됩니다. 기존처럼 vite와 vite build 명령을 사용하면서, 내부 빌.. 2026. 11. 12.
WebSocket으로 만든 실시간 마을: 접속 상태부터 채팅까지 개인 프로젝트에 여러 사용자가 같은 3D 공간에서 서로를 보고, 이동하고, 채팅할 수 있는 '마을' 기능을 만들었습니다. 해당 마을을 구현하는데 WebSocket 연결을 하나 열어서, 서로 실시간 이벤트를 주고받도록 만들었습니다. 해당 포스팅은 HTTP API와 WebSocket의 역할은 어떻게 나눴는지, 서버가 어떤 상태를 가지게 되는지, 끊김과 중복 접속은 어떻게 다뤘는지에 대해 작성하였습니다.왜 Pooling 대신 WebSocket이었을까마을에는 다음과 같은 이벤트들이 발생합니다.누군가가 입장하거나 퇴장한다.캐릭터가 다른 위치로 이동한다.보여지고 있는 탭이 숨겨져 자리비움 상태가 된다.점프나 미니게임 성공 알림이 발생한다.채팅 메시지가 추가된다.Pooling으로 구현하면 클라이언트가 일정 간격마다 .. 2026. 11. 10.
인바운드 API 인증 로그 살펴보기 서비스 로그를 보다가 낯익으면서도 조금 신경 쓰이는 경고를 만났습니다.WARN backend: 인바운드 API 요청 거부 method=GET fetch_site=missing has_origin=false has_referer=false처음에는 GET 요청인데 왜 거부됐을까 싶었습니다. 데이터를 읽는 요청이라면 무해한 것 아닐까 하는 생각도 들었고요. 하지만 이 로그는 오류라기보다, 보호된 API가 제 역할을 했다는 기록에 가깝습니다. 이번 글에서는 이 한 줄의 경고가 어떤 상황에서 남는지, 그리고 운영 중 무엇을 확인하면 좋은지 정리해 봅니다.이 로그가 말해 주는 것예시 프로젝트인 프로젝트A의 보호된 /api/* 및 /api/logic/* 경로는 요청을 처리하기 전에 인바운드 인증 미들웨어를 거칩니다... 2026. 11. 9.
TraceDeck — 로그 확인을 위한 개인용 데스크톱 앱 개인 웹 프로젝트를 운영하면서 서버 로그를 확인할 일이 많았습니다. 기존에는 매번 SuperPuTTY나 MobaXterm 같은 터미널 에뮬레이터를 열고, 서버에 접속한 뒤 로그 폴더로 이동해 다음 작업을 반복했습니다.SSH로 운영 서버에 접속한다.로그가 저장된 폴더로 이동한다.cat으로 이전 로그를 확인한다.tail -f로 새 로그를 실시간으로 확인한다.문제가 발견되면 코드를 수정하고 다시 배포한다.반복적인 작업 자체는 단순했지만, 두 가지가 특히 불편했습니다.프로그램을 실행할 때마다 서버 접속과 로그 폴더 이동을 반복해야 한다.긴 경로나 파일명을 직접 입력하다 보니 오타가 자주 발생한다.이 문제를 줄이기 위해 Codex와 함께 TraceDeck을 만들기 시작했습니다.계획먼저 실제 사용 흐름을 기준으로 .. 2026. 11. 2.
Vite 개발 서버와 Rust 백엔드 자동 재시작 구성하기 React/Vite 프런트엔드와 Rust 백엔드를 함께 개발할 때, 프런트엔드 변경은 곧바로 화면에 반영되지만 Rust 변경은 서버를 다시 컴파일하고 재시작해야 한다. 이 글은 두 개발 경험을 하나의 실행 명령으로 묶는 일반적인 방법을 정리한다. 프로젝트 구조는 다음과 같다.example-service/├── frontend/ # Vite 기반 프런트엔드├── backend/ # Rust HTTP 서버├── package.json└── .env원하는 개발 경험개발 서버를 실행한 뒤 파일을 저장했을 때의 기대 동작은 다음과 같다.변경 대상원하는 반영 방식React·TypeScript·CSSVite HMR로 브라우저를 갱신Rust 소스백엔드를 다시 컴파일하고 재시작DB 마이그레이션백엔.. 2026. 10. 29.
6개 웹 백엔드 프레임워크 성능 비교 Rust Axum, Java Spring Boot, Node.js NestJS, Python FastAPI, Go Gin, ASP.NET Core를 같은 PC에서 비교했다. 이번 글은 목표 10,000 RPS, 500 VU, 병렬도 4 조건에서 네 가지 작업을 실행한 결과를 정리한다. 한눈에 보는 결론plaintext, json, aggregate 작업에서는 Axum, Spring Boot, Gin, ASP.NET Core가 대체로 목표 요청률에 근접했다.NestJS도 aggregate에서는 9,984.3 RPS를 기록했지만, json에서는 9,309.8 RPS로 목표보다 낮았다.FastAPI는 네 작업 모두 목표 요청률에 도달하지 못했다. 특히 큰 JSON 응답에서는 1,600.2 RPS였다.항목 1,.. 2026. 10. 24.
728x90
반응형