지니제스트 테크 블로그 배너
지니제스트Tech Archive

전체 글 목록

총 52개의 기술 가이드가 발행되었습니다.

Gemini API 503 UNAVAILABLE 오류와 재시도 설정 정리
AI7분 소요

Gemini API가 This model is currently experiencing high demand라며 503 UNAVAILABLE을 돌려줄 때 원인과 대응을 정리했습니다. 429와 503의 차이, 공식 문서가 권하는 지수 백오프와 지터, 실제 자동 발행 서버에서 8초와 16초 대기로는 넘기지 못했던 사례와 대기 시간을 늘린 설정을 다룹니다.

Gemini API 503 UNAVAILABLE 오류와 재시도 설정 정리
리눅스에서 NVIDIA 드라이버와 CUDA가 인식되지 않을 때 확인 순서
AI9분 소요

nvidia-smi 오류와 파이썬에서 CUDA를 못 찾는 문제를 단계별로 가르는 방법을 정리했습니다. 드라이버, 커널 모듈, Secure Boot, nvidia-smi와 nvcc 버전이 다른 이유, PyTorch와 Docker에서 GPU가 안 보일 때의 점검까지 다룹니다.

리눅스에서 NVIDIA 드라이버와 CUDA가 인식되지 않을 때 확인 순서
Kubernetes Pod CrashLoopBackOff 종료 코드로 원인 좁히기
IT & 테크8분 소요

Pod가 CrashLoopBackOff에 빠졌을 때 kubectl describe의 Last State와 Exit Code, logs --previous로 원인을 가르는 순서를 정리했습니다. OOMKilled, 잘못된 명령, 프로브 실패, 설정 오류를 구분하고 kubectl debug로 직접 확인하는 방법까지 다룹니다.

Kubernetes Pod CrashLoopBackOff 종료 코드로 원인 좁히기
curl SSL certificate problem 오류 원인별 해결하기
IT & 테크8분 소요

curl로 HTTPS에 접속할 때 나오는 SSL certificate problem(종료 코드 60)을 원인별로 가르는 방법을 정리했습니다. openssl s_client로 서버 체인과 CA 저장소를 구분하고, 중간 인증서 누락, 사내 프록시 루트 CA, 시스템 시간, 만료 인증서별로 --cacert와 CA 등록으로 고치는 순서를 다룹니다.

curl SSL certificate problem 오류 원인별 해결하기
PCIe Bifurcation 설정으로 NVMe SSD 미인식 해결하기
하드웨어8분 소요

NVMe 확장 카드를 꽂았는데 SSD가 하나만 보이거나 아예 안 보일 때 확인할 순서를 정리했습니다. lspci와 dmesg로 인식 단계를 가르고, 슬롯별 Bifurcation 모드(x4x4, x4x4x4x4)를 맞추는 방법과 스위치 칩 카드, SSD 호환성 점검까지 다룹니다.

PCIe Bifurcation 설정으로 NVMe SSD 미인식 해결하기
RAM 오류 진단, 윈도우 메모리 진단부터 Memtest86+와 EDAC 로그까지
하드웨어9분 소요

랜덤 블루스크린과 앱 크래시의 원인이 RAM인지 가려내는 순서를 정리했습니다. 윈도우 메모리 진단과 이벤트 로그, Memtest86+ 결과 읽는 법, Linux EDAC의 ce_count와 ue_count, 불량 모듈 특정 방법까지 다룹니다.

RAM 오류 진단, 윈도우 메모리 진단부터 Memtest86+와 EDAC 로그까지
adb install INSTALL_FAILED 오류 코드별 원인과 해결
모바일9분 소요

adb install이 Failure [INSTALL_FAILED_...]로 끝날 때 오류 코드별 원인과 조치를 정리했습니다. 서명 불일치, ABI 불일치, 저장 공간, 버전 다운그레이드, minSdk, Xiaomi USER_RESTRICTED까지 다룹니다.

adb install INSTALL_FAILED 오류 코드별 원인과 해결
Cloudflare Pages 배포 실패, 빌드 로그로 원인 찾기
Cloudflare6분 소요

Cloudflare Pages 배포가 Failed로 끝날 때 빌드 로그의 4단계(환경 초기화, 저장소 클론, 빌드, 배포) 중 어디서 멈췄는지 보는 법과 npm ci 락 파일 불일치, 대소문자, Node 버전, 20분 타임아웃, 월 500회 빌드 한도를 정리했습니다.

Cloudflare Pages 배포 실패, 빌드 로그로 원인 찾기
Docker Compose 시작 순서 오류와 healthcheck 해결
Docker7분 소요

depends_on만 쓰면 db가 떠 있어도 app이 Connection refused로 죽는 이유를 service_started 기본 동작에서 설명하고, pg_isready healthcheck와 condition: service_healthy, up --wait, start_period 설정까지 정리했습니다.

Docker Compose 시작 순서 오류와 healthcheck 해결
NFS root 권한 파일 생성 실패 원인과 squash 옵션 해결
NAS & 홈서버6분 소요

NFS 마운트에서 root로 touch나 mkdir을 하면 Permission denied가 나는 이유를 root_squash 동작부터 설명하고, exports의 anonuid 지정과 no_root_squash의 위험, exportfs -ra 적용과 NFSv3·NFSv4 차이까지 정리했습니다.

NFS root 권한 파일 생성 실패 원인과 squash 옵션 해결