使用 Docker 部署 Spring Boot 開源軟件雲收藏

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

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

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

雲收藏

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

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

產品主頁

http://favorites.ren

項目主頁

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

產品截圖

使用 Docker 部署 Spring Boot 開源軟件雲收藏

核心功能點:

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

項目使用技術:

  • 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 化改造

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

使用 Docker 部署 Spring Boot 開源軟件雲收藏

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

docker-compose.yaml 文件

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

<code>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/<code>

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

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

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

<code>version: '3'services:  nginx:   volumes:     - /tmp/logs:/var/log/nginx  app:   volumes:     - /tmp/logs:/usr/local/logs/<code>

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

定製 mysql 初始化信息

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

<code>version: '3'services:  mysql:   build: ./mysql   environment:     TZ: Asia/Shanghai   volumes:     - ./mysql_data:/var/lib/mysql/<code>

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

my.cnf 文件內容

<code>#省略一部分...character_set_server=utf8character_set_filesystem=utf8collation-server=utf8_general_ciinit-connect='SET NAMES utf8'init_connect='SET collation_connection = utf8_general_ci'skip-character-set-client-handshake/<code>

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

Dockerfile 文件內容

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

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

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

其它

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

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

部署

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

1、下載源碼解壓

下載最新發布版本

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

解壓

<code>unzip favorites-1.1.1.zip/<code>

進入目錄

<code>cd favorites-web-favorites-1.1.1//<code>

2、修改配置文件

修改文件application-docker.properties

<code>vi app/src/main/resources/application-docker.properties/<code>

修改內容如下

<code>favorites.base.path=http://xx.xxx.xx.xx/ /<code>

地址為部署服務器的地址

3、啟動項目

配置完成後,後臺啟動

<code>[root@~]# docker-compose up -dCreating network "favoriteswebfavorites111_default" with the default driverCreating favorites-nginx                  ... doneCreating favoriteswebfavorites111_mysql_1 ... doneCreating favoriteswebfavorites111_app_1   ... done/<code>

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

輔助內容

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

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

<code>[root@VM_73_217_centos ~]# docker psCONTAINER ID        IMAGE                            COMMAND                  CREATED             STATUS                  PORTS                                      NAMESa466ce6e58a5        favoriteswebfavorites111_app     "/usr/local/bin/mv..."   16 hours ago        Up 16 hours             8080/tcp                                   favoriteswebfavorites111_app_11b4f1b912de0        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-nginx65b481bb7741        favoriteswebfavorites111_mysql   "/entrypoint.sh my..."   16 hours ago        Up 16 hours (healthy)   0.0.0.0:3306->3306/tcp, 33060/tcp          favoriteswebfavorites111_mysql_1/<code>

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

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

退出容器執行以下命令:

<code>root@a466ce6e58a5:/app# exitexit[root@VM_73_217_centos ~]# /<code>

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


分享到:


相關文章: