Panduan Full Stack & Backend: Makefile Terdokumentasi Mandiri untuk Monorepo & CI
Dalam repositori poliglot yang menggabungkan mikroservis Go, API Python/Django, frontend TypeScript/React, dan infrastruktur Terraform, mengorientasikan insinyur baru atau men-debug kegagalan CI sering kali berubah menjadi perburuan melalui README usang. Lebih buruk lagi, ketika perintah pengembang lokal menyimpang dari skrip .gitlab-ci.yml atau GitHub Actions, kode lolos secara lokal tetapi gagal di CI. Sebagai full stack engineer dan backend engineer, saya menstandardisasi alur kerja pengembang poliglot di sekitar satu Makefile mode ketat yang terdokumentasi mandiri yang dibagi secara identik antara mesin lokal dan runner CI.
1. Bendera Shell Ketat & make help Terdokumentasi Mandiri
Dengan mengatur .SHELLFLAGS := -eu -o pipefail -c dan mengurai komentar ## dengan target awk ringan, menjalankan make mencetak referensi perintah terkategori sambil memastikan setiap resep gagal cepat pada kesalahan pipa apa pun:
# Makefile
SHELL := /usr/bin/env bash
.SHELLFLAGS := -eu -o pipefail -c
.DEFAULT_GOAL := help
PYTHON_BIN ?= /home/aldian/.virtualenv/afcom-310/bin/python
NODE_BIN ?= /home/aldian/node-v22.13.1-linux-x64/bin
.PHONY: help check-env lint-py lint-ts test-backend build-frontend ci
help: ## Tampilkan semua target standar lokal dan CI
@awk 'BEGIN {FS = ":.*##"; printf "
Usage:
make [36m<target>[0m
Targets:
"} /^[a-zA-Z0-9_-]+:.*?##/ { printf " [36m%-18s[0m %s
", $$1, $$2 }' $(MAKEFILE_LIST)
check-env: ## Verifikasi variabel lingkungan yang diperlukan
@test -n "$${DATABASE_URL:-}" || (echo "ERROR: DATABASE_URL belum diatur." && exit 1)
lint-py: ## Periksa kompilasi modul Python untuk kesalahan sintaks
$(PYTHON_BIN) -m py_compile django/core/sitemaps.py django/blog/views.py
lint-ts: ## Jalankan pemeriksaan tipe kompiler TypeScript
PATH="$(NODE_BIN):$$PATH" npx tsc -p tsconfig.json --noEmit
2. Menghilangkan Penyimpangan Konfigurasi CI
Alih-alih menempelkan 25 baris perintah shell ke dalam definisi YAML CI, setiap pekerjaan CI cukup menjalankan make lint-py, make lint-ts, atau make test-backend—menjamin paritas 100% antara mesin lokal dan gerbang penggabungan CI.