Docker 빌드에 비밀키 전달하는 법: ARG·ENV 대신 BuildKit 시크릿 사용하는 기준
Docker 빌드에 비밀키를 전달할 때는 ARG·ENV 대신 BuildKit 시크릿을 사용하는 것이 기본이다. 비공개 패키지나 저장소 인증에 필요한 값은 빌드 명령이 실행되는 동안만 제공하고, 완성된 이미지에는 남기지 않아야 한다. 핵심은 클라이언트에서 --secret 으로 전달한 뒤
2026. 11. 7.재테크 인기글
전체보기 →npm ci가 실패할 때: package-lock.json 불일치와 설치 옵션 확인 순서
npm ci가 실패할 때는 package-lock.json 불일치와 설치 옵션 차이를 먼저 구분해야 한다. 로컬에서 npm install이 성공해도 CI에서는 같은 결과가 나오지 않을 수 있다. 잠금 파일을 바로 삭제하기보다 파일 상태, Node.js·npm 버전, 프로젝트 설정을 차례
2026. 11. 6.Git worktree로 브랜치별 작업 폴더 나누는 법: AI 코딩 병렬 작업과 정리 시 주의점
Git worktree로 브랜치별 작업 폴더를 나누면 진행 중인 코드를 그대로 둔 채 다른 기능 개발이나 오류 수정에 착수할 수 있다. AI 코딩 세션을 동시에 실행할 때도 각 세션에 별도 폴더를 배정하면 파일 수정이 뒤섞이는 문제를 줄일 수 있다. 핵심 흐름은 간단하다. add -b
2026. 11. 5.PostgreSQL 백업 중 server version mismatch 오류 해결법: pg_dump와 서버 버전 확인 순서
PostgreSQL 백업 중 server version mismatch 오류 가 발생하면, 실제 실행된 pg_dump 버전부터 확인해야 한다. 이어서 백업 대상 서버의 메이저 버전을 비교하고, 복원할 서버의 버전까지 따로 점검하면 해결 방향이 선명해진다. 이 오류는 오래된 백업 도구가
2026. 11. 4.VS Code에서 파이썬 모듈을 못 찾을 때: 인터프리터와 pip 설치 경로 확인법
VS Code에서 파이썬 모듈을 못 찾을 때는 실행 중인 인터프리터와 pip 설치 경로부터 확인하는 것이 빠릅니다. 설치 성공 메시지가 나왔는데도 ModuleNotFoundError: No module named 'requests' 가 나타난다면, 패키지를 설치한 파이썬과 코드를 실행한
2026. 11. 3.제미나이 API 파일 검색 비용 계산법: 문서 색인과 질문별 토큰 과금 구분하기
제미나이 API 파일 검색 비용 계산법의 핵심은 문서 색인 비용과 질문별 답변 생성 비용을 나누는 것이다. 문서를 한 번 등록한 뒤 같은 자료에 계속 질문한다면, 최초 임베딩 비용과 매번 발생하는 입력·출력 토큰 비용을 따로 계산해야 예산이 맞는다. 파일 크기와 질문 횟수만으로 견적을
2026. 11. 2.PHP 버전 확인했는데 웹사이트와 다를 때: CLI·PHP-FPM 버전과 php.ini 경로 확인법
PHP 버전 확인 결과가 웹사이트와 다르다면, CLI와 웹 요청을 처리하는 PHP를 각각 확인해야 한다. 터미널의 php -v 는 그 명령으로 실행한 PHP의 정보다. 사이트에 적용된 버전은 해당 사이트에서 실행한 PHP_VERSION 과 실행 환경, 실제 로드된 php.ini 경로를
2026. 11. 1.리눅스마스터 2급부터 1급까지, 로키 리눅스로 익히는 핵심 명령어와 권한 관리
리눅스마스터 2급부터 1급까지 준비할 때는 로키 리눅스에서 명령어를 실행하고, 결과를 확인하고, 원래 상태로 되돌리는 연습이 중요하다. 권한 숫자를 외웠어도 파일이 열리지 않는 이유를 설명하지 못하면 문제풀이와 실제 관리 작업 사이에 간격이 생긴다. 설치된 Rocky Linux 환경을
2026. 10. 31.VS Code 제한 모드가 뜨는 이유: 작업 영역 신뢰 설정과 실행 전 확인할 항목
VS Code 제한 모드는 새로 연 폴더의 코드를 검토하는 동안 자동 실행을 제한하는 보호 기능이다. 외부 저장소를 내려받은 뒤 실행이나 확장 기능이 막혔다면, 먼저 작업 영역 신뢰 상태를 확인하면 된다. 파일을 읽고 수정하는 일은 계속할 수 있으며, 실행에 필요한 설정을 살펴본 뒤 해
2026. 10. 30.한국어 문서 AI 검색 정확도 높이는 법: 임베딩 모델의 질문·문서 인코딩과 유사도 확인
한국어 문서 AI 검색 정확도 를 높이려면 모델을 바꾸기 전에 질문·문서 인코딩 설정과 원문 분할 상태부터 확인해야 한다. 검색어와 비슷한 문장은 나오는데 정작 답이 있는 문서는 빠진다면, 접두어 누락이나 입력 잘림이 원인일 수 있다. 이 글은 설정을 직접 점검하는 단계별 가이드다. 임
2026. 10. 29.Git .gitignore가 적용되지 않을 때: 이미 추적 중인 파일과 예외 규칙 확인법
Git .gitignore가 적용되지 않을 때는 파일의 추적 상태부터 확인해야 한다. 이미 커밋한 파일에 무시 규칙을 추가해도 변경 사항이 계속 표시되는 것은 정상 동작이다. 반면 아직 추적하지 않는 파일이 계속 나타난다면 패턴의 위치, 적용 순서, 예외 규칙을 살펴봐야 한다. 해결 순
2026. 10. 28.AWS 비용 알림 설정하는 법: 예산 초과 알림과 자동 차단의 차이
AWS 비용 알림 설정은 AWS Budgets에서 월 예산과 알림 임계값, 수신자를 지정하면 된다. 다만 알림을 켰다고 과금까지 멈추지는 않는다. 예상하지 못한 청구를 줄이려면 비용을 감시하는 알림과 리소스를 제어하는 예산 작업을 구분해야 한다. 📌 핵심 요약 예산은 비용 감시 기준이
2026. 10. 27.최신 글
Docker 빌드에 비밀키 전달하는 법: ARG·ENV 대신 BuildKit 시크릿 사용하는 기준
Docker 빌드에 비밀키를 전달할 때는 ARG·ENV 대신 BuildKit 시크릿을 사용하는 것이 기본이다. 비공개 패키지나 저장소 인증에 필요한 값은 빌드 명령이 실행되는 동안만 제공하고, 완성된 이미지에는 남기지 않아야 한다. 핵심은 클라이언트에서 --secret 으로 전달한 뒤
npm ci가 실패할 때: package-lock.json 불일치와 설치 옵션 확인 순서
npm ci가 실패할 때는 package-lock.json 불일치와 설치 옵션 차이를 먼저 구분해야 한다. 로컬에서 npm install이 성공해도 CI에서는 같은 결과가 나오지 않을 수 있다. 잠금 파일을 바로 삭제하기보다 파일 상태, Node.js·npm 버전, 프로젝트 설정을 차례
Git worktree로 브랜치별 작업 폴더 나누는 법: AI 코딩 병렬 작업과 정리 시 주의점
Git worktree로 브랜치별 작업 폴더를 나누면 진행 중인 코드를 그대로 둔 채 다른 기능 개발이나 오류 수정에 착수할 수 있다. AI 코딩 세션을 동시에 실행할 때도 각 세션에 별도 폴더를 배정하면 파일 수정이 뒤섞이는 문제를 줄일 수 있다. 핵심 흐름은 간단하다. add -b
PostgreSQL 백업 중 server version mismatch 오류 해결법: pg_dump와 서버 버전 확인 순서
PostgreSQL 백업 중 server version mismatch 오류 가 발생하면, 실제 실행된 pg_dump 버전부터 확인해야 한다. 이어서 백업 대상 서버의 메이저 버전을 비교하고, 복원할 서버의 버전까지 따로 점검하면 해결 방향이 선명해진다. 이 오류는 오래된 백업 도구가
VS Code에서 파이썬 모듈을 못 찾을 때: 인터프리터와 pip 설치 경로 확인법
VS Code에서 파이썬 모듈을 못 찾을 때는 실행 중인 인터프리터와 pip 설치 경로부터 확인하는 것이 빠릅니다. 설치 성공 메시지가 나왔는데도 ModuleNotFoundError: No module named 'requests' 가 나타난다면, 패키지를 설치한 파이썬과 코드를 실행한
제미나이 API 파일 검색 비용 계산법: 문서 색인과 질문별 토큰 과금 구분하기
제미나이 API 파일 검색 비용 계산법의 핵심은 문서 색인 비용과 질문별 답변 생성 비용을 나누는 것이다. 문서를 한 번 등록한 뒤 같은 자료에 계속 질문한다면, 최초 임베딩 비용과 매번 발생하는 입력·출력 토큰 비용을 따로 계산해야 예산이 맞는다. 파일 크기와 질문 횟수만으로 견적을
PHP 버전 확인했는데 웹사이트와 다를 때: CLI·PHP-FPM 버전과 php.ini 경로 확인법
PHP 버전 확인 결과가 웹사이트와 다르다면, CLI와 웹 요청을 처리하는 PHP를 각각 확인해야 한다. 터미널의 php -v 는 그 명령으로 실행한 PHP의 정보다. 사이트에 적용된 버전은 해당 사이트에서 실행한 PHP_VERSION 과 실행 환경, 실제 로드된 php.ini 경로를
리눅스마스터 2급부터 1급까지, 로키 리눅스로 익히는 핵심 명령어와 권한 관리
리눅스마스터 2급부터 1급까지 준비할 때는 로키 리눅스에서 명령어를 실행하고, 결과를 확인하고, 원래 상태로 되돌리는 연습이 중요하다. 권한 숫자를 외웠어도 파일이 열리지 않는 이유를 설명하지 못하면 문제풀이와 실제 관리 작업 사이에 간격이 생긴다. 설치된 Rocky Linux 환경을
VS Code 제한 모드가 뜨는 이유: 작업 영역 신뢰 설정과 실행 전 확인할 항목
VS Code 제한 모드는 새로 연 폴더의 코드를 검토하는 동안 자동 실행을 제한하는 보호 기능이다. 외부 저장소를 내려받은 뒤 실행이나 확장 기능이 막혔다면, 먼저 작업 영역 신뢰 상태를 확인하면 된다. 파일을 읽고 수정하는 일은 계속할 수 있으며, 실행에 필요한 설정을 살펴본 뒤 해
한국어 문서 AI 검색 정확도 높이는 법: 임베딩 모델의 질문·문서 인코딩과 유사도 확인
한국어 문서 AI 검색 정확도 를 높이려면 모델을 바꾸기 전에 질문·문서 인코딩 설정과 원문 분할 상태부터 확인해야 한다. 검색어와 비슷한 문장은 나오는데 정작 답이 있는 문서는 빠진다면, 접두어 누락이나 입력 잘림이 원인일 수 있다. 이 글은 설정을 직접 점검하는 단계별 가이드다. 임
Git .gitignore가 적용되지 않을 때: 이미 추적 중인 파일과 예외 규칙 확인법
Git .gitignore가 적용되지 않을 때는 파일의 추적 상태부터 확인해야 한다. 이미 커밋한 파일에 무시 규칙을 추가해도 변경 사항이 계속 표시되는 것은 정상 동작이다. 반면 아직 추적하지 않는 파일이 계속 나타난다면 패턴의 위치, 적용 순서, 예외 규칙을 살펴봐야 한다. 해결 순
AWS 비용 알림 설정하는 법: 예산 초과 알림과 자동 차단의 차이
AWS 비용 알림 설정은 AWS Budgets에서 월 예산과 알림 임계값, 수신자를 지정하면 된다. 다만 알림을 켰다고 과금까지 멈추지는 않는다. 예상하지 못한 청구를 줄이려면 비용을 감시하는 알림과 리소스를 제어하는 예산 작업을 구분해야 한다. 📌 핵심 요약 예산은 비용 감시 기준이