デプロイガイド · ガイド

コンテスト作品を公開する

コンテスト・ゲームジャム・ハッカソンに出したWeb作品は、審査が終わるとそのまま埋もれがちです。HRUMホスティングの無料プランに公開すれば、ドメインを買わなくても appname.ridm.ai で誰でも開けます。韓国の調達庁のコンテストに出したWebゲーム「調達王」を公開した順番どおりにまとめました。

こんな方に

対象
コンテスト・ゲームジャム・ハッカソンに、HTML・JavaScriptで作ったWeb作品を出した人。ビルドすると index.html ができる作品なら大丈夫です。
なぜ
提出して終わりにはもったいない作品を、自分のアドレスで開いておけます。ポートフォリオや応募書類にリンクひとつで見せられ、審査が終わった後も誰でも遊べます。
用意するもの
作品フォルダ(ビルド結果)、Googleアカウント、ターミナル。GitHubアカウントはなくても大丈夫です。

実際に公開した作品: 調達王

Webゲーム「調達王」のタイトル画面。島の地図に工場・倉庫・港があり、中央にスタートボタンがある
調達王のタイトル画面

韓国の調達庁のコンテストに出したWebゲームです。HRUMホスティングの無料プランに公開し、ドメインを買わずに無料のサブドメインで開きました。

jodalwang.ridm.ai

下の手順は、この作品を公開した順番そのままです。最初は静的ファイルを小さなWebサーバーで配信し、あとでMetamoaに接続人数を送るため小さなNodeサーバーに切り替えました。

調達王を開く

手順

appname は申し込み時に決めたアドレス名に置き換えてください。

  1. ホスティングを申し込む(無料プラン)

    HRUMコンソールのマイアプリでホスティングを申し込み、無料プランを選びます。ここで決めたアドレスが appname.ridm.ai になり、あとから変えられないので作品名にしましょう。

  2. アプリ画面でgitHrumを始める

    アプリ画面で「Start without GitHub」を選びます。HRUMがアプリごとにコード保管庫(gitリポジトリ)をひとつ用意します。

  3. プログラムのインストールと端末ログイン

    gitHrumプログラム(コマンド hrum)を入れ、公開するフォルダでログインします。

    ターミナルに貼り付けます
    # gitHrumプログラムをインストール (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 <appname>

    ブラウザにコンソールの承認画面が開いたら、ターミナルに出たコードを自分で入力し、いま自分が実行したものなら「Allow」を押します。このパソコンにそのアプリ専用のトークンが保存され、トークンは画面やログに出ません。

  4. 作品フォルダにDockerfile

    ビルドしたWebファイル(index.html があるフォルダの中身)を、このフォルダの public/ に入れます。静的ファイルなら小さなWebサーバーひとつで十分です。フォルダの一番上に下の 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/appname.git リポジトリにつなぎます。そのあと main にpushするとデプロイが始まります。

    同じフォルダで
    # このフォルダをアプリのリポジトリにつなぐ
    hrum init <appname>
    
    # 保存してmainにpush
    git add .
    git commit -m "Web公開版"
    git push origin main

    調達王は git push で公開しました。hrum save "メモ" と hrum push でも同じことができ、こちらは秘密の値らしきものがあると保存せず、デプロイの進み具合を表示します。

  6. 自分のアドレスで開く

    pushするとHRUMがビルドし、起動チェックを通ったあと自動で反映します。終わると https://appname.ridm.ai で開けます。失敗したらアプリ画面のビルド履歴とログを見て直し、もう一度pushします。その後もpushするたびに自動で反映されます。

提出版と公開版を分ける

コンテストに出した提出版は、規定どおりに作ったまま残しておくのがおすすめです。調達王も外部リクエストのない提出用ZIPはそのままにし、Web公開用のブランチを別に作ってそこだけで手を入れました。

元の作品リポジトリで
# 提出版(main)はそのままにして公開用ブランチを作る
git switch -c web-public

# 公開版にだけ入れるものはここで直して保存
git commit -am "Web公開版の手直し"

# ビルド結果だけを公開するフォルダの public/ にコピー

公開するフォルダにはビルド結果だけを置けば大丈夫です。元のリポジトリを丸ごと上げる必要はなく、提出版は手つかずのまま残ります。

知っておくと便利なこと

無料プランは休んでから目を覚まします。しばらくアクセスがないとアプリは休み、次のアクセスでまた起動します。そのため休んだ後の最初のアクセスは少し遅く開くことがあります。

Metamoaにスペースとして登録する。作品をもっと多くの人に見てもらいたいなら、Metamoa(metamoa.com)にスペースとして登録してみてください。調達王はスペースとして登録し、いまの接続人数をMetamoaに送っています。

次に

終わった作品、自分のアドレスでもう一度開いてみませんか。

Googleで登録