谷粒商城简介

前言

gulimall` 项目致力于打造一个完整的电商系统，采用现阶段流行技术来实现，采用前后端分离继续编写。

项目API接口文档

文档地址：https://easydoc.xyz/s/78237135/ZUqEdvA4/hKJTcbfd

项目介绍

gulimall（谷粒商城）项目是一套电商项目，包括前台商城系统以及后台管理系统，基于 SpringCloud + SpringCloudAlibaba + MyBatis-Plus实现，采用 Docker 容器化部署。前台商城系统包括：用户登录、注册、商品搜索、商品详情、购物车、下订单流程、秒杀活动等模块。后台管理系统包括：系统管理、商品系统、优惠营销、库存系统、订单系统、用户系统、内容管理等七大模块。

项目演示

前台部分功能演示效果

后端登录界面

主页面

后台部分功能

组织结构

gulimall
├── gulimall-common -- 工具类及通用代码
├── renren-generator -- 人人开源项目的代码生成器
├── gulimall-auth-server -- 认证中心（社交登录、OAuth2.0、单点登录）
├── gulimall-cart -- 购物车服务
├── gulimall-coupon -- 优惠卷服务
├── gulimall-gateway -- 统一配置网关
├── gulimall-order -- 订单服务
├── gulimall-product -- 商品服务
├── gulimall-search -- 检索服务
├── gulimall-seckill -- 秒杀服务
├── gulimall-third-party -- 第三方服务
├── gulimall-ware -- 仓储服务
└── gulimall-member -- 会员服务

技术选型

后端技术

技术	说明	官网
SpringBoot	容器+MVC框架	https://spring.io/projects/spring-boot
SpringCloud	微服务架构	https://spring.io/projects/spring-cloud
SpringCloudAlibaba	一系列组件	https://spring.io/projects/spring-cloud-alibaba
MyBatis-Plus	ORM框架	https://mp.baomidou.com
renren-generator	人人开源项目的代码生成器	https://gitee.com/renrenio/renren-generator
Elasticsearch	搜索引擎	https://github.com/elastic/elasticsearch
RabbitMQ	消息队列	https://www.rabbitmq.com
Springsession	分布式缓存	https://projects.spring.io/spring-session
Redisson	分布式锁	https://github.com/redisson/redisson
Docker	应用容器引擎	https://www.docker.com
OSS	对象云存储	https://github.com/aliyun/aliyun-oss-java-sdk

前端技术

技术	说明	官网
Vue	前端框架	https://vuejs.org
Element	前端UI框架	https://element.eleme.io
thymeleaf	模板引擎	https://www.thymeleaf.org
node.js	服务端的js	https://nodejs.org/en

架构图

系统架构图

业务架构图

环境搭建

开发工具

工具	说明	官网
IDEA	开发Java程序	https://www.jetbrains.com/idea/download
RedisDesktop	redis客户端连接工具	https://redisdesktop.com/download
SwitchHosts	本地host管理	https://oldj.github.io/SwitchHosts
X-shell	Linux远程连接工具	http://www.netsarang.com/download/software.html
Navicat	数据库连接工具	http://www.formysql.com/xiazai.html
PowerDesigner	数据库设计工具	http://powerdesigner.de
Postman	API接口调试工具	https://www.postman.com
Jmeter	性能压测工具	https://jmeter.apache.org
Typora	Markdown编辑器	https://typora.io

开发环境

工具	版本号	下载
JDK	1.8	https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html
Mysql	5.7	https://www.mysql.com
Redis	Redis	https://redis.io/download
Elasticsearch	7.6.2	https://www.elastic.co/downloads
Kibana	7.6.2	https://www.elastic.co/cn/kibana
RabbitMQ	3.8.5	http://www.rabbitmq.com/download.html
Nginx	1.1.6	http://nginx.org/en/download.html

注意：以上的除了jdk都是采用docker方式进行安装，详细安装步骤可参考百度!!!

本地搭建步骤

MacOS本地环境部署

修改本机的host文件，映射域名端口

192.168.2.130	gulimall.com
192.168.2.130	search.gulimall.com
192.168.2.130  item.gulimall.com
192.168.2.130  auth.gulimall.com
192.168.2.130  cart.gulimall.com
192.168.2.130  order.gulimall.com
192.168.2.130  member.gulimall.com
192.168.2.130  seckill.gulimall.com
以上端口换成自己Linux的ip地址

修改Linux中Nginx的配置文件

1、在nginx.conf中添加负载均衡的配置    
upstream gulimall {
        server 192.168.43.182:88;
    }
2、在gulimall.conf中添加如下配置
server {
    listen       80;
    server_name  gulimall.com  *.gulimall.com hjl.mynatapp.cc;

    #charset koi8-r;
    #access_log  /var/log/nginx/log/host.access.log  main;

    #配置静态资源的动态分离
    location /static/ {
        root   /usr/share/nginx/html;
    }

    #支付异步回调的一个配置
    location /payed/ {
        proxy_set_header Host order.gulimall.com;        #不让请求头丢失
        proxy_pass http://gulimall;
    }

    location / {
        #root   /usr/share/nginx/html;
        #index  index.html index.htm;
        proxy_set_header Host $host;        #不让请求头丢失
        proxy_pass http://gulimall;
    }

克隆前端项目 renren-fast-vue 以 npm run dev 方式去运行
克隆整个后端项目 gulimall ，并导入 IDEA 中完成编译

远程测试服务器搭建步骤

安装在了免费的oralce云 ARM (4核心CPU/24G内存)实例机器上，在 Linux 上以 All-in-One 模式安装 KubeSphere，

dokcerfile文件构建镜像内容

FROM openjdk:8u342-jre
VOLUME /tmp
ARG JAR_FILE=target/*.jar
# 将编译构建得到的jar文件复制到镜像空间中
COPY ${JAR_FILE} app.jar
RUN bash -c 'touch /app.jar'
# 指定运行生产环境配置 springboot程序
ENTRYPOINT ["java","-jar","/app.jar","--spring.profiles.active=prod"]

创建使用shell命令方便一键部署微服务到服务器，适用于单节点。

#!/bin/bash

# 判断是否安装了sshpass
if ! [ -x "$(command -v sshpass)" ]; then
  echo '请安装sshpass后再使用此脚本！'
  exit 1
fi

# 镜像名
IMAGE_NAME='gulimall/admin:0.0.1'

# TAG名
TAG_NAME='0.0.1'

# 配置了deployment和service的yaml文件名
DEPLOY_SERVICE_YAML='deploy.yaml'

# K8S环境的IP地址
K8S_IP_ADDRESS='xxx'

# K8S环境的SSH账号
K8S_SSH_ACCOUNT='root'

# 8S环境的SSH密码
K8S_SSH_PSWD='xxx'

# K8S上存放tar和yaml文件的位置
K8S_FILE_PATH='~/deploy_temp/admin'

# 当前名目录
CURRENT_DIR=`pwd`

JAR_FILE=target/*.jar
echo '开始自动构建和部署，当前目录是：'${CURRENT_DIR}

# 执行maven命令构建项目
mvn clean package -Dmaven.test.skip=true

echo "在K8S服务器创建存放文件的目录："${K8S_FILE_PATH}
sshpass -p ${K8S_SSH_PSWD} ssh ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS} "mkdir -p ${K8S_FILE_PATH}/target"

echo "将yaml、Dockerfile、JAR_FILE文件发送到K8S服务器："${IMAGE_NAME}
sshpass -p ${K8S_SSH_PSWD} scp ${CURRENT_DIR}/${DEPLOY_SERVICE_YAML} ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS}:${K8S_FILE_PATH}/
sshpass -p ${K8S_SSH_PSWD} scp ${CURRENT_DIR}/Dockerfile ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS}:${K8S_FILE_PATH}/
sshpass -p ${K8S_SSH_PSWD} scp ${CURRENT_DIR}/${JAR_FILE} ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS}:${K8S_FILE_PATH}/target


echo "如果K8S环境之前已经部署过，就先清理："${IMAGE_NAME}
sshpass -p ${K8S_SSH_PSWD} ssh ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS} "kubectl delete -f ${K8S_FILE_PATH}/${DEPLOY_SERVICE_YAML}"

echo "等待2秒"
sleep 2

echo "清理之前加载到本地仓库的镜像："${IMAGE_NAME}
sshpass -p ${K8S_SSH_PSWD} ssh ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS} "docker rmi ${IMAGE_NAME}"


echo "构建镜像文件："${IMAGE_NAME}
sshpass -p ${K8S_SSH_PSWD} ssh ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS} "docker build --platform linux/arm64  -t ${IMAGE_NAME} ${K8S_FILE_PATH}"

echo "部署："${IMAGE_NAME}
sshpass -p ${K8S_SSH_PSWD} ssh ${K8S_SSH_ACCOUNT}@${K8S_IP_ADDRESS} "kubectl apply -f ${K8S_FILE_PATH}/${DEPLOY_SERVICE_YAML}"

远程生产服务器多节点Kubernetes

在 Linux 上安装 KubeSphere / 简介 / 多节点安装

在安装后启用 DevOps, 多节点，需要推流docker镜像到docker库，再在多节点服务器拉取镜像生成服务容器。编写jenkins流水线

谷粒商城项目