如何安装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翻译组