JHipster安装
来源:JHipster |
时间:2018-11-01
|
|

JHipster安装

安装方法

我们提供六种使用JHipter的方法。不熟悉的建议使用第二种方法,“本地NPM安装”:

  • JHipster Online是一种无需安装JHipster就能创建应用程序的简单方法。

  • “本地NPM安装”是一种经典的使用JHipster的方式。所有的东西都安装在你的电脑里,会有一点复杂,但大部分使用这种工作方式。不熟悉的,建议使用这种方法。

  • “本地Yarn安装”与上一种方法类似,只是使用了Yarn替代NPM。

  • 软件包管理器安装”是适用于Mac和Windows电脑。如果你使用软件包管理器会很简单,但它还处于BETA版本

  • 基于Vagrant"开发包",是一种把软件安装到Ubuntu虚拟机的方式。

  • 使用Docker容器,一种轻量级容器来安装JHipster。

JHipster Online(面向想要使用简便方法来运行JHipster的用户)

JHipster Online 允许用户在不安装JHipster的情况下很轻松就可以生成JHipster程序。

这个适合于第一次接触JHipster和想了解JHipster的用户。

尽管他更简单,但它没有提供所有的JHipster体验。在你生成了应用程序后,仍然需要参照下一章的步骤(本地NPN安装),需要安装Java(运行程序)和NPM(管理你的前后端代码)。

期待JHipster Online在将来可以提供更多的功能。

本地NPM安装(推荐普通用户使用)

快速安装

  1.  从 Oracle website 安装Java 8

  2.  Node.js 网站安装Node.js(请使用LTS 64-bit版本,not-LTS不支持)

  3. NPM会随Node.js一起安装,但你需要升级它:npm install -g npm

  4. 如果你想使用JHipster市场,需要安装Yeoman: npm install -g yo

  5. 安装JHipster: npm install -g generator-jhipster

现在JHipster已经安装了,下一步时创建一个应用程序。

可选项安装

  1. 安装Java构建工具


    • 不管你选择Maven或Gradle,你通常不需要安装任何东西,JHipster会自动为你安装Maven Wrapper或Gradle Wrapper。

    • 如果你不想使用这些wrapper,可以去Maven或Gradle的官网自己安装。

  2. git-scm.com安装Git。如果你开始使用Git,我们推荐你使用SourceTree工具。

  3. JHipster upgrade sub-generator 运行需要安装Git

    • 安装后,JHipster会尝试提交你的工程到Git

加信息

使用Yeoman生成JHipster代码。在你提交一个bug之前,请参照the Yeoman “getting starting”获取更多信息提示和帮助。

配置被保存在一个生成的.yo-rc.json文件中,所以强烈建议用户不要在HOME文件夹下生成一个JHipster工程。如果你这样做了,你将无法在子文件夹下生成新的工程。解决的办法就是,删除.yo-rc.josn文件。

本地Yarn安装(替代NPM)

快速安装

与NPM相同的步骤,有两个不一样的地方。

  1. Yarn网站上安装Yarn,来替代NPM升级中的3步骤

  2. 使用yarn global add代替npm install -g,例如:


    • 安装Yeoman:yarn global add yo

    • 安装JHipster:yarn global add generator-jhipster

疑难解答

如果你在使用全局Yarn时遇到问题,可以检查一下$HOME/.config/yarn/global/node_modules/.bin是否在你的path设置中。

Mac或Linux:export PATH="$PATH:`yarn global bin`:$HOME/.config/yarn/global/node_modules/.bin"

使用包管理器安装

注意这是一个BETA版本。如果你在安装过程中遇到问题,请直接给在@java_hipster上给我们发送 bug report 或反馈.

在Mac上使用Homebrew安装

JHipster在http://formulae.brew.sh/formula/jhipster上提供一个Homebrew包

安装JHipster(Node和NPM相同):

brew install jhipster

每当有新的JHipster release版本创建了就会发布一个新的安装包,但Homebrew团队可能还要花一些时间来验证这个包。所以如果你有一个更老的JHipster release版本,请耐心等待或是使用之前NPM安装。

在Windows上使用Chocolatey安装

JHipster在https://chocolatey.org/packages/jhipster上提供一个Chocolatey安装包。

安装JHipster(与Node,NPM,Yeoman,Java和Git相同):

choco install jhipster

每当有新的JHipster release版本创建了就会发布一个新的安装包,但Homebrew团队可能还要花一些时间来验证这个包。所以如果你有一个更老的JHipster release版本,请耐心等待或是使用之前NPM安装。

Vagrant box安装

JHipster开发盒项目提供给你一个包含所有JHipster所必须工具的虚拟机。

这是一种简单的方法来快速开始运行JHipster。

除了JHipster,这个虚拟机包括许多开发工具,包括Docker,所以你应该就可以开始工作了。

请访问 JHipster development box page 来获取更多的安装和配置方面的信息。

Docker安装(仅限高级用户)

请注意:这个Docker镜像是用来在容器中运行JHipster generator. 这与“Docker and Docker Compose configurations”是完全不同的,那个是在容器中运行你生成的程序。

信息

JHipster提供一个特殊的Dockerfile来生成Docker镜像。

 https://hub.docker.com/r/jhipster/jhipster/网站上可以制作一个自动构建的Docker。

这个镜像允许你在Docker里运行JHipster。

先决条件

这个依赖于你的操作系统。

1.Linux:linux支持Docker安装,你只需要按照Docker网站的向导操作。

2.Mac和Windows:使用Docker Toolbox来轻松安装Docker。

生成的文件的如果在你的共享文件夹中,他们不会被删除如果你停止你的Docker容器。然而,如果你不希望Docker每次都重新下载所有的Maven和NPM依赖,你应该提交它的状态或是加载一个卷轴。

警告:基于你的操作系统,你的DOCKER_HOST会不同。在Linux上,它会是你的localhost。在Mac/Windows上,你需要用命令获得IP地址:docker-machine ip default

提示:Kitematic是一个方便使用的图形化Docker Toolbox工具。

在Linux上,如果你的账号不是在docker group里,你也许需要以root的权限运行docker命令。好的方法是把你的账号加入到docker group中,这样你就可以以一个非root用户运行你的docker命令。按照 http://askubuntu.com/a/477554 的步骤来操作。

在Linux/Mac Windows上的用法(使用Docker Toolbox)

Pull镜像

Pull最近的JHipster Docker镜像

docker image pull jhipster/jhipster

Pull开发版的Hipster Docker镜像

docker image pull jhipster/jhipster:master

你也可以在 这里 查看他们的标签。

运行镜像

警告:如果你是在Mac或Windows上使用Docker Machine,你的Docker守护进程访问OS X或Windows文件系统权限是受限制的。Docker Machine尝试自动分享 your/Users(OS X)或是C:/Users/<username>(Windows)目录。所以你必须在这些目录下创建工程文件,避免卷轴加载的问题

在你的根目录下,创建一个jhipster文件夹:

mkdir ~/jhipster

使用以下选项,运行Docker镜像:

  • Docker下的“/home/jhipster/app”文件夹分享给本地“~/jhipster”文件夹。

  • 设置所有的Docker 端口(8080:Java应用程序,9000:BrowserSync,3001:BrowserSync 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

提示:如果你之前已经运行了容器,你不需要再运行以上命令,你可以简单的运行/停止容器。

检查容器是否在运行

使用命令 docker container 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:9000-3001->9000-3001/tcp, 0.0.0.0:8080->8080/tcp    jhipster

常用的操作:

  • 停止容器运行:docker container stop jhipster

  • 再一次开始运行:docker container start jhipster

在需要更新Docker镜像的时候(从Docker hub重新构建或pull),最好先把存在的容器删除,再重新运行容器。首先停止并删除容器,然后再运行它:

  1. docker container stop jhipster

  2. docker container rm jhipster

  3. docker image pull jhipster/jhipster

  4. 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

访问容器

警告:Windows上,你在`npm install`步骤时,需要以管理员身份运行Docker Quick终端来创建symlinks。

最简单的方法登陆运行的容器:

docker container exec -it <container_name> bash

如果你复制粘帖上面的命令来运行容器,注意你必须以jhipster作为容器名字:

docker container exec -it jhipster bash

你会以“jhipster”用户登陆。

如果你想以root登陆。由于sudo在Ubuntu Xenial上不可用,你需要运行一下命令:

docker container exec -it --user root jhipster bash


你的第一个工程

你可以进入你容器的/home/jhipster/app目录,开始在Docker中构建你的应用:

cd /home/jhipster/app

jhipster

提示:如果你更倾向于使用Yarn,你可以使用jhipster —yarn,用Yarn代替NPM。

你的程序创建了以后,你可以运行常用 gulp/bower/maven命令,例如:

./mvnw

恭喜!你已经在Docker里面运行了你的JHipster程序。

在你的主机上,你应该能够:

警告:默认,在jhipster/jhipster镜像内是没有安装Docker的。

因此你不能:

  • 使用docker-compose文件

  • 使用docker守护进程构建一个Docker镜像(Maven goal: jib:dockerBuild or Gradle task: jibDockerBuild

然而,在没有访问docker守护进程 (Maven goal: jib:build or Gradle task: jibBuild)权限下,使用 [jib](https://github.com/GoogleContainerTools/jib)的非守护进程模式来构建一个docker镜像,并且推送到一个注册中心。你需要在安装程序前,先在docker注册中心安装证书。参见[Jib plugin configuration documentations]

更多信息(https://github.com/GoogleContainerTools/jib/tree/master/jib-maven-plugin#configuration)


提交
查看更多评论
没有更多评论