mirror of
https://github.com/zebrajr/node.git
synced 2026-01-15 12:15:26 +00:00
tools: add Boxstarter script
Adds a Boxstarter script for easy Node.js building prerequisites installation PR-URL: https://github.com/nodejs/node/pull/17046 Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Refael Ackermann <refack@gmail.com> Reviewed-By: João Reis <reis@janeasystems.com> Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com>
This commit is contained in:
@@ -89,6 +89,9 @@ Depending on host platform, the selection of toolchains may vary.
|
||||
|
||||
## Building Node.js on supported platforms
|
||||
|
||||
*Note:* All prerequisites can be easily installed by following
|
||||
[this bootstrapping guide](https://github.com/nodejs/node/blob/master/tools/bootstrap/README.md).
|
||||
|
||||
### Unix / macOS
|
||||
|
||||
Prerequisites:
|
||||
|
||||
55
tools/bootstrap/README.md
Normal file
55
tools/bootstrap/README.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# Node.js Bootstrapping Guide
|
||||
|
||||
## Windows
|
||||
|
||||
A [Boxstarter][] script can be used for easy setup of Windows systems with all
|
||||
the required prerequisites for Node.js development. This script will install
|
||||
the following [Chocolatey] packages:
|
||||
* [Git for Windows][] with the `git` and Unix tools added to the `PATH`
|
||||
* [Python 2.x][]
|
||||
* [Visual Studio 2017 Build Tools][] with [Visual C++ workload][]
|
||||
|
||||
To install Node.js prerequisites using [Boxstarter WebLauncher][], just open
|
||||
[this link](http://boxstarter.org/package/nr/url?https://raw.githubusercontent.com/nodejs/node/master/tools/bootstrap/windows_boxstarter)
|
||||
with Internet Explorer or Edge browser on the target machine.
|
||||
|
||||
Alternatively, you can use PowerShell. Run those commands from an elevated
|
||||
PowerShell terminal:
|
||||
```console
|
||||
Set-ExecutionPolicy Unrestricted -Force
|
||||
iex ((New-Object System.Net.WebClient).DownloadString('http://boxstarter.org/bootstrapper.ps1'))
|
||||
get-boxstarter -Force
|
||||
Install-BoxstarterPackage https://raw.githubusercontent.com/nodejs/node/master/tools/bootstrap/windows_boxstarter -DisableReboots
|
||||
```
|
||||
|
||||
Entire installation will take up about 8 GB of disk space.
|
||||
|
||||
## Linux
|
||||
|
||||
For building Node.js on Linux, following packages are required (note, that this
|
||||
can vary from distribution to distribution):
|
||||
* `git`
|
||||
* `python`
|
||||
* `gcc-c++` or `g++`
|
||||
* `make`
|
||||
|
||||
To bootstrap Node.js on Linux, run in terminal:
|
||||
* OpenSUSE: `sudo zypper install git python gcc-c++ make`
|
||||
* Fedora: `sudo dnf install git python gcc-c++ make`
|
||||
* Ubuntu, Debian: `sudo apt-get install git python g++ make`
|
||||
|
||||
## macOS
|
||||
|
||||
To install required tools on macOS, run in terminal:
|
||||
```console
|
||||
xcode-select --install
|
||||
```
|
||||
|
||||
[Boxstarter]: http://boxstarter.org/
|
||||
[Boxstarter WebLauncher]: http://boxstarter.org/WebLauncher
|
||||
[Chocolatey]: https://chocolatey.org/
|
||||
[Git for Windows]: https://chocolatey.org/packages/git
|
||||
[Python 2.x]: https://chocolatey.org/packages/python2
|
||||
[Visual Studio 2017 Build Tools]: https://chocolatey.org/packages/visualstudio2017buildtools
|
||||
[Visual C++ workload]: https://chocolatey.org/packages/visualstudio2017-workload-vctools
|
||||
|
||||
21
tools/bootstrap/windows_boxstarter
Normal file
21
tools/bootstrap/windows_boxstarter
Normal file
@@ -0,0 +1,21 @@
|
||||
# Boxstarter (http://boxstarter.org/) script for Node.js prerequisites
|
||||
#
|
||||
# To install either open this link in IE or Edge:
|
||||
# http://boxstarter.org/package/nr/url?https://raw.githubusercontent.com/nodejs/node/master/tools/bootstrap/windows_boxstarter
|
||||
#
|
||||
# Or run those commands in an elevated Powershell terminal:
|
||||
# iex ((New-Object System.Net.WebClient).DownloadString('http://boxstarter.org/bootstrapper.ps1'))
|
||||
# get-boxstarter -Force
|
||||
# Install-BoxstarterPackage https://raw.githubusercontent.com/nodejs/node/master/tools/bootstrap/windows_boxstarter -DisableReboots
|
||||
#
|
||||
# For more detail see
|
||||
# https://github.com/nodejs/node/blob/master/tools/bootstrap/README.md
|
||||
#
|
||||
|
||||
# Git and Unix tools will be added to the PATH
|
||||
choco install git -params /GitAndUnixToolsOnPath -y
|
||||
choco install python2 -y
|
||||
|
||||
# Installs VS 2017 Build Tools
|
||||
choco install visualstudio2017buildtools -y
|
||||
choco install visualstudio2017-workload-vctools -y
|
||||
Reference in New Issue
Block a user