Cloudflare 에지 컴퓨팅 및 네트워크 터널링 기술을 학습합니다. Cloudflare Pages와 Workers를 활용한 서버리스 프론트/백엔드 배포, Cloudflare Tunnel을 이용한 로컬 PC/노트북 모델 서버 안전 노출, CDN/DNS 프록시 캐싱 설정, 그리고 Wrangler CLI 명령어를 마스터합니다.
Cloudflare 에지 컴퓨팅 및 네트워크 터널링 기술을 학습합니다. Cloudflare Pages와 Workers를 활용한 서버리스 프론트/백엔드 배포, Cloudflare Tunnel을 이용한 로컬 PC/노트북 모델 서버 안전 노출, CDN/DNS 프록시 캐싱 설정, 그리고 Wrangler CLI 명령어를 마스터합니다. 이 가이드는 개념을 나열하기보다, 실제 프로젝트에서 판단해야 하는 순서대로 내용을 따라갈 수 있게 구성했습니다.
설치 명령을 외우기보다 트래픽, 런타임, 관측, 장애 대응이 어떤 순서로 이어지는지 파악합니다.
글로 읽은 내용을 머릿속에 오래 남기려면 먼저 흐름을 그림으로 잡는 편이 좋습니다. 아래 두 그림은 Cloudflare를 학습할 때 계속 되돌아볼 수 있는 기준 지도입니다.
Cloudflare를 처음 펼칠 때는 세부 명령보다 큰 그림이 먼저입니다. 이 섹션에서는 앞으로 배울 개념들이 어떤 문제를 풀기 위해 등장했는지부터 잡아봅니다.
export default {
async fetch(request: Request, env: any): Promise<Response> {
const url = new URL(request.url);
if (url.pathname === "/api/health") {
return new Response(JSON.stringify({ status: "healthy", edge: "cloudflare-workers" }), {
headers: { "Content-Type": "application/json" }
});
}
return new Response("Not Found", { status: 404 });
}
};여기서는 Cloudflare Tunnel 터널링을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.
# Cloudflare 터널 클라이언트 설치 및 로그인
cloudflared tunnel login
# 로컬 터널 생성
cloudflared tunnel create local-ai-tunnel
# config.yml 작성 (터널 ID 및 로컬 포트 매핑)
# tunnel: <TUNNEL_ID>
# credentials-file: /root/.cloudflared/<TUNNEL_ID>.json
# ingress:
# - hostname: ai-api.aidevops.kr
# service: http://localhost:8000
# - service: http_status:404
# 터널 실행
cloudflared tunnel run local-ai-tunnel이 섹션은 DNS & CDN 프록시 캐싱을 실무 관점에서 정리합니다. 개념을 외우기보다, 어떤 상황에서 이 기준을 꺼내 쓸지에 초점을 맞춰보세요.
여기서는 Wrangler CLI 명령어을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.
# Workers 새 프로젝트 생성
npx wrangler init my-worker
# 로컬 데브 서버 기동 (핫 리로드)
npx wrangler dev
# Workers 에지망에 최종 배포
npx wrangler deployCloudflare 실무 설계은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.
| 결정 지점 | 확인 질문 | 실무 기준 |
|---|---|---|
| 경계 | Cloudflare 코드에서 바뀌기 쉬운 부분은 어디인가? | 입출력, 설정, 외부 연동, 핵심 규칙을 분리합니다. |
| 상태 | 상태가 어디서 생성되고 어디서 사라지는가? | 상태 소유자와 수명 주기를 코드로 드러냅니다. |
| 장애 | 실패했을 때 호출자는 무엇을 받는가? | timeout, fallback, error contract를 먼저 정합니다. |
이 섹션은 Cloudflare 운영 기준을 실무 관점에서 정리합니다. 개념을 외우기보다, 어떤 상황에서 이 기준을 꺼내 쓸지에 초점을 맞춰보세요.
Cloudflare 검증 전략은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.
| 품질 축 | 검증 방법 | 완료 기준 |
|---|---|---|
| 정확성 | 정상/실패 케이스를 자동화합니다. | 핵심 시나리오가 재현 가능하게 통과합니다. |
| 회귀 방지 | 버그 수정 시 동일 케이스를 테스트로 남깁니다. | 같은 장애가 다시 배포되지 않습니다. |
| 운영성 | 로그, 메트릭, 알림을 확인합니다. | 문제가 생겼을 때 원인 추적 경로가 있습니다. |