배포 가이드 · 가이드

공모전 작품 올리기

공모전·게임잼·해커톤에 낸 웹 작품, 심사가 끝나면 그대로 묻히기 쉬워요. 흐름 호스팅 무료 플랜에 올리면 도메인을 사지 않아도 앱이름.ridm.ai 주소로 누구나 열어 볼 수 있어요. 조달청 공모전에 낸 웹게임 「조달왕」을 올린 순서 그대로 적었어요.

이런 분께

누가
공모전·게임잼·해커톤에 HTML·JavaScript로 만든 웹 작품을 낸 사람. 빌드하면 index.html이 나오는 작품이면 돼요.
왜
제출하고 끝내기 아까운 작품을 내 주소로 계속 열어 둬요. 포트폴리오나 지원서에 링크 하나로 보여 줄 수 있고, 심사가 끝난 뒤에도 누구나 해 볼 수 있어요.
준비물
작품 폴더(빌드 결과), 구글 계정, 터미널. GitHub 계정은 없어도 돼요.

실제로 올린 작품: 조달왕

웹게임 조달왕 첫 화면. 섬 지도 위에 공장·창고·항구가 있고 가운데에 시작 버튼이 있다
조달왕 첫 화면

조달청 공모전에 낸 웹게임이에요. 흐름 호스팅 무료 플랜에 올려서, 도메인을 사지 않고 무료 서브도메인으로 열었어요.

jodalwang.ridm.ai

아래 따라 하기는 이 작품을 올린 순서 그대로예요. 처음엔 정적 파일을 작은 웹 서버로 내보냈고, 나중에 메타모아에 접속자 수를 보내려고 작은 Node 서버로 바꿨어요.

조달왕 열어 보기

따라 하기

앱이름은 신청할 때 정한 주소 이름으로 바꿔 넣어요.

  1. 호스팅 신청 (무료 플랜)

    흐름 콘솔의 내 앱에서 호스팅을 신청하고 무료 플랜을 골라요. 이때 정한 주소가 앱이름.ridm.ai가 되고 나중에 바꿀 수 없으니, 작품 이름으로 정해요.

  2. 앱 화면에서 깃흐름 시작

    앱 화면에서 「깃허브 연결 없이 시작하기」를 눌러요. 흐름이 앱마다 코드 보관함(git 저장소)을 하나 줘요.

  3. 프로그램 설치와 기기 로그인

    깃흐름 프로그램(명령어 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 <앱이름>

    브라우저에 콘솔 승인 화면이 열리면 터미널에 나온 코드를 직접 입력하고, 방금 내가 실행한 게 맞으면 「허용」을 눌러요. 이 컴퓨터에 그 앱 전용 토큰이 저장되고, 토큰은 화면이나 로그에 나오지 않아요.

  4. 작품 폴더에 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 요구사항에 있어요. 서버가 필요한 작품이면 그 조건에 맞춰 직접 써요.

  5. 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도 같은 일을 하고, 이쪽은 비밀값 모양이 보이면 저장하지 않고 배포 진행을 보여 줘요.

  6. 내 주소로 열기

    올리면 흐름이 빌드하고 시작 시험을 거친 뒤 자동으로 적용해요. 끝나면 https://앱이름.ridm.ai로 열려요. 실패하면 앱 화면의 빌드 기록과 로그를 보고 고친 뒤 다시 올려요. 그 뒤로도 올릴 때마다 자동으로 반영돼요.

제출본과 공개본 나누기

공모전에 낸 제출본은 규정에 맞춰 만든 그대로 두는 게 좋아요. 조달왕도 외부 요청이 없는 제출용 ZIP은 그대로 두고, 웹 공개용 브랜치를 따로 만들어 거기서만 고쳐서 올렸어요.

원본 작품 저장소에서
# 제출본(main)은 그대로 두고 공개용 브랜치를 만들어요
git switch -c web-public

# 공개본에만 넣을 것은 여기서 고치고 저장
git commit -am "웹 공개본 손질"

# 빌드한 결과만 올릴 폴더의 public/ 에 복사해요

올리는 폴더에는 빌드 결과만 두면 돼요. 원본 저장소를 통째로 올리지 않아도 되고, 제출본은 손대지 않은 채로 남아요.

알아 두면 좋은 것

무료 플랜은 쉬었다가 깨어나요. 한동안 방문이 없으면 앱이 쉬고, 다음 방문 때 다시 켜져요. 그래서 쉬고 난 뒤 첫 방문은 조금 늦게 열릴 수 있어요.

메타모아에 공간으로 등록하기. 작품을 더 많은 사람에게 보여 주고 싶으면 메타모아(metamoa.com)에 공간으로 등록해 보세요. 조달왕은 공간으로 등록하고 지금 접속자 수를 메타모아에 보내요.

다음으로

끝난 작품, 내 주소로 다시 열어 볼까요?

구글로 가입하기