安装 JHipster

安装类型

我们提供了4中安装方式：

• A "用Yarn本地安装", 这是一种传统的方式. 所有的都安装在你的机器上, 这种安装方式可能比较复杂,但是是大多数人都是这样干的。如有疑问，请选择此安装.
• A "NPM本地安装", 这和"用Yarn本地安装"一样是一个传统的安装方式, 只是用NPM代替了 Yarn
• A 基于Vagrant的 "development box", 所有的工具都在基于Ubuntu的虚拟机中已经安装好.
• A "Docker" 容器, Docker带给你一个轻量级、虚拟化的JHipster环境容器。

使用Yarn进行本地安装(推荐大多数用户)

1. 安装 Java 8 从 Oracle 网站.
2. (可选) 安装 Java build 工具.
   • 无论你选择 Maven 或 Gradle, 你通常不需要做任何事JHipster就会自动帮你安装Maven 包 或 Gradle 包.
   • 如果你不想用自动安装的包, 去他们的官方网站 Maven 网站 or Gradle 网站 自行安装.
3. 安装 Git 从 git-scm.com. 如果你开始使用GIT的话，我们建议您也使用 SourceTree 这个工具。
4. 安装 Node.js 从 Node.js 网站 (选择 LTS 版本)
5. 安装 Yarn 从 Yarn 网站
6. 安装 Yeoman，使用这个命令: yarn global add yo
7. 仅适用于 AngularJS 1, 安装 Bower: yarn global add bower
8. 仅适用于 AngularJS 1, 安装 Gulp: yarn global add gulp-cli
9. 安装 JHipster，使用这个命令: : yarn global add generator-jhipster

注意: 如果你使用这些工具有问题，, 请确认在你的目录中是否有 $HOME/.config/yarn/global/node_modules/.bin目录.

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

JHipster 使用 Yeoman 作为代码生成工具。 要了解更多信息，提示和帮助，请看看 the Yeoman "getting starting" guide ，并且 为 Yarn 文档 提交错误.

既然已经安装JHipster，你的下一个步骤是 创建应用程序

使用NPM本地安装

1. 安装 Java 8 从 Oracle 网站.
2. (可选) 安装 Java build 工具.
   • 无论你选择 Maven 或 Gradle, 你通常不需要做任何事JHipster就会自动帮你安装Maven 包 或 Gradle 包.
   • 如果你不想用自动安装的包, 去他们的官方网站 Maven 网站 or Gradle 网站 自行安装.
3. 安装 Git 从 git-scm.com. 如果你开始使用GIT的话，我们建议您也使用 SourceTree 这个工具。
4. 安装 Node.js 从 Node.js 网站 (选择 LTS 版本). 这同时会安装npm作为包管理工具.
5. （推荐）更新NPM: npm install -g npm
6. 安装 Yeoman: npm install -g yo
7. 仅适用于 AngularJS 1, 安装 Bower: npm install -g bower
8. 仅适用于 AngularJS 1, 安装 Gulp: npm install -g gulp-cli (如果你以前是在全局安装的, 请运行 npm rm -g gulp移除glup,以确保您的旧版本不冲突 gulp-cli)
9. 安装 JHipster: npm install -g generator-jhipster

10. (可选) 安装 Yarn: npm install -g yarn (如果安装了,在以后的项目中t, yarn install 将替代 npm install)

    你可以在这里找到 NPM 文档.

Vagrant box 安装

JHipster development box 项目为您提供了一个开发JHipster项目所有必要工具的虚拟机.

这是一个简单的快速启动和运行JHipster的方法。

请到JHipster development box 页面 进行安装和配置信息。

Docker 安装 (高级用户)

请注意: 这个 Docker 镜像是为了运行容器内的 JHipster generatorr. 这不同于Docker and Docker Compose configurations，那是为了到一个容器内运行生成的应用程序。

信息

JHipster 有一个特定的 Dockerfile。

Docker Hub上已经 "自动构建" 了一个可用的Jhipster: https://hub.docker.com/r/jhipster/jhipster/

使用这个镜像你能够在Docker运行JHipster.

先决条件

这取决于您的操作系统.

1. Linux: Linux 支持 Docker out-of-box. 你只需要遵循Docker 网站上的教程 .
2. Mac & Windows: 安装 Docker Toolbox 获得Docker.

由于生成的文件都在你的共享文件夹, 如果你停止了 Docker 容器他们不会被自动删除. 但是, 如果你不想Docker一直保存下载的所有Maven和NPM依赖，你应该提交其状态或装入卷。

在 Linux 上, 如果您的用户不是docker组的一部分，则可能需要以root用户身份运行该docker命令. 将您的用户添加到docker组是一个好主意，以便您可以以非root用户身份运行docker命令. 按照 http://askubuntu.com/a/477554 上的步骤进行操作.

在Linux / Mac Windows上使用（使用Docker Toolbox）

拉取镜像

拉取最新的 JHipster Docker 镜像:

docker image pull jhipster/jhipster

拉取开发 JHipster Docker 镜像:

docker image pull jhipster/jhipster:master

你可以在这里看到所有的标签 here

运行镜像

在您的主目录中创建一个“Jhipster”文件夹:

mkdir ~/jhipster

使用以下选项运行Docker映像:

• Docker "/home/jhipster/app" 文件夹被共享到本地的 "~/jhipster" folder
• 转发Docker公开的所有端口（Java应用程序为8080，BrowserSync为9000，BrowserSync UI为3001）

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集线器重建或拉出），最好删除现有容器，并再次运行容器。为此，首先停止容器，将其移除，然后再次运行:

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

访问容器

登录运行容器的最简单的方法是执行以下命令:

docker container exec -it <container_name> bash

如果您复制粘贴上述命令来运行容器，请注意，您必须指定 jhipster 为容器名称:

docker container exec -it jhipster bash

您将以“jhipster”用户身份登录.

因为sudo 命令在Ubuntu Xenial中不可用，如果要以“root”身份登录，则需要运行:

docker container exec -it --user root jhipster bash

你的第一个项目

你可以进入容器的 /home/jhipster/app 目录, 然后在Docker容器内构件app:

cd /home/jhipster/app

jhipster

创建应用程序后，您可以运行所有正常的 gulp/bower/maven 命令, 例如:

./mvnw

恭喜！您已经在Docker中运行了JHipster应用程序！

在您的主机上，您应该能够： :

• 访问正在运行的应用程序 http://DOCKER_HOST:8080
• 获取共享文件夹中的所有生成的文件