배포 가이드 · 가이드
공모전 작품 올리기
공모전·게임잼·해커톤에 낸 웹 작품, 심사가 끝나면 그대로 묻히기 쉬워요. 흐름 호스팅 무료 플랜에 올리면 도메인을 사지 않아도 앱이름.ridm.ai 주소로 누구나 열어 볼 수 있어요. 조달청 공모전에 낸 웹게임 「조달왕」을 올린 순서 그대로 적었어요.
이런 분께
- 누가
- 공모전·게임잼·해커톤에 HTML·JavaScript로 만든 웹 작품을 낸 사람. 빌드하면
index.html이 나오는 작품이면 돼요. - 왜
- 제출하고 끝내기 아까운 작품을 내 주소로 계속 열어 둬요. 포트폴리오나 지원서에 링크 하나로 보여 줄 수 있고, 심사가 끝난 뒤에도 누구나 해 볼 수 있어요.
- 준비물
- 작품 폴더(빌드 결과), 구글 계정, 터미널. GitHub 계정은 없어도 돼요.
실제로 올린 작품: 조달왕
조달청 공모전에 낸 웹게임이에요. 흐름 호스팅 무료 플랜에 올려서, 도메인을 사지 않고 무료 서브도메인으로 열었어요.
jodalwang.ridm.ai아래 따라 하기는 이 작품을 올린 순서 그대로예요. 처음엔 정적 파일을 작은 웹 서버로 내보냈고, 나중에 메타모아에 접속자 수를 보내려고 작은 Node 서버로 바꿨어요.
조달왕 열어 보기따라 하기
앱이름은 신청할 때 정한 주소 이름으로 바꿔 넣어요.
-
호스팅 신청 (무료 플랜)
흐름 콘솔의 내 앱에서 호스팅을 신청하고 무료 플랜을 골라요. 이때 정한 주소가
앱이름.ridm.ai가 되고 나중에 바꿀 수 없으니, 작품 이름으로 정해요. -
앱 화면에서 깃흐름 시작
앱 화면에서 「깃허브 연결 없이 시작하기」를 눌러요. 흐름이 앱마다 코드 보관함(git 저장소)을 하나 줘요.
-
프로그램 설치와 기기 로그인
깃흐름 프로그램(명령어
hrum)을 깔고, 작품을 올릴 폴더에서 로그인해요.터미널에 붙여 넣어요# 깃흐름 프로그램 설치 (macOS·Linux) curl -fsSL https://console.hrum.ai/git/install.sh | sh # Windows PowerShell이면: irm https://console.hrum.ai/git/install.ps1 | iex # 새 터미널을 열고, 작품을 올릴 폴더에서 로그인 hrum login <앱이름>브라우저에 콘솔 승인 화면이 열리면 터미널에 나온 코드를 직접 입력하고, 방금 내가 실행한 게 맞으면 「허용」을 눌러요. 이 컴퓨터에 그 앱 전용 토큰이 저장되고, 토큰은 화면이나 로그에 나오지 않아요.
-
작품 폴더에 Dockerfile
빌드한 웹 파일(
index.html이 있는 폴더 내용)을 이 폴더의public/에 넣어요. 정적 파일이면 작은 웹 서버 하나로 충분해요. 폴더 맨 위에 아래Dockerfile을 두거나, 없으면 다음 단계의hrum init이 같은 파일을 넣어 줘요.Dockerfile (정적 사이트)FROM busybox:1.36 COPY --chown=1000:1000 public /www USER 1000:1000 EXPOSE 3000 CMD ["httpd", "-f", "-p", "3000", "-h", "/www"]포트·실행 사용자 같은 조건은 Dockerfile 요구사항에 있어요. 서버가 필요한 작품이면 그 조건에 맞춰 직접 써요.
-
git push로 올리기
hrum init이 이 폴더를git.hrum.ai/앱이름.git저장소에 연결해요. 그다음main에 올리면 배포가 시작돼요.같은 폴더에서# 이 폴더를 앱 저장소에 연결 hrum init <앱이름> # 저장하고 main에 올리기 git add . git commit -m "웹 공개본" git push origin main조달왕은
git push로 올렸어요.hrum save "메모"와hrum push도 같은 일을 하고, 이쪽은 비밀값 모양이 보이면 저장하지 않고 배포 진행을 보여 줘요. -
내 주소로 열기
올리면 흐름이 빌드하고 시작 시험을 거친 뒤 자동으로 적용해요. 끝나면
https://앱이름.ridm.ai로 열려요. 실패하면 앱 화면의 빌드 기록과 로그를 보고 고친 뒤 다시 올려요. 그 뒤로도 올릴 때마다 자동으로 반영돼요.
제출본과 공개본 나누기
공모전에 낸 제출본은 규정에 맞춰 만든 그대로 두는 게 좋아요. 조달왕도 외부 요청이 없는 제출용 ZIP은 그대로 두고, 웹 공개용 브랜치를 따로 만들어 거기서만 고쳐서 올렸어요.
# 제출본(main)은 그대로 두고 공개용 브랜치를 만들어요
git switch -c web-public
# 공개본에만 넣을 것은 여기서 고치고 저장
git commit -am "웹 공개본 손질"
# 빌드한 결과만 올릴 폴더의 public/ 에 복사해요
올리는 폴더에는 빌드 결과만 두면 돼요. 원본 저장소를 통째로 올리지 않아도 되고, 제출본은 손대지 않은 채로 남아요.
알아 두면 좋은 것
무료 플랜은 쉬었다가 깨어나요. 한동안 방문이 없으면 앱이 쉬고, 다음 방문 때 다시 켜져요. 그래서 쉬고 난 뒤 첫 방문은 조금 늦게 열릴 수 있어요.
메타모아에 공간으로 등록하기. 작품을 더 많은 사람에게 보여 주고 싶으면 메타모아(metamoa.com)에 공간으로 등록해 보세요. 조달왕은 공간으로 등록하고 지금 접속자 수를 메타모아에 보내요.
다음으로
끝난 작품, 내 주소로 다시 열어 볼까요?
구글로 가입하기