使用PasteSpider部署CoreShop商城

『PasteSpider』

准备工作

首先打开CoreShop的官网 https://www.coreshop.cn/ ，按照提示下载源码！

本文适合于有一定基础的，之前已经成功发布过coreshop商城的人。没发布过的还是去coreshop官网查看文档，有很多内容和PasteSpider并没有多大的关系。

我们本次使用的是linux部署coreshop系统，请先在linux上安装好docker,教程本论坛有，在centos7中安装docker

CoreShop采用的数据库是Mysql的，不过这里我建议改用mariadb数据库，mariadb这个数据库和mysql可以说是同一个团队写的，能非常好的兼容，他修复了很多mysql中的问题，具体的自行搜索了解！

1.mariadb(mysql)，记录好数据库的密码

2.Navicat for MySQL,用于连接数据库的，也可以使用DBeaver ,这个的作用就是本地连接数据库，到时候可以查看一些数据库里面的数据，也可以测试数据库配置是否正确等。

3.Xshell和Xftp,这2个工具一个是远程命令，一个是远程传输文件的。这个软件的免费版本就够我们使用了。

4.Microsoft Visual Studio 2022 用于编译和发布coreshop的接口端和管理端。

5.HBuilder X 用于编译和打包coreshop的H5端,小程序端等

mariadb的安装

我们不希望重新安装数据库的时候数据库文件丢失，所以要做虚拟目录。先在linux中执行如下命令，创建文件夹

mkdir -p /coreshop/mydata/maridb/mysql-files

mkdir -p /coreshop/mydata/maridb/data

mkdir -p /coreshop/mydata/maridb/logs

可以使用如下命令安装

docker run -it --name mariadb -p 8005:3306 --restart always -v /coreshop/mydata/maridb/mysql-files:/var/lib/mysql-files -v /coreshop/mydata/maridb/data:/var/lib/mysql  -v /coreshop/mydata/maridb/logs:/var/log/mysql -e MYSQL_ROOT_PASSWORD=yourmariadbpass -d mariadb --lower_case_table_names=1

上面的命令其实是mysql的安装命令，由于他们2个数据库兼容，我改了下，还真可以安装。注意yourmariadbpass要改成你得数据库密码，尽量正规点，别使用=符号，会冲突的。

以上命令执行完成后，可以使用

docker ps

查看下状态，如果没找到，再使用

docker ps -a

查看，是不是停止了，一般的停止了是触发了异常，如果没有正常启动，我们可以使用如下命令查看下日志

docker logs mariadb

再根据日志的提醒做相应的处理。

Redis的安装

redis的安装很简单，只需要一行代码

docker run -it --name redis -p 8004:6379 -d --restart always redis --requirepass yourredispass

注意yourredispass需要修改成你的redis的密码。

编译打包

基于coreshop的官方文档编译打包，后我们生成了三大文件夹

Web端

h5端的前端web部分，项目是这个CoreCms.Net.Uni-App

使用HBuilder X打开源代码，注意看common\setting\constVarsHelper.js,注意修改里面的一些url。

在HBuilder X中右键这个项目-发行-网站pcWeb或者手机H5

发布后存放在CoreCms.Net.Uni-App\CoreShop\unpackage\dist\build\h5,发布后大概是这个样子

Api端

2.h5端的API部分,通过VS发布(项目是CoreCms.Net.Web.WebApi)后，默认路径应该在

打包前修改下CoreCms.Net.Web.WebApi下面的Dockerfile

FROM mcr.microsoft.com/dotnet/aspnet:5.0
WORKDIR /app
EXPOSE 80
COPY . .
ENV TZ=Asia/Shanghai
RUN sed -i 's/MinProtocol = TLSv1.2/MinProtocol = TLSv1/g' /etc/ssl/openssl.cnf
RUN sed -i 's/MinProtocol = TLSv1.2/MinProtocol = TLSv1/g' /usr/lib/ssl/openssl.cnf
WORKDIR /app
ENTRYPOINT ["dotnet", "CoreCms.Net.Web.WebApi.dll"]

由于我下载的是之前的版本是.net5.0的，后面的只要把上面的aspnet:5.0修改成对应的即可。

右键CoreCms.Net.Web.WebApi，选择发布-文件夹-完成，一般如下

那么我发布后的文件应该在CoreCms.Net.Web.WebApi\bin\Release\net5.0\publish发布后如下这个样子

管理端

管理端的发布和Api端的发布可以说是一样的，只是项目改成了CoreCms.Net.Web.Admin，记得修改Dockerfile的文件内容

FROM mcr.microsoft.com/dotnet/aspnet:5.0

RUN apt-get update && apt-get install -y libgdiplus

WORKDIR /app

EXPOSE 80

COPY  . .

ENV TZ=Asia/Shanghai

ENTRYPOINT ["dotnet", "CoreCms.Net.Web.Admin.dll"]

同上，要基于自己项目的net版本，就行修改。

发布同上操作，管理端发布后的路径应该是CoreCms.Net.Web.Admin\bin\Release\net5.0\publish，发布后如下图的样子

Spier端配置

创建coreshop项目，菜单-》项目信息-项目列表-新增

为啥要拆分成2个项目？PasteSpider中项目的拆分是基于域名的，你一个域名下是否可以访问所有服务，能一起访问的就合并在一个项目中，不能就分开。

新增三个服务，api(发布模式),manage(发布模式),web(静态模式)，菜单->项目信息-服务列表-新增

其他用默认配置即可。

其他配置依然使用默认配置

上面这个注意文件模式，由于都是html,css,js等文件，文件模式选择静态文件

上传项目文件

PasteSpider的文件同步机制是基于文件Md5的，后续的更新，有改动的或者配置必须更新的才会需要更新。

菜单-》项目信息-服务列表

点击第一行的文件更新，意思是更新coreshop的前端文件，如下图

1.是操作区域，2是当前服务端的文件情况，3是执行信息，4是确定把对比的文件上传到服务器上。按照提示，我们把上一个步骤中的前端文件

全选，然后拉入到1位置

点击最下方的同步，等待操作完成，然后刷新页面，就会看到2位置有文件了！就表示文件同步上去了。如果有部分文件更新失败，那多半是你配置PasteSpider的nginx的上传文件大小限制太小了，默认是1MB。 Docker中安装Spider 有介绍。

同理，更新Api端和管理端。管理端的api和web页面是放在一起的，wwwroot文件夹下面的就是管理端的web页面。

更新规则

上面是第一次上载文件，一般所有需要的文件都需要上传，我们下次升级的适合希望忽略一些文件，比如配置文件appsettings.json,这就需要使用到PasteSpider的同步配置功能了，表示下一次上载文件的时候比更新某个文件或者忽略某个文件，支持文件夹。

菜单->项目信息-同步过滤-新增

注意文件模式需要和服务的创建那边配置一致，这个问题后续会修复应该直接从服务中拿取这个配置。同理你可以配置其他服务，也可以配置文件夹等，注意都是以/开头，路径是相对于项目来说的。

构建镜像

菜单-》项目信息-服务列表，找到coreshop商城的管理和接口那行数据，点击“构建镜像”，在弹出来的页面中选择一个仓储，操作后会提示已经提交这个任务了，可以到任务列表中查看。

菜单-》运行记录-工作列表

点击对应的详细，可以查看运行到哪个步骤了，构建镜像会失败一般的原因有:1.Dockerfile文件有问题 2.Dockerfile里面安装软件有问题，比如这个项目的Dockerfile中的RUN apt-get update && apt-get install -y libgdiplus 你得注视他，用另外一个方式实现！

构建镜像2个都成功后，我们接下来要让他运行起来，PasteSpider的运行机制是基于服务和环境的，之前我们创建服务的时候，勾选的环境应该都是默认环境。

运行服务，任务执行成功后，可以使用xshell使用命令docker images查看下构建的镜像列表,我的如下：

镜像的命名规则为项目的代码_服务代码，然后TAG为当前版本号。

菜单-》项目信息-环境列表，如下图

如上图所示，其实除了文件模式为静态文件的，其他模式需要为这个服务的这个环境配置分布，意思就是告诉PasteSpider系统，这个服务需要运行在哪些服务器上，点击后面的分布，进行设置。如我点击了第二行的分布

勾选状态，表示启用这个关系，然后设置最小运行数，然后记得点击保存。这个操作完成后，要么你可以等待PasteSpider下一次的运行检查，要么你手动给他扩容。

我设置分布后，可以在任务列表中看到如下：

从0到1，对于系统来说就是扩容了。

打开xshell，连接到服务器，查看下是否启动了这个服务。

docker ps

我的看到如下图，如果没有看到的话，估计是启动失败了，可以试试docker ps -a

使用PasteSpider发布的容器或者镜像都是有规律的，如上，容器的名称为default_6_f5623cd630b24812bfd9b和default_7_7879b38f31d34b2b8878e，表示运行的是服务ID为6的default环境的容器和服务ID为7的default环境的容器。往第二列看，可以知道他是基于哪个镜像的。

如上操作后，我们的网站还是不能访问的，或者说不能通过浏览器访问，因为没有配置他的路由，接下来我们配置下路由规则，需要准备对外的域名，我这里准备的域名为t1.pastecode.cn(给前端用)和t2.pastecode.cn(给管理端用)

配置路由

菜单-》项目信息-路由列表-新增,上半部分如下配置

往下拉，可以看到一些快捷操作

上面的案例1，案例2，因为并不是绝对的，需要你根据你的项目进行配置，我们选择"案例一"，然后点击后面的那个"检查"

预览中生成了如下信息：

# --- -- - http模式 - -- ---
											
	   upstream coreshopserapi {
				  			server 172.17.0.11:80 weight=10;
		  				}
												
	   upstream coreshopsermanage {
				  			server 172.17.0.6:80 weight=10;
		  				}
	server {
	listen 80;
	server_name ;
		location /api/api {
		proxy_pass http://coreshopserapi/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	}
		location /api/manage {
		proxy_pass http://coreshopsermanage/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	}
		location / {
		root ;
		index index.html index.htm;
	}
}

上面很多信息其实是错误的，我们修改下，我就按照我的信息进行配置，前端的web我们存放在服务器的路径在文件更新的那个页面的顶部有显示，是/PasteSpider/static/coreshop/web，所以文件内容部分我做修改后，如下：(模板的语法，你可以点击模板格式，里面有介绍怎么用这个语法)

    # --- -- - http模式 - -- ---
{% for item in services -%}
	{% assign findapp=false -%}
	{% for model in item.models -%}
		{% for app in model.apps -%}
			{% assign findapp=true -%}
		{% endfor -%}
	{% endfor -%}
	{% if findapp == true %}
	   upstream {{ Code }}ser{{item.Code}} {
		{% for model in item.models -%}
		  {% for app in model.apps -%}
			server {{ app.Address }}:{{ app.listen_ports }} weight=10;
		  {% endfor -%}
		{% endfor -%}
		}
     {% endif -%}
{% endfor -%}
server {
	listen 80;
	server_name t1.pastecode.cn;
	location /api/ {
		proxy_pass http://coreshopserapi/api/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	}

	location / {
		root /PasteSpider/static/coreshop/web;
		index index.html index.htm;
	}
}

执行检查后，预览如下:

    # --- -- - http模式 - -- ---
     											
	   upstream coreshopserapi {
				  			server 172.17.0.11:80 weight=10;
		  				}
	          server {
	listen 80;
	server_name t1.pastecode.cn;
	location /api/ {
		proxy_pass http://coreshopserapi/api/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	}

	location / {
		root /PasteSpider/static/coreshop/web;
		index index.html index.htm;
	}
}

点击保存.

同理点击后面的分布按钮，为这个路由文件配置下，他应该更新到那个服务器上。

管理端的，我的模板代码如下：

    # --- -- - http模式 - -- ---
{% for item in services -%}
	{% assign findapp=false -%}
	{% for model in item.models -%}
		{% for app in model.apps -%}
			{% assign findapp=true -%}
		{% endfor -%}
	{% endfor -%}
	{% if findapp == true %}
	   upstream {{ Code }}ser{{item.Code}} {
		{% for model in item.models -%}
		  {% for app in model.apps -%}
			server {{ app.Address }}:{{ app.listen_ports }} weight=10;
		  {% endfor -%}
		{% endfor -%}
		}
     {% endif -%}
{% endfor -%}
server {
	listen 80;
	server_name t2.pastecode.cn;
	location / {
		proxy_pass http://shopplatsermanage/;
		proxy_set_header Host $host;
                index index.html index.htm;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	}
}

检查后，如下：

    # --- -- - http模式 - -- ---
          											
	   upstream shopplatsermanage {
				  			server 172.17.0.6:80 weight=10;
		  				}
	     server {
	listen 80;
	server_name t2.pastecode.cn;
	location / {
		proxy_pass http://shopplatsermanage/;
		proxy_set_header Host $host;
                index index.html index.htm;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
	}
}

我们之前已经发布过，就是在环境列表那边分布后，等待或者手动扩容，这样上面的路由配置在点击检查的时候才会有数据。

在正式发布前，我们配置下通知，这样在发布成功或者失败的时候，我们会收到消息。当然如果你不要这个通知，你也可以不配置这个通知。