시스템 & 인프라/Linux & DevOps

[리눅스 한 학기 살기 #2] curl과 Makefile 사용법: 옵션, jq, 자동 변수

kugorang 2025. 3. 17. 23:42
728x90

TL;DR (세 줄 요약)

  1. curl은 URL로 요청을 보내고 서버의 응답을 화면에 출력하거나 파일로 저장하는 명령어입니다. make는 Makefile에 적힌 규칙을 읽고, 바뀐 파일만 다시 빌드하는 명령어입니다.
  2. curl은 -s(진행 표시 끄기), -f(HTTP 오류를 실패로 처리), -L(리다이렉트 따라가기), -o(파일로 저장) 옵션과 jq를 함께 쓰는 경우가 많습니다.
  3. make는 변수, 자동 변수($@, $<, $^), 패턴 규칙, .PHONY를 알면 대부분의 빌드 규칙을 짧게 쓸 수 있습니다.

이 글은 "리눅스 한 학기 살기" 과제의 2주 차 기록입니다. 서버에 요청을 보내고 응답을 확인하는 일과 소스 코드를 컴파일하는 일은 매번 반복됩니다. 이 두 가지 반복을 명령 한 줄로 줄여 주는 도구가 curl과 make입니다.

1. curl은 무엇인가요?

Dash에게 curl과 make를 아는지 묻는 그림
그림. curl과 make를 아는지 묻는 장면

curl은 URL로 요청을 보내는 명령어입니다. URL은 https://example.com처럼 인터넷에서 자료가 있는 위치를 적은 주소입니다. curl은 libcurl이라는 라이브러리를 사용해 요청을 보내고, 서버가 돌려준 응답을 화면에 출력하거나 파일로 저장합니다.

curl은 1996년에 다니엘 스텐버그가 IRC 채팅에서 환율 정보를 자동으로 받아 오려고 쓰던 도구에서 시작했습니다. 처음 이름은 httpget이었고, 그다음 urlget을 거쳐 curl이 되었습니다. 지금은 200개가 넘는 옵션이 있고 HTTP/1.1, HTTP/2, HTTP/3, HTTPS, FTP, SMTP 등을 지원합니다.

curl https://example.com

이 한 줄을 실행하면 다음 순서로 진행됩니다.

  1. 서버와 TCP 연결을 맺습니다. TCP는 데이터가 빠지지 않고 순서대로 도착하도록 보장하는 통신 방식입니다.
  2. TLS 협상을 합니다. TLS는 주고받는 내용을 암호화하는 규칙입니다.
  3. GET 요청을 보냅니다. GET은 자료를 달라고 요청하는 HTTP 메서드입니다.
  4. 서버의 응답을 받습니다.
  5. 응답 본문을 표준 출력으로 내보냅니다. 표준 출력은 프로그램이 결과를 내보내는 기본 통로이고, 보통 터미널 화면입니다.

2. curl에서 자주 쓰는 옵션은 무엇인가요?

옵션하는 일
-o 파일응답 본문을 지정한 파일로 저장합니다.
-OURL에 있는 파일 이름 그대로 저장합니다.
-X POSTHTTP 메서드를 지정합니다.
-d 'a=1'요청 본문에 데이터를 담아 보냅니다.
-H 'Content-Type: application/json'요청 헤더를 추가합니다. 헤더는 요청에 붙이는 부가 정보입니다.
-u 아이디:비밀번호기본 인증(Basic 인증)에 쓸 아이디와 비밀번호를 보냅니다.
-v요청 헤더, 응답 헤더, TLS 과정을 자세히 출력합니다.
-I본문 없이 응답 헤더만 받습니다.
-L3xx 리다이렉트를 따라갑니다. 리다이렉트는 서버가 "다른 주소로 가라"고 알려 주는 응답입니다.
-k인증서 검증을 건너뜁니다. 테스트할 때만 씁니다.
-s진행 표시를 끕니다.
-fHTTP 4xx, 5xx 응답을 실패로 처리합니다. 스크립트에서 오류를 알아차리려면 꼭 필요합니다.
-C -중단된 다운로드를 이어서 받습니다.

3. curl과 jq는 어떻게 함께 쓰나요?

jq는 JSON에서 필요한 값만 골라내는 명령어입니다. JSON은 {"이름": 값} 형태로 데이터를 적는 형식입니다. 아래 예는 GitHub API에서 flutter 저장소 정보를 받아 이름, 별 개수, 포크 개수만 출력합니다.

curl -s https://api.github.com/repos/flutter/flutter \
  | jq '{name, stars: .stargazers_count, forks: .forks_count}'

|는 파이프입니다. 파이프는 앞 명령어의 출력을 뒤 명령어의 입력으로 넘깁니다. curl은 받은 내용을 그대로 넘기고, jq가 JSON을 해석해서 필요한 항목만 뽑습니다. 값만 빠르게 확인하고 싶을 때 유용합니다.

4. 여러 URL을 한꺼번에 받거나 걸린 시간을 재려면 어떻게 하나요?

cat urls.txt | xargs -P 10 -n 1 curl -O

curl -s -w "DNS: %{time_namelookup} Connect: %{time_connect} TTFB: %{time_starttransfer} Total: %{time_total}\n" -o /dev/null https://example.com

첫 번째 명령어는 urls.txt에 적힌 주소를 한 줄씩 curl에 넘겨 내려받습니다. xargs -P 10은 동시에 실행할 프로세스 수를 10개로 정하고, -n 1은 주소를 한 번에 하나씩 넘긴다는 뜻입니다.

두 번째 명령어의 -w는 각 단계에 걸린 시간을 초 단위로 출력합니다. DNS 조회, 연결, 첫 응답 도착(TTFB), 전체 시간을 따로 볼 수 있어서 어느 구간이 느린지 구분할 수 있습니다. DNS는 도메인 이름을 IP 주소로 바꿔 주는 시스템입니다.

5. make는 무엇이고 규칙은 어떻게 쓰나요?

make는 Makefile이라는 파일에 적힌 규칙을 읽고 명령을 실행하는 도구입니다. 주로 소스 코드를 컴파일할 때 씁니다. 컴파일은 사람이 쓴 소스 코드를 컴퓨터가 실행할 수 있는 파일로 바꾸는 일입니다.

규칙 하나는 다음과 같이 생겼습니다.

타겟: 의존성
	명령어   # 반드시 탭으로 시작
  • 타겟: 만들려는 파일의 이름입니다.
  • 의존성: 타겟을 만드는 데 필요한 파일입니다.
  • 명령어: 타겟을 만드는 방법입니다. 줄 맨 앞은 반드시 탭 문자로 시작해야 합니다.

make는 타겟 파일과 의존성 파일의 수정 시각을 비교합니다. 의존성 파일이 더 최근에 바뀌었으면 명령을 실행하고, 그렇지 않으면 아무것도 하지 않습니다. 그래서 소스 파일 하나를 고쳤을 때 전체를 다시 컴파일하지 않아도 됩니다.

CC = gcc
CFLAGS = -Wall -Wextra -Werror
OBJS = main.o util.o
TARGET = program

$(TARGET): $(OBJS)
	$(CC) $(CFLAGS) -o $@ $^

%.o: %.c
	$(CC) $(CFLAGS) -c -o $@ $<

clean:
	rm -f $(OBJS) $(TARGET)

.PHONY: clean

위 Makefile의 내용은 다음과 같습니다.

  • CC = gcc처럼 이름 = 값으로 변수를 만들고, $(CC)처럼 꺼내 씁니다.
  • %.o: %.c는 패턴 규칙입니다. "이름이 같은 .c 파일로 .o 파일을 만든다"는 규칙을 한 번만 적으면 모든 파일에 적용됩니다.
  • clean은 만들어진 파일을 지우는 규칙입니다.

6. 자동 변수는 무엇인가요?

자동 변수는 make가 규칙을 실행할 때 값을 자동으로 채워 주는 변수입니다.

자동 변수뜻
$@현재 타겟의 이름
$<첫 번째 의존성
$^모든 의존성(중복은 제거됩니다)
$?타겟보다 최근에 바뀐 의존성만

위 예의 $(CC) $(CFLAGS) -o $@ $^는 "컴파일러로 타겟 이름의 파일을 만들고, 의존성 전부를 입력으로 준다"는 뜻입니다. 파일 이름을 바꿔도 규칙은 고치지 않고 그대로 쓸 수 있습니다.

7. make에서 자주 쓰는 옵션은 무엇인가요?

옵션하는 일
-j4작업 4개를 동시에 실행합니다.
-n실제로 실행하지 않고 실행할 명령만 보여 줍니다.
-B수정 시각과 상관없이 모두 다시 빌드합니다.
-C 디렉터리지정한 디렉터리로 이동해서 실행합니다.
-f 파일다른 이름의 Makefile을 사용합니다.

8. .PHONY는 왜 필요한가요?

.PHONY: all clean test
all: $(TARGET)

test: $(TARGET)
	./$(TARGET) --test

clean:
	rm -rf obj bin

.PHONY는 clean처럼 파일이 아닌 이름을 타겟으로 쓸 때 필요합니다. 폴더 안에 clean이라는 이름의 파일이 있으면 make는 "이미 최신"이라고 판단해 명령을 건너뜁니다. .PHONY에 이름을 적어 두면 같은 이름의 파일이 있어도 항상 명령을 실행합니다.

9. curl과 make를 함께 쓰면 어떤 일을 할 수 있나요?

deploy: build
	curl -fsS -X POST -H "Content-Type: application/json" \
	  -d '{"text":"deploy done"}' $$SLACK_WEBHOOK_URL

health:
	curl -fsS http://localhost:8080/health || (echo "down"; exit 1)

빌드는 make가 맡고, 배포 알림과 상태 확인은 curl이 맡습니다. deploy는 빌드가 끝난 뒤 Slack 웹훅 주소로 메시지를 보냅니다. health는 서버의 상태 확인 주소에 요청을 보냅니다.

요청이 실패하면 -f 옵션 때문에 curl의 종료 코드가 0이 아닌 값이 됩니다. 종료 코드는 명령어가 끝나면서 남기는 숫자이고, 0은 성공을 뜻합니다. CI는 종료 코드가 0이 아니면 그 단계에서 멈춥니다. CI는 코드를 올릴 때마다 빌드와 테스트를 자동으로 실행하는 방식입니다.

자주 묻는 질문 (FAQ)

Q1. curl과 wget은 무엇이 다른가요?

wget은 파일 다운로드와 사이트 전체를 내려받는 재귀 미러링에 강하고, 기본 동작이 파일 저장입니다. curl은 메서드, 헤더, 본문을 직접 구성하는 요청과 여러 프로토콜, API 테스트에 강하고, 기본 동작이 표준 출력입니다. API를 다룰 때는 curl이 편하고, 사이트를 통째로 받을 때는 wget이 편합니다.

Q2. Makefile 명령에서 "missing separator" 오류가 납니다.

명령 줄이 탭이 아니라 공백으로 들여쓰기되어 있을 때 나는 오류입니다. make는 탭으로 시작하는 줄만 명령으로 인식합니다. 편집기에서 탭을 공백으로 바꾸는 설정이 켜져 있는지 확인합니다.

Q3. make가 아무것도 하지 않고 "up to date"라고만 나옵니다.

타겟이 의존성보다 최신이라고 make가 판단한 것입니다. 실제로 바뀐 것이 없다면 정상입니다. 강제로 다시 빌드하려면 make -B를 씁니다. 타겟 이름이 파일 이름과 겹쳐서 생긴 문제라면 그 이름을 .PHONY에 추가합니다.

수정 안내

이 글은 2026년 11월 21일에 다시 썼습니다. curl의 시작을 설명한 문장은 curl 공식 기록에 맞게 고쳤습니다. curl은 다니엘 스텐버그가 처음부터 만든 것이 아니라, httpget이라는 기존 도구를 이어받아 발전시킨 것입니다.

참고 자료

같은 주제의 다른 글: [리눅스 한 학기 살기 #1] 라즈베리파이5에 Ubuntu 24.04 설치하고 SSH 원격 접속까지, [리눅스 한 학기 살기 #3] Ubuntu 24.04 원격 데스크톱: grdctl로 RDP 접속, [리눅스 한 학기 살기 #4] 라즈베리파이 VPN: Tailscale과 WireGuard 비교, [리눅스 한 학기 살기 #5] 라즈베리파이 5(ARM64)에 Docker Engine 설치하기, [리눅스 한 학기 살기 #6] Docker로 Jenkins 실행하기: CI/CD 개념과 초기 설정

728x90
728x90