2022-06-20 14:31:15 +00:00
# Windows Subsystem for Linux (WSL) で freeCodeCamp 開発環境を構築する
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
> [!NOTE] これらの指示に従う前に、システムが要件を満たしていることを確認してください。
2021-09-22 14:28:36 +00:00
>
2022-02-07 13:53:40 +00:00
> **WSL2**: Windows 10 64-bit (Version 2004, Build 19041以上) - Windows 10 Home を含むすべてのディストリビューションで利用可能です。
2021-09-22 14:28:36 +00:00
>
2022-02-07 13:53:40 +00:00
> **Docker Desktop for Windows**: [Windows 10 Pro](https://docs.docker.com/docker-for-windows/install/#system-requirements) および [Windows 10 Home](https://docs.docker.com/docker-for-windows/install-windows-home/#system-requirements) の各要件を参照してください。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
このガイドでは、WSL2 のセットアップに関する一般的な手順について説明します。 WSL2 に関する一般的な問題に対処したら、[ローカルセットアップガイド](how-to-setup-freecodecamp-locally.md) に従い、Ubuntu のように WSL ディストリビューションを実行している Windows 上で freeCodeCamp を起動できるようになります。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
## WSLを有効化する
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
[公式ドキュメント ](https://docs.microsoft.com/en-us/windows/wsl/install-win10 ) の指示に従って、WSL1 をインストールしてから、WSL2 にアップグレードしてください。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
## Ubuntu をインストールする
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
1. WSL2 で Ubuntu-18.04 またはそれ以降を使用することをお勧めします。
2021-09-22 14:28:36 +00:00
> [!NOTE]
>
2022-02-03 22:25:42 +00:00
> 他の非debianベースのdistrosを使用することができますが、それぞれの問題点があり、このガイドの範囲を超えています。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
2. OS の依存関係を更新します。
2021-09-22 14:28:36 +00:00
```console
sudo apt update
sudo apt upgrade -y
# cleanup
sudo apt autoremove -y
```
2022-02-03 22:25:42 +00:00
## Git を設定する
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
Git は Ubuntu 18.04 でプリインストールされています。Git バージョンを `git --version` で確認してください。
2021-09-22 14:28:36 +00:00
```output
~
❯ git --version
git version 2.25.1
```
2022-02-03 22:25:42 +00:00
(任意ですが推奨) GitHub で [ssh キー設定 ](https://help.github.com/articles/generating-an-ssh-key ) を実行します。
2021-09-22 14:28:36 +00:00
2022-02-07 13:53:40 +00:00
## コードエディターをインストールする
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
Windows 10 に [Visual Studio Code ](https://code.visualstudio.com ) をインストールすることを強くお勧めします。 WSLの素晴らしいサポートがあり、自動的にWSL distro に必要な拡張機能をすべてインストールします。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
基本的には、Windows にインストールされている VS Code を使用して、Ubuntu-18.04 上でコードを編集して保存します。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
[IntelliJ Idea ](https://www.jetbrains.com/idea/ ) を使用する場合、Node インタプリターと Npm パッケージマネジャーを WSL distro にインストールされているものに更新する必要があるかもしれません。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
その設定は、設定 > 言語 & フレームワーク > Node.js および NPM で確認できます。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
## Docker Desktop をインストールする
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
**Docker Desktop for Windows** を使用すると、MongoDB のようなデータベースや NGINX などのサービスをインストールして実行できます。 MongoDB やその他のサービスを Windows または WSL2 に直接インストールする際の一般的な落とし穴を避けることができます。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
[公式ドキュメント ](https://docs.docker.com/docker-for-windows/install ) の指示に従って、Docker Desktop for Windows をインストールしてください。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
最高の体験を得るための最低限のハードウェア要件があります。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
## Docker Desktop for WSL を構成する
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
Docker Desktop がインストールされたら、[この手順に従って](https://docs.docker.com/docker-for-windows/wsl) Ubuntu-18.04 をバックエンドとして使用するように設定します。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
これにより、コンテナは Windows 上ではなく WSL 側で実行されます。 Windows と Ubuntu の両方で `http://localhost` からサービスにアクセスできます。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
## Docker Hub から MongoDB をインストールする
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
WSL2 で動作するように Docker Desktop を設定したら、次の手順に従って MongoDB サービスを起動します。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
1. 新しい Ubuntu-18.04 端末を起動します。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
2. dockerhub から `MongoDB 4.0.x` を取得します。
2021-09-22 14:28:36 +00:00
```console
docker pull mongo:4.0
```
2022-02-03 22:25:42 +00:00
3. MongoDB サービスをポート `27017` で起動し、システム再起動時に自動的に実行するように設定します。
2021-09-22 14:28:36 +00:00
```console
docker run -it \
-v mongodata:/data/db \
-p 27017:27017 \
--name mongodb \
--restart unless-stopped \
-d mongo:4.0
```
2022-02-03 22:25:42 +00:00
4. Windows または Ubuntu から `mongodb://localhost:27017` でサービスにアクセスできるようになりました。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
## Node.js と npm をインストールする
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
Node バージョンマネジャー - [nvm ](https://github.com/nvm-sh/nvm#installing-and-updating ) を使用して、Node.js 用の LTS リリースをインストールすることを推奨します。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
インストールしたら、以下のようなコマンドを使って、Node.js バージョンをインストールして使用します。
2021-09-22 14:28:36 +00:00
```console
nvm install --lts
# OR
# nvm install <version>
nvm install 14
# Usage
# nvm use <version>
nvm use 12
```
2022-02-03 22:25:42 +00:00
Node.js には `npm` がバンドルされています。次のコマンドで `npm` の最新バージョンに更新することができます。
2021-09-22 14:28:36 +00:00
```console
npm install -g npm@latest
```
2022-02-03 22:25:42 +00:00
## freeCodeCamp をローカルで設定する
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
前提条件のインストールが完了したら、[ ローカルセットアップガイド](how-to-setup-freecodecamp-locally.md) に従って、マシンに freeCodeCamp をローカルにクローンし、インストールし、セットアップしてください。
2021-09-22 14:28:36 +00:00
> [!WARNING]
>
2022-02-03 22:25:42 +00:00
> 現在、Cypress テストのセットアップ (および関連するGUIのニーズ) 作業が進行中です。 それでも、ほとんどのコードベースで作業できるはずです。
2021-09-22 14:28:36 +00:00
2022-02-03 22:25:42 +00:00
## 有用なリンク
2021-09-22 14:28:36 +00:00
2022-08-19 14:47:44 +00:00
- [A WSL2 Dev Setup with Ubuntu 20.04, Node.js, MongoDB, VS Code and Docker ](https://hn.mrugesh.dev/wsl2-dev-setup-with-ubuntu-nodejs-mongodb-and-docker ) - an article by Mrugesh Mohapatra (Staff Developer at freeCodeCamp.org)
2022-02-03 22:25:42 +00:00
- よくある質問:
2021-09-22 14:28:36 +00:00
- [Windows Subsystem for Linux ](https://docs.microsoft.com/en-us/windows/wsl/faq )
- [Docker Desktop for Windows ](https://docs.docker.com/docker-for-windows/faqs )