はじめに

こちらはバイセルテクノロジーズ Advent Calendar 2022 の 23 日目の記事です。前日の記事は高谷さんの「全社員がSQLを書けるようBQの権限やデータソースを整理して運用している話（後編）」でした。

こんにちは！株式会社バイセルテクノロジーズのテクノロジー戦略本部に所属している田中です。

弊社では買取管理システムGYROというサービスを開発・運用しています。

GYROはGKE上にマイクロサービスとして構築されています。以下の図のようなリポジトリ群から成り立っており、今まではローカルで環境構築をする際には各リポジトリに対して環境構築のコマンドを一つずつ実行していました。

この記事ではGYROの環境構築をコマンドでまとめて簡略化できたので、その方法を紹介します。

はじめに
背景
取り組んだこと
- バックエンド（Rails）
  - Before
  - After
- フロントエンド(Vue.js)
  - Before
  - After
まとめ

背景

直近3ヶ月でチームにjoinするメンバーが増えて、環境構築に関する質問が増えていました。Slackで新たにオンボーディング専用のチャンネルを作り、詰まっているところを共有して回答していました。これには質問する側も回答する側もお互いに時間を取られていました。

環境構築の資料に従って、記載されている順番に環境構築用のコマンドを実行していけば環境構築が終わるようになっていました。資料にはコマンドを打つときの注意事項や手順が羅列されているだけだったため、作業者が読み解いてコマンドを実行する必要がありました。

そのため、以下の図のようにコマンドを実行する順番を間違えてしまうことやコマンドの打ち間違えが発生し、正常に環境構築が終わらないことがあり問題となっていました。今回は環境構築の手順を見直しました。

取り組んだこと

それでは具体的にやったことをまとめていきます。

バックエンド（Rails）

まず、環境構築を行うそれぞれのリポジトリで実行していた各コマンドを、1つのコマンドで実行できるシェルスクリプトの中にまとめました。そして、Makefileから作成したシェルスクリプトを呼び出すことにしました。

Makefileにまとめるということも検討しましたが、もし今後複雑な手順になった場合にシェルスクリプトに切り出してあると改修しやすいと判断しました。

Makefile内で以下のようにsetupコマンドを設定しました。

setup:
    ./scripts/setup.sh ${GITHUB_USER_NAME_AND_TOKEN}

実行する際には make setup GITHUB_USER_NAME_AND_TOKEN=<githubのusername>:<personal access token> と指定して実行します。

＊プライベートリポジトリで管理されたgemをbundle installできるように、GitHubのユーザ名とPersonal access tokenの設定が必要となります。

./scripts/setup.shの中身は以下の通りです。

export BUNDLE_GITHUB__COM=$1
cp .env.sample .env
git submodule update --init
make build
docker-compose up -d
docker-compose exec app bin/rails db:create
make db-migrate-up
make seed_fu

このように各リポジトリで一行ずつ打っていたコマンドをまとめて実行するようにしました。

コマンドをまとめることで、コマンドの打ち間違いや実行の順番の間違いが発生しなくなり、Slackでの質問数を削減できました。

Before

以下の手順を8つのリポジトリ全てに繰り返し実行していました。

＊BFFに関してはdocker-compose up -dまで実行

.env.sampleからコピーして .env ファイルを作成
git submoduleで管理しているフィルを更新
GitHubのユーザ名とPersonal access tokenの設定
make build
docker-compose up -d
docker-compose exec app bin/rails db:create
make db-migrate-up
make seed_fu

After

各リポジトリで、以下のコマンドを実行するのみになりました。

make setup GITHUB_USER_NAME_AND_TOKEN=<githubのusername>:<personal access token>

フロントエンド(Vue.js)

package.jsonのscriptsにsetupコマンドを追加しました。

"scripts": {
    "setup": "brew install pyenv && pyenv install 2.7.18 && pyenv local 2.7.18 && yarn global add n && sudo n 10.15.1 && yarn && cp .env .env.local"
  }

事前にyarnのインストールした後に、yarn run setupと打つだけで環境構築をすることができるようになりました。

以前はnodeやpythonのバージョンを個人でそれぞれで設定していました。

nodeやpythonのバージョンを統一することで誰でも同じように再現することが可能になりました。