自前で無料の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のページはここです。大体ここに書いてある!!
緑のボタンをクリックして…
git clone https://github.com/bcdice/bcdice-api.git
作業ディレクトリにbcdice-apiがまるっとコピーされてきます。
HEROKUへデプロイする
heroku login
任意のキー(q以外ならなんでもいい)を打つとブラウザが起動するので、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
トラベラーという昔のSFRPGのソロジャーナル化を頑張っています。印刷代の足しにしてやるぜ!という嬉しい方がいましたらメンバーシップ入って頂けると喜びます。