本文將帶大家從一臺全新的 CentOS 服務器開始倔丈,部署一套完整的前后端分離項目喻鳄。操作步驟非常詳細扼倘,新手友好型文章~
后端技術棧:SpringCloud 微服務架構 + Redis + RabbitMQ + MySql;
前端技術棧:Vue + ElementUI除呵;
部署工具:后端用 Docker 容器化部署再菊,并把命令封裝成腳本自動執(zhí)行;前端用 Nginx 做代理颜曾。
一袄简、前期準備
系統(tǒng)版本為:CentOS 7.6 64位。
1.1 連接服務器
要對遠程服務器進行操作泛啸,首先要連上服務器才行绿语。打開命令行工具,輸入以下命令候址,再輸入服務器實例的密碼吕粹,即可遠程連接到服務器。
ssh root@xxx.xx.xx.xx
@ 之后是服務器的公網 ip岗仑,假如服務器 ip 地址為:120.456.78.123匹耕,那么連接服務器的命令為:
ssh root@120.456.78.123
敲回車之后會讓輸入密碼,輸入正確的密碼即可荠雕。
1.2 安裝 Docker
Docker 容器化部署的優(yōu)點就不多說了稳其,直接上干貨如何安裝 Docker。
下面直接把代碼框里的命令拷貝到命令行執(zhí)行就可以炸卑。
先移除舊版本(如果有):
sudo yum remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-selinux \
docker-engine-selinux \
docker-engine
安裝一些必要的工具:
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
添加軟件源信息:
sudo yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
更新 yum 緩存:
sudo yum makecache fast
安裝 Docker-ce:
sudo yum -y install docker-ce
啟動 Docker 后臺服務
sudo systemctl start docker
測試運行 hello-world(這步可要可不要既鞠,目的是驗證身份安裝 Docker 成功,如果成功會打印出 Hello World)
docker run hello-world
1.3 安裝 mysql
拉取 mysql5.7 版本的鏡像
docker pull mysql:5.7
運行 MySql
docker run -p 3306:3306 --name mysql -v $PWD/conf:/etc/mysql/conf.d -v $PWD/logs:/logs -v $PWD/data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=123456 -d mysql:5.7
命令說明:
- -p 3306:3306:將容器的 3306 端口映射到主機的 3306 端口盖文。
- -v $PWD/conf:/etc/mysql/conf.d:將主機當前目錄下的 conf/my.cnf 掛載到容器的 /etc/mysql/my.cnf嘱蛋。
- -v $PWD/logs:/logs:將主機當前目錄下的 logs 目錄掛載到容器的 /logs。
- -v $PWD/data:/var/lib/mysql :將主機當前目錄下的data目錄掛載到容器的 /var/lib/mysql 。
- -e MYSQL_ROOT_PASSWORD=123456:初始化 root 用戶的密碼洒敏。
注意在運行之前切換到合適的目錄龄恋,因為 MySql 容器映射到本機的目錄是映射的當前目錄的相對目錄。比如當前目錄為 /root/abc 凶伙,那執(zhí)行完上面的命令后郭毕,會在 /root/abc 下創(chuàng)建 MySql 掛載出來的目錄和文件。
1.4 安裝 redis
也可以直接執(zhí)行運行命令函荣,如果系統(tǒng)檢測到沒有安裝此鏡像铣卡,則會拉取安裝,再運行偏竟。
下載并運行 redis:4.0.8 :
docker run -p 6379:6379 -t -dit redis:4.0.8
1.5 安裝 RabbitMQ
跟上面一樣也是直接執(zhí)行運行命令安裝并運行 rabbitmq:3.7.7 :
docker run -d --hostname my-rabbit -p 5672:5672 -p 15672:15672 rabbitmq:3.7.7-management
到此部署微服務后端項目的前期環(huán)境準備工具已經做完。如果要部署前端還需要安裝 Nginx敞峭,這個在前端部署的章節(jié)再講踊谋。
二、后端部署
部署后端需要做的工作有兩個旋讹,一個是修改每個微服務模塊的配置文件 application.yml 殖蚕,另一個是編寫 Dockerfile 。
先看目錄結構:
一共有 5 個模塊沉迹,其中 common 是純 java 代碼用于各模塊公共代碼的提取睦疫,剩下四個每個是一個獨立的微服務模塊,所以我們要部署 eureka 鞭呕、user蛤育、education、gateway 四個模塊葫松,也就是最后會運行四個獨立的 docker 容器瓦糕。
具體的業(yè)務邏輯就不做過多說明了,本文只講部署腋么。
2.1 配置文件 application.yml
為了本地調試和服務器部署互不影響咕娄,我們把原來的 application.yml 拆分為三個文件:
- application.yml :總配置,指定應該用下面哪個配置
- application-dev.yml :開發(fā)環(huán)境配置
- application-pro.yml :生成環(huán)境配置
另外為了方便珊擂,把 Dockerfile 也放到同級目錄下圣勒。如圖:
下面是三個配置文件的代碼:
application.yml
spring:
profiles:
active: pro
application-dev.yml
eureka:
client:
service-url:
defaultZone: http://localhost:8761/eureka/
instance:
prefer-ip-address: true
server:
port: 8899
spring:
application:
name: education
datasource:
driver-class-name: com.mysql.jdbc.Driver
username: root
password: 123456
url: jdbc:mysql://127.0.0.1/edu?characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
jpa:
show-sql: true
# 如果字段值為null則不返回
jackson:
default-property-inclusion: non_null
rabbitmq:
host: localhost
port: 5672
username: guest
password: guest
redis:
port: 6379
database: 0
host: 127.0.0.1
password:
jedis:
pool:
max-active: 8
max-wait: -1ms
max-idle: 8
min-idle: 0
timeout: 5000ms
application-pro.yml
eureka:
client:
service-url:
defaultZone: ${SPRING-CLOUD-EUREKA-ZONE}
instance:
prefer-ip-address: true
server:
port: 8899
spring:
application:
name: education
datasource:
driver-class-name: com.mysql.jdbc.Driver
username: root
password: 123456
url: jdbc:mysql://${SPRING-CLOUD-MYSQL-HOST}/${SPRING-CLOUD-DB-NAME}?characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
jpa:
show-sql: true
# 如果字段值為null則不返回
jackson:
default-property-inclusion: non_null
rabbitmq:
host: ${SPRING-CLOUD-RABBIT-MQ-HOST}
port: 5672
username: guest
password: guest
redis:
port: 6379
database: 0
host: ${SPRING-CLOUD-REDIS-HOST}
password:
jedis:
pool:
max-active: 8
max-wait: -1ms
max-idle: 8
min-idle: 0
timeout: 5000ms
這個項目配置比較全,redis摧扇、rabbitMQ圣贸、mysql、jpa 都有配置扛稽。
dev 跟 pro 的配置差不多旁趟,只是把 dev 中的 localhost 、127.0.0.1 這兩個本地的地址,換成了諸如 {SPRING-CLOUD-RABBIT-MQ-HOST} 等變量橙困。
那這些變量是在哪設置的呢?待會兒編寫 Dockerfile 的時候就可以看到耕餐,會在 Dockerfile 里設置這幾個變量為環(huán)境變量凡傅,當啟動 Docker 容器的時候,程序就會讀取到 Dockerfile 中設置的值并應用到項目中肠缔。
2.2 編寫Dockerfile
下面是 education 模塊的 Dockerfile
FROM java:8
VOLUME /tmp
ADD education.jar app.jar
RUN bash -c 'touch /app.jar'
ENV SPRING-CLOUD-EUREKA-ZONE http://123.456.789.10:8761/eureka/
ENV SPRING-CLOUD-MYSQL-HOST 123.456.789.10
ENV SPRING-CLOUD-DB-NAME edu
ENV SPRING-CLOUD-RABBIT-MQ-HOST 123.456.789.10
ENV SPRING-CLOUD-REDIS-HOST 123.456.789.10
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
EXPOSE 8899
簡單的解釋下每句話的作用
FROM java:8 : 指定基礎鏡像夏跷,必須為第一個命令
VOLUME /tmp : 用于指定持久化目錄
ADD education.jar app.jar : 將本地文件 education.jar 添加到容器中并命名為 app.jar。注意這里的 education.jar 要換成你自己項目打包出來的 jar 包名字明未,如果你打的包名字叫 abc.jar槽华,那應該這么寫:ADD abc.jar app.jar 。
RUN bash -c 'touch /app.jar' : 在鏡像容器中執(zhí)行的命令趟妥,運行 jar 包猫态。
ENV *** : 這幾行以 ENV 開頭的是設置環(huán)境變量,還記得上面 application-pro.yml 文件里的那幾個 ${} 變量嗎披摄?就是在這里設置的亲雪。把該填地址的地方都換成這臺服務器的公網 ip 地址,本配置假設你服務器的地址是 123.456.789.10 疚膊,用的時候把這個地址換成你自己服務器地址即可义辕。
ENTRYPOINT *** : 配置容器,使其可執(zhí)行化寓盗。
EXPOSE 8899 : 對外暴露 8899 端口灌砖。這個端口要和項目的配置文件中 server.port 設置的端口一致。
總結一下傀蚌,Dockerfile 文件你要改的周崭,只有三個地方:
- 第三行 education.jar 換成你打包出來的 jar 包名字
- ENV 開頭的環(huán)境變量自己根據 application-pro.yml 的配置進行設置
- 最后一行 EXPOSE 8899 改成你項目的端口號
再貼一個模塊的 Dockerfile 作對比:
FROM java:8
VOLUME /tmp
ADD gateway.jar app.jar
RUN bash -c 'touch /app.jar'
ENV SPRING-CLOUD-EUREKA-ZONE http://123.456.789.10:8761/eureka/
ENV SPRING-CLOUD-REDIS-HOST 123.456.789.10
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
EXPOSE 8888
按照這種方法,把每個需要打包的微服務項目的 Dockerfile 寫好续镇。
2.3 打包
配置好三個 applicaiton.yml 和 Dockerfile(其實打包這一步用不到 Dockerfile),在項目的根目錄下執(zhí)行以下命令打包:
mvn clean package -Dmaven.test.skip=true
看到控制臺輸出 SUCCESS 則打包成功
打完的包在 項目目錄/target 里销部,如圖:
檢查一下 jar 包的大小摸航,如果是好幾十 M 就沒啥問題,如果是幾百 K 那就是打包配置有問題舅桩,檢查 pom.xml 文件的 <build> 標簽配置是否正確酱虎。
附 <build> 配置:
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
<finalName>education</finalName>
</build>
2.4 編寫自動化腳本
寫完 Dockerfile 文件還要執(zhí)行命令打包成 image 鏡像,還需要運行起容器擂涛,兩行代碼雖然不多但每次寫還是麻煩读串,把它封裝成一個 sh 腳本,每次直接運行腳本省時省力。
新建 education_deploy.sh 文件恢暖,把兩行代碼放進去:
docker build -t education .
docker run -p 8899:8899 -t -dit --restart=always education
注意第一行最后有個點 . 排监,如果你想把打出來的鏡像名叫 abc,對外暴露的端口是 6666杰捂,則應該這樣寫:
docker build -t abc .
docker run -p 6666:6666 -t -dit --restart=always abc
2.4 上傳到服務器
新建一個文件夾舆床,并為每個微服務模塊新建一個文件夾用于存放 jar 包、Dockerfile 和自動化部署文件嫁佳,目錄結構如圖:
把 back_end 這個文件夾整體壓縮挨队,壓縮命令為:
tar -cvf back_end.tar ./back_end
執(zhí)行完后會在目錄下看到 back_end.tar 壓縮文件。
使用 ssh 命令登錄到服務器蒿往,根目錄下新建一個 edu 文件夾盛垦,進入這個文件夾,查看當前目錄瓤漏,記住這個目錄
//新建文件夾 edu
mkdir edu
//進入到 edu 文件夾內
cd edu
//查看當前目錄腾夯,會輸出:/root/edu
pwd
記住你要傳到服務器的位置:/root/edu,再回到本機剛才壓縮 back_end.tar 文件的目錄赌蔑,執(zhí)行以下命令把 back_end.tar 發(fā)送到服務器的 /root/edu 目錄下:
scp back_end.tar root@123.456.789.10:/root/edu
上傳完之后,在服務器解壓
tar -xvf back_end.tar
然后依次進入到各個模塊的文件夾內竟秫,執(zhí)行 sh 腳本
sh ./education_deploy.sh
都運行完之后后端微服務就部署完啦娃惯!
2.5 常用 Docker 命令
部署完還要檢驗是否部署正確,先從 Docker 開始檢查肥败,最后在瀏覽器輸入接口地址看能否調通趾浅。
下面的命令都在 CentOS 服務器上執(zhí)行。
查看當前運行的容器馒稍,看 mysql皿哨、redis、rabbitMQ 和你自己的項目是否運行
docker ps
查看日志
想進入到容器中查看日志:
docker logs 容器id
比如想查看容器id為 378af204f7bc 的容器日志纽谒,應該執(zhí)行:
docker logs 378af204f7bc
如果容器運行了很長時間证膨,將會產生非常多的日志,直接使用 docker logs 會把所有日志都打印出來鼓黔,可不可以只打印最后多少行或者從某個時間之后的日志呢央勒?當然可以。
查看指定時間后的日志澳化,只顯示最后100行:
docker logs -f -t --since="2019-10-24" --tail=100 CONTAINER_ID
只打印最后50行日志:
docker logs --tail=50 容器id
查看最近30分鐘的日志:
docker logs --since 30m 容器id
查看某時間之后的日志:
docker logs -t --since="2019-10-24T13:23:37" CONTAINER_ID
查看某時間段日志:
docker logs -t --since="2019-10-24T13:23:37" --until "2019-10-25T12:23:37" CONTAINER_ID
停止和啟動
停止容器
docker stop 容器id
查看所有容器(包括已經停止的)
docker ps -a
重新啟動容器(容器被停止了崔步,但還未被刪除)
docker start 容器id
刪除容器和鏡像
如果項目有改動,最好把之前的容器缎谷、鏡像都刪掉井濒,再運行新的容器。
先停止容器
docker stop 容器id
再刪除容器
docker rm 容器id
查看 image 鏡像
docker images
刪除鏡像
docker rmi 鏡像id
由于篇幅過長,所以本篇分為上下兩篇瑞你,下篇關于前端部署的內容鏈接會貼在下方【點擊即可跳轉】 :
趕緊點贊收藏干貨吧