JHipster生成微服务架构的应用栈(四)- 网关微服务示例

本文涉及的产品
服务治理 MSE Sentinel/OpenSergo,Agent数量 不受限
简介: 本系列文章演示如何用JHipster生成一个微服务架构风格的应用栈。环境需求:安装好JHipster开发环境的CentOS 7.4(参考这里)应用栈名称:appstack认证微服务: uaa业务微服务:microservice1网关微服务:gateway实体名:role主机IP:192.

本系列文章演示如何用JHipster生成一个微服务架构风格的应用栈。
环境需求:安装好JHipster开发环境的CentOS 7.4(参考这里
应用栈名称:appstack
认证微服务: uaa
业务微服务:microservice1
网关微服务:gateway
实体名:role
主机IP:192.168.220.120

1 生成网关微服务的工程代码

进入appstack/gateway目录,输入命令后回车:

$ cd gateway/
$ jhipster

命令行输出JHipster启动信息

img_4e58ba7a967f8133b3e49b7bdd8fbccf.png

现在开始问答环节

1.1 Which type of application would you like to create?

选择生成的应用类型
这是一个单选题,有4个选项,使用上下键切换选项。
这里选择Microservice gateway,也就是网关微服务。

img_417d1cf3284f0714c0eb157fd8640524.png

单击回车继续。

1.2 What is the base name of your application?

输入应用的名称
默认名称是当前目录名gateway,也可以自己输入名称;这里使用默认名称。
注意:名称只能是大小写字母,数字和下划线的任意组合,不允许任何其它字符。

img_e65ec2008429b556394a8fe96476e06c.png

单击回车继续。

1.3 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,也可以自己输入端口号,注意不要和别的微服务和进程的端口号冲突。

img_8996565904ed5d9457c622cad2e02f2e.png

单击回车继续。

1.4 What is your default Java package name?

输入应用的java包名
默认java包名是com.mycompany.myapp,也可以自己输入包名;这里使用默认包名。
注意:包名要符合Java标准规范的要求。

img_f0d7bc4001ea678364120916e1b9fd17.png

单击回车继续。

1.5 Which service discovery server do you want to use?

选择一个服务发现组件
这是一个单选题,有3个选项,使用上下键切换选项。
根据微服务体系规划,这里选择JHipster Registry

img_1792d23b04734cacef81c83353038100.png

单击回车继续。

1.6 Which type of authentication would you like to use?

选择使用的认证类型
这是一个单选题,有3个选项,使用上下键切换选项。
根据微服务体系规划,这里选择Authentication with JHipster UAA server (the server must be generated separately)

img_e293003227a49905af2feca6c53f41a8.png

单击回车继续。

1.7 What is the folder path of your UAA application?

输入uaa微服务所在的目录
这是一个相对于gateway的相对路径,默认路径是../uaa,这就是我们之前生成uaa工程的目录所在;如果之前生成的uaa目录名是myuaa,那么这里要输入../myuaa
注意:这个问题和上一个问题(1.6)的选择有关联性,上一个问题的不同选择,会导致后续不同问题的出现。

img_640ed72f474e9f403d9bd64e2ff76ad9.png

单击回车继续。

1.8 Which type of database would you like to use?

选择使用的数据库类型
这是一个单选题,有4个选项,使用上下键切换选项。
可以看到支持的数据库类型很多,这里选择默认选项SQL

img_f1886f77b6b8b80b1f680169a65af226.png

单击回车继续。

1.9 Which production database would you like to use?

选择生产环境中使用的数据库
这是一个单选题,有5个选项,使用上下键切换选项。
可以看到目前支持5种SQL数据库,这里选择默认选项MySQL

img_cbd5b1d57715d0c9fa507313d9c6fe71.png

单击回车继续。

1.10 Which development database would you like to use?

选择开发环境中使用的数据库
这是一个单选题,有3个选项,使用上下键切换选项。
H2调试起来简单,但为了和生产环境保持一致性,这里选择MySQL

img_a0303fef6ca6698b177c88cff9ccc631.png

单击回车继续。

1.11 Do you want to use Hibernate 2nd level cache?

是否需要使用Hibernate 2级缓存?
默认选择是Y,如果不需要,输入n;这里选择默认选项Y

img_d836b0016740ca73542bef733ac09280.png

单击回车继续。

1.12 Would you like to use Maven or Gradle for building the backend?

选择使用Maven还是Gradle来构建微服务
这是一个单选题,有2个选项,使用上下键切换选项。
根据自己的开发环境需要,选择相应的构建工具,这里选择默认选项Maven

img_08bc1a23fdc743e0b515210555a80a62.png

单击回车继续。

1.13 Which other technologies would you like to use?

选择需要用到的技术组件
这是一个多选题,有4个选项,使用上下键切换选项,使用空格键选中选项,使用a键全选,使用i键取消全选。
根据自己的技术架构规划,选择相应的技术组件,也可以都不选择。

img_01236c0db49b4599823c96e826236ff3.png

单击回车继续。

1.14 Which Framework would you like to use for the client?

选择前端框架
这是一个单选题,有2个选项,使用上下键切换选项。
根据自己的技术架构规划,选择相应的前端框架,这里选择默认选项Angular 6

img_e97bdd4012383fb19ea4d39a4bb9d63f.png

单击回车继续。

1.15 Would you like to enable SASS support using the LibSass stylesheet preprocessor?

是否需要启用样式表预处理来支持SASS?
默认选择是N,如果需要启用,输入y;这里选择默认选项N

img_94cdcbd60bbec73d826f2267caea63be.png

单击回车继续。

1.16 Would you like to enable internationalization support?

是否需要国际化支持?
默认选择是Y,如果不需要,输入n;这里选择默认选项Y

img_717a7374854fdc58d0695ab6115fbccc.png

单击回车继续。

1.17 Please choose the native language of the application

选择国际化支持中的母语
这是一个单选题,有37个选项,使用上下键切换选项。
注意:这个问题和上一个问题(1.16)的选择有关联性,上一个问题如果选择n,这个问题不会出现。

img_9c90d1483b0d7a3fffc8e8ffa2c4c534.png

单击回车继续。

1.18 Please choose additional languages to install

选择国际化支持中的其它语言
这是一个多选题,有37个选项,使用上下键切换选项,使用空格键选中选项,使用a键全选,使用i键取消全选。
根据自己的业务规划,选择相应的语言,也可以都不选择。

img_fa58b9dff94e55cca6efe3fc5dde8644.png

单击回车继续。

1.19 Besides JUnit and Jest, which testing frameworks would you like to use?

选择单元测试工具
这是一个多选题,有2个选项,使用上下键切换选项,使用空格键选中选项,使用a键全选,使用i键取消全选。
根据自己的技术架构规划,选择相应的技术组件,也可以都不选择。

img_bdf395d3b6fcb908a922f597d2a5a5bb.png

单击回车继续。

1.20 Would you like to install other generators from the JHipster Marketplace?

是否需要从JHipster市场中安装其它的开发工具?
默认选择是N,如果需要启用,输入y;这里选择默认选项N

img_e6c715c87b461a8375c65c644e5d3b96.png

单击回车继续。

问答结束,开始生成工程代码

这个过程可能会有点长,根据电脑性能和网速的不同,通常需要3-5分钟。

img_ed1a8ed08891501d66ff1b4993c22792.png

至此,生成工程代码成功完成。可以在appstack/gateway目录下查看所有生成的文件。

2 生成实体代码

接下来,是为microservice1中的实体表role生成前端资源。
在开始之前,确保microservice1已经为实体role生成过后端代码。
进入appstack/gateway目录,输入命令后回车:

$ cd gateway/
$ jhipster entity role

命令行输出实体已创建

img_1581170d7689d83d946dec405efe3568.png

现在开始问答环节

2.1 Do you want to generate this entity from an existing microservice?

是否为一个现有的业务微服务的实体生成前端资源?
默认选择是Y,如果不需要添加,输入n;这里选择默认选项Y

img_5e803cd173a50e57d21a05a6bc54b086.png

单击回车继续。

2.2 Enter the path to the microservice root directory:

输入这个现有的业务微服务的路径
这是一个相对于gateway的相对路径,对于microservice1工程来说,这里要输入../microservice1

img_b1ad7f4c00a12debc94ad68df4e6f934.png

单击回车继续。

2.3 Do you want to update the entity? This will replace the existing files for this entity, all your custom code will be overwritten

是否要更新这个实体
这是一个单选题,有4个选项,使用上下键切换选项。
4个选项的意思分别是是的,重新生成这个实体是的,增加字段和关系是的,删除字段和关系不,退出。这里选择Yes, re generate the entity

img_3778c037d06a4c1fe73f93729976dd25.png

单击回车继续。

问答结束,开始生成实体代码

这个过程中会提示与已有文件有冲突,需要选择处理方式,提示的输入选项是Ynaxdh,说明如下:

Y: yes (Default)
n: no
a: yes to this question and all others (or always yes).
x: abort (exit)
d: show the differences between the old and the new file
h: help, list all options

这里选择a

img_d23027dbb0f1568f2162f539c7115fdf.png

单击回车。这里主要是生成实体对应的前端资源,根据实体的复杂程度不同,耗时也不尽相同,我们这个示例只有1个字段,生成很快,通常1-2分钟就能完成。

img_bb36de154b1811ffc865d01a34b478ae.png

至此,生成实体代码成功完成。可以执行maven测试命令来验证整个工程代码(如果生成工程代码时选择的构建工具是Maven)

$ mvn test

如果一切正常,命令行会输出成功信息:

img_f785c9d89781a40dd3648b0a9ed89858.png

3 生成前端资源

之前在生成工程代码时选择的前端组件是Angular,所以前端资源会按如下流程生成:
a, 生成工程代码或者实体代码的任务完成后,会自动触发执行yarn install
b, yarn install执行完成后,会自动触发执行webpack:build
c, webpack:build执行完成后,所有前端资源就已经生成了,默认是在gateway/target/www目录下。

调试前端页面

进入gateway目录,输入命令后回车:

$ cd gateway/
$ yarn start

如果一切正常,会启动Webpack dev-server;

img_9f5143e7f13b3777a4edfad5064bcafa.png

可通过浏览器访问http://192.168.220.120:9000查看前端调试页面。此时所有前端资源的修改,都会同步更新到浏览器上。

img_bcb133159022d6be6412b2c9c80b5747.png

4 数据库配置

4.1 启动一个数据库容器

在命令行,任意目录下,启动一个mysql容器;如果本地没有mysql:5的镜像,容器启动时会自动去docker store下载镜像。

$ docker container run --name gateway-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d -p 32800:3306 mysql:5

4.2 在数据库中创建schema

通过客户端连接上刚启动的数据库容器,添加一个名为gateway的schema。应用启动时会自动在这个schema里面创建数据表。

4.3 修改应用的数据库配置

spring.datasource.url中的端口号32800,与步骤4.1中-p参数指定的值保持一致。
spring.datasource.url中的schema名称gateway,与步骤4.2中添加的schema名称保持一致。
spring.datasource.password的值my-secret-pw,与步骤4.1中MYSQL_ROOT_PASSWORD参数指定的值保持一致。

$ cd gateway/
$ vi src/main/resources/config/application-dev.yml
# 修改数据库连接相关配置
spring:
    datasource:
        url: jdbc:mysql://localhost:32800/gateway?useUnicode=true&characterEncoding=utf8&useSSL=false
        username: root
        password: my-secret-pw

5 构建和启动

5.1 构建

进入gateway目录,输入命令后回车:

$ cd gateway/
$ mvn -Pdev package

如果一切正常,命令行会输出构建成功信息:

img_7445f8e86a436f417a8143bf94dd6708.png

5.2 启动

进入gateway目录,输入命令后回车:

$ nohup ./target/gateway-0.0.1-SNAPSHOT.war &

通过tail命令,查看启动日志:

$ tail -f nohup.out

如果一切正常,日志会输出启动成功信息:

img_905d6cf65fdd0aa6b91e3fa8fb89eb8a.png

5.3 注册到JHipster Registry

启动完成后,可以通过浏览器访问http://192.168.220.120:8761,登录名和密码默认都是admin

img_eabcdfd14a97da47627805cbfd26b7ff.png

可以看到在Instances Registered区域,gateway已经注册。

6 访问网关微服务UI

6.1 访问首页

通过浏览器访问http://192.168.220.120:8080,进入网关微服务的首页:

img_9b398d63778f2ee74bc0f4b51d9b491c.png

点击右上角账号 - 登录, 默认用户名和密码都是admin

6.2 实体页面

登录之后可以看到页头上的菜单,数据菜单下就是所有实体的操作页面,这里能看到生成的实体role的子菜单:

img_0d8f51d289c8dcad724d25254d2d973e.png

点击role子菜单,进入role实体的操作页面,这里已经生成了基本的增删改查功能,如果需要更多功能,就要定制开发了:

img_dac2a9f06a0f0955ffa0c789f056cf6d.png

6.3 管理页面

这里包括了如下功能页面:

  • 网关
  • 用户管理
  • 资源监控
  • 服务状态
  • 配置
  • 审核
  • 日志
  • API

img_f6f8ea5e7e47c5db4845cdfc23106ce1.png

页面功能都很直观,点进去看一看就知道了。

6.4 语言页面

这里就是国际化支持的页面,生成工程代码时选择了哪些语言,这里就会提供哪些语言的子菜单:

img_2d9d247765385d0b8077acc2b408bcd1.png

系列文章

JHipster生成微服务架构的应用栈(一)- 准备工作
JHipster生成微服务架构的应用栈(二)- 认证微服务示例
JHipster生成微服务架构的应用栈(三)- 业务微服务示例
JHipster生成微服务架构的应用栈(四)- 网关微服务示例
JHipster生成微服务架构的应用栈(五)- 容器编排示例




你现在的气质里,藏着你走过的路,读过的书,爱过的人。


相关实践学习
基于CentOS快速搭建LAMP环境
本教程介绍如何搭建LAMP环境,其中LAMP分别代表Linux、Apache、MySQL和PHP。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助     相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
目录
相关文章
|
3天前
|
负载均衡 测试技术 持续交付
高效后端开发实践:构建可扩展的微服务架构
在当今快速发展的互联网时代,后端开发扮演着至关重要的角色。本文将重点探讨如何构建可扩展的微服务架构,以及在后端开发中提高效率的一些实践方法。通过合理的架构设计和技术选型,我们可以更好地应对日益复杂的业务需求,实现高效可靠的后端系统。
|
3天前
|
监控 持续交付 API
构建高效可扩展的微服务架构
在当今快速迭代和竞争激烈的软件市场中,构建一个高效、可扩展且易于维护的后端系统变得尤为重要。微服务架构作为一种流行的分布式系统设计方式,允许开发者将应用程序划分为一系列小型、自治的服务,每个服务负责执行特定的业务功能。本文将探讨如何利用现代技术栈搭建一个符合这些要求的微服务架构,并讨论其潜在的挑战与解决方案。我们将涵盖服务划分策略、容器化、服务发现、API网关、持续集成/持续部署(CI/CD)以及监控和日志管理等关键主题,以帮助读者构建出既可靠又灵活的后端系统。
|
4天前
|
消息中间件 敏捷开发 运维
构建高效可靠的微服务架构:策略与实践
随着现代软件开发的复杂性增加,微服务架构逐渐成为企业解决大型应用系统分解、敏捷开发和持续部署问题的有效手段。本文深入探讨了构建一个高效且可靠的微服务架构的关键策略,包括服务的合理划分、通信机制的选择、数据一致性保障以及容错处理。通过分析这些策略在具体案例中的应用,我们旨在为开发者提供一套可行的微服务设计及实施指南。
110 6
|
4天前
|
API 持续交付 开发者
构建高效微服务架构:后端开发的新范式
在数字化转型和技术迭代的浪潮中,微服务架构以其灵活性、可扩展性和独立性成为现代后端开发的重要趋势。本文深入探讨了构建高效微服务架构的关键要素,包括服务划分策略、容器化部署、API网关设计以及持续集成与持续部署(CI/CD)的实践。通过分析这些组件和流程,我们旨在为后端开发者提供一套实用的指南,帮助他们构建和维护一个高性能、可靠的微服务系统。
20 5
|
5天前
|
监控 Kubernetes 持续交付
构建高效可扩展的微服务架构:后端开发实践指南
在数字化转型的浪潮中,企业对软件系统的要求日益提高,追求快速响应市场变化、持续交付价值成为核心竞争力。微服务架构以其灵活性、模块化和独立部署的特点,成为解决复杂系统问题的有效途径。本文将深入探讨如何构建一个高效且可扩展的微服务架构,涵盖关键设计原则、技术选型及实践案例,为后端开发者提供一条清晰的指导路线,帮助其在不断变化的技术环境中保持竞争力。
112 3
|
8天前
|
存储 JSON 监控
构建高效微服务架构:后端开发的新趋势
【2月更文挑战第29天】在软件开发的世界中,微服务架构已经成为一种流行且有效的方式来组织和部署应用程序。这种架构模式通过将大型、复杂的应用拆分成一系列小型、自治的服务来提供灵活性和可扩展性。本文将探讨微服务的核心概念,包括其定义、优势、挑战以及如何在现代后端开发中实施微服务架构。我们将通过具体案例分析微服务的实施策略,并讨论如何克服常见的技术障碍,以实现一个高效、可维护的系统。
|
4天前
|
监控 数据管理 API
构建高效微服务架构:后端开发的新趋势
在现代软件开发领域,随着业务需求的不断复杂化以及敏捷迭代的加速,传统的单体应用架构逐渐暴露出其局限性。微服务架构作为一种新的解决方案,以其高度模块化、独立部署和可扩展性,正成为后端开发领域的新趋势。本文将探讨微服务架构的核心概念,分析其优势与面临的挑战,并提供实施高效微服务的策略和最佳实践,帮助读者理解如何利用这一架构模式提升系统的可靠性、灵活性和可维护性。
115 5
|
7天前
|
人工智能 运维 监控
构建高性能微服务架构:现代后端开发的挑战与策略构建高效自动化运维系统的关键策略
【2月更文挑战第30天】 随着企业应用的复杂性增加,传统的单体应用架构已经难以满足快速迭代和高可用性的需求。微服务架构作为解决方案,以其服务的细粒度、独立性和弹性而受到青睐。本文将深入探讨如何构建一个高性能的微服务系统,包括关键的设计原则、常用的技术栈选择以及性能优化的最佳实践。我们将分析微服务在处理分布式事务、数据一致性以及服务发现等方面的挑战,并提出相应的解决策略。通过实例分析和案例研究,我们的目标是为后端开发人员提供一套实用的指南,帮助他们构建出既能快速响应市场变化,又能保持高效率和稳定性的微服务系统。 【2月更文挑战第30天】随着信息技术的飞速发展,企业对于信息系统的稳定性和效率要求
|
7天前
|
消息中间件 监控 开发者
构建高效微服务架构:后端开发的新趋势
【2月更文挑战第30天】 在现代软件开发领域,微服务架构已成为实现可扩展、灵活且容错的系统的首选设计。本文深入探讨了构建高效微服务架构的关键步骤和最佳实践,涵盖了从服务划分到部署管理的全过程。我们不仅将分析微服务的优势与挑战,还将提供具体的技术建议和解决方案,以帮助后端开发者有效地构建和优化其系统结构。
|
4天前
|
消息中间件 缓存 API
微服务架构下的API网关性能优化实践
在现代的软件开发中,微服务架构因其灵活性和可扩展性被广泛采用。随着服务的细分与增多,API网关作为微服务架构中的关键组件,承担着请求路由、负载均衡、权限校验等重要职责。然而,随着流量的增长和业务复杂度的提升,API网关很容易成为性能瓶颈。本文将深入探讨API网关在微服务环境中的性能优化策略,包括缓存机制、连接池管理、异步处理等方面的具体实现,旨在为开发者提供实用的性能提升指导。

相关产品

  • 微服务引擎
  • 服务网格