2017-01-04 13:05:41 -08:00

2.3 KiB

eShop Web SPA (Single Page Application)

Requirements and set up

Install NPM

The SPA application is using a newer version of NPM than the one provided by Visual Studio 2015 (npm 2.7.4 currently), so you need to install the latest stable version of NPM,like npm .

NPM is bundled with NODE.JS. Installing NPM and NODE is pretty straightforward by using the installer package available at https://nodejs.org/en/

You can install the version "Recommended For Most Users" of Node which at the moment of this writing was v6.9.3 LTS and comes with a newer version of NPM. You can see your initial NPM version and the installed NPM version with the command npm -v, as shown below.

Set NPM path into Visual Studio

NPM will be usually installed under this path: C:\Program Files (x86)\nodejs. You need to update that path in Visual Studio 2015 under the "External Web Tools" location paths, as shown below:

Build the SPA app with NPM

Finally, you need to build the SPA app (TypeScript and Angular based client app) with NPM.

  • Open a command-prompt window and move to the root of the SPA application (src\Web\WebSPA\eShopOnContainers.WebSPA)
  • Run the command npm run build:prod as shown below:

If you get an error like "Node Sass could not find a binding for your current environment: Windows 64-bit with Node.js 6.x", then run the command npm rebuild node-sass as in the following screenshot: Then, run again the npm run build:prod command that should finish with no errors.

Build/create the Docker images

Create the Docker images with the build-images.ps1 PowerShell script in Windows (or the build-images.sh bash script in a Mac) as explained in the main instructions at https://github.com/dotnet/eShopOnContainers/

Deploy/run the Docker containers

Deploy/run the Docker containers with "docker-compose up" as explained in the main instructions at https://github.com/dotnet/eShopOnContainers/

Test the SPA web application

Test the SPA app by running the following URL in a browser: http://TBD