Deploy the Mall E‑commerce Project on Rainbond: A Step‑by‑Step Guide

Introduction

Many developers spend a long time configuring the Mall e‑commerce project for deployment. This article shows how to use Rainbond, a cloud‑native application management platform, to deploy Mall quickly and easily, allowing you to focus on code.

Deployment Methods

Deploy Mall via Rainbond's open‑source app store.

Deploy Mall from scratch by setting up all services manually.

Prerequisite

Install a functional Rainbond environment on Linux, macOS, or Windows. See the Rainbond quick‑install guide.

Quick Deployment via App Store

The Mall project is published in the Rainbond open‑source app store. Search for

mall

in Platform Management → Application Market → Open‑Source App Store and install it.

Rainbond will automatically build and start all Mall services. After deployment, the topology looks like this:

Verify the deployment by accessing the

mall-admin-web

front‑end (default credentials

admin / macro123

). The

mall-portal

and

mall-search

services currently have no front‑end; you can verify them via the backend Swagger UI at

http://xxx/swagger-ui/

.

Manual Deployment from Scratch

Middleware Installation

Mall requires the following middleware, all of which can be installed from the Rainbond app store:

MySQL

Redis

RabbitMQ

MongoDB

ElasticSearch

Install Redis

Search for Redis in the open‑source app store and install version 5.x.

Install MongoDB

Search for MongoDB and install version 4.x.

Install RabbitMQ

Search for RabbitMQ and install it.

Install MySQL

Search for MySQL and install version 5.7. Then open the component’s Component → Port page, enable the external port, and connect using

root / root

. Import the Mall SQL data via a client.

Install ElasticSearch

Search for ElasticSearch and install version 7.15.2. Optionally remove the Kibana component. Disable security by setting

xpack.security.enabled

to

false

in the component’s configuration file.

Install IK Analyzer Plugin

In Team View → Plugin → Add Plugin → Install from App Store , search for

ES-IK-Analysis

and install it.

Add storage to the ElasticSearch component at Component → Storage → Add Storage with:

Name: Custom

Mount Path:

/usr/share/elasticsearch/plugins

Type: Shared Storage

Enable the

ES-IK-Analysis

plugin under Component → Plugin → Not Enabled .

Restart or update the ElasticSearch component.

Backend Service Configuration

Modify Maven Build Settings

Comment out the

execution

section in

pom.xml

so that Docker image building is handled by Rainbond.

<code><!--
<execution>
  <id>build-image</id>
  <phase>package</phase>
  <goals>
    <goal>build</goal>
  </goals>
</execution>
--></code>

Update Configuration Files

Replace hard‑coded values with environment variables for flexibility.

mall‑admin application-dev.yml

<code>spring:
  datasource:
    url: jdbc:mysql://${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false # MySQL connection URL
    username: ${MYSQL_USERNAME} # MySQL user
    password: ${MYSQL_PWD} # MySQL password
  redis:
    host: ${REDIS_HOST} # Redis host
  ...
</code>

mall‑portal application-dev.yml

<code>spring:
  datasource:
    url: jdbc:mysql://${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false # MySQL connection URL
    username: ${MYSQL_USERNAME} # MySQL user
    password: ${MYSQL_PWD} # MySQL password
  data:
    mongodb:
      host: ${MONGODB_HOST} # MongoDB host
      port: 27017
      database: mall-port
  redis:
    host: ${REDIS_HOST} # Redis host
  rabbitmq:
    host: ${AMQP_HOST} # RabbitMQ host
    virtual-host: ${RABBITMQ_DEFAULT_VHOST}
    username: ${RABBITMQ_DEFAULT_USER}
    password: ${RABBITMQ_DEFAULT_PASS}
  ...
</code>

mall‑search application-dev.yml

<code>spring:
  datasource:
    url: jdbc:mysql://${MYSQL_HOST}:${MYSQL_PORT}/${MYSQL_DATABASE}?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&useSSL=false # MySQL connection URL
    username: ${MYSQL_USERNAME} # MySQL user
    password: ${MYSQL_PWD} # MySQL password
  elasticsearch:
    uris: ${ES_HOST}:${ES_PORT} # ElasticSearch URL
  ...
</code>

Using environment variables makes the deployment portable; Rainbond automatically injects variables from dependent components.

Deploy Backend Components

Create components from source in the team or application view ( New → Create Component from Source ) with the following settings:

Component name: custom

Component English name: custom

Repository URL:

https://github.com/zzzhangqi/mall.git

Version: master

Rainbond detects the multi‑module project and builds

mall-admin

,

mall-portal

, and

mall-search

. Adjust each component’s port:

mall-admin: 8080

mall-portal: 8085

mall-search: 8081

Establish Component Dependencies

In edit mode, connect components according to their dependencies.

Frontend Deployment

Handle Cross‑Origin Issues

The backend address in

config/prod.env.js

must match the front‑end address to avoid CORS. Define a proxy path (e.g.,

/api

) and rewrite it with Nginx.

<code>module.exports = {
  NODE_ENV: "production",
  BASE_API: "/api"
}
</code>

Rewrite

/api

to the actual backend endpoint using Nginx:

<code>server {
    listen 80;
    location / {
        root /app/www;
        index index.html index.htm;
    }
    location /api {
        rewrite ^/api/(.*)$ /$1 break;
        proxy_pass http://127.0.0.1:8080;
    }
}
</code>

Deploy Frontend Component

Create a new component from source with these settings:

Component name: custom

Component English name: custom

Repository URL:

https://github.com/zzzhangqi/mall-admin-web.git

Version: master

Set the

mall-admin-web

component to depend on the

mall-admin

backend service.

Verification

Access

mall-admin-web

to verify the front‑end (default credentials

admin / macro123

). The

mall-portal

and

mall-search

services can be verified via their Swagger UI at

http://xxx/swagger-ui/

.

Reference Links

Rainbond quick‑install: https://www.rainbond.com/docs/quick-start/quick-install

Rainbond environment variable injection: https://www.rainbond.com/docs/micro-service/service-mesh/connection_env