java 範例專案運行運行

範例 github repository

https://github.com/agileworks-tw/spring-boot-sample

clone repository

透過下面指令，將會複製範例專案

git clone [email protected]:agileworks-tw/spring-boot-sample.git

pull java 8 and maven 3 docker image

docker pull maven:3-jdk-8

透過 docker image 進行專案測試

運行指令如下：

docker run --rm \
-v `pwd`:/app \
-v $HOME/.m2:/root/.m2 \
-w /app \
-p 8000:8000 \
maven:3-jdk-8 \
mvn spring-boot:run

-v or --volume

使用了兩次：

1. ${pwd}:/app: 將目前專案所在目錄掛載到 docker container 中的/app 路徑
2. $HOME/.m2:/root/.m2: 將 docker 內的 maven cache 掛載到 host 以加快後續的建置

另外一個方式就是使用 docker volume container

docker run --rm \
-v `pwd`:/app \
--volumes-from sample-java-data \
-w /app \
maven:3-jdk-8 \
-p 8000:8000 \
mvn spring-boot:run

相關說明可以參考 java project install

-p or --publish

對於 docker container 而言，預設 container 是不對外開放 port 的，我們可以根據我們運行上的需要開放必要的 port。

-p 8000:8000 代表的意思就是將 container 內的 8000 publish 到 host 8000 port 令我們可以存取 service。

執行專案運行

最後使用 maven:3-jdk-8 image 則為官方提供的 maven 環境。

mvn spring-boot:run 將會將專案運行，透過下列網址進行存取

http://localhost:8000/api

透過 docker compose 運行

將 docker command 轉換為 docker-compose

以下面的指令為例

docker run \
--name sample-java-data \
-v /root/.m2 \
ubuntu

docker run --rm \
-v `pwd`:/app \
--volumes-from sample-java-data \
-w /app \
maven:3-jdk-8 \
-p 8000:8000 \
mvn spring-boot:run

轉換為 docker-compose.yml 其檔案內容如下：

data:
  image: ubuntu
  volumes:
    - /root/.m2

server:
  image: maven:3-jdk-8
  volumes:
    - ./:/app
  volumes_from:
    - data
  working_dir: /app
  ports:
   - "8000:8000"
  command: "mvn spring-boot:run"

透過 docker-compose 運行專案安裝

docker-compose up server

這邊使用 up 主要是因為要讓 port 可以 publish 所以使用 up 關鍵字

若使用 run 預設 port 是 unpublish 的。

我們一樣可以透過下列網址來進行驗證。

http://localhost:8000/api