Git을 처음 사용할 때, SSH 키가 왜 필요한지 이해하기 어려울 수 있다. 나도 처음엔 HTTPS로 clone 받으면 그만이라고 생각했다. 그런데 push할 때마다 비밀번호를 입력하라는 창이 뜨고, 2021년 8월부터는 GitHub이 비밀번호 기반 HTTPS 인증을 완전히 차단하면서 상황이 달라졌다. Personal Access Token을 쓰는 방법도 있지만, 토큰을 관리하고 갱신하는 것 자체가 번거롭다. 결국 SSH 키를 한 번 제대로 … 더 읽기
npm install을 실행했는데 갑자기 터미널이 빨간 글씨로 도배되는 경험, 해본 적 있는가? error engine Unsupported engine error Found: [email protected] error Required: node@^18.0.0 error at /Users/dev/project-a/package.json 지난달에 정확히 이 상황을 겪었다. 회사 레거시 프로젝트는 Node.js 18을 요구하고, 사이드 프로젝트에서 쓰던 Next.js 15는 Node.js 20 이상이 필요했다. Homebrew로 설치한 Node.js는 시스템 전체에 딱 하나의 버전만 유지하니까, 프로젝트를 … 더 읽기
iPad 하나로도 본격적인 코딩 환경을 구축할 수 있다. 2년 전만 해도 이 문장을 진지하게 받아들이는 개발자는 드물었다. 하지만 GitHub Codespaces가 브라우저 기반 VS Code 환경을 안정적으로 제공하면서 상황이 달라졌다. 나는 출장이 잦은 편인데, 노트북 대신 iPad Air + Magic Keyboard 조합으로 코드 리뷰와 간단한 기능 수정을 처리한 지 6개월이 넘었다. 로컬 개발 환경 세팅 없이 … 더 읽기
녹화 버튼을 눌렀는데 미리보기가 까만 화면이라면, 당황스러울 수밖에 없다. OBS Studio 30.x를 설치하고 소스를 추가했는데 프리뷰 창이 칠흑 같은 검정색 — 나도 macOS Sonoma 14.4로 업데이트한 직후에 이 상태를 처음 겪었고, 거의 40분을 날렸다. 소스 설정 문제인지, 권한 문제인지, 아니면 Apple Silicon GPU 호환성 문제인지 원인이 여러 갈래라서 더 혼란스럽다. 이 글에서는 macOS Sonoma 14.x와 … 더 읽기
페이지 로딩 시간이 3초를 넘기면, 방문자의 53%가 이탈한다는 통계가 있다. Google의 2024년 Core Web Vitals 보고서에 따르면 모바일 사용자의 기대 로딩 시간은 2.5초 이하이고, LCP(Largest Contentful Paint) 기준 2.5초를 충족하는 워드프레스 사이트는 전체의 33%에 불과하다. 나도 운영하던 블로그의 PageSpeed Insights 점수가 모바일 기준 28점까지 떨어진 적이 있는데, 아래 과정을 거치고 나서 82점까지 끌어올렸다. 한 번에 … 더 읽기
사이트에 접속했더니 하얀 화면만 나온다. 어제까지 잘 되던 사이트가 갑자기 먹통이 된 거다. 관리자 페이지(wp-admin)도 열리지 않고, 500 에러만 반복되는 상황. 이런 일이 보통 새벽에 터진다. 자동 업데이트가 돌아간 직후 — 예를 들어 Application Passwords 관련 플러그인이 업데이트되면서 REST API 401 에러가 동시에 터지기도 한다 —, 혹은 플러그인 하나를 무심코 업데이트한 뒤에. 나도 운영 중인 … 더 읽기
Application Passwords는 WordPress 5.6부터 도입된 REST API 인증 방식이다. 기존에는 쿠키 인증이나 OAuth 플러그인 없이는 외부에서 WordPress API를 호출하기가 꽤 번거로웠는데, 이 기능 덕분에 별도 플러그인 설치 없이도 HTTP Basic Auth 기반의 API 연동이 가능해졌다. 나는 GitHub Actions 기반 자동 배포 파이프라인과 연동하는 자동 포스팅 시스템을 구축하면서 이 기능을 처음 사용했는데, 세팅 자체는 5분이면 끝나지만 … 더 읽기
Cron Trigger가 예상대로 실행되지 않을 때, 순서대로 점검하면 대부분 원인을 찾을 수 있다. 이 글은 내가 실제로 Cloudflare Workers의 Cron Trigger를 운영하면서 겪었던 문제들을 체크리스트 형태로 정리한 것이다. wrangler.toml 설정 실수부터 UTC 타임존 혼동, scheduled() 핸들러 누락까지 — 한 항목씩 따라가다 보면 어디서 막혔는지 금방 파악할 수 있을 거다. 📑 목차 증상부터 확인하기 wrangler.toml [triggers] … 더 읽기
Workers에서 환경변수를 다룰 때, 로컬과 프로덕션의 차이를 간과하는 경우가 많다. env.API_KEY를 콘솔에 찍어보면 undefined가 떡하니 나오고, 분명 대시보드에서 설정했는데 왜 안 되는 건지 한참을 헤맸던 경험 — 아마 Workers 개발자라면 한 번쯤 겪어봤을 거다. 로컬에서는 잘 되다가 배포만 하면 터지는 경우, 반대로 프로덕션에서는 되는데 wrangler dev에서만 안 되는 경우, 심지어 둘 다 안 되는 경우까지. … 더 읽기
Cloudflare Pages는 정적 사이트 배포에 최적화된 플랫폼이다. 커스텀 도메인을 연결하는 과정에서 SSL 인증서 관련 오류를 만나면 꽤 당황스럽다. 분명 DNS 설정도 했고, 도메인도 연결했는데 브라우저에 빨간 자물쇠가 뜨면서 ERR_SSL_VERSION_OR_CIPHER_MISMATCH 에러가 화면을 채울 때의 그 막막함이란… 배포는 성공했는데 사이트에 접속이 안 되는 상황, 생각보다 자주 발생한다. 이 문제는 대부분 Cloudflare의 SSL/TLS 설정과 DNS 레코드 구성이 맞물려 … 더 읽기