mirror of
https://github.com/linux-odyssey/linux-odyssey.git
synced 2026-11-05 19:20:12 +08:00
docs: add windows environment setup document draft
This commit is contained in:
1 parent
b449d84c54
commit
84bd2620d8
1 file changed
+144
@@ -0,0 +1,144 @@
|
|||||||
|
# Windows Environment Setup
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
1. Have a computer with Windows 10 or later.
|
||||||
|
1. Install WSL and Ubuntu on Windows.
|
||||||
|
1. Enter Ubuntu terminal.
|
||||||
|
|
||||||
|
## Setup Environment (In Ubuntu terminal)
|
||||||
|
|
||||||
|
1. Update and upgrade
|
||||||
|
|
||||||
|
```
|
||||||
|
$ sudo apt-get update
|
||||||
|
$ sudo apt-get upgrade
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Install Git
|
||||||
|
|
||||||
|
```
|
||||||
|
$ sudo apt-get install git
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Install Node.js (Version 20.x)
|
||||||
|
|
||||||
|
```
|
||||||
|
$ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
|
||||||
|
$ sudo apt-get install nodejs
|
||||||
|
```
|
||||||
|
|
||||||
|
1. [Install Docker](#install-docker)
|
||||||
|
1. [Install Python 2.7](#install-python-27)
|
||||||
|
|
||||||
|
## Run the Project (In Ubuntu terminal)
|
||||||
|
|
||||||
|
1. Installation
|
||||||
|
|
||||||
|
```
|
||||||
|
$ git clone https://github.com/lancatlin/linux-odyssey.git
|
||||||
|
$ cd linux-odyssey
|
||||||
|
$ yarn install
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Docker setup
|
||||||
|
|
||||||
|
```
|
||||||
|
$ docker compose pull
|
||||||
|
$ docker compose build
|
||||||
|
$ docker-compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
<!-- Check folder ./config exist and is empty -->
|
||||||
|
<!-- Check .env file exist -->
|
||||||
|
|
||||||
|
1. Run the project
|
||||||
|
|
||||||
|
```
|
||||||
|
$ yarn build
|
||||||
|
$ yarn dev
|
||||||
|
```
|
||||||
|
|
||||||
|
<!-- Check ./config/ssh_key.pub is a file not a folder -->
|
||||||
|
|
||||||
|
## References
|
||||||
|
|
||||||
|
### Install Docker
|
||||||
|
|
||||||
|
(Refer to [get.docker.com](https://get.docker.com/))
|
||||||
|
|
||||||
|
To install the latest stable versions of Docker CLI, Docker Engine, and their
|
||||||
|
dependencies:
|
||||||
|
|
||||||
|
1. Download the script
|
||||||
|
|
||||||
|
```
|
||||||
|
$ curl -fsSL https://get.docker.com -o install-docker.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
1. verify the script's content
|
||||||
|
|
||||||
|
```
|
||||||
|
$ cat install-docker.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
1. run the script with --dry-run to verify the steps it executes
|
||||||
|
|
||||||
|
```
|
||||||
|
$ sh install-docker.sh --dry-run
|
||||||
|
```
|
||||||
|
|
||||||
|
1. run the script either as root, or using sudo to perform the installation.
|
||||||
|
|
||||||
|
```
|
||||||
|
$ sudo sh install-docker.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Verify the installation
|
||||||
|
|
||||||
|
```
|
||||||
|
$ docker --version
|
||||||
|
```
|
||||||
|
|
||||||
|
### Install Python 2.7
|
||||||
|
|
||||||
|
1. Install required packages
|
||||||
|
|
||||||
|
```
|
||||||
|
$ sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses-dev xz-utils tk-dev libffi-dev liblzma-dev python3-openssl git
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Install pyenv
|
||||||
|
|
||||||
|
```
|
||||||
|
$ curl https://pyenv.run | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Add following lines to bash configuration file (e.g. `~/.bashrc`, `~/.bash_profile`, `~/.zshrc`)
|
||||||
|
|
||||||
|
```
|
||||||
|
export PATH="$HOME/.pyenv/bin:$PATH"
|
||||||
|
eval "$(pyenv init --path)"
|
||||||
|
eval "$(pyenv init -)"
|
||||||
|
eval "$(pyenv virtualenv-init -)"
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Restart the shell
|
||||||
|
|
||||||
|
1. Install Python 2.7.18 using pyenv
|
||||||
|
|
||||||
|
```
|
||||||
|
$ pyenv install 2.7.18
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Set Python 2.7.18 as the global version
|
||||||
|
|
||||||
|
```
|
||||||
|
$ pyenv global 2.7.18
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Verify the installation
|
||||||
|
|
||||||
|
```
|
||||||
|
$ python --version
|
||||||
|
```
|
||||||
Reference in new issue
Block a user