배포 방법

1. 포털에 로그인합니다.
2. 메인 배포 칸에 프로젝트 zip 을 올립니다.
3. 3~5분 뒤 https://teamNN.hack26.act.club 에 뜹니다.

앱이 지켜야 할 것

가장 중요합니다. 이거 하나로 대부분의 사고가 갈립니다.

0.0.0.0 의 3000 포트를 리슨할 것 (또는 PORT 환경변수를 읽을 것)

127.0.0.1 이나 localhost 에 묶으면 빌드는 성공하는데 접속만 안 됩니다. 컨테이너 바깥에서 들어오는 요청을 받지 못하기 때문입니다.

Node / Express

app.listen(process.env.PORT || 3000, '0.0.0.0');

Next.js

{ "scripts": { "start": "next start -H 0.0.0.0 -p 3000" } }

FastAPI

uvicorn main:app --host 0.0.0.0 --port 3000

Flask

app.run(host="0.0.0.0", port=int(os.environ.get("PORT", 3000)))

정적 사이트

빌드 결과를 서빙할 서버가 필요합니다.

{ "scripts": { "start": "serve -s dist -l 3000" } }

빌드 방식

zip 루트에 Dockerfile 이 있으면 그걸로 빌드합니다. 없으면 서버가 언어를 자동으로 감지해 빌드합니다(package.json → Node, requirements.txt → Python 등).

재업로드 규칙

다시 올리면 이전 내용을 통째로 교체합니다. 덧붙이는 게 아닙니다 — 지운 파일은 실제로 사라지니 항상 프로젝트 전체를 올리세요.

제한

항목	값
최대 용량	200MB
업로드 간격	칸마다 2분에 1회
배포 소요	3~5분 (마감 직전에는 더 걸릴 수 있음)

배포가 안 될 때

1. “준비중” 페이지 그대로 — 아직 빌드 중이거나 실패했습니다. 5분까지 기다려 보세요.
2. 502 / 접속 안 됨 — 십중팔구 포트 문제입니다. 위의 0.0.0.0 을 확인하세요.
3. 빌드 실패 — node_modules 잔재, 의존성 누락, 락파일 충돌이 흔합니다.

그래도 안 되면 privacy@poi.kr 로 팀 번호 + 증상을 보내 주세요.