1. 程式人生 > >Spring Boot 2.0(六):使用 Docker 部署 Spring Boot 開源軟件雲收

Spring Boot 2.0(六):使用 Docker 部署 Spring Boot 開源軟件雲收

Spring Boot Dokcer 雲收藏

只需三步即可部署開源項目雲收藏,打造專屬個人的收藏系統,就是這麽簡單!

雲收藏項目已經開源2年多了,作為當初剛開始學習 Spring Boot 的練手項目,使用了很多當時很新的技術,現在看來其實很多新技術是沒有必要使用的,但做為學習案例來講確實是一個絕佳的 Spring Boot 實踐。

從開源到現在,寫了一些教程給大家介紹如何部署雲收藏,如何在IDE中運行雲收藏,但是仍然有很多的朋友不知道如何使用,如何部署?就像“請提供一份雲收藏數據結構” 這樣的問題我至少都回答了一百多次,並且在 github 關閉了近十個類似的問題。

這也從另外一個方面可以看出,部署雲收藏項目對一些朋友還是比較復雜,現在有了 Docker 我們就可以愉快的解決這個問題,只需三步就可以部署雲收藏項目,打造專屬個人的收藏系統。

雲收藏

一些朋友可能還不了解雲收藏,給大家簡單介紹一下:

雲收藏是一個使用 Spring Boot 構建的開源網站,可以讓用戶在線隨時隨地收藏的一個網站,在網站上分類整理收藏的網站或者文章,可以作為稍後閱讀的一個臨時存放。作為一個開放開源的軟件,可以讓用戶從瀏覽器將收藏夾內容導入到雲收藏,也支持隨時將雲收藏收集的文章導出去做備份。

產品主頁

http://favorites.ren

項目主頁

https://github.com/cloudfavorites/favorites-web

產品截圖

技術分享圖片

核心功能點:

  • 收藏、分類、檢索文章
  • 導出、導出(包活從瀏覽器中)
  • 可以點贊、分享、討論
  • 註冊、登錄、個人賬戶
  • 臨時收藏、查看別人收藏
  • 其它...

項目使用技術:

  • Vue
  • Bootstrap
  • jQuery
  • Thymeleaf
  • Spring Data Jpa
  • Spring Boot Mail
  • WebJars
  • Mysql
  • Tomcat
  • Redis

Redis 後期去掉是由於服務器資源有限和部署麻煩

項目改造

依賴環境

準備一臺系統為 Centos 7 以上的服務器,系統需要安裝 Docker 和 Docker Compos 環境,安裝方法可以參考前面兩篇文章:

  • Docker(一):Docker入門教程
  • Docker(四):Docker 三劍客之 Docker Compose

Docker 化改造

項目改造後的項目機構圖如下:

技術分享圖片

因為上一篇文章Spring Boot 2.0(五):Docker Compose + Spring Boot + Nginx + Mysql 實踐 已經介紹了此類項目結構和內容含義,因此這裏主要描述新增內容。

docker-compose.yaml 文件

我們首先來看一下docker-compose.yaml文件:

version: ‘3‘
services:
  nginx:
   container_name: favorites-nginx
   image: nginx:1.13
   restart: always
   ports:
   - 80:80
   - 443:443
   volumes:
     - ./nginx/conf.d:/etc/nginx/conf.d
     - /tmp/logs:/var/log/nginx

  mysql:
   build: ./mysql
   environment:
     MYSQL_DATABASE: favorites
     MYSQL_ROOT_PASSWORD: root
     MYSQL_ROOT_HOST: ‘%‘
     TZ: Asia/Shanghai
   ports:
   - "3306:3306"
   volumes:
     - ./mysql_data:/var/lib/mysql
   restart: always

  app:
    restart: always
    build: ./app
    working_dir: /app
    volumes:
      - ./app:/app
      - ~/.m2:/root/.m2
      - /tmp/logs:/usr/local/logs
    expose:
      - "8080"
    command: mvn clean spring-boot:run -Drun.profiles=docker
    depends_on:
      - nginx
      - mysql

相對上一篇內容本次的docker-compose.yaml文件主要新增了兩部分的內容:

  • 1、將 Nginx 和 app 的日誌映射到宿主機上,方便我們查看日誌
  • 2、將 Mysql 的數據存儲映射到宿主機上,這樣的好處是不至於將集群關掉之後數據丟失

docker-compose.yaml文件中,日誌部分:

version: ‘3‘
services:
  nginx:
   volumes:
     - /tmp/logs:/var/log/nginx
  app:
   volumes:
     - /tmp/logs:/usr/local/logs

分別將 Nginx 和雲收藏項目日誌映射到宿主機的/tmp/logs,方便我們查看項目日誌。

定制 mysql 初始化信息

docker-compose.yaml文件中,Mysql 變化內容:

version: ‘3‘
services:
  mysql:
   build: ./mysql
   environment:
     TZ: Asia/Shanghai
   volumes:
     - ./mysql_data:/var/lib/mysql

我將有變化的內容都摘了出來,mysql 新增了 TZ 環境變量將時區指向上海,另外我們將 Mysql 鏡像內容提出來,放到項目的 mysql 目錄下單獨構建。mysql 目錄下有兩個文件,一個是 Dockerfile 定義 Mysql 鏡像,一個是 my.cnf 文件定義 Mysql 編碼等信息。

my.cnf 文件內容

#省略一部分
...
character_set_server=utf8
character_set_filesystem=utf8
collation-server=utf8_general_ci
init-connect=‘SET NAMES utf8‘
init_connect=‘SET collation_connection = utf8_general_ci‘
skip-character-set-client-handshake

此文件主要的作用是讓 Mysql 支持 UTF-8.

Dockerfile 文件內容

FROM mysql/mysql-server:5.7
COPY my.cnf /etc/my.cnf

使用 Mysql5.7 版本,並且將同目錄下的 my.cnf 拷貝到服務器/etc/my.cnf

這樣 Mysql 的相關信息就定義好了。

其它

其它內容變化不大,nginx 目錄下存放著 Nginx 的配置文件,項目新增application-docker.properties文件,將數據庫連接部分修改即可。

改造完成之後,我們只需要將項目拷貝到部署服務器然後執行:docker-compose up就可以啟動。

部署

我已經將項目的改造內容提交到 github 上面,這樣大家部署的時候僅需要三步,即可成功部署雲收藏項目。

1、下載源碼解壓

下載最新發布版本

wget https://github.com/cloudfavorites/favorites-web/archive/favorites-1.1.1.zip

解壓

unzip favorites-1.1.1.zip

進入目錄

cd favorites-web-favorites-1.1.1/

2、修改配置文件

修改文件application-docker.properties

vi app/src/main/resources/application-docker.properties

修改內容如下

favorites.base.path=http://xx.xxx.xx.xx/ 

地址為部署服務器的地址

3、啟動項目

配置完成後,後臺啟動

[root@~]# docker-compose up -d
Creating network "favoriteswebfavorites111_default" with the default driver
Creating favorites-nginx                  ... done
Creating favoriteswebfavorites111_mysql_1 ... done
Creating favoriteswebfavorites111_app_1   ... done

啟動完成後,瀏覽器訪問上面配置地址:http://xx.xxx.xx.xx/,就可以看到雲收藏的首頁了。

輔助內容

啟動後想查看某個容器內的服務運行情況,可以使用以下命令進入:

使用docker ps查看宿主機上面運行的 Docker 容器

[root@VM_73_217_centos ~]# docker ps
CONTAINER ID        IMAGE                            COMMAND                  CREATED             STATUS                  PORTS                                      NAMES
a466ce6e58a5        favoriteswebfavorites111_app     "/usr/local/bin/mv..."   16 hours ago        Up 16 hours             8080/tcp                                   favoriteswebfavorites111_app_1
1b4f1b912de0        nginx:1.13                       "nginx -g ‘daemon ..."   16 hours ago        Up 16 hours             0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   favorites-nginx
65b481bb7741        favoriteswebfavorites111_mysql   "/entrypoint.sh my..."   16 hours ago        Up 16 hours (healthy)   0.0.0.0:3306->3306/tcp, 33060/tcp          favoriteswebfavorites111_mysql_1

根據上面查詢的 Docker 容器 ID 信息,執行下面命令

docker exec -ti CONTAINER_ID  bash
#比如進入項目容器中
[root@VM_73_217_centos ~]# docker exec -ti a466ce6e58a5 bash
root@a466ce6e58a5:/app# ps -ef|grep java
...

退出容器執行以下命令:

root@a466ce6e58a5:/app# exit
exit
[root@VM_73_217_centos ~]# 

這樣以後如果我們想部署雲收藏項目就變的非常簡單,僅僅需要三步可以愉快的搭建自己的收藏系統了,小夥伴們趕緊動起手來。

Spring Boot 2.0(六):使用 Docker 部署 Spring Boot 開源軟件雲收