기능
드라이런 배포를 실행하여 실제로 업로드될 파일을 검사합니다. 잘못된 빌드 타겟, 비대한 번들, 의존성 바이너리가 정적 에셋으로 배포되는 것을 라이브 배포 전에 발견할 수 있습니다.
사전 요구사항
PATH에wrangler와node가 있어야 함- 프로젝트 루트에
wrangler.toml(또는wrangler.jsonc) 파일 존재 - Cloudflare 인증 정보가
wrangler에 제공되어야 함 (환경 변수를 통해, 커밋 금지)
환경 확인
다른 작업 전에 다음을 실행하세요:
command -v wrangler && command -v node
둘 중 하나라도 없으면 중단하고 보고:MISSING_DEP: wrangler
단계별 설명
-
wrangler 설정 파일이 있는지 확인:
test -f wrangler.toml || test -f wrangler.jsonc둘 다 없으면
MISSING_CONFIG: wrangler.toml보고 -
.wrangler/가 gitignore에 포함되어 있는지 확인 (로컬 상태와 토큰이 저장될 수 있음):test -f .gitignore && grep -qxF '.wrangler/' .gitignore || echo "WARN: .wrangler/ not gitignored" -
사전 비행 실행 (드라이런 + 업로드 검사):
bash scripts/preflight.sh -
시크릿 검사 실행:
bash scripts/check-secrets.sh -
두 검사가 모두 통과해야만 배포:
wrangler deploy
절대 가정하지 마세요
wrangler deploy가 Pages를 대상으로 할 때 Workers를 대상으로 한다고 가정하지 마십시오. 배포 전에wrangler.toml에서 대상을 확인하세요.- 빌드 출력 디렉토리가 정확하다고 가정하지 마십시오 — wrangler가 자동으로 찾으며 잘못된 디렉토리를 선택할 수 있습니다. 드라이런 출력 경로를 확인하세요.
node_modules와workerd바이너리가 정적 에셋 업로드에서 제외된다고 가정하지 마십시오. 드라이런을 검사하세요.- 시크릿을 절대 에코하지 마십시오. 어떤 단계에서
${{ secrets.* }}나 토큰이 출력되면 누출로 간주:CREDENTIAL_LEAK보고 후 중단. .wrangler/나.dev.vars를 절대 커밋하지 마십시오.
출력
드라이런 크기 보고서, 누출된 바이너리 목록, 통과/실패 판정. 두 검사가 모두 통과해야만 배포가 이루어집니다.
실패 처리
wrangler없음 →MISSING_DEP: wrangler보고, 중단.- 드라이런 실패 → wrangler의 stderr를 그대로 표시, 맹목적으로 재시도하지 마십시오.
ASSET_LEAK→ 중단, 빌드 수정 후 재실행. 배포하지 마십시오.CREDENTIAL_LEAK→ 자격 증명을 교체한 후 재실행.