安装类型
我们提供6种方式安装。如有疑问可以选择第二项,通过Yarn在本地安装
1.JHipster Online是一个创建应用的简单方法,无需安装
2.使用Yarn进行本地安装是一个经典的方法,所有的东西都会安装到你的机器上,但却创建起来却有点复杂
3.使用NPM进行安装也是一个经典的选择
4.使用包管理下载只能在Mac OS X和Windows下生效。这是一个非常简单的安装方法,但它还是公测版本
5.基于Vagrant的development box,把所有工具都配置在一个Ubutu的虚拟机器里
6.Docker容器,给予你一个轻量级的开发环境
使用Yarn进行本地安装(推荐一般用户使用)
快速配置当使用Angular的时候
1.安装Java 8 the Oracle website
2.Node.js the Node.js website (prefer an LTS version)
3.Yarn the Yarn website
4.如果你想使用JHipster Marketplace需安装Yeoman yarn global add yo
5.JHipster:yarn global add generator-jhipster
现在你已经安装好了,下一步就是创建一个程序create an application
Angular和AngularJS 1.x可选的安装选项
1.安装Java build工具
·无论你选择的是Maven或者Gradle,你不需要安装任何东西,因为JHipster已经自动安装好Maven Wrapper或者Gradle Wrapper了
如果你不想使用wrappers可以到各自的官网下载以上两款工具
2.安装Git git-scm.com 我们同样推荐一个工具 SourceTree如果使用Git的话
JHipster会尽量把你的项目提交到Git,
JHipster更新子生成器也要求安装了Git
问题解决
如果你在全局使用Yarn的时候遇到了问题,确保你的环境变量中包含:$HOME/.config/yarn/global/node_modules/.bin
Mac or Linux上则是: export PATH="$PATH:`yarn global bin`:$HOME/.config/yarn/global/node_modules/.bin"
JHipster使用Yeoman生成代码。想要更多的消息提示和帮助,请移步Yeoman “getting starting” guide和Yarn documentation 在你提交bug前请仔细确认
使用NPM进行本地安装
这与使用Yarn安装是一样的步骤,只有两处不同
1.在第三步的时候使用NPM代替Yarn:npm install -g npm
2.使用npm install -g 代替yarn global add例如
npm install -g yo安装Yeoman
npm install -g generator-jhipster
更多信息请查看NPM documentation.
Dokcer下的安装(高级用户适用)
请注意这个Docke镜像只能在一个容器内运行JHipster generator.它跟 Docker and Docker Compose configurations是完全不同的,目的是在容器中运行一个应用
消息
JHipster有一个特殊的Dockerfile,提供Docker 镜像。能使Docker在这个地址下https://hub.docker.com/r/jhipster/jhipster/自动构建,这个镜像能使你在Docker中运行JHipster
前提条件
这取决于你的操作系统
1.Linux支持Docker运行于box外,你只需要跟随Docker 的教程即可
2.Mac & Windows下需要安装Docker Toolbox 简化安装
由于创建的文件在你共享的文件夹中,当你停止Docker容器的时候,它们将被删除。然而,如果你不想Docker每次重启后都从Maven或者NPM下载依赖的话,你可以把状态提交或者mount a volume
在Linux中,你可能需要以root用户运行docker命令如果你的用户不是docker用户组的一员。可见把你的非root用户加入到docker用户组是一个好方法,那样你就能以非root用户身份运行docker命令。只要跟随以下步骤即可http://askubuntu.com/a/477554
Linux上的使用
拉取镜像
拉取Docker下最新的JHipster镜像
docker image pull jhipster/jhipstrer
拉取开发中的镜像
docker image pull jhipster/jhipster:master
你可以点击here查看版本标签
运行镜像
在home目录下创建jhipster目录
mkdir ~/jhipster
通过以下的选项运行Docker镜像
·Docker中的/home/jhipster/app与本地中的~/jhipster目录是共享的
·将所有的端口通过Docker映射出来(8080端口给Java程序使用,9000给浏览器同步,访问3001查看浏览器同步UI)
以下是详细的命令
docker container run --name jhipster -v ~/jhipster:/home/jhipster/app -v ~/.m2:/home/jhipster/.m2 -p 8080:8080 -p 9000:9000 -p 3001:3001 -d -t jhipster/jhipster
提示:如果你之前已经开启了一个容器,你就不需要上诉的命令,只需简单通过start/stop命令启动和关闭已存在的容器。
如何确定容器已经 运行了
使用docker container ps
日常操作
·停止容器:docker container stop jhipster
·启动容器:docker container start jhipster
当你想要更新Docker镜像的时候(重建或者从Docker hub拉取的时候),最好就移除先前的容器,重新运行一遍新的容器。首先要停止容器,移除它然后再运行:
1. docke container stop jhipster
2.docker container rm jhipster
3.docker image pull jhipser/jhipser
4.docker container run --name jhipster -v ~/jhipster:/home/jhipster/app -v ~/.m2:/home/jhipster/.m2 -p 8080:8080 -p 9000:9000 -p 3001 -d -t jhipster/jhipster
访问容器
登录已运行容器最简单的方法就是执行:docker container exec -it
如果你复制粘贴了上述命令,注意你的容器的名称是jhipster
docker contianer exec -it jhipster bash
默认的话你是以jhipster身份登录,如果你想要以root用户身份登录则执行:
docker container exec -it --user root jhipster bash (sudo命令在Ubuntu Xenial中不可用)
你的第一个项目
接下来你可以到Docker中的 /home/jhipster/app目录下开始构建你的app
cd /home/jhipster/app
jhipster
提示:如果你对使用Yarn有疑问的话,可以使用 jhipster --npm 以NPM代替Yarn
当你创建好app之后,你可以运行: gulp/bower/maven等命令,例如:
./mvnw
祝贺你,你已经进入Docker中的JHipster app
在你的主机中,你可以:
·通过http://DOCKER_HOST:8080访问正在运行的程序
·通过共享文件获取你创建的所有文件
警告:默认的,Docker并没有安装在jhipster/jhipster镜像中
所以你并不可以:
·使用docker-compose文件
·构建Docker镜像(Maven goal:docker file:build or Gradle task:buildDocker)