JHispter的安装、使用

前言

参考：https://jhipster.github.io/installation
后台服务只生成带UAA的微服务
前端我们使用Angular，不使用AngularJS

安装

本地安装（yarn方式）

• Install Java 8 from the Oracle website.
• (Optional) Install a Java build tool.
  Whether you choose to use Maven or Gradle, you normally don’t have to install anything, as JHipster will automatically install the Maven Wrapper or the Gradle Wrapper for you.
  If you don’t want to use those wrappers, go to the official Maven website or Gradle website to do your own installation.
• Install Git from git-scm.com.
  We recommend you also use a tool like SourceTree if you are starting with Git.
• Install Node.js from the Node.js website (prefer an LTS version)
• Install Yarn from the Yarn website
• Install Yeoman:
  $ yarn global add yo
• Install JHipster

$ yarn global add generator-jhipster
$ yarn global add generator-jhipster-elasticsearch-reindexer

使用

生成UAA

$ mkdir uaa
$ cd uaa
$ jhipster

? (1/16) Which *type* of application would you like to create? 
[BETA] JHipster UAA server (for microservice OAuth2 authentication)
? (2/16) What is the base name of your application? 
uaa
? (3/16) As you are running in a microservice architecture, on which port would like your server to run? It should be unique to avoid port conflicts. 
9999
? (4/16) What is your default Java package name? 
com.example.uaa
? (5/16) Do you want to use the JHipster Registry to configure, monitor and scale your microservices and gateways? 
Yes
? (6/16) Which *type* of database would you like to use? 
SQL (H2, MySQL, MariaDB, PostgreSQL, Oracle, MSSQL)
? (7/16) Which *production* database would you like to use? 
MySQL
? (8/16) Which *development* database would you like to use? 
MySQL
? (9/16) Do you want to use Hibernate 2nd level cache? 
Yes, with HazelCast (distributed cache, for multiple nodes)
? (10/16) Would you like to use Maven or Gradle for building the backend? 
Maven
? (11/16) Which other technologies would you like to use?
? (12/16) Would you like to enable internationalization support? 
Yes
? Please choose the native language of the application 
Chinese (Simplified)
? Please choose additional languages to install
? (13/16) Besides JUnit and Karma, which testing frameworks would you like to use?
? (14/16) Would you like to install other generators from the JHipster Marketplace? 
No 

生成Gateway

在uaa的目录下

$ cd ..
$ mkdir gate
$ cd gate
$ jhipster --skip-client

? (1/16) Which *type* of application would you like to create? 
Microservice gateway
? (2/16) What is the base name of your application? 
gate
? (3/16) As you are running in a microservice architecture, on which port would like your server to run? It should be unique to avoid port conflicts. 
8080
? (4/16) What is your default Java package name? 
com.example.uaa
? (5/16) Do you want to use the JHipster Registry to configure, monitor and scale your microservices and gateways? 
Yes
? (6/16) Which *type* of authentication would you like to use? 
[BETA] Authentication with JHipster UAA server (the server must be generated separately)
? (7/16) What is the folder path of your UAA application? 
../uaa
? (8/16) Which *type* of database would you like to use? 
SQL (H2, MySQL, MariaDB, PostgreSQL, Oracle)
? (9/16) Which *production* database would you like to use? 
MySQL
? (10/16) Which *development* database would you like to use? 
MySQL
? (11/16) Would you like to use Maven or Gradle for building the backend? 
Maven
? (12/16) Which other technologies would you like to use?
? (13/16) Which *Framework* would you like to use for the client? 
Angular 4
? (14/16) Would you like to use the LibSass stylesheet preprocessor for your CSS? 
No
? (15/16) Would you like to enable internationalization support? 
Yes
? Please choose the native language of the application 
Chinese (Simplified)
? Please choose additional languages to install
? (16/16) Besides JUnit and Karma, which testing frameworks would you like to use?
? (17/16) Would you like to install other generators from the JHipster Marketplace? 
No 

生成微服务

在uaa目录下

$ cd ..
$ mkdir app
$ cd app
$ jhipster

? (1/16) Which *type* of application would you like to create? 
Microservice application
? (2/16) What is the base name of your application? 
app
? (3/16) As you are running in a microservice architecture, on which port would like your server to run? It should be unique to avoid port conflicts. 
8081
? (4/16) What is your default Java package name? 
com.example.uaa
? (5/16) Do you want to use the JHipster Registry to configure, monitor and scale your microservices and gateways? 
Yes
? (6/16) Which *type* of authentication would you like to use? 
[BETA] Authentication with JHipster UAA server (the server must be generated separately)
? (7/16) What is the folder path of your UAA application? 
../uaa
? (8/16) Which *type* of database would you like to use? 
SQL (H2, MySQL, MariaDB, PostgreSQL, Oracle)
? (9/16) Which *production* database would you like to use? 
MySQL
? (10/16) Which *development* database would you like to use? 
MySQL
? (11/16) Do you want to use Hibernate 2nd level cache? Yes, with 
HazelCast (distributed cache, for multiple nodes)
? (12/16) Would you like to use Maven or Gradle for building the backend? 
Maven
? (13/16) Which other technologies would you like to use?
? (14/16) Would you like to enable internationalization support? 
Yes
? Please choose the native language of the application 
Chinese (Simplified)
? Please choose additional languages to install
? (15/16) Besides JUnit and Karma, which testing frameworks would you like to use?
? (16/16) Would you like to install other generators from the JHipster Marketplace? 
No 

1. 生成微服务中的Entity

jhipster  entity Organization --skip-client 

其中Organization是实体Entity的名字，可以替换成任意有有意义的其他实体名字

运行（以Docker的方式）

• 启动registry

$ cd uaa
$ docker-compose -f src/main/docker/jhipster-registry.yml up -d 

启动成功后登陆
http://your-server:8761
默认用户名密码:admin/admin123

• 启动UAA

$ cd uaa
$ ./mvnw package -Pdev docker:build
$ docker run -d --restart=always -p 9999:9999 -p 9999+5701:9999+5701  --name uaa  uaa

• 启动GATE
  “`
  $cd gate$ ./mvnw package -Pdev docker:build
  $ docker run -d –restart=always -p 8080:8080 -p 8080+5701:8080+5701 –name gate gate

 - 启动微服务APP 
  ```
$ cd app
$ ./mvnw package -Pdev docker:build
$ docker run -d --restart=always -p 8081:8081 -p 8081+5701:8081+5701  --name app  app

• 启动后台管理

$ cd gate
$ yarn install
$ yarn start

按照输出的提示，在浏览器输入URL，注意端口。即可用admin/admin登陆后台管理界面

• 更改webpack-dev-server域名

修改webpack.config.js，添加host，disableHostCheck选项
若后台管理和gate服务不在一台（虚拟）机器上，则需要修改webpack/webpack.dev.js或webpack/webpack.prod.js，增加host和disableHostCheck等配置

devServer: {
    historyApiFallback: true,
    host: '0.0.0.0',
    disableHostCheck: true,
    noInfo: true
  },

• 生成数据实体Entity

进入工程根目录，运行

$ jhipster entity <entityName>

• 登录API

API: http://localhost:9001/uaa/oauth/token

$ curl  http://ip:9001/uaa/oauth/token --request POST --insecure --data "grant_type=password&username=admin&password=admin" -H "Authorization:Basic d2ViX2FwcDo="

返回下面内容表示成功

{
  "access_token" : "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1MDUwMTMxNTQsInVzZXJfbmFtZSI6ImFkbWluIiwiYXV0aG9yaXRpZXMiOlsiUk9MRV9BRE1JTiIsIlJPTEVfVVNFUiJdLCJqdGkiOiI2NTY1ZmQzMC04YTE0LTRkYzMtYmJhNC05MWM4ZDE2YzdhYzQiLCJjbGllbnRfaWQiOiJ3ZWJfYXBwIiwic2NvcGUiOlsib3BlbmlkIl19.eEDPlsAZ1YI4vMWkDtEL8E3nk83D6JBO2ZdPUTTqnGnc9uKlVFsGQXj292vWSXZ1SI2EMgtEtf0TJmQ-4Cvz-RHywWmBcqiue5OLtDkv9okTOBxniM5wCH4Jbt9bz1DpDTdiMja6rTp6Y62BGro5QJpmzCxeYpVMBP_zukNgZlB7JDZDqLAhnFi7t2leWTLQ4ycoQDpM1CS6LUJJU9WzmK9Jw3LkBIYFJitWSQoxYRCQwwai36dcd346VxiebeQ83f5-VbJlOtIL_zZFaM7h0WuUzgX32TK2GTnzB837Jb3yChqr4auko1ICJqx8E1DJh2zZjO7nVTj4QRoKKkntRA",
  "token_type" : "bearer",
  "refresh_token" : "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX25hbWUiOiJhZG1pbiIsInNjb3BlIjpbIm9wZW5pZCJdLCJhdGkiOiI2NTY1ZmQzMC04YTE0LTRkYzMtYmJhNC05MWM4ZDE2YzdhYzQiLCJleHAiOjE1MDc1NjE5NTQsImF1dGhvcml0aWVzIjpbIlJPTEVfQURNSU4iLCJST0xFX1VTRVIiXSwianRpIjoiOGJmNWJjNmEtMmI4My00MTlhLTgyMzYtODFiNGYyNjNmZDA2IiwiY2xpZW50X2lkIjoid2ViX2FwcCJ9.Ls6fNbsiR5Oh3Ny2n8Aklw6UIYzBxFrU8UKFqJyIeGXEq43tqIAnWgy-U2b9keqFGT95T4iWRiLYltrRJ4Oo7zUvaoZ4Cm6m38tF3J1hiyyWKemEVecX9K06TbeSSb8aOYitEdY2MDoFypUrzzRD-2PDkKhsj6KJIgvdK7KJuHMRmLHOZ4T5fJoD52ZNNk1TDVH2iwOWRrkex2J7pe0uOFLuycQrgy4RsWSidrgl3uyWArZ0Q5q6bsm0be0PgQm45nBL6SVXOXz-WH3ZgslqPawoR2fCEfCCSz3-X15TmIofs30cDXq8A_N9FcJ5S5WfM555bVK0FbfW2_7BxwcTNg",
  "expires_in" : 43199,
  "scope" : "openid",
  "jti" : "6565fd30-8a14-4dc3-bba4-91c8d16c7ac4"
}

Elastic Search Reindex

yo generator-jhipster-elasticsearch-reindexer 

执行会提示

/opt/node-v8.4.0-linux-x64/lib/node_modules/yo/node_modules/insight/node_modules/configstore/index.js:53
                                throw err;
                                ^

Error: EACCES: permission denied, open '/root/.config/configstore/insight-yo.json'
You don't have access to this file.

    at Object.fs.openSync (fs.js:652:18)
    at Object.fs.readFileSync (fs.js:553:33)
    at Configstore.get (/opt/node-v8.4.0-linux-x64/lib/node_modules/yo/node_modules/insight/node_modules/configstore/index.js:34:26)
    at Configstore.get (/opt/node-v8.4.0-linux-x64/lib/node_modules/yo/node_modules/insight/node_modules/configstore/index.js:81:13)
    at Insight.get (/opt/node-v8.4.0-linux-x64/lib/node_modules/yo/node_modules/insight/lib/index.js:48:22)
    at Object.<anonymous> (/opt/node-v8.4.0-linux-x64/lib/node_modules/yo/lib/cli.js:194:47)
    at Module._compile (module.js:573:30)
    at Object.Module._extensions..js (module.js:584:10)
    at Module.load (module.js:507:32)
    at tryModuleLoad (module.js:470:12)

修改方案：

sed -i -e '/rootCheck/d' "${NPM_CONFIG_PREFIX}/lib/node_modules/yo/lib/cli.js"