왜 필요한가

명령이 늘수록 팀마다 실행 방식이 달라지고 CI와 로컬 결과가 어긋납니다. Makefile은 이를 단일 인터페이스로 맞추는 장치입니다.

최소 규칙

  • make build
  • make test
  • make lint
  • make generate
  • make clean

개발자와 CI가 같은 명령을 쓰도록 강제합니다.

예시

GO := go
 
.PHONY: build test lint generate clean
 
build:
	$(GO) build ./...
 
test:
	$(GO) test -race -cover ./...
 
lint:
	golangci-lint run ./...
 
generate:
	$(GO) generate ./...
 
clean:
	rm -rf bin

모노레포에서의 팁

  • 서비스별 타겟 분리 (build-api, build-worker)
  • 변경 서비스만 빌드하는 타겟 별도 제공
  • help 타겟으로 실행 가능한 문서화

자주 하는 실수

  • Makefile에 환경별 분기를 과도하게 넣어 복잡도 폭증
  • 로컬만 되는 명령을 넣어 CI와 불일치
  • 모든 타겟을 .PHONY로 선언하지 않아 캐시 오작동

요약

Makefile의 본질은 자동화가 아니라 표준화입니다. 팀이 같은 명령을 쓰게 만드는 것만으로 온보딩과 배포 안정성이 크게 좋아집니다.