doc: 修改格式

50a16cfb · 康明 · 225ca035 · 50a16cfb · 50a16cfb · 50a16cfb
Commit 50a16cfb authored Aug 30, 2022 by 康明
6 changed files
--- a/开发规范/.DS_Store
+++ b/开发规范/.DS_Store
--- a/部署手册/中间件部署手册/.DS_Store
+++ b/部署手册/中间件部署手册/.DS_Store
--- a/部署手册/中间件部署手册/JDK 安装手册.md
+++ b/部署手册/中间件部署手册/JDK 安装手册.md
-# JDK安装手册
 ## Linux系统下安装方式
 - **首先查看系统中是否已安装JDK**
-:::info
+> [root@VM-12-6-centos software]# java -version
-[root@VM-12-6-centos software]# java -version
-:::
 显示如下：
-:::info
+> openjdk version "1.8.0_102"
-openjdk version "1.8.0_102"
+> OpenJDK Runtime Environment(build 1.8.0_102-b14)
-OpenJDK Runtime Environment(build 1.8.0_102-b14)
+> OpenJDK 64-Bit Server VM(build 25.102-b14, mixed mode)
-OpenJDK 64-Bit Server VM(build 25.102-b14, mixed mode)
-:::
 - **卸载已安装的**
 首先检测安装包：
-:::info
+> [root@VM-12-6-centos software]# rpm -qa | grep java
-[root@VM-12-6-centos software]# rpm -qa | grep java
-:::
 显示如下：
-:::info
+> java-1.7.0-openjdk-1.7.0.111-2.6.7.8.el7.x86_64
-java-1.7.0-openjdk-1.7.0.111-2.6.7.8.el7.x86_64
+> python-javapackages-3.4.1-11.el7.noarch
-python-javapackages-3.4.1-11.el7.noarch
+> tzdata-java-2016g-2.el7.noarch
-tzdata-java-2016g-2.el7.noarch
+> javapackages-tools-3.4.1-11.el7.noarch
-javapackages-tools-3.4.1-11.el7.noarch
+> java-1.8.0-openjdk-1.8.0.102-4.b14.el7.x86_64
-java-1.8.0-openjdk-1.8.0.102-4.b14.el7.x86_64
+> java-1.8.0-openjdk-headless-1.8.0.102-4.b14.el7.x86_64
-java-1.8.0-openjdk-headless-1.8.0.102-4.b14.el7.x86_64
+> java-1.7.0-openjdk-headless-1.7.0.111-2.6.7.8.el7.x86_64
-java-1.7.0-openjdk-headless-1.7.0.111-2.6.7.8.el7.x86_64
-:::
 卸载：
-:::info
+> [root@VM-12-6-centos software]# rpm -e --nodeps tzdata-java-2016g-2.el7.noarch
-[root@VM-12-6-centos software]# rpm -e --nodeps tzdata-java-2016g-2.el7.noarch
+> [root@VM-12-6-centos software]# rpm -e --nodeps java-1.7.0-openjdk-1.7.0.111- 2.6.7.8.el7.x86_64
-[root@VM-12-6-centos software]# rpm -e --nodeps java-1.7.0-openjdk-1.7.0.111- 2.6.7.8.el7.x86_64
+> [root@VM-12-6-centos software]# rpm -e --nodeps java-1.7.0-openjdk-headless-1.7.0.111-2.6.7.8.el7.x86_64
-[root@VM-12-6-centos software]# rpm -e --nodeps java-1.7.0-openjdk-headless-1.7.0.111-2.6.7.8.el7.x86_64
+> [root@VM-12-6-centos software]# rpm -e --nodeps java-1.8.0-openjdk-1.8.0.102-4.b14.el7.x86_64
-[root@VM-12-6-centos software]# rpm -e --nodeps java-1.8.0-openjdk-1.8.0.102-4.b14.el7.x86_64
+> [root@VM-12-6-centos software]# rpm -e --nodeps java-1.8.0-openjdk-headless-1.8.0.102-4.b14.el7.x86_64
-[root@VM-12-6-centos software]# rpm -e --nodeps java-1.8.0-openjdk-headless-1.8.0.102-4.b14.el7.x86_64
-:::
 之后再次输入rpm -qa | grep java 查看卸载情况：
-:::info
+> [root@VM-12-6-centos software]# rpm -qa | grep java
-[root@VM-12-6-centos software]# rpm -qa | grep java
+> python-javapackages-3.4.1-11.el7.noarch
-python-javapackages-3.4.1-11.el7.noarch
+> javapackages-tools-3.4.1-11.el7.noarch
-javapackages-tools-3.4.1-11.el7.noarch
-:::
 - **安装JDK**
 首先到官网下载需要的JDK版本，也可以从[公司软件库](https://www.baidu.com)下载，在此省略此步骤
 将jdk包上传到系统中指定的目录 **/opt/software** 下
 创建JDK存放目录：
-:::info
+> [root@VM-12-6-centos local]# mkdir /usr/local/java
-[root@VM-12-6-centos local]# mkdir /usr/local/java
-:::
 进入安装包目录：
-:::info
+> [root@VM-12-6-centos local]# cd /opt/software
-[root@VM-12-6-centos local]# cd /opt/software
-:::
 解压jdk-8u161-linux-x64.tar.gz安装包到指定目录：
-:::info
+> [root@VM-12-6-centos software]# tar -zxvf jdk-8u161-linux-x64.tar.gz -C /usr/local/java
-[root@VM-12-6-centos software]# tar -zxvf jdk-8u161-linux-x64.tar.gz -C /usr/local/java
-:::
 设置环境变量：
-:::info
+> [root@VM-12-6-centos java]# vim /etc/profile
-[root@VM-12-6-centos java]# vim /etc/profile
-:::
 在最后面添加：
-:::info
+> export JAVA_HOME=/usr/local/java/jdk1.8.0_161
-export JAVA_HOME=/usr/local/java/jdk1.8.0_161
+> export JRE_HOME=${JAVA_HOME}/jre
-export JRE_HOME=${JAVA_HOME}/jre
+> export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
-export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
+> export PATH=${JAVA_HOME}/bin:$PATH
-export PATH=${JAVA_HOME}/bin:$PATH
-:::
 记得保存噢! (1.使用vim编辑好文件后，按下esc键退出编辑状态; 2.输入冒号+wq字符，按下回车.)
 执行profile文件：
-:::info
+> [root@VM-12-6-centos java]# source /etc/profile
-[root@VM-12-6-centos java]# source /etc/profile
-:::
 这样可以使配置文件立即生效
 - **检测JDK是否安装成功**
 执行命令：
-:::info
+> [root@VM-12-6-centos java]# java -version
-[root@VM-12-6-centos java]# java -version
-:::
 出现以下结果则JDK安装成功：
-:::info
+> java version "1.8.0_161"
-java version "1.8.0_161"
+> Java(TM) SE Runtime Environment (build 1.8.0_161-b12)
-Java(TM) SE Runtime Environment (build 1.8.0_161-b12)
+> Java HotSpot(TM) 64-Bit Server VM (build 25.161-b12, mixed mode)
-Java HotSpot(TM) 64-Bit Server VM (build 25.161-b12, mixed mode)
-:::
 至此，JDK安装结束。
--- a/部署手册/中间件部署手册/Nginx 安装手册.md
+++ b/部署手册/中间件部署手册/Nginx 安装手册.md
-# Nginx安装手册
 ## 安装包下载
 [http://nginx.org/en/download.html](http://nginx.org/en/download.html)
 - **安装Nginx**
 1. 安装依赖：
-:::info
+> [root@VM-12-6-centos software]# yum -y install gcc zlib zlib-devel pcre pcre-devel openssl openssl-devel make
-[root@VM-12-6-centos software]# yum -y install gcc zlib zlib-devel pcre pcre-devel openssl openssl-devel make
-:::
 2. 解压安装包并切换到文件夹中：
-:::info
+> [root@VM-12-6-centos software]# tar -zxvf /opt/software/nginx-1.22.0.tar.gz
-[root@VM-12-6-centos software]# tar -zxvf /opt/software/nginx-1.22.0.tar.gz
+> [root@VM-12-6-centos software]# cd nginx-1.22.0
-[root@VM-12-6-centos software]# cd nginx-1.22.0
-:::
 3. 开始执行编译、安装(一并安装SSL模块)：
-:::info
+> [root@VM-12-6-centos nginx-1.22.0]# ./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module
-[root@VM-12-6-centos nginx-1.22.0]# ./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module
+> [root@VM-12-6-centos nginx-1.22.0]# make && make install
-[root@VM-12-6-centos nginx-1.22.0]# make && make install
-:::
 4. 查看是否安装成功
-:::info
+> [root@VM-12-6-centos nginx-1.22.0]# /usr/local/nginx/sbin
-[root@VM-12-6-centos nginx-1.22.0]# /usr/local/nginx/sbin
+> [root@VM-12-6-centos nginx-1.22.0]# ./nginx -V
-[root@VM-12-6-centos nginx-1.22.0]# ./nginx -V
-:::
 显示如下：
-:::info
+> nginx version: nginx/1.22.0
-nginx version: nginx/1.22.0
+> built by gcc 4.8.5 20150623 (Red Hat 4.8.5-44) (GCC) 
-built by gcc 4.8.5 20150623 (Red Hat 4.8.5-44) (GCC) 
+> built with OpenSSL 1.0.2k-fips  26 Jan 2017
-built with OpenSSL 1.0.2k-fips  26 Jan 2017
+> TLS SNI support enabled
-TLS SNI support enabled
+> configure arguments: --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module
-configure arguments: --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module
-:::
 安装结束。
 - **配置环境变量**
 1. 查看 nginx 版本，此时会发现报 bash:nginx: 未找到命令，需要我们手动配置打开环境变量的文件
-:::info
+> [root@VM-12-6-centos nginx-1.22.0]# nginx -v
-[root@VM-12-6-centos nginx-1.22.0]# nginx -v
-:::
 显示如下：
-:::info
+> bash: nginx: command not found...
-bash: nginx: command not found...
-:::
 2. 编辑环境变量文件：
-:::info
+> [root@VM-12-6-centos nginx-1.22.0]# vim /etc/profile
-[root@VM-12-6-centos nginx-1.22.0]# vim /etc/profile
-:::
 行末加上自己的nginx安装目录下sbin目录的地址：
 ```shell
 .... #前面省略
@@ -60,25 +44,19 @@ export PATH=$PATH:/usr/local/nginx/sbin
 ```
 3. 重新加载环境：
-:::info
+> [root@VM-12-6-centos nginx-1.22.0]# source /etc/profile
-[root@VM-12-6-centos nginx-1.22.0]# source /etc/profile
-:::
 4. 再次查看 nginx 版本
-:::info
+> [root@iZuf68wpeyqmolhdab3bh0Z software]# nginx -v
-[root@iZuf68wpeyqmolhdab3bh0Z software]# nginx -v
-:::
 显示如下：
-:::info
+> nginx version: nginx/nginx-1.22.0
-nginx version: nginx/nginx-1.22.0
-:::
 - **开机启动配置**
 1. 先创建开机自启脚本：
-:::info
+> [root@VM-12-6-centos software]# cd /etc/systemd/system
-[root@VM-12-6-centos software]# cd /etc/systemd/system
+> [root@VM-12-6-centos system]# vim nginx.service
-[root@VM-12-6-centos system]# vim nginx.service
-:::
 2. 内容复制到 vim 中：
 ```shell
@@ -98,34 +76,33 @@ WantedBy=multi-user.target
 ```
 3. 服务命令：
-:::info
+> **第一种方式启动**
-**第一种方式启动**
+> **#启动nginx服务**
-**#启动nginx服****务**
+> cd /usr/local/nginx/sbin/
-cd /usr/local/nginx/sbin/
+> ./nginx
-./nginx
+> **#查看运行状态**
-**#查看运行状态**
+> ps aux | grep nginx
-ps aux | grep nginx
+> **#停止nginx服务**
-**#停止nginx服务**
+> ./nginx –s stop
-./nginx –s stop
+> **#重启nginx服务**
-**#重启nginx服务**
+> ./nginx –s reload
-./nginx –s reload
+> **#检查配置文件是否正确**
-**#检查配置文件是否正确**
+> ./nginx –t
-./nginx –t
+> **#查看nginx版本**
-**#查看nginx版本**
+> ./nginx –v
-./nginx –v
+> 
+> **第二种基于配置开机启动模式启动**
-**第二种基于配置开机启动模式启动**
+> **#设置开机自启动**
-**#设置开机自启动**
+> systemctl enable nginx
-systemctl enable nginx
+> **#启动nginx服务**
-**#启动nginx服务**
+> systemctl start nginx.service
-systemctl start nginx.service
+> **#重新启动服务**
-**#重新启动服务**
+> systemctl restart nginx.service
-systemctl restart nginx.service
+> **#查看服务当前状态**
-**#查看服务当前状态**
+> systemctl status nginx.service
-systemctl status nginx.service
+> **#停止开机自启动**
-**#停止开机自启动**
+> systemctl disable nginx.service
-systemctl disable nginx.service
-:::
 4. 访问服务器IP
@@ -136,10 +113,9 @@ systemctl disable nginx.service
 证书可以自行到阿里云或者腾讯云申请免费的证书，并下载对应Nginx的证书
 服务器 /usr/local/nginx/conf 下创建 cert 目录，并将证书放入该文件夹中
 编辑Nginx配置文件：
-:::info
+> [root@VM-12-6-centos software]#  cd /usr/local/nginx/conf
-[root@VM-12-6-centos software]#  cd /usr/local/nginx/conf
+> [root@VM-12-6-centos conf]#  vim nginx.conf
-[root@VM-12-6-centos conf]#  vim nginx.conf
-:::
 在http代码块里添加如下配置：
 ```shell
 server {

--- a/部署手册/中间件部署手册/Redis 安装手册.md
+++ b/部署手册/中间件部署手册/Redis 安装手册.md
-# Redis安装手册
 Redis约定次版本号（即第一个小数点后的数字）为偶数的版本是稳定版（如2.8版、3.0版），奇数版本是非稳定版（如2.7版、2.9版），生产环境下一般需要使用稳定版本。
 # 安装依赖
 redis是由C语言开发，因此安装之前必须要确保服务器已经安装了gcc，可以通过如下命令查看机器是否安装：
-:::info
+> gcc -v
-gcc -v
-:::
 如果没有安装则通过以下命令安装：
-:::info
+> yum install -y gcc
-yum install -y gcc
-:::
 # 下载安装包
 访问查看需要的版本：[http://download.redis.io/releases](http://download.redis.io/releases)
-:::info
+> **#安装包统一存放到/opt/software目录下，没有则进入/opt目录执行创建mkdir software创建**
-**#安装包统一存放到/opt/software目录下，没有则进入/opt目录执行创建mkdir software创建**
+> cd /opt/software
-cd /opt/software
+> wget [http://download.redis.io/releases/redis-6.2.6.tar.gz](http://download.redis.io/releases/redis-6.2.6.tar.gz) 
-wget http://download.redis.io/releases/[redis-6.2.6.tar.gz](http://download.redis.io/releases/redis-6.2.6.tar.gz) 
-:::
 如果提示wget找不到通过一下命令安装：
-:::info
+> yum -y install wget
-yum -y install wget
-:::
 # 解压安装包并安装
 解压安装包
-:::info
+> tar xzf redis-6.2.6.tar.gz -C /usr/local
-tar xzf redis-6.2.6.tar.gz -C /usr/local
-:::
 进入解压目录并编译
-:::info
+> **#进入解压目录**
-**#进入解压目录**
+> cd redis-6.2.6
-cd redis-6.2.6
+> **#编译**
-**#编译**
+> make
-make
+> **#指定安装目录并进行安装**
-**#指定安装目录并进行安装**
+> make install PREFIX=/usr/local/redis-6.2.6
-make install PREFIX=/usr/local/redis-6.2.6
-:::
 # 启动Redis服务
-通过守护进程方式启动
+**通过守护进程方式启动**
-:::info
+修改redis.conf
-**#修改redis.conf**
+> cd /usr/local/redis-6.2.6
-cd /usr/local/redis-6.2.6
+> vim redis.conf
-vim redis.conf
-**# 修改内容如下：**
+修改内容如下
-daemonize 的值从 no 修改成 yes
+> daemonize 的值从 no 修改成 yes使用ESC键，并输入
-**#使用ESC键，并输入**
-:wq
+使用ESC键，并输入
-:::
+> :wq
-启动服务
-:::info
-cd /usr/local/redis-6.2.6/bin
+**启动服务**
-./redis-server ../redis.conf
+> cd /usr/local/redis-6.2.6/bin
-:::
+> ./redis-server ../redis.conf
-查看进程来确定redis是否启动成功
-:::info
-ps -ef |grep redis
-:::
+**查看进程来确定redis是否启动成功**
-关闭服务
+> ps -ef |grep redis
-:::info
-cd /usr/local/redis-6.2.6/bin
-/redis-cli shutdown
-:::
+**关闭服务**
+> cd /usr/local/redis-6.2.6/bin
+> /redis-cli shutdown
--- a/部署手册/项目部署手册.md
+++ b/部署手册/项目部署手册.md
-# 项目部署手册
 # 1. 目的
 为了保证系统稳定性运行，严格管理、规范实施，制定本项目部署和版本发布规范。
 # 2. 项目部署环境
 ## 2.1 Spring Boot 项目
@@ -58,23 +53,20 @@ status)
  echo "useing generator-boot.sh (start|stop|status)"
 esac
 ```
-:::info
+> **修改脚本参数参数：**
-**修改脚本参数参数：**
+> FAT_JAR_DIR：默认../fatjar/，一般不用调整
-FAT_JAR_DIR：默认../fatjar/，一般不用调整
+> APP_NAME：Jar名称，例如：check-service-1.0.0.jar，可写成check-service*，但必须保证唯一，通过check-service*只能找到一个文件，如再出现check-service-biz-1.0.0.jar则会找到2个将存在问题
-APP_NAME：Jar名称，例如：check-service-1.0.0.jar，可写成check-service*，但必须保证唯一，通过check-service*只能找到一个文件，如再出现check-service-biz-1.0.0.jar则会找到2个将存在问题
+> PROFILES_ACTIVE：项目环境，根据服务器是属于DEV/TEST/PORD进行调整
-PROFILES_ACTIVE：项目环境，根据服务器是属于DEV/TEST/PORD进行调整
+> 
+> **如何启动, 停止, 以及查询服务的运行状态：**
+> ./run-xxx.sh start //启动项目
+> ./run-xxx.sh stop //停止项目
+> ./run-xxx.sh status //查看项目状态
+> 
+> **注意事项：**
+> 如果当前服务器存在多个用户账号去启停程序，需要注意采用原始账号操作，否则可能会启动多个进程，操作程序错误。
+> 有特殊场景下会存在多个程序进程执行，可通过命令：ps -ef | grep java 查找到PID，再通过kill -9 PID 结束进程。
-**如何启动, 停止, 以及查询服务的运行状态：**
-./run-xxx.sh start //启动项目
-./run-xxx.sh stop //停止项目
-./run-xxx.sh status //查看项目状态
-注意事项：
-1. 如果当前服务器存在多个用户账号去启停程序，需要注意采用原始账号操作，否则可能会启动多个进程，操作程序错误。
-1. 有特殊场景下会存在多个程序进程执行，可通过命令：ps -ef | grep java 查找到PID，再通过kill -9 PID 结束进程。
-:::
 ## 2.2 Tomcat 项目
 - Tomcat 安装略过
@@ -144,14 +136,13 @@ server {
 }
 ```
 **最后就是nginx修改配置一定要重启！！**
-:::info
+> **#进入nginx安装目录**
-**#进入nginx安装目录**
+> cd /usr/local/nginx/sbin/
-cd /usr/local/nginx/sbin/
+> **#检查配置文件是否正确**
-**#检查配置文件是否正确**
+> ./nginx –t
-./nginx –t
+> **#重启nginx服务**
-**#重启nginx服务**
+> ./nginx –s reload
-./nginx –s reload
-:::
 ### **2.3.1 **解决刷新路由404问题
 Vue项目采用了history的路由方式后打包出现404
 解决问题的办法：