<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"><channel><title>지니로그</title><description>코딩 인사이트와 트러블슈팅 기록. 문제에서 해결까지의 경로를 남깁니다.</description><link>https://jiny-log.vercel.app/ko/</link><language>ko</language><item><title>PostgreSQL에서 OFFSET이 음수면 &apos;must not be negative&apos;로 쿼리가 실패한다</title><link>https://jiny-log.vercel.app/ko/posts/postgresql-offset-must-not-be-negative</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/postgresql-offset-must-not-be-negative</guid><description>OFFSET에 음수가 들어가면 PostgreSQL은 `ERROR: OFFSET must not be negative`로 쿼리를 거부한다. 페이지네이션에서 offset을 `(page-1)*pageSize`로 만들 때 page가 0이나 음수면 offset이 음수가 되는 것이 원인이다. 클라이언트 입력을 믿지 말고 서버에서 page를 [1, maxPage]로 clamp한 뒤 offset을 계산하고, 보정된 page를 응답에 실어 준다.</description><pubDate>Sun, 27 Sep 2026 00:00:00 GMT</pubDate><category>postgresql</category><category>pagination</category><category>spring-boot</category><category>jpa</category><category>sql</category></item><item><title>노출 기간이 있는 데이터는 클라이언트에서 다시 판정하지 마라</title><link>https://jiny-log.vercel.app/ko/posts/server-authoritative-time-window</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/server-authoritative-time-window</guid><description>노출 기간(start~end)이 있는 데이터의 &apos;지금 보일지&apos;는 서버의 단일 시계로만 판정하고, 클라이언트는 재판정하지 않는다. 브라우저 시계는 사용자가 바꿀 수 있어 틀어져 있으면 항목이 조용히 사라지고, 이 버그는 시계가 정확한 개발자 기기에서 재현되지 않는다. 서버가 이미 걸러 내려주므로 클라이언트의 start/end 필드는 &apos;표시용&apos;으로만 쓴다.</description><pubDate>Sun, 27 Sep 2026 00:00:00 GMT</pubDate><category>frontend</category><category>architecture</category><category>timezone</category><category>date</category><category>ssot</category></item><item><title>Next.js 16에서 hydration mismatch가 나는 진짜 이유</title><link>https://jiny-log.vercel.app/ko/posts/nextjs-hydration-mismatch</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/nextjs-hydration-mismatch</guid><description>hydration mismatch의 대부분은 Date, Math.random, 로케일 포맷, 브라우저 전용 API 중 하나에서 나온다. React 19는 실패한 DOM 노드를 에러에 직접 찍어주므로, 먼저 콘솔의 diff를 읽어 원인을 특정한 뒤 useEffect 지연 또는 suppressHydrationWarning으로 좁혀 해결한다.</description><pubDate>Mon, 17 Aug 2026 00:00:00 GMT</pubDate><category>nextjs</category><category>react</category><category>hydration</category><category>ssr</category></item><item><title>pnpm에서 ERR_MODULE_NOT_FOUND가 뜰 때: strict 격리와 peer dependency</title><link>https://jiny-log.vercel.app/ko/posts/pnpm-strict-isolation</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/pnpm-strict-isolation</guid><description>pnpm은 선언하지 않은 패키지를 import할 수 없게 막는다. npm의 평탄한 node_modules에서는 우연히 접근되던 전이 의존성이 pnpm에서는 보이지 않기 때문이다. 해결책은 해당 패키지를 package.json에 직접 선언하는 것이고, shamefully-hoist는 문제를 덮을 뿐이다.</description><pubDate>Thu, 02 Jul 2026 00:00:00 GMT</pubDate><category>pnpm</category><category>nodejs</category><category>dependencies</category></item><item><title>docker login에서 &apos;server gave HTTP response to HTTPS client&apos;가 날 때</title><link>https://jiny-log.vercel.app/ko/posts/docker-harbor-login-push-pull</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/docker-harbor-login-push-pull</guid><description>Docker 클라이언트는 레지스트리에 기본적으로 HTTPS로 붙는다. Harbor를 HTTP(포트 5000)로 띄웠다면 /etc/docker/daemon.json의 insecure-registries에 해당 호스트:포트를 넣고 dockerd를 재시작해야 로그인이 된다. push할 이미지는 HOST:PORT/PROJECT/IMAGE:TAG 형식으로 태그해야 하며, 이 경로가 Harbor의 프로젝트 구조와 1:1로 맞아야 한다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>docker</category><category>harbor</category><category>registry</category><category>devops</category><category>troubleshooting</category></item><item><title>Docker 설치와 베이스 이미지 만들기 — JDK 21 / Node 20 공통 이미지</title><link>https://jiny-log.vercel.app/ko/posts/docker-install-base-image</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/docker-install-base-image</guid><description>공통 런타임(JDK 21, Node 20+Nginx)을 베이스 이미지로 한 번 만들어 두면 서비스별 Dockerfile이 중복 설치 레이어를 반복하지 않는다. 빌드 결과는 backend-base:jdk21이 466MB, frontend-base:node20이 1.11GB였다. Compose는 apt로 들어오는 docker-compose-plugin과 standalone 바이너리 설치 방식이 따로 있다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>docker</category><category>docker-compose</category><category>dockerfile</category><category>ubuntu</category><category>devops</category></item><item><title>VM에 GitLab 설치하고 root 비밀번호 재설정하기</title><link>https://jiny-log.vercel.app/ko/posts/gitlab-install-vm</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/gitlab-install-vm</guid><description>gitlab.rb의 external_url을 실제 접속 주소로 바꾸고 gitlab-ctl reconfigure를 돌려야 접속이 된다. root 초기 비밀번호는 /etc/gitlab/initial_root_password에 있지만 첫 reconfigure 후 24시간이 지나면 자동 삭제된다. 그 뒤에는 sudo gitlab-rails console에서 User.find_by_username(&apos;root&apos;)로 계정을 찾아 password와 password_confirmation을 함께 지정하고 save!가 true를 반환하는지 확인한다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>gitlab</category><category>ubuntu</category><category>ufw</category><category>devops</category><category>gitlab-rails</category></item><item><title>GitLab과 SonarQube 연동하기 — sonar-scanner·gitlab-runner 설치부터 Quality Gate까지</title><link>https://jiny-log.vercel.app/ko/posts/gitlab-sonarqube-integration</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/gitlab-sonarqube-integration</guid><description>SonarQube 쪽에서 DevOps Platform Integration으로 GitLab을 등록하고 project analysis token을 만든 뒤, GitLab 프로젝트에 runner를 등록하고 SONAR_HOST_URL·SONAR_TOKEN을 CI/CD 변수로 주입하면 연동이 끝난다. 스캐너 설정은 언어별로 다르다 — JS/TS는 sonar-project.properties, Gradle은 build.gradle의 sonar 블록을 쓴다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>gitlab</category><category>sonarqube</category><category>gitlab-ci</category><category>devops</category><category>docker</category><category>quality-gate</category></item><item><title>Harbor 설치와 프로젝트 생성 — offline installer로 컨테이너 레지스트리 띄우기</title><link>https://jiny-log.vercel.app/ko/posts/harbor-install-project-setup</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/harbor-install-project-setup</guid><description>Harbor는 단일 컨테이너가 아니라 core·db·portal·registry·jobservice·redis·log·nginx·registryctl 아홉 개 컨테이너로 뜬다. install.sh 전에 harbor.yml의 hostname을 실제 접속 주소로 바꿔야 하며, hostname을 localhost로 두면 외부에서 push가 안 된다. HTTPS를 쓰지 않을 거라면 https 블록을 주석 처리해야 설치가 진행된다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>harbor</category><category>docker</category><category>registry</category><category>devops</category><category>ubuntu</category></item><item><title>Jenkins에 GitLab 연동 설정하기 — API token과 저장소 인증 자격증명 두 개가 필요하다</title><link>https://jiny-log.vercel.app/ko/posts/jenkins-gitlab-integration</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/jenkins-gitlab-integration</guid><description>GitLab에서 api·read_user·read_repository scope로 personal access token을 발급한 뒤, Jenkins에 두 번 등록한다. 하나는 Jenkins 관리 &gt; System의 GitLab 섹션에 GitLab API token 종류로(연결 확인용), 다른 하나는 Credentials &gt; Global credentials에 Username with password 종류로(Job의 git clone 인증용) 넣는다. 이 둘을 하나로 착각하면 Job에서 저장소 인증이 실패한다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>jenkins</category><category>gitlab</category><category>devops</category><category>ci</category><category>credentials</category></item><item><title>Ubuntu에 Jenkins 설치하기 — 포트 변경과 journald 로그 확인</title><link>https://jiny-log.vercel.app/ko/posts/jenkins-install-ubuntu</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/jenkins-install-ubuntu</guid><description>Jenkins 포트는 /lib/systemd/system/jenkins.service의 JENKINS_PORT 환경변수를 고치고 daemon-reload 해야 적용된다. Jenkins는 systemd journal에 바이너리로 로그를 쓰기 때문에 /var/log/jenkins/jenkins.log 같은 파일이 생기지 않는다 — 로그는 journalctl -u jenkins로 봐야 하고, 파일로 남기려면 journalctl 출력을 리다이렉트하거나 cron으로 덤프해야 한다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>jenkins</category><category>ubuntu</category><category>openjdk</category><category>systemd</category><category>devops</category><category>journald</category></item><item><title>Jenkins Job 3개로 백엔드 이미지를 빌드해 Harbor에 push하기</title><link>https://jiny-log.vercel.app/ko/posts/jenkins-job-backend-harbor-push</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/jenkins-job-backend-harbor-push</guid><description>build → image → image-push 세 Job으로 나누고 Build other projects로 연결한다. Job 사이의 산출물 전달은 앞 Job에서 Archive the artifacts로 남기고 뒤 Job에서 Copy artifacts from another project로 받는다. Harbor 자격증명은 Job 스크립트에 박지 않고 Use secret text(s) or file(s)로 HARBOR_USERNAME·HARBOR_PASSWORD 환경변수에 바인딩한 뒤 --password-stdin으로 넘긴다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>jenkins</category><category>harbor</category><category>docker</category><category>gradle</category><category>devops</category><category>ci</category></item><item><title>Jenkins Job 3개로 프런트엔드 이미지를 빌드해 Harbor에 push하기</title><link>https://jiny-log.vercel.app/ko/posts/jenkins-job-frontend-harbor-push</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/jenkins-job-frontend-harbor-push</guid><description>Jenkins 관리 &gt; Tools에서 NodeJS를 먼저 등록하고, Job의 Environment에서 Provide Node &amp; npm bin/ folder to PATH를 켜야 셸 스텝에서 npx pnpm이 잡힌다. 산출물은 dist/**와 Dockerfile을 아카이브해 다음 Job으로 넘긴다. 나머지 흐름(build → image → image-push)은 백엔드와 같다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>jenkins</category><category>harbor</category><category>docker</category><category>nodejs</category><category>pnpm</category><category>devops</category><category>ci</category></item><item><title>SonarQube 설치하기 — PostgreSQL 15 연동과 vm.max_map_count 설정</title><link>https://jiny-log.vercel.app/ko/posts/sonarqube-install-postgresql</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/sonarqube-install-postgresql</guid><description>SonarQube는 Elasticsearch를 내장하므로 vm.max_map_count를 262144로 올리지 않으면 기동에 실패한다. DB는 sonarqube 데이터베이스와 sonar 사용자를 만들고 public 스키마의 소유권까지 넘겨야 한다. 접속 포트는 sonar.web.port로 바꿀 수 있고, 기본 관리자 계정은 admin/admin이므로 첫 로그인 직후 반드시 변경한다.</description><pubDate>Tue, 15 Apr 2025 00:00:00 GMT</pubDate><category>sonarqube</category><category>postgresql</category><category>ubuntu</category><category>devops</category></item><item><title>axios interceptors로 JWT 인증과 공통 에러 처리를 한곳에 모으기</title><link>https://jiny-log.vercel.app/ko/posts/axios-interceptors</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/axios-interceptors</guid><description>interceptor는 then/catch로 넘어가기 전에 요청과 응답을 가로챈다. request interceptor에서 localStorage의 access token을 Authorization 헤더에 붙이고, response interceptor에서 status가 401이면 토큰을 지우고 5xx면 공통 안내를 띄우면 호출부마다 같은 에러 처리를 반복하지 않아도 된다. 인증이 필요 없는 요청은 별도 인스턴스로 분리해야 토큰이 없을 때 불필요하게 실패하지 않는다.</description><pubDate>Mon, 30 Dec 2024 00:00:00 GMT</pubDate><category>axios</category><category>jwt</category><category>nextjs</category><category>typescript</category><category>authentication</category></item><item><title>react-query: Type &apos;string[]&apos; has no properties in common with type &apos;InvalidateQueryFilters&apos;</title><link>https://jiny-log.vercel.app/ko/posts/react-query-invalidate-queries-type-error</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/react-query-invalidate-queries-type-error</guid><description>TanStack Query v5부터 invalidateQueries는 배열이 아니라 InvalidateQueryFilters 객체를 받는다. invalidateQueries([&apos;todos&apos;])를 invalidateQueries({ queryKey: [&apos;todos&apos;] })로 바꾸면 된다. 같은 변경이 removeQueries·refetchQueries 등 다른 필터 계열 메서드에도 적용된다.</description><pubDate>Mon, 09 Sep 2024 00:00:00 GMT</pubDate><category>react-query</category><category>tanstack-query</category><category>typescript</category><category>troubleshooting</category></item><item><title>vite + react + typescript에서 svg를 React 컴포넌트로 import하는 방법</title><link>https://jiny-log.vercel.app/ko/posts/vite-react-typescript-svg-import</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/vite-react-typescript-svg-import</guid><description>vite-plugin-svgr를 설치해 vite.config.ts의 plugins에 svgr()를 추가하고, vite-env.d.ts에 vite-plugin-svgr/client 타입 참조를 넣어야 한다. 그래도 ts2307이 남으면 *.svg?react 모듈 선언을 직접 만든다. 접미사는 소문자 ?react 여야 하며 ?React로 쓰면 플러그인이 잡지 못한다. 선언 파일을 src 밖에 두면 tsconfig의 include에 경로를 추가해야 한다.</description><pubDate>Mon, 09 Sep 2024 00:00:00 GMT</pubDate><category>vite</category><category>react</category><category>typescript</category><category>svg</category><category>svgr</category><category>troubleshooting</category></item><item><title>jsconfig.json의 checkJs와 JSON 주석이 만든 세 가지 문제</title><link>https://jiny-log.vercel.app/ko/posts/jsconfig-json-path-alias</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/jsconfig-json-path-alias</guid><description>jsconfig.json에 checkJs를 켜면 VS Code의 Quick Fix에 자동 import 항목이 생기지만, 동시에 순수 js 파일에도 타입 검사가 걸려 없는 에러가 뜬다. 그래서 옵션을 지워야 하는데 // 로 주석 처리하면 안 된다 — jsconfig.json은 엄격한 JSON이라 react-scripts가 파싱하다 Expected double-quoted property name in JSON 으로 죽는다. 지울 옵션은 주석이 아니라 삭제해야 한다.</description><pubDate>Mon, 12 Aug 2024 00:00:00 GMT</pubDate><category>jsconfig</category><category>vscode</category><category>javascript</category><category>react</category><category>json</category><category>troubleshooting</category></item><item><title>zsh: command not found: tsc — TypeScript는 프로젝트마다 설치돼 있어도 전역에는 없다</title><link>https://jiny-log.vercel.app/ko/posts/zsh-command-not-found-tsc</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/zsh-command-not-found-tsc</guid><description>tsc는 프로젝트의 devDependencies에 들어 있어도 PATH에는 잡히지 않는다. 전역에서 쓰려면 npm install -g typescript 나 brew install typescript 로 따로 설치해야 하고, 설치 없이 쓰려면 npx tsc 또는 package.json 스크립트로 실행한다. 설치 후 tsc --version 이 버전을 출력하면 tsc --init 으로 tsconfig.json 을 만들 수 있다.</description><pubDate>Mon, 12 Aug 2024 00:00:00 GMT</pubDate><category>typescript</category><category>zsh</category><category>homebrew</category><category>npm</category><category>troubleshooting</category></item><item><title>selenium과 BeautifulSoup으로 유튜브 댓글을 수집해 워드클라우드 만들기</title><link>https://jiny-log.vercel.app/ko/posts/youtube-comment-crawling</link><guid isPermaLink="true">https://jiny-log.vercel.app/ko/posts/youtube-comment-crawling</guid><description>유튜브 댓글은 스크롤해야 로드되므로 scrollHeight가 더 이상 변하지 않을 때까지 반복 스크롤한 뒤 page_source를 파싱한다. 댓글 노드는 ytd-comment-thread-renderer, 본문은 그 안의 yt-attributed-string#content-text 다. 이 선택자는 유튜브가 DOM을 바꾸면 그대로 깨지므로, 크롤러를 오래 쓰려면 선택자를 상수로 분리해 두는 편이 낫다. 한국어 분석은 KoNLPy Okt로 명사만 추출하고 불용어를 거른다.</description><pubDate>Mon, 22 Apr 2024 00:00:00 GMT</pubDate><category>python</category><category>selenium</category><category>beautifulsoup</category><category>wordcloud</category><category>konlpy</category><category>crawling</category></item></channel></rss>