如何安裝JHipster

安裝Jhipster

安裝方法

咱們提供了3種Jhipster的工做方式:

• 本地安裝,這是一個經典的方式使用Jhipster.全部都安裝在你本機,可能設置起來比較複雜,但確實大多數人一般選擇的方式.若有疑問,選擇這個安裝.
• 一個基於Vagrant的"開發工具箱",在一個基於Ubuntu的虛擬機上集成並配置好了開發所需的全部工具(STS,Yeoman,NODE,NPM,Genterator,JAVA8,Atom,MySQL).
• 一個"Docker"容器版,一個安裝JHipster的輕量級虛擬化的容器.

本地安裝 (推薦給通常用戶OSX 類Linux)

1. 安裝JAVA8 Oracle官網.
2. (選擇) 安裝一個Java構建工具.
   • 不管你選擇使用 Maven 或者 Gradle, 通常狀況下你不須要安裝任何東西, 由於 JHipster將會自動爲你安裝Maven Wrapper或者Gradle Wrapper.
   • 若是你不想使用這些wrappers,去Maven website或者Gradle website官網下載本身的安裝包.
3. 安裝git-scm.com. 若是你剛接觸Git,咱們建議你使用 SourceTree.
4. 安裝the Node.js website (推薦Long Time Support版本).這也會安裝NPM,NODE的包管理工具,將會在接下來的命令中使用.
5. 安裝 Yeoman: npm install -g yo
6. 安裝 Bower: npm install -g bower
7. 安裝 Gulp: npm install -g gulp
8. 安裝 JHipster: npm install -g generator-jhipster

想要獲取更多的信息, 提示和幫助,請參閱 the Yeoman "getting starting" guide 和 NPM documentation 以後提交Issues submitting a bug.

如今JHipster已經安裝,下一步將是建立一個應用 [create an application]({{ site.url }}/creating-an-app/)

Vagrant 工具箱安裝

JHipster development box 項目爲你提供了開發JHipster所必須工具的一個虛擬化環境.

它一個極簡而快捷的方式的,啓動JHipster的方式.

除了JHipster,這個虛擬化環境還包含了Spring Tool Suite, the Atom text editor and MySQL Workbench開發工具.

請到 JHipster development box page 獲取安裝和配置信息.

Docker 安裝 (高級用戶)

注意:這個Docker鏡像在容器內部運行着JHipster生成器.它與JHipster生成器[Docker and Docker Compose configurations]({{ site.url }}/docker-compose/)不一樣的是運行生成在內部容器的程序.

信息

JHipster有一個特別的 Dockerfile, 可以提供一個 Docker 鏡像.

它將提供一個Docker的自動構建: https://hub.docker.com/r/jhipster/jhipster/

這個鏡像將容許你運行JHipster在Docker內部.

準備工做

這取決於你的操做系統.

1. Linux: Linux 爲Docker提供了開箱即用. 請跟隨Docker官網提供的教程 Docker.
2. Mac & Windows: 安裝 Docker 工具箱 更簡便的爲你提供安裝.

生成的文件在你的共享目錄下,它們不會由於Docker容器的中止而被刪除.不管怎樣,若是你不想讓老是讓Dokcer去下載全部Maven和NPM的依賴,你應當掛載到本地的磁盤卷.

警告: 操做系統不一樣, 你的 <code>DOCKER_HOST</code> 將會不一樣. 在Linux上, 就簡單的是你主機地址. 對於Mac/Windows, 你能夠經過如下命令獲取IP: docker-machine ip default

提示: Kitematic是一個Docker提供的開袋即食的圖形化管理工具箱,這將會是安裝的工做更加簡單.

在Linux上,你可能須要以root用戶運行docker命令,若是當前用戶不屬於容器組.創建將當前用戶加入容器組以便運行容器命令的時候可使用非root用戶.按照這個步驟去實現 http://askubuntu.com/a/477554.

在Linux/Mac Windows 上使用(Docker 工具箱)

拉取鏡像

拉取JHipster最新版本的Docker鏡像:

docker pull jhipster/jhipster

拉取JHipster開發環境Docker鏡像:

docker pull jhipster/jhipster:master

這裏你能夠看到全部的標籤 here

運行鏡像

警告: 若是你在Mac或者Win上使用Dokcer虛擬機在,你的Docker守護進程只限於訪問你本機OS X或者Win文件系統.Docker虛擬機試圖自動共享/Users(OS X)或者C:\Users&lt;username>(Win)文件夾,因此你須要將項目文件建立在這些文件夾下以免卷掛載的問題.

在你Home目錄下建立一個"jhipster"文件夾:

mkdir ~/jhipster

選擇一下方式運行docker鏡像:

• Docker "/home/jhipster/app" 文件夾共享在本地的 "~/jhipster" 文件夾下
• 爲Docker暴露這些端口 (8080 for Tomcat, 3000 for BrowserSync from the "gulp serve" task, 3001 for the BrowserSync UI)

docker run --name jhipster -v ~/jhipster:/home/jhipster/app -v ~/.m2:/home/jhipster/.m2 -p 8080:8080 -p 3000:3000 -p 3001:3001 -d -t jhipster/jhipster

提示: 若是你已經啓動過一次容器,你就不須要再運行上面那行命令了,你能夠直接啓動/中止已經存在的容器.

檢查容器是否已經運行

用 docker ps 命令檢查你的容器是否是處於運行狀態:

CONTAINER ID    IMAGE               COMMAND                 CREATED         STATUS          PORTS                                                       NAMES
4ae16c0539a3    jhipster/jhipster   "tail -f /home/jhipst"  4 seconds ago   Up 3 seconds    0.0.0.0:3000-3001->3000-3001/tcp, 0.0.0.0:8080->8080/tcp    jhipster

####經常使用操做

• 執行: docker stop jhipster 中止容器
• 執行: docker start jhipster 從新啓動

若是你更新你的Docker鏡像(從新構建或者從DockerHub拉取),最好是刪除現有的容器,而後運行上面的以前的命令.

1. docker stop jhipster
2. docker rm jhipster
3. docker pull jhipster/jhipster
4. docker run --name jhipster -v ~/jhipster:/home/jhipster/app -v ~/.m2:/home/jhipster/.m2 -p 8080:8080 -p 3000:3000 -p 3001:3001 -d -t jhipster/jhipster

訪問容器

執行下面的命令是最簡單的方法登陸到運行容器中的方法:

docker exec -it <container_name> bash

若是你複製黏貼下面的命令去運行容器,意味着你必須指定jhipster 爲容器名:

docker exec -it jhipster bash

你將以"jhipster"用戶登錄.若是你須要 sudo ,密碼和用戶名同樣爲(jhipster).

你的第一個項目

你能夠去容器下 /home/jhipster/app 目錄,在容器內部此目錄下開始構建你的程序:

cd /home/jhipster/app

yo jhipster

一旦你的程序建立好,你能夠運行常規的 gulp/bower/maven 命令,以下:

./mvnw

恭喜!你已經在容器內部啓動了你的JHipster程序!

在你本機,你應該可以 :

• 經過 http://DOCKER_HOST:8080 訪問運行着的程序
• 在共享目錄下獲取全部生成的文件

歡迎掃碼加入咱們,內有大量資料,翻譯,視頻,文檔.歡迎加入咱們GITHUB翻譯組