雲收藏專案已經開源2年多了,作為當初剛開始學習 Spring Boot 的練手專案,使用了很多當時很新的技術,現在看來其實很多新技術是沒有必要使用的,但做為學習案例來講確實是一個絕佳的 Spring Boot 實踐。
從開源到現在,寫了一些教程給大家介紹如何部署雲收藏,如何在IDE中運行雲收藏,但是仍然有很多的朋友不知道如何使用,如何部署?就像“請提供一份雲收藏資料結構” 這樣的問題我至少都回答了一百多次,並且在 github 關閉了近十個類似的問題。
這也從另外一個方面可以看出,部署雲收藏專案對一些朋友還是比較複雜,現在有了 Docker 我們就可以愉快的解決這個問題,只需三步就可以部署雲收藏專案,打造專屬個人的收藏系統。
雲收藏一些朋友可能還不了解雲收藏,給大家簡單介紹一下:
雲收藏是一個使用 Spring Boot 構建的開源網站,可以讓使用者線上隨時隨地收藏的一個網站,在網站上分類整理收藏的網站或者文章,可以作為稍後閱讀的一個臨時存放。作為一個開放開源的軟體,可以讓使用者從瀏覽器將收藏夾內容匯入到雲收藏,也支援隨時將雲收藏收集的文章匯出去做備份。
產品主頁
http://favorites.ren
專案主頁
https://github.com/cloudfavorites/favorites-web
產品截圖
核心功能點:
收藏、分類、檢索文章匯出、匯出(包活從瀏覽器中)可以點贊、分享、討論註冊、登入、個人賬戶臨時收藏、檢視別人收藏其它…專案使用技術:
VueBootstrapjQueryThymeleafSpring Data JpaSpring Boot MailWebJarsMysqlTomcatRedis專案改造Redis 後期去掉是由於伺服器資源有限和部署麻煩
依賴環境
準備一臺系統為 Centos 7 以上的伺服器,系統需要安裝 Docker 和 Docker Compos 環境,安裝方法可以參考前面兩篇文章:
Docker(一):Docker入門教程Docker(四):Docker 三劍客之 Docker ComposeDocker 化改造
專案改造後的專案機構圖如下:
因為上一篇文章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=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
此檔案主要的作用是讓 Mysql 支援 UTF-8.
Dockerfile 檔案內容
FROM mysql/mysql-server:5.7COPY 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 -dCreating network "favoriteswebfavorites111_default" with the default driverCreating favorites-nginx ... doneCreating favoriteswebfavorites111_mysql_1 ... doneCreating favoriteswebfavorites111_app_1 ... done
啟動完成後,瀏覽器訪問上面配置地址:http://xx.xxx.xx.xx/,就可以看到雲收藏的首頁了。
輔助內容
啟動後想檢視某個容器內的服務執行情況,可以使用以下命令進入:
使用docker ps檢視宿主機上面執行的 Docker 容器
[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
根據上面查詢的 Docker 容器 ID 資訊,執行下面命令
docker exec -ti CONTAINER_ID bash#比如進入專案容器中[root@VM_73_217_centos ~]# docker exec -ti a466ce6e58a5 bashroot@a466ce6e58a5:/app# ps -ef|grep java...
退出容器執行以下命令:
root@a466ce6e58a5:/app# exitexit[root@VM_73_217_centos ~]#
這樣以後如果我們想部署雲收藏專案就變的非常簡單,僅僅需要三步可以愉快的搭建自己的收藏系統了,小夥伴們趕緊動起手來。