Spurtcommerce Microservices Deployment

This article provides detailed instructions on how to setup Spurtcommerce Ecommerce Microservices solution along with Backend APIs and all associated frontend panels, including the Store Panel, Vendor Panel, and Admin Panel.

Infrastructure pre-requisites

Before diving into the installation process, ensure that your local or server environment meets the necessary infrastructure prerequisites as detailed in this Link

Note: You can choose to ignore "React Installation" step if you have purchased Angular store.

Frontend Setup

Please follow steps and guidelines detailed in the below links to setup Angular storefront, Vendor Panel & Admin Panel.

Angular Store: Steps to deploy Angular storefront

Angular Admin: Steps to deploy Admin Panel

Angular vendor: Steps to deploy Vendor Panel

Backend Setup

  1. Setup RabbitMQ:

  • Ensure latest version of RabbitMQ is installed, running, and accessible.

  • Necessary exchanges, queues, and bindings etc required for the services will be handled by backend application logic during runtime..

  1. Extract the zip file of the backend source-code that you purchased and you should see the below folder structure.

  1. Navigate to each service directory (including /api-gateway folder) and perform the following:

3.1 Install the required dependencies using the following command.

npm install

Above step shall install gRPC modules along with other relvant/applicable node modules as well.

3.2 Import the corresponding SQL database for each service.

3.3 Configure a .env file of each service with the necessary environment variables and this includes:

  • Database credentials (host, port, username, password, database name)

  • RabbitMQ URL (protocol, host, port, username, password)

  • gRPC URL (host, port)

  • API Gateway settings (host, port, routes)

Note: If all services are on the same machine, ensure the gRPC URLs and API Gateway settings in the .env files are set to localhost (i.e retain the default config provided by Spurtcommerce team initially) whereas if you prefer to deploy services on different machines, then update the corresponding .env file with the correct IP addresses or domain names for gRPC and API Gateway and ensure network security groups and firewall rules allow communication between services.

3.4 Start the service using the following command.

npm start serve

After all the above steps are executed, check if the api-gateway is up by running http://localhost:8000

Specific configuration:

"Chat" module related configuration should be done in "Customer Service" .env file. Please check the chat server setup guidelines here Link

Above steps concludes successful installation and setup of Spurtcommerce Microservices based Marketplace solution and "Your Own Marketplace" will be ready-to-use.

Last updated