はじめに
covid19対策(まとめ)サイトの開発環境の一つである yarn を WSL 上に構築するたの手順として、各所の構築手順をまとめただけのメモです。
covid19対策サイトは、各都道府県単位などで開発・公開されており、本家東京都版はGitHub https://github.com/tokyo-metropolitan-gov/covid19 にあります。
構築手順
WSLの導入
まず、Windows10 に WSL(Windows Subsystem for Linux)のubuntu 18.04 を導入します。
(追記)WSL2でも、Ubuntu 20.04でも導入手順は同じ。
nodeの導入
次に node を導入しますが、apt で入るものは古いので、一旦 apt で依存関係を含めて導入した後、最新版に差し替えます。
まず、aptで nodejsと npm をインストール
sudo apt install -y nodejs npm
次に n package を導入し、最新の node をインストール
sudo npm install n -g
sudo n stable
aptで入れた nodejs, npm を削除
sudo apt purge -y nodejs npm
再ログイン後、インストールした nodeのバージョンを確認
$ node -v
v12.16.1
/usr/local/bin/node だと実行できる場合は、/usr/local/bin にパスを通す。
yarnの導入
https://yarnpkg.com/en/docs/install#linux-tab に従ってインストール。
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update && sudo apt install -y yarn
インストールした yarn のバージョンを確認
$ yarn -v
1.22.4
同時に入る nodejs は古いので削除。
sudo apt purge -f libuv1 nodejs
必要なパッケージのインストール
必要なパッケージ情報は、githubに登録されているので、まずクローンします(クローン済なら省略)。
cloneする前に自分のGitHubアカウントに fork (分岐コピー)することを推奨。fork手順は、https://qiita.com/FPC_COMMUNITY/items/b9cc072813dc2231b2b2 あたりを参照。
git clone GitHubのリポジトリのURL
クローンしたディレクトリに移動して、パッケージのインストールを実行
cd covid19 # cloneしたディレクトリ
yarn install
しばらく待つとパッケージのインストールされます。
ローカルサーバの起動
yarn dev
初回はビルドに時間がかかります。
ビルドが終わったら、http://localhost:3000 にアクセスして動作を確認。edge等の、Windows ブラウザで表示できます。
修正・更新
ソースやデータを編集すると、自動で更新されますので、しばらく待つとブラウザで確認できます。
実際に貢献する方法は、https://qiita.com/FPC_COMMUNITY/items/b9cc072813dc2231b2b2 などを参照。
参考
(おまけ)Windowsに直接導入する場合の一例
- node.js
https://nodejs.org/ja/download/ から Windoss Installer (msi)をダウンロードし実行。
- yarn
https://classic.yarnpkg.com/ja/ からインストーラーをダウンロードして実行
- バージョン確認
コマンドプロンプトを立ち上げてバージョン確認
>node -v
v12.16.1
>yarn -v
1.22.4
- yarnでパッケージインストールとサーバ起動
cd covid19 # cloneしたディレクトリ
yarn install # パッケージインストール
- サーバ起動
.env で GENERATE_ENV=development を指定し http://localhost:3000 が表示できれば完了。
yarn dev # 起動
参照先
このページの内容は以下のリンク先を参考にさせていただきました。
- n package https://github.com/tj/n
- yarn本家 https://classic.yarnpkg.com/en/docs/install#windows-stable
- Qiita
- https://qiita.com/StoneDot/items/0b6b5b74de8f4e07af95
- https://qiita.com/seibe/items/36cef7df85fe2cefa3ea
- https://qiita.com/FPC_COMMUNITY/items/b9cc072813dc2231b2b2
- https://qiita.com/chihiro/items/d018599ef13c35781412
- https://qiita.com/munieru_jp/items/3b1edceadb3990a901c8
- https://qiita.com/yasushi00/items/0e2bf042c14862c87ce2