项目

PasteSpider中的项目和我们平时说的项目意思一样，比如你要开发一个在线客服系统(项目)，一个商城系统(项目),一个CRM系统(项目)。这些都可以概括为一个项目，他们之间没有啥联系。在PasteSpider中还有一层一次，如果你部署的一个系统，可以用一个域名进行访问，那么就可以概述为项目！

在菜单 =项目信息=项目列表新增，如下图：

项目代码

这里的项目代表，表示使用字母的表达式，用于容器的镜像名称，所以不要使用特殊符号和中文等，可以使用英文开头混合数字，长度限定下。在整个PasteSpider中要确保项目代码唯一！

名称

其实就是项目的中文名称，或者你能识别的名称，只作为显示使用。

描述

这个项目的介绍，有些时候名称没办法很好的介绍项目的时候，这个描述就可以帮衬上了。

推送地址

在PasteSpider部署服务后，或者升级后，会把这个项目的TemProject信息推送给这个地址，TemProject里面描述了这个项目的当前运行的服务，环境，容器的IP，端口等信息，比如在作者的一个在线客服系统，就需要在在线客服系统部署后告知在线客服系统中的某一个服务，便以服务检测子服务等。

状态

是否启用这个项目，如果禁用了，对应的很多功能将失效！

服务

怎么去理解服务呢，一个项目可以包括很多个服务，比如一个商城项目中，有订单服务，会员服务，支付服务等，在PasteSpider中服务为单独部署的一些功能的统称，他们往往以不一样的容器出现。你也可以理解成他们在访问的时候有特殊的路径，比如/api/user/表示访问会员服务，/api/order/表示访问订单服务。

在菜单 =项目信息= =服务列表= 新增，如下图

所属项目

这个服务是属于哪个项目的，项目就是前面介绍的，比如商城项目。

服务代码

类似于项目代码，这个请使用英文字母开头，混不混数字随意，你自己能识别就好，比如user表示会员服务，order表示订单服务，一个项目内，服务代码请保证唯一，因为服务的镜像名称是使用项目代码_服务代码组合而成的。

名称

就是这个服务的中文名称，自己可以识别即可，只做显示使用。

存放路径

这个输入项一般留空，主要是为文件类型(文件模式)为静态的时候使用的，用于上传文件的时候直接上传到这个路径下，注意要在所在服务器的工作目录下。

服务描述

这个服务的描述信息

当前版本

当前镜像版本，系统默认1000起，这个版本可以在服务器上的镜像列表中的tag可以看到，版本作为镜像的一个重要信息，不建议修改，会混乱里面的逻辑。

监听端口

一般的服务监听80,也有一些是监听多个端口的，监听多个端口的话使用英文的逗号隔开，比如80,443表示这个服务内部是使用80和443端口的。

文件模式

文件模式分为4种情况，

1.纯静态文件，比如html,js,css等只要放在宿主服务器上的文件夹即可，一般为网站的静态页面等

2.源码模式，PasteSpider支持git/svn模式，就是你提交自己的项目代码后，PasteSpider会自动去拉取代码，编译，构建，升级服务。这个需要和git/svn配置使用

3.发布模式，就是开发者在自己电脑上编译发布，然后使用同步工具把发布后的文件上传到宿主服务器后，执行镜像的构建和运行等

4.镜像模式，指的是镜像来源是公共镜像仓库的，比如redis,rabbit,postgre,mariadb等

镜像名称

这个默认留空，只有文件模式为镜像模式的时候这里需要填写，比如redis

服务状态

是否启用这个服务，如果不启用，则对应的服务不会继续执行。

自动重启

这个是docker/podman里面的restart=always的参数，设定容器有异常后是否自动重启。一般是启用

端口映射

如果你的这个服务需要其他服务器能够访问，那么就需要端口映射，端口映射就是打通宿主服务器的端口和这个服务的容器内的端口。这个映射会映射一个或者多个就是看上面的监听端口。

升级前置命令

一个服务的升级过程为到发布文件夹，然后执行打包镜像的动作，打包后，在对应的服务器上拉取镜像，然后基于这个镜像运行服务(启动容器 docker run/podman run)，前置命令就是在打包镜像前的命令，比如你可以从其他地方复制文件到发布文件夹，然后随其他文件一起打包到镜像中，这个需求一般是很少的。

因为服务器上的发布文件夹对于PasteSpider的用户来说是不能下载的，只能读取文件的基本信息，比如大小，创建时间，文件码等。

这个命令可以使用带参的形式，比如{{Service.Code}}表示读取当前服务的代码。更多的参数在后续会介绍！