본문 바로가기
728x90

전체 글175

git reset --hard 뒤 커밋 되살리기: reflog의 HEAD@{1}로 찾고, 미커밋 수정은 왜 못 살리는지 실험 커밋을 되돌리려고 git reset --hard를 실행했더니 git log에서 방금까지 있던 커밋이 전부 사라졌습니다. 이때 많은 사람이 커밋이 지워졌다고 판단하지만, 실제로는 브랜치가 가리키는 위치만 바뀐 경우가 많습니다. 이 글은 Git 2.43.0 로컬 저장소에서 reset 전후의 reflog를 직접 실행해 보고, 되살릴 수 있는 것과 되살릴 수 없는 것을 나눠 정리합니다.reset --hard 전후 reflog 항목과 복구 명령의 결과를 옮긴 직접 제작 표입니다. AI 생성 이미지가 아닙니다.1. log에 안 보이는 커밋과 reflog의 차이git log는 현재 HEAD에서 거슬러 올라갈 수 있는 커밋만 보여 줍니다. reset --hard HEAD~2를 실행하면 HEAD가 두 커밋 앞의 커밋을 .. 2026. 11. 12.
다운로드한 파일의 SHA-256이 맞지 않을 때: sha256sum -c의 종료 코드로 경로 문제와 내용 변경 나누기 다운로드한 파일의 SHA-256 값을 공식 페이지에 적힌 값과 비교했더니 다르게 나오거나, sha256sum -c가 FAILED를 출력하는 경우가 있습니다. 그런데 이 메시지는 "해시가 틀렸다"와 "파일을 열지 못했다"를 모두 뜻할 수 있어서, 메시지만 보고 파일을 다시 받으면 같은 실수를 반복하기 쉽습니다. 이 글은 GNU coreutils 9.4의 sha256sum -c가 다섯 가지 상황에서 어떤 출력과 종료 코드를 내는지 직접 실행해 보고, 어디부터 확인해야 하는지 정리합니다.같은 체크섬 목록을 다섯 상황에서 검사한 출력과 종료 코드를 정리한 직접 제작 도식입니다. AI 생성 이미지가 아닙니다.1. 검증 명령의 기본 형식검증은 두 단계입니다. 먼저 파일의 해시를 계산해 목록 파일에 저장하고, 나중에.. 2026. 11. 12.
python-dotenv가 셸 환경변수와 .env 값 중 무엇을 남기는지: override 옵션을 실행 결과로 비교하기 로컬 개발 환경에서 .env 파일을 읽으려고 load_dotenv()를 호출했는데, 셸에 이미 같은 이름의 환경변수가 있어서 값이 바뀌지 않는 경우가 있습니다. 파일을 고쳤는데 결과가 그대로이면 대부분 이 우선순위 문제입니다. 이 글은 python-dotenv 1.2.4로 같은 키를 두 곳에 두고, 옵션을 바꿀 때 어떤 값이 남는지 실행해서 확인합니다.python-dotenv 네 가지 상황에서 읽힌 APP_MODE 값을 로컬 실행 출력으로 정리한 원본 도식입니다. AI 생성 이미지가 아닙니다.1. 기본 동작: 이미 있는 환경변수를 덮어쓰지 않는다python-dotenv README에 따르면 load_dotenv()의 override 기본값은 False입니다. 이 경우 환경변수 이름이 이미 존재하면 .en.. 2026. 11. 12.
Dockerfile ARG와 ENV는 어디까지 보일까: 빌드 인자가 컨테이너와 docker history에 남는 범위 Dockerfile에서 ARG로 받은 값이 실행한 컨테이너에서는 비어 있거나, 반대로 빌드할 때 넘긴 토큰 값이 이미지 이력에서 보이는 경우가 있습니다. 두 증상 모두 ARG와 ENV가 값을 가지는 시점과 저장되는 위치를 같은 것으로 보기 때문에 생깁니다. 이 글은 같은 Dockerfile을 빌드해서 빌드 단계, 이미지 설정, 실행 중인 컨테이너, docker history에 값이 각각 어떻게 남는지 확인합니다.같은 Dockerfile을 빌드 단계, 실행 컨테이너, 이미지 Env, docker history에서 조회했을 때 값이 남는 위치를 정리한 원본 표 도식입니다. AI 생성 이미지가 아닙니다.1. ARG와 ENV는 값을 저장하는 범위가 다르다ARG는 빌드 중에만 쓰는 변수입니다. docker bui.. 2026. 11. 12.
git push만으로 태그가 올라가지 않는 이유: --follow-tags와 --tags를 실험으로 나누기 릴리스 태그를 만들고 git push까지 실행했는데 원격 저장소의 태그 목록에 버전이 보이지 않는 경우가 있습니다. 브랜치는 올라갔으니 푸시가 성공한 것처럼 보이지만, 태그는 브랜치와 다른 참조(ref)라서 기본 푸시 대상에 들어가지 않습니다. 이 글은 임시 원격 저장소에서 같은 상황을 네 단계로 재현해, 어떤 명령이 어떤 태그를 올리는지 나눠 확인합니다.git push 네 단계에서 원격에 올라간 태그와 빠진 태그를 로컬 실험 출력으로 정리한 원본 도식입니다. AI 생성 이미지가 아닙니다.1. 브랜치 푸시와 태그 푸시는 다른 대상이다Git은 브랜치를 refs/heads/ 아래에, 태그를 refs/tags/ 아래에 저장합니다. git-push 공식 문서에 따르면 푸시할 ref는 명령줄 refspec, --.. 2026. 11. 12.
bash의 [ ]와 [[ ]]는 다르다: 빈 변수, 공백, 와일드카드를 종료 코드로 비교하기 셸 스크립트에서 if [ $name = "x" ]이 갑자기 "too many arguments"류의 오류를 내거나, 같아 보이는 [[ $file == *.txt ]]와 [ "$file" = *.txt ]가 다른 결과를 낼 때 대부분은 두 문법을 같은 것으로 보고 있기 때문입니다. 이 글은 빈 변수, 공백이 든 값, 와일드카드, 정규식, 조건 결합을 같은 입력으로 나란히 실행해서 [와 [[가 어디서 갈라지는지 종료 코드(exit status)로 확인합니다.[ ]와 [[ ]]가 같은 입력에서 0, 1, 2 중 다른 종료 코드를 내는 사례를 로컬 bash 실행 결과로 정리한 원본 도식입니다. AI 생성 이미지가 아닙니다.1. 두 문법의 역할부터 나눠 보기[는 test 명령과 같은 계열입니다. bash에는 내장.. 2026. 11. 12.
.nvmrc와 engines는 다르다: Node 버전 pin을 설치 실패와 셸 전환으로 나눠 확인하기 프로젝트 루트에 .nvmrc와 package.json의 engines를 같이 적어 두었는데, 팀원 PC에서는 Node 버전이 달라도 npm install이 그냥 통과하는 경우가 있습니다. 이 글은 두 설정이 각각 무엇을 막고 무엇은 경고만 남기는지 임시 프로젝트로 나눠 확인합니다. 실행 환경은 Node v22.15.1, npm 11.4.0이며, 아래 결과는 모두 로컬 실행 출력입니다.npm engines 경고와 engine-strict 거부, nvm use의 종료 코드를 로컬 실험 결과로 나눠 정리한 원본 도식입니다. AI 생성 이미지가 아닙니다.1. 두 설정은 같은 일을 하지 않는다.nvmrc는 셸 도구가 읽는 파일입니다. nvm use를 실행하면 파일에 적힌 버전을 찾아 현재 셸의 Node를 바꿉니다.. 2026. 11. 12.
Document Assistant 11: A timeout is not proof that nothing happened Your request timed out. The server may still be working.Original explanatory diagram for this series. Illustrative timeline: server work reaches 12 seconds unless cancellation is received and honored.Document Assistant · Part 11 of 20 · TimeoutsThe assistant has several waits: connecting to retrieval, reading passages, waiting for model capacity, and streaming generation. A timeout on one of tho.. 2026. 11. 12.
cp -r로 복사하면 심볼릭 링크가 링크로 남는 이유: -a와 -L을 실험으로 비교하기 폴더를 통째로 복사하려고 cp -r을 썼는데, 복사본에서 링크 파일이 일반 파일로 바뀌었거나 깨진 링크 하나 때문에 명령이 실패해서 당황한 적이 있다면, 원인은 cp가 심볼릭 링크를 만났을 때 무엇을 따라가는지에 있습니다. 이 글은 같은 폴더를 cp -r, cp -a, cp -rL로 각각 복사해 결과를 비교합니다. 실험은 GNU coreutils 9.4 환경에서 임시 디렉터리로만 진행했고, 출력은 그대로 옮겼습니다.cp -r, cp -a, cp -rL이 같은 링크 폴더를 어떻게 복사했는지 실험 출력으로 정리한 직접 제작 도식입니다. AI 생성 이미지가 아닙니다.1. 실험 준비: 링크 세 개가 있는 폴더파일 하나, 같은 폴더를 가리키는 링크, 대상이 없는 깨진 링크를 만들었습니다. 각 항목을 파일, 디렉터.. 2026. 11. 11.
grep에서 +와 |가 안 먹는 이유: 기본 정규식(BRE)과 -E를 실험으로 나누기 터미널에서 grep 'error+'를 실행했는데 +가 들어간 줄이 하나도 안 나오거나, grep 'warn|disk'가 기대와 다르게 아무것도 찾지 못한다면 패턴 문법이 기본 모드(BRE)와 확장 모드(ERE)에서 다르게 읽히고 있을 가능성이 큽니다. 이 글은 GNU grep 3.11에서 같은 입력 파일을 여덟 가지 조건으로 검색해 보고, 어떤 기호가 특수문자로 동작하는지 표로 정리합니다.grep 기본 모드와 -E, -F에서 같은 패턴이 줄을 찾거나 못 찾는 결과를 비교한 원본 도식입니다. AI 생성 이미지가 아닙니다.1. 증상: 같은 기호인데 어떤 때는 0줄, 어떤 때는 여러 줄grep은 패턴을 읽을 때 정규식 문법을 고릅니다. 옵션을 주지 않으면 기본 정규식(Basic Regular Expressio.. 2026. 11. 11.
728x90
반응형