自前で無料のBCDice-APIを立てる～初学者向け

WEB-APIであるBCDice-APIをHEROKU上に作ります。少人数で使う場合に気が楽ですね！

WEB-APIとはなんぞや

BCDice-APIはWEB-APIです。
ざっくり調べたところ、
WEBクライアント（Discordとかココフォリアとか）とBCDice本体を繋いでくれるWEB上のプログラムらしいです。DiscordでもココフォリアでもquoridornでもオンセンでもBCDiceが使えるのはこれのおかげってこと？

あまり深く考えなくても作れます。

HEROKUとはなんぞや

なんと無料で（2021年3月31日現在）WEB-APIを作らせてくれる太っ腹サービス。24時間365日稼働させたければ工夫が必要。（ヒント：クレジットカード登録、bot常時起動）

用意するもの

・WindowsのPC
・gitコマンド
・メールアドレス
・Heroku CLI

Winでgitを使えるようにする

githubアカウントを取得する。

https://github.co.jp/　に飛んで登録するをクリック。ユーザー名とメールアドレスとパスワードを求められます。

git for windowsをインストール

https://gitforwindows.org/　に飛んでダウンロードをクリック。

exeファイルがダウンロードされるのでダブルクリック。

https://prog-8.com/docs/git-env-win　こちらの記事の初期設定までを行います。

エディタをサクラエディタにする例。
git config --global core.editor "'C:/Program Files (x86)/sakura/sakura.exe' -CODE=4"

HEROKUに登録する

https://jp.heroku.com/　に飛んで無料で新規登録をクリック。

必須項目を埋めて無料アカウント作成。

HEROKU CLIを使えるようにする

https://devcenter.heroku.com/ja/articles/heroku-cli　に飛んでwin版をダウンロード＆インストール。インストールはNextとかYesをクリックするだけ。

BCDice-APIをgit cloneする

先ほどインストールしたGitBashを起動します。
cdコマンドで作業ディレクトリにしたいフォルダまで移動します。

BCDice-APIのページはここです。大体ここに書いてある！！

bcdice/bcdice-api

緑のボタンをクリックして…

git clone https://github.com/bcdice/bcdice-api.git

作業ディレクトリにbcdice-apiがまるっとコピーされてきます。

HEROKUへデプロイする

heroku login

任意のキー（ｑ以外ならなんでもいい）を打つとブラウザが起動するので、HEROKUへログインします。

cd bcdice-api

BCDice-APIディレクトリ本体に入っておきます。

heroku create 任意の名前

https://任意の名前.herokuapp.comにBCDice-APIが出来るよ。

git push heroku master

しばらく待っておしまい。

ダイスを最新版に更新するにはBCDiceの更新

BCDice本体は1カ月に1度程度更新されています。これを反映させます。

cd bcdice-api

winでBCDice-APIディレクトリ本体に入っておきます。ここまでは上記と同じ。

bundle update

git commit

ここでサクラエディタが起動するので、一番上の空の行に何を更新したのかメモして上書保存します。エディタを閉じます。

git push heroku master

でおわりです。

API自体のバージョンが変わったらBCDice-APIの更新

あまり頻度はないと思うのですが。BCDice-APIをまるっと更新します。

cd bcdice-api
git pull origin master
git push heroku master

BCDiceのバージョンを確認するコマンド

このコマンドで最新版になっていればOK

BCDiceVersion