安装Jhipster

安装方法

我们提供了3种Jhipster的工作方式:

本地安装,这是一个经典的方式使用Jhipster.所有都安装在你本机,可能设置起来比较复杂,但确实大多数人通常选择的方式.如有疑问,选择这个安装.
一个基于Vagrant的"开发工具箱",在一个基于Ubuntu的虚拟机上集成并配置好了开发所需的所有工具(STS,Yeoman,NODE,NPM,Genterator,JAVA8,Atom,MySQL).
一个"Docker"容器版,一个安装JHipster的轻量级虚拟化的容器.

本地安装 (推荐给一般用户OSX 类Linux)

安装JAVA8 Oracle官网.
(选择) 安装一个Java构建工具.
- 无论你选择使用 Maven 或者 Gradle, 一般情况下你不需要安装任何东西, 因为 JHipster将会自动为你安装Maven Wrapper或者Gradle Wrapper.
- 如果你不想使用这些wrappers,去Maven website或者Gradle website官网下载自己的安装包.
安装git-scm.com. 如果你刚接触Git,我们建议你使用 SourceTree.
安装the Node.js website (推荐Long Time Support版本).这也会安装NPM,NODE的包管理工具,将会在接下来的命令中使用.
安装 Yeoman: npm install -g yo
安装 Bower: npm install -g bower
安装 Gulp: npm install -g gulp
安装 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内部.

准备工作

这取决于你的操作系统.

Linux: Linux 为Docker提供了开箱即用. 请跟随Docker官网提供的教程 Docker.
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<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拉取),最好是删除现有的容器,然后运行上面的之前的命令.

docker stop jhipster
docker rm jhipster
docker pull jhipster/jhipster
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