개발공부 블로그

[vscode-loc] vscode 확장 이진탐색 번역수정 기여

박종범_ — Tue, 2 Jun 2026 10:16:19 +0900

0.개요

지난번 vscode 확장에서 오류가 났을때 확장 이분탐색 기능을 이용했었다.

https://asa9874.tistory.com/739

vscode 확장 프로그램 이분 탐색(Extension Bisect)

0. 개요오늘도 평화롭게 vscode를 키니 확장에서 오류나 나기때문에 확장 프로그램 이분탐색을 시작해보자 1.확장 프로그램 이분탐색이란vscode에서 확장을 절반씩 키고 문제여부를 판단해가며 이

asa9874.tistory.com

그 과정에서 "재현할 수 없음", "재현할 수 있음"으로 번역된 버튼들이 너무 직역된거같아서 이해하기 어려웠기 때문에 기여하기로 하였다.

1. VScode-loc

vscode-loc은 vscode의 번역을 위한 레포지토리이므로 해당 레포지토리에 기여하도록하겠다.

https://github.com/microsoft/vscode-loc

GitHub - microsoft/vscode-loc: VS Code Localization Extension

VS Code Localization Extension. Contribute to microsoft/vscode-loc development by creating an account on GitHub.

github.com

기여 방법을 보았을때, 번역의 경우 PR없이 단순 이슈로 기여를 한다면 내부에서 확인후 적용하는 형식으로 진행되는듯하다.

2. 원문 찾기

번역은 다음 extensionBisect 파일에서 번역파일을 찾을수있었다.
I cannot reporoduce는 문제가 다시발생하지않는다는 의미이고, This is bad는 문제가 다시 발생해서 나쁘다는 의미 인듯하다.

"vs/workbench/services/extensionManagement/browser/extensionBisect": {
   "I cannot reproduce": "재현할 수 없음",
   "This is Bad": "재현할 수 있음",
}

3. 번역 제안 이슈올리기

이제 위의 이러한 내용들을 담은 이슈를 올렸다.

https://github.com/microsoft/vscode-loc/issues/2227

[Korean] Improve translation for Extension Bisect buttons ("I cannot reproduce", "This is Bad") · Issue #2227 · microsoft/vsco

The current translations for the action buttons in the "Extension Bisect" notification are too formal and literal. I suggest changing them to more intuitive expressions that clearly represent the s...

github.com

4. 이슈 반영

그후 마이크로소프트 내부 팀에서

Internally tracking via ADO#1145327를 남겨주며 내부 팀에서 작업번호로 설정후 검토하고있음을 알리는 댓글이 달렸고, 그후 반영되었음을 알리는 댓글이 달렸다.

5. 반영된 내용 확인

내가 이슈한 그대로 반영되지는 않았지만 이제 직관적으로 어떤 내용인지 알수있게 번역되었다.

재현할 수 없음 => 현재 문제가 발생하지 않음

[vscode] github copilot 커밋시 co-authored 붙는거 제거하기

박종범_ — Sat, 2 May 2026 20:46:12 +0900

0. 개요

vscode에서 copilot을 사용하며 같이 코딩을 하던중 커밋기록에 Co-authored로 생성되는걸 발견하였다.
보니까 vscode쪽에서 조용히 이런기능을 넣은거같은데 이러면 내 코드베이스에서 copilot의 자동완성기능만 한번 사용해도 동업자로 표기하게 되는 참 이해할수없는 업데이트다.

1. 제거법

윈도우 유저면 control + , 를 눌러서 설정창을 열고 co-authored 를 검색해서

Git: Add AI Co Author 을 off로 표기해두자.

2. 사담

이 설정이 20260502기준 기본이 On으로 설정되어있고 Off로 해달라는 PR도 올라온 상태이다.
관심있으면 아래 PR 주소를 참고하자

https://github.com/microsoft/vscode/pull/313725

Default `git.addAICoAuthor` to `off` by typed-sigterm · Pull Request #313725 · microsoft/vscode

The unauthorized addition of product advertisements without notifying users has drawn widespread criticism: https://github.com/orgs/community/discussions/194075 https://news.ycombinator.com/item?i...

github.com

vscode 자바 클래스들 경로 안잡힐때 해결법

박종범_ — Tue, 28 Apr 2026 19:42:44 +0900

0. 개요

vscode는 아무래도 자바만을 위한 툴이 아니고 기본적으로 확장 기능으로 요소들을 추가해나가는 느낌이라 인텔리제이에서는 겪은적없는 문제들이 가끔씩 발생하는데 특히 SpringBoot에서 Gradle로 사용할때 자바 클래스 경로가 안잡힐때가 있어서 이에 대해 알아보자

1. 해결법

일단 해결법은 Ctrl + Shift + P로 명령어 팔래트를 열고 Java: Clean Java Language Server Workspace 를 찾아 누르는 것이다.
자바의 워크스페이스 초기화를 통해 꼬여버린 캐시를 정리하고 다시 재정립해준다.

2. 해결법 2

만약 gradle을 쓰고있는데 위의 해결법으로 해결이 안된다면 Gradle 프로젝트 새로고침를 한번 해보자

vscode 확장 프로그램 이분 탐색(Extension Bisect)

박종범_ — Mon, 27 Apr 2026 17:48:25 +0900

0. 개요

오늘도 평화롭게 vscode를 키니 확장에서 오류나 나기때문에 확장 프로그램 이분탐색을 시작해보자

1.확장 프로그램 이분탐색이란

vscode에서 확장을 절반씩 키고 문제여부를 판단해가며 이분탐색을 통해 문제있는 확장을 찾아가는 방법이다.

각 과정에서 문제가 없으면 재현할 수 없음, 문제가 있으면 재현할 수 있음을 선택해가며 나아가면 된다.

이 과정을 반복하면 최종적으로 문제있는 확장이 찾아진다. 이확장을 사용하지않도록 유지를 체크하고 계속을 누르면 문제 확장이 자동으로 비활성화된다.

[개발지식] WS(Web Server)

박종범_ — Mon, 27 Apr 2026 00:16:01 +0900

0.개요

웹 서버와 웹 애플리케이션 서버의 차이에 대해서는 어느정도 알고있다.
웹 서버는 클라이언트로부터 HTTP 요청을 받으면 서버에 저장된 정적 자원을 반환하는 역할을 주로 하고, 웹 어플리케이션 서버는 사용자의 요청에 따라 서버 단에서 코드를 실행하고 DB와 통신하는 주로 서버라고 말하는 파트이다.

오늘은 단순히 이런정의 말고 내가 만들었던 프로젝트 코드를 통해 웹서버의 실제 용도 조금 깊게 알아보고자 한다.

1. 웹서버 (webserver)

1-1. 웹서버 종류

자주쓰이는 웹서버로는 다음 2가지 정도가 있을거같다.

일단 전통적으로 사용하던 Process/Thread 기반구조를 사용하는 Apache HTTP Server가 있고, 지금 최근에 가장 많이 쓰이는 웹서버인 Nginx가 있다. 특히 Nginx는 리버스 프록시, 로드 밸런서, 메일 프록시기능이 강해서 최근에 많이 쓰인다.

1-2.정적 콘텐츠 서비스

웹 서버의 가장 본연적인 역할이라고 할수있는 기능으로 정적 콘텐츠를 클라이언트에게 제공하는 역할을 해준다.
뒷단의 WAS가 이 역할까지 하면 WAS의 리소스소모가 커지기 때문에 웹서버에게 맡겨서 응답 속도를 높혀준다.

정적파일들

1-3.리버스 프록시

웹서버는 클라이언트의 요청을 대신 받아 내부 서버(WAS)로 전달하는 중계자 역할을 할수도있다.

아래는 SpringBoot와 함께 사용했던 Nginx의 일부인데 외부 사용자는 http://your-domain.com (기본 80포트)으로 접속하지만, Nginx는 이를 내부망에 숨겨진 172.18.0.4:8080으로 넘긴다. 사용자는 실제 포트가 8080인지, 서버 IP가 무엇인지 알수없게된다.

upstream spring_app {
    server 172.18.0.4:8080; # 실제 Spring Boot가 떠 있는 내부 IP와 포트
}

location / {
    proxy_pass http://spring_app; # 들어온 요청을 위에서 정의한 곳으로 전달
    ...
}

1-4.로드 밸런싱 (Load Balancing)

웹서버는 트래픽이 몰릴 때 여러 대의 WAS로 요청을 공평하게 나누어 주는 역할을 수행해줄수도있다.
한 서버에 요청이 집중되는 것을 방지해주고 WAS에 장애가 발생하면 웹 서버가 이를 감지하고 정상적인 서버로만 요청을 보내 서비스가 중단되지 않게한다.

아래는 10~50명 사용자일때 만들어본 Nginx를 이용해서 로드밸런싱예시다.

1-5. SSL/TLS 종단

보통 보안을 위해 HTTPS를 사용하게 되는데, 외부(클라이언트)와 Nginx 사이는 HTTPS로 암호화하고, Nginx와 내부 서버 사이는 가벼운 HTTP로 통신하는 방식을 사용할수 있게 해준다.
내부까지 HTTPS를 사용하면 CPU 연산량을 꽤 많이 잡아먹기 때문에 필요하다.

아래는 Nginx 파일의 일부이다. 이렇게 설정하면 외부 사용자는 HTTPS로 안전하게 접속하지만, 내부의 spring_app은 복잡한 SSL 설정 없이 평범한 HTTP 요청으로 데이터를 받아 처리할 수 있게 된다.

server {
     listen 80;
     ...
     # HTTP를 HTTPS로 리다이렉트
     return 301 https://$server_name$request_uri;
 }

server {
    listen 443 ssl; # HTTPS 표준 포트
    ssl_certificate /path/to/fullchain.pem; # 인증서 경로
    ssl_certificate_key /path/to/privkey.pem; # 비밀키 경로

    location / {
        proxy_pass http://spring_app; # 내부로는 여전히 http로 쏜다!
        ...
    }
}

1-6. 데이터 압축 및 캐싱

웹 서비스의 응답 속도를 높이고 서버의 자원을 아끼기 위해 웹서버에서는 데이터압축,캐싱기능을 지원해준다.
데이터 압축은 서버가 클라이언트에게 파일을 보내기 전, 용량을 줄여서 전송하는기능이다.
주로 Gzip을 사용하고 HTML, CSS, JS, JSON 등을 압축하기 좋다.

아래는 내가 사용했던 Nginx 설정값이다.

gzip on;                  # 압축 활성화
gzip_comp_level 6;        # 압축률 설정 (1~9, 6이 성능과 압축률의 적정선)
gzip_types application/json ...; # 어떤 파일들을 압축할지 지정

캐싱 기능은 API 서버같은곳에서 웹서버를 사용할때 사용자가 옛날 데이터를 보게 될 위험이 있기 때문에 잘 사용하지않지만 이미지나 CSS 파일을 Nginx를통해 제공하면 캐싱기능또한 사용할수있다.

[Docker] Docker Hub로 CD(Continuous Delivery)

박종범_ — Sat, 25 Apr 2026 21:54:22 +0900

0.개요

졸업작품을 만들면서 EC2에서 Docker로 SpringBoot, RabbitMQ,Mysql을 배포하게되었는데
SpringBoot의 코드를 CD(Continuous Delivery)하는 플로우를 만들어볼려고 했는데 마침 Docker에서 무료로 DockerHub Private Repository 1개를 지원해주길래 그를 이용하여 CD를 구축해보았다.

1. Docker Hub 란

Docker에서 운영하는 클라우드 기반의 컨테이너 이미지 저장소 서비스이다.
쉽게말하면 Docker 버전의 Github이다. 여기서 Dockerhub은 코드가 아닌 "이미지"를 올린다.

2.Docker Hub 사용방법.

2-1. 레포지토리 만들기

우선 DockerHub을 사용할려면 Docker 계정이 필요하다.

https://hub.docker.com/

Docker Hub Container Image Library | App Containerization

Software supply chain Secure Your Supply Chain with Docker Hardened Images Use Docker's enterprise-grade base images: secure, stable, and backed by SLAs for Ubuntu, Debian, Java, and more. Regularly scanned and maintained with CVE remediation and long-term

hub.docker.com

Docker가입을 하고 위의 사이트에 들어가면 DockerHub의 Repository를 관리할수있다.
우상단의 Create a Repository 버튼을 누르자

누르면 레포지토리를 만들수있게된다.
(무료 회원은 private는 1개까지라 나는 잠겨있다.)

2-2. 레포지토리에 이미지 업로드하기

다른 방법도 존재하겠지만 이번에는 Local 환경에서 이미지를 업로드하는법에 대해 작성할것이다.
우선 터미널에서 Docker Hub 계정으로 로그인해야 권한을 얻을 수 있다.

docker login

Docker Hub에 올릴 수 있도록 계정명을 포함하여 이미지를 생성한다.

docker build -t [도커허브_계정명]/[저장소명]:[태그] .

이름이 지정된 이미지를 원격 저장소(Docker Hub)로 전송한다.

docker push [도커허브_계정명]/[저장소명]:[태그]

2-3. 레포지토리에서 이미지 불러오기

이미지를 서버에 다운로드한다.

docker pull [도커허브_계정명]/[저장소명]:[태그]

기존 컨테이너를 중지 및 삭제한다.

docker stop [컨테이너_이름]
docker rm [컨테이너_이름]

새 컨테이너 실행을한다.

docker run -d -p [호스트_포트]:[컨테이너_포트] --name [컨테이너_이름] [도커허브_계정명]/[저장소명]:[태그]

3. 내 졸작 프로젝트에서 실전 만들어보기

3-1. Push 과정

하나의 스크립트 파일로 만들어서 편하게 할수있게 만들었다.
(소규모 프젝이라 내가 직접 수동으로 관리할수있게 자동화는 안했다.)

Docker 엔진이 현재 켜져 있는지 먼저확인한다.

docker info >nul 2>&1

Docker 이미지를 만들기 전, 이미지 안에 들어갈 실행 파일(JAR)을 먼저 만들고,
위에서 썼던 Docker build 명령어를 사용하여 빌드한다. 특정 버전 태그 외에도, 언제나 최신판임을 알리는 latest 태그를 하나 더 생성하였다. (편의성을 위해)

call gradlew.bat build -x test
set "FULL_IMAGE_NAME=%DOCKERHUB_USERNAME%/%IMAGE_NAME%:%TAG%"
docker build -t "%FULL_IMAGE_NAME%" .
docker tag "%FULL_IMAGE_NAME%" "%LATEST_IMAGE_NAME%"

빌드된 이미지를 원격 저장소로 업로드합니다.

docker push "%FULL_IMAGE_NAME%"
docker push "%LATEST_IMAGE_NAME%"

최종 스크립트는 이렇게 작성하였다.

@echo off
setlocal

REM --- [설정 구간] ---
set "DOCKERHUB_USERNAME=본인의_아이디"
set "IMAGE_NAME=이미지이름"
set "TAG=%1"

REM 태그를 입력하지 않고 실행하면 기본값으로 'latest' 사용
if "%TAG%"=="" set "TAG=latest"
REM ------------------

echo >>> 1. JAR 파일 빌드 중...
call gradlew.bat build -x test

echo >>> 2. Docker 이미지 빌드 중... (태그: %TAG%)
docker build -t %DOCKERHUB_USERNAME%/%IMAGE_NAME%:%TAG% .

echo >>> 3. 'latest' 태그 추가 지정...
docker tag %DOCKERHUB_USERNAME%/%IMAGE_NAME%:%TAG% %DOCKERHUB_USERNAME%/%IMAGE_NAME%:latest

echo >>> 4. Docker Hub로 푸시 중...
docker push %DOCKERHUB_USERNAME%/%IMAGE_NAME%:%TAG%
docker push %DOCKERHUB_USERNAME%/%IMAGE_NAME%:latest

echo >>> 모든 작업 완료!
endlocal

3-2. pull & run 과정

이 과정은 Ec2에서 이뤄진다.
Docker Hub에 올려둔 최신 이미지를 서버로 가져온다.

docker pull "${DOCKERHUB_USERNAME}/${IMAGE_NAME}:${IMAGE_TAG}"

새 버전을 실행하기 위해 현재 돌아가고 있는 이전 버전의 컨테이너를 끕니다.

docker compose -f docker-compose.prod.yml down --remove-orphans

다운로드한 최신 이미지를 바탕으로 서비스를 다시 시작합니다.
(여기선 docker-compose를 사용하였기 때문에 이런식으로 작성했다.)

docker compose -f docker-compose.prod.yml up -d

최종스크립트는 이렇다.

# 1. 환경 변수 및 설정 로드
# .env 파일에 정의된 DOCKERHUB_USERNAME, IMAGE_NAME 등을 읽어옴
set -a
source .env
set +a

# 실행 시 인자가 없으면 기본값으로 'latest' 사용
TAG="${1:-latest}"
FULL_IMAGE="%DOCKERHUB_USERNAME%/%IMAGE_NAME%:%TAG%"

# 2. Docker Hub에서 최신 이미지 다운로드 (Pull)
# 서버 환경에 최신 빌드본을 미리 가져옵니다.
docker pull $FULL_IMAGE

# 3. 기존 컨테이너 중지 및 삭제 (Down)
# docker-compose.prod.yml 파일에 정의된 구버전 서비스를 종료합니다.
# --remove-orphans: 설정 파일에 없는 불필요한 컨테이너까지 정리
docker compose -f docker-compose.prod.yml down --remove-orphans || true

# 4. 새 컨테이너 백그라운드 실행 (Up)
# -d 옵션으로 백그라운드에서 실행하여 터미널을 종료해도 서비스 유지
docker compose -f docker-compose.prod.yml up -d

[개발지식] API 버전관리 , API 시맨틱 버저닝

박종범_ — Fri, 24 Apr 2026 14:10:41 +0900

0. 개요 API 버전관리

졸업작품을 만들면서 API의 구조를 손봐야할일이 생겼다.
그런데 지금 이 구조를 바로 바꿔버리면 클라이언트쪽에서 오류가 발생할것이기때문에 하위호완성으로 기존 API는 남겨두고 나중에 지울목적으로 두고 V2,V3이런식으로 확장해나갔었다. 이런 API 버전관리에 대해 알아 보기위해 글을 작성한다.

2. API 버전관리 방법

API 버전 관리는 하위 호환성을 유지하면서 API를 개선해 나가는 과정이다.
새로운 기능을 출시하거나 기존 기능을 수정할 때, 기존 API를 사용 중인 클라이언트가 오류 없이 작동하도록 하기 위함이다.

2-1.URI 경로 (Path Variable) 방식

내가 위에서 사용한 방법이다. 가장 직관적이고 많이 쓰이는 방식이라고 한다.
사실 다른 API 서비스들에서도 이런 방식이 제일 많이 보인다.

https://api.example.com/v1/users

2-2.Query Parameter 방식

URL 끝에 파라미터를 붙인다. 경로 자체가 바뀌지 않아 리소스중심의 설계를 했다고 볼수있지만 개인적으로는 쿼리스트링이 붙는게 별로 예뻐보이지않는다.

https://api.example.com/users?version=1

2-3.Header 방식

HTTP 헤더에 버전 정보를 담는다. 겉으로 보기에는 가장깔끔해보일수있지만 클라이언트가 헤더를 일일이 설정해야 하며, 테스트 시 헤더를 별도로 세팅해야한다는 불편함이 있다.

X-API-VERSION: 1

3.API 시멘틱 버저닝

소프트웨어나 API의 버전 번호를 부여할 때 직관적으로 예측할 수 있게 만든 규칙이라고 한다.

MAJOR.MINOR.PATCH

3-1.MAJOR

기존 API의 작동 방식을 아예 바꿀 때

3-2.MINOR

기존 기능은 놔두고, 새로운 기능을 추가할 때

3-3.PATCH

기존 기능의 내부적인 버그만 고쳤을 때

인생회고

박종범_ — Fri, 24 Apr 2026 13:45:50 +0900

0. 게임을 좋아하는 아이(~2016)

어릴 때는 게임을 좋아하던 아이였습니다. 스타크래프트, 스팀 게임, 마인크래프트, 넥슨 게임, 그리고 최고 인기 게임인 리그 오브 레전드, 오버워치까지 게임이라면 뭐든 좋아했고 인터넷과 정말 친하게 지내던 아이였습니다.

단순히 게임하는 것만 좋아하는 게 아니라 인터넷에서 구한 마인크래프트 서버를 여는 프로그램으로 직접 서버를 열고 세팅하며, 친한 사람들과 게임을 즐기던 시절입니다. 이때 서버를 열고 멀티를 위해 주로 사용한 VPN 프로그램인 하마치(Hamachi)를 사용했는데, 이것들이 각각 뭘 하는 건지는 몰라도 오류가 나면 인터넷에서 찾아 해결하면서 컴퓨터 세상에 익숙해졌습니다.

1. 개발을 처음 접하다 (2017년 3월, 16세, 중학교 3학년)

중학교 3학년 무렵, 저는 딱히 꿈이 없는 학생이었습니다. 그러다 우연히 정보 수업에서 '엔트리'라는 블록 코딩을 처음 접하게 되었는데, 그것이 제 개발 인생의 첫 단추가 될 줄은 그때는 미처 몰랐습니다.

블럭 코딩 사이트 entry

단순히 다른 학생들처럼 시각적으로 무언가를 만들고 움직이게 하는 것도 재밌었지만, 저에게 더 재미있었던 것은 함수 블록을 만들어서 각각의 떨어지는 운석에 중력 가속도를 적용한다든가, 제공하는 클라우드 변수 서비스에 데이터를 저장하여 랭킹 시스템을 만드는 게 재미있었습니다. 이때까지만해도 아직 코딩은 재미있는 놀이 정도였습니다.

https://playentry.org/community/tips/list?query=%EC%A0%80%EC%9E%A5%EA%B8%B0%EB%8A%A5&term=all&sort=score

2. C언어를 처음 배워보다. (2017년 12월, 16세, 중학교 3학년)

슬슬 중학교를 졸업할 때가 다가왔습니다. 각자 어렴풋이 생각하는 진로에 따라 고등학교의 방향을 고민하는 시기. 저는 수업 때 재미있게 했던 엔트리를 생각해 보며 '프로그래밍 한 번 해볼까?'라는 생각으로 C 언어 책을 사서 공부해 보았습니다.

내가 구입한 책

명령어를 타이핑하여 컴퓨터 세계에서 원하는 대로 작동한다는 것은 너무 매력적이었습니다. 이때는 제 개인 방에 컴퓨터가 있던 시절도 아니어서, 컴퓨터를 사용할 수 없는 밤이 되면 노트와 책을 가지고 손코딩으로 C 언어를 직접 작성하며 공부했는데 그것만으로도 재미있었습니다. 이때 저는 생각했습니다. '아, 나는 개발자가 되자.'

3. 고등학교 시절 (2018년 ~ 2020년, 17~19세, 고등학생)

3-1. 공부하는 법을 배우다

사실 공부 자체는 1학년 때부터 되게 열심히 했다고 생각한다. 야자도 매일매일 참여했었다. 하지만 공부하는 법, 나에게 맞는 공부법에 대해서는 아직 모를 때였다. 그러다 2학년 1학기에 나에게 맞는 공부법을 슬슬 찾아가기 시작했고, 성적이 쭉쭉 상승했다.

3-2. 프로그래머

진로 희망은 여전히 프로그래머로 고등학교 생활을 지냈다.
이 시기에는 과목생기부용, 코딩 동아리용으로 만들었던 간단한 C언어 프로그램들이 있지만 이때는 Git을 몰랐기 때문에 남아있는 소스코드가 없다.

4. 컴퓨터공학부 1학년 (2021년, 20세, 대학생)

4-1. 첫 깃헙

2021년 5월 19일 대학교를 다니며 파이썬을 배우던중 Github에 첫가입을 하게된다.

처음올라간 프로젝트는 간단한 python 프로젝트로 당시 학교 교양 영어를 위한 단어풀기 프로그램였다.

4-2.첫 프로젝트 디스코드봇

2021년 9월 19일 친구들과의 디스코드방에서 사용할 디스코드봇을 만들어서 실제 배포까지 해보다. 클라우드 서비스로는 Heroku를 사용했는데 무료였지만 현재는 유료 서비스이다. 이때는 API의 개념도 잘모르고 한창 웹크롤링에 대해 재미를 느끼고있던 때라 API사용하면 편하게 만들걸 셀레니움을 사용했다. (대신 트러블슈팅 많이겪으며 성장하는 기회이간했다.)

4. 컴퓨터공학부 2학년 1학기(~2022년 9월, 21세, 대학생)

이 시기에는 학점을 챙기는거 이외에는 별도로 행동을 한게 없다. 왜냐하면 곧 군대를 가야할때라 그외에는 아무 생각이 안들었다.

2학년 1학기 학점

5. 군대 (2022년 9월20일 ~ 2024년 3월19일,22살~23살 군인)

22사단으로 군대를 다녀왔다.

훈련소 수료때 사진

6. 전역후 공백기 공부 (2024년 3월 ~ 2024 9월, 23살, 민간인)

6-1. 개발공부 블로그 시작 (2024.03.10)

이시기 전역하고 막 공부해보자는 마인드로 개발 블로그를 만들어보았다.

6-3.알고리즘 공부시작(2024.04.09)

지금은 이제 폐쇄되는 백준을 통해 알고리즘 공부를 처음으로 시작하였다.
이시기에 골드 2까지 찍었었다. 굿바이 백준

6-2.SQLD 자격증 취득(2024.05.25)

SQL도 공부하는김에 자격증 하나정도 따봐도 좋을거같아서 SQLD 자격증도 취득해보았다.

6-3. 프레임워크들과 언어들을 사용해보다(2024.05.01~)

이 시기엔 아직 내가 주로 뭘할지 탐색해보던 시절이라 여러 프로그래밍 언어, 프레임워크들을 유명한것들을 다 찍먹해보고 다녔었다.

이 시기에 배운 프론트엔드 Web으로 게임들을 만들면서 놀았었다.

6-4. 구글 클라우드로 디스코드 봇을 배포하다 (2024. 5. 20)

구글 클라우드 가입시 일정량 무료 토큰을 주길래 이번엔 입대전에는 몰랐던 API들을 잘 활용한 디스코드봇을 만들어서 배포해서 사용하였다.

https://asa9874.tistory.com/135

[Python]24시간 디스코드 봇 무료 호스팅하기 구글클라우드

1.Github 업로드제작한 python 소스 코드를 Github에 업로드 한다. 2.구글 클라우드 회원가입서버로 사용할 GoogleCloud사이트에 가서 회원가입을 한다.https://console.cloud.google.com/ Google 클라우드 플

asa9874.tistory.com

7. 2학년 2학기 (2024년 9월 ~ 2024 12월, 23살, 대학생)

7-1. 학교 개발동아리 BCSD-FrontEnd에 들어가다

학교의 동아리 BCSD에 들어갔다. 백엔드에 들어갈려고했는데 이번분기에는 백엔드 모집을 안한다고해서 공부겸 프론트엔드에 들어가서 활동했다. 리엑트, 타입스크립트의 숙련도를 높히고 프로젝트도 만들어보았다.

https://github.com/asa9874/product-recall-info

GitHub - asa9874/product-recall-info: React 회수상품

React 회수상품. Contribute to asa9874/product-recall-info development by creating an account on GitHub.

github.com

https://productrecall.netlify.app/

회수 제품 정보

회수 제품들에 대한 정보를 알아보세요

productrecall.netlify.app

7-2. 교내 코딩 경시대회에 참여하다

교내에 코딩 경시대회가 열린다고 하길래 친구들과 함께 경시대회에 도전해보았다.

공등3등인가? 입상에 성공해서 장학금으로 30만원을 받았었다.

8. 3학년 (2025년 24살, 대학생)

7-1. 학교 개발동아리 BCSD-Backend에 들어가다

3학년이 되고 1년동안 BSCD 백엔드로 들어가서 활동을 하였다. 학교인원들을 위한 서비스인 "코인" 을 운영하며 인프라에 대한 지식을 쌓고, 협업경험을 쌓을수있는 좋은 기회였다.

7-2. 백엔드 기술들을 습득하다

3학년 이제 진로를 백엔드로 진로를 잡으며 토이 프로젝트를 만들어보며 시행착오들을 겪으며 다양한 기술들을 접하고 사용해보며 지식들을 습득하였다.

https://github.com/asa9874/shoppingmall-backend

7-3.AWS SAA 자격증을 습득하다.

교내에서 AWS SAA 자격증 취득 교육을 방학때 진행한다고 해서 마침 AWS를 배우고싶었던때여서 이기회에 공부하는김에 자격증까지 취득하였다.

https://asa9874.tistory.com/718

[AWS] AWS Certified Solutions Architect - Associate 합격 후기

1. 계기개인 SpringBoot 프로젝트를 AWS에 Ec2에 배포도 해보고, 공부해보며 AWS 인프라에 대해 공부해야겠다고 생각하고있었는데, 그때 마침 학교에서 여름방학에 진행하는 AWS 자격증 취득과정에 참

asa9874.tistory.com

7-4. 졸업설계 준비를 하다

졸업설계에서 팀장으로 활동하며 졸업설계를 위한 프로그램 아이디어와 계획등을 수립하였다.

8.4학년 (2026년 25살, 대학생)

8-1. 졸업설계를 제작하다.

졸업설계로 팀장으로 개발파트는 백엔드, AI 파트를 담당하게되었다.
API서버 SpringBoot와 AI서버 와 RabbitMQ로 연결하고 AWS로 직접 배포하고 보안까지 신경쓰며 인프라적인 경험치를 쌓았다.

[SpringBoot] UUID(Universally Unique Identifier)란?

박종범_ — Tue, 24 Mar 2026 11:34:46 +0900

0. 개요

릴스에서 REST에 대한 개념적인 영상으로 다음과 같은 주제의 영상이 나왔고, 나는 댓글에 들어갔다.

당신의 API v1은 GET /getUserById?id=5 입니다.
v2는 GET /users/5 입니다.
당신의 테크 리드(개발 팀장)는 v1이 잘못되었다고 말합니다.
두 방식 모두 같은 데이터를 반환하고, 잘 작동합니다.
왜 URL 구조가 실제로 중요한 것일까요?

댓글
AAA: 둘 다 잘못되었습니다. 열거 공격(enumeration attacks)을 방지하려면 사용자를 조회할 때 항상 UUID를 사용해야 합니다.

BBB: 숫자 5를 실제 UUID나 CUID 등을 나타내기 위한 단순 예시(placeholder)로 볼 수도 있잖아요. 전 이게 그렇게 나쁘다고 생각하지 않아요.

AAA: 사람들에게 무엇이 "올바른" 방법인지 교육하려는 목적이라면 저런 예시는 여전히 나쁩니다.

영상의 API의 uri PK가 단순 정수형으로 나와있는 부분이 보안상 좋지않다는 부분에 대한 논쟁이였다. 이에 대해 알아보도록하겠다.

1.UUID(Universally Unique Identifier)란

컴퓨터 시스템에서 정보를 식별하기 위해 128비트 크기로 생성되는 고유한 식별자이다.
형식은 아래의 이미지와 같다.

https://www.twilio.com/en-us/blog/developers/a-brief-history-of-the-uuid

주로 데이터베이스의 기본 키나 API 엔드포인트의 리소스 식별자로 활용된다.

https://liora.io/en/primary-key-definition-advantages-and-special-features

2. 왜 쓰는가

2-1. 보안상 문제

여기 id가 1부터 순차적으로 1씩증가하는 PK를 가진 회원을 조회하는 API가 있다.

해당 부분의 문제성은 악의적인 사용자가 단순하게 id를 1씩증가시켜서 조회하는것만으로 다른 사용자들의 데이터가 조회되어 크롤링 될수 있다는것이다.

하지만 UUID를 사용하면 이런식으로 조회하게 되므로 위의 방식을 막을수 있다.

GET /api/members/123e4567-e89b-12d3-a456-426614174000

2-2. 분산 시스템(MSA)에서의 키 충돌 방지

UUID는 128비트로 구성되고 규칙을 나타내는 고정된 6비트를 제외한 122비트가 완전한 난수로 채워진다.
이는 UUID 의 경우의 수가 2^122 라는건데 RFC 4122에 따르면, 1조 개의 UUID를 생성해도 충돌 확률은 10억 분의 1이라고한다. 때문에 사실상 0%라고 간주한다.

트래픽을 감당하기 위해 DB를 여러 대로 나누면(Sharding), 각 DB가 독립적으로 숫자 1, 2, 3을 생성하므로 전체 시스템에서 고유한 ID를 보장할 수 없게 되는데, UUID는 데이터베이스에 의존하지 않고 애플리케이션 레벨에서 직접 생성하고 여러 대의 서버가 동시에 각자 UUID를 만들어도 전 세계적으로 값이 겹칠 확률이 0에 수렴하므로, 충돌 걱정 없이 안전하게 쓸 수 있다.

https://blog.bytebytego.com/p/a-guide-to-database-sharding-key

3. 실제 사용법(UUID v7)

3-1. java.util.UUID (v7 못사용)

기본 내장 클래스인 java.util.UUID를 사용하여 간단하게 생성할 수 있지만 UUID Version 4이다.

import java.util.UUID;

// UUID 객체 생성
UUID uuid = UUID.randomUUID();

// 문자열로 변환
String uuidString = uuid.toString();

3-2. SpringBoot 에서 사용(v7)

가장 널리 쓰이는 라이브러리는 uuid-creator이다.

Hibernate가 자동으로 ID를 생성하도록 맡기지 않고, JPA의 생명주기 콜백인 @PrePersist를 활용하여 DB에 저장되기 직전에 UUID v7을 직접 할당해 줍니다.
(타입자체는 Java 타입의 동일한 java.util.UUID입니다. 생성방식만 바뀝니다.)

@Entity
@Table(name = "orders")
public class Order {

    @Id
    // @GeneratedValue를 사용하지 않습니다.
    @Column(columnDefinition = "BINARY(16)", updatable = false, nullable = false)
    private UUID id;

    @Column(nullable = false)
    private String orderName;
    
    // 엔티티가 DB에 INSERT 되기 직전에 실행됨
    @PrePersist
    protected void onCreate() {
        if (this.id == null) {
            // UUID v7 생성 및 할당
            this.id = UuidCreator.getTimeOrderedEpoch();
        }
    }

    // Getters
    public UUID getId() { return id; }
    public String getOrderName() { return orderName; }
}

4. UUID V4 vs UUID V7

4-1. UUID V4

철저하게 무작위로 생성되므로 값을 절대 예측할 수 없어 보안성이 매우 뛰어나지만 기본 키로 사용할 경우, 값이 뒤죽박죽으로 들어오기 때문에 B-Tree 인덱스가 계속 쪼개지고 섞이는 페이지 분할 및 단편화가 많이 발생한다.

API 토큰, 임시 파일명, 비밀번호 초기화 링크 등 절대 예측되면 안 되는 값에 활용하기에 좋다.

[난수] - [난수] - [버전+난수] - [변형+난수] - [난수]

4-2. UUID V7

앞부분이 시간순으로 점점 커지는 숫자이므로, 데이터베이스에 삽입될 때 기존 인덱스 트리 끝에 차곡차곡 쌓인다.
즉, Auto Increment와 유사한 우수한 INSERT 성능을 보여줍니다. 뒷부분은 난수라서 여전히 고유성과 어느 정도의 보안성을 보장한다.

데이터베이스 기본 키(PK), 생성 시간순 조회가 빈번한 식별자에서 사용하기에 좋다.

[유닉스 타임스탬프(48비트)] - [버전+난수] - [변형+난수] - [난수]

[Docker] Docker Compose는 Production에서 사용하면 안될까?

박종범_ — Thu, 19 Mar 2026 11:45:53 +0900

0. 개요

오늘도 아무생각 없이 릴스를 내리다가 인도인 개발자 릴스를 만나게 되었다. 내용은 Docker Compose를 Production 환경에서 사용하지마라. 오늘은 이에 대해 알아볼 예정이다.

1.Docker Compose

Docker Compose는 여러 개의 컨테이너로 구성된 애플리케이션을 단일 YAML 파일에 정의하여, 한 번의 명령으로 전체 서비스를 생성하고 관리하는 도구이다.

솔직히 여러 환경 옮겨가며 작업할때 Docker 환경 설정하기 귀찮은데 해당 Docker Compose YAML 하나만 가지고 다니며 Docker 환경을 구축했다.

2. Docker Compose Production?

사실 지금 작업중인 졸업작품 프로젝트도 그렇고, 작은 프로젝트들을 배포환경에서 테스트 해볼때 Docker Compose를 EC2환경에 올려서 바로 내부에서 Docker 환경을 구축해서 사용해왔는데 왜 쓰지 말라고 하는걸까?

결론부터 말하면 나처럼 현재 작은 규모의 프로그램을 배포하는 경우에는 크게 상관이 없지만 Docker Compose를 Production에서 쓰지 말라는 경우는 수백 수천개의 컨테이너가 사용되는 대규모 기업의 환경에서 말하는것이다. (여러 호스트환경)

3. 대규모 환경에서 Docker Compose의 근본적인 한계점

3-1.물리적 확장의 불가능

Docker Compose는 기본적으로 한대의 물리 컴퓨터에서 사용하는 기술이다.
때문에 대규모 환경에서 여러대의 컴퓨터에 분산하여 컨테이너를 생성하고 이를 관리하는 클러스터링 기능이 없다.

3-2. 낮은 가용성

낮은 가용성은 앞의 단일 물리 컴퓨터 사용에 포함된다.
쿠버네티스와 같은 서비스는 A 서버가 죽으면, 그 안에서 돌던 컨테이너들을 즉시 B 서버와 C 서버에 새로 띄워서 서비스를 유지하지만 Docker Compose는 단일 물리 컴퓨터이기 때문에 서버가 죽으면 그 안에 있는 모든 컨테이너와 서비스가 같이 죽어버린다.

4. 그러면 대규모환경에서는 무엇을 사용해야할까?(컨테이너 오케스트레이션)

이런 여러 물리 컴퓨터가 존재할때 수백, 수천 개의 컨테이너의 배포, 관리, 확장, 네트워킹을 자동으로 조율하고 제어해 주는 기술과 시스템을 컨테이너 오케스트레이션이라고 한다.

이에 가장 대표되는 기술이 Kuberetes다. 스케줄링, 장애 복구, 스케일링등등 과같은 기능들을 제공해준다.