AG-Admin微服务框架入门
AG-Admin微服务框架入门
@qq群：一群： 837736451 二群 169824183
一 概要介绍
AG-Admin后台地址：https://gitee.com/minull/ace-security
AG-Admin前端地址：https://gitee.com/minull/AG-Admin-v2.0
要想玩儿转spring cloud必须进行一大波儿的学习哦,先有个心理准备。
AG-Admin基于Spring Cloud微服务化开发平台，具有统一授权、认证微服务云框架。其中包含了服务注册与发现、用户管理、资源权限管理、网关API管理等多个模块，支持多业务系统并行开发，是一个完整的微服务脚手架开发框架。
AG-Admin采用前后端分离架构，前端基于vue-admin-element框架,项目地址：https://github.com/PanJiaChen/vue-element-admin
二 基础安装
1 下载安装git
对git必要的熟练使用，因为现有的开源项目都是在git开源中国或者github上。你应具有熟练的项目拉取，提交代码能力。说了那么多来一个简单的教程：https://backlog.com/git-tutorial/cn/
2 下载安装idea
请使用IDEA集成工具开发Spring应用，什么eclipse，myeclipse还是别了，来一个IDEA安装教程
https://blog.csdn.net/yangying496875002/article/details/73603303
3 下载安装Maven，
安装教程
https://www.cnblogs.com/yyiou/archive/2017/08/22/7411409.html
想进一步了解Maven：
https://www.cnblogs.com/rjjs/p/9339632.html
4 下载安装nodejs
你应对前端框架Vue有所了解，或者对前端三大框架react，angular，vue任意一个框架有所了解，或者最低要求能够对nodejs有所了解。因为AG-Admin前端是基于vue的vue-admin-element一个 开源项目。来一个nodejs的入门教程：
https://www.cnblogs.com/zhouyu2017/p/6485265.html
5 下载并配置nginx
首先去Nginx官网下载一个最新版本的Nginx，下载地址：http://nginx.org/en/download.html。我这里下载的版本是：nginx/Windows-1.11.6。下载完成之后，得到一个.zip的压缩包，把压缩包解压到D盘根目录。
1) 修改配置文件。打开“conf”文件夹下的“nginx.conf”文件，使用如下配置全部覆盖
#user nobody;
worker_processes 1;
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
#pid logs/nginx.pid;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
#log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';
#access_log logs/access.log main;
sendfile on;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65;#长连接超时时间，单位秒
#gzip on;#启用Gzip压缩
server{
listen 8104;#监听8020端口，可以改成其他端口
server_name localhost;#当前服务的域名
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
if ($request_method = 'OPTIONS') {
add_header 'Access-Control-Allow-Origin' 'http://localhost:9527';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Credentials' 'true';
#
# Custom headers and headers various browsers *should* be OK with but aren't
#
add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization';
#
# Tell client that this pre-flight info is valid for 20 days
#
return 204;
}
proxy_pass http://localhost:8765;
proxy_redirect default;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_cookie_path /nginx/ /;
proxy_set_header Cookie $http_cookie;
proxy_cookie_domain domino.server localhost;
include uwsgi_params;
add_header 'Access-Control-Allow-Origin' 'http://localhost:9527';
add_header 'Access-Control-Allow-Credentials' 'true';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type';
}
}
}
2)打开命令行，定位到Nginx当前目录，使用“start nginx”命令启动nginx
6了解Spring boot
因为Ag-Admin是基于Spring Cloud，而Spring Cloud是基于Spring boot，因此他是基础你必须有所了解。
来一个简单的教程：
https://www.cnblogs.com/black-spike/p/8017768.html
三 启动AG-Admin
3.1 把AG-Admin弄到自己家里来
克隆到本地
3.2 AG-Admin组成结构
使用idea打开
在这里先认识一下API网关就可以了，API网关是所有服务对外暴露API接口的唯一有效入口，也就是前端访问后台都是走API网关就可以了，至于API网关具体怎么回事先不要捉急去深究。其他没有标注的暂时不用去关心，我们先入门，别急。
3.3 安装Rabbit MQ
1)由于Rabbit MQ是基于erlang因此先把erlang装上，下载地址
http://www.erlang.org/downloads
安装完成之后创建一个名为ERLANG_HOME的环境变量，其值指向erlang的安装目录，同时将%ERLANG_HOME%\bin加入到Path中
进入cmd输入：erl出现下图说明安装配置ok，如果不行请检查上行步骤
下载安装Rabbit MQ，地址：http://www.rabbitmq.com/download.html
默认安装的RabbitMQ 监听端口是5672,默认用户名：guest，密码：guest。
2)、RabbitMQ-Plugins插件安装
这个插件相当于是一个管理界面，方便我们在浏览器界面查看RabbitMQ各个消息队列以及exchange的工作情况，安装方法是：打开命令行cd进入rabbitmq的sbin目录(我的目录是：C:\Program Files\RabbitMQ Server\rabbitmq_server-3.7.2\sbin)，输入：
rabbitmq-plugins enable rabbitmq_management
命令，稍等会会发现出现plugins安装成功的提示
然后重启服务，使用命令(此时最后以管理员运行CMD)：
net stop RabbitMQ && net start RabbitMQ
插件安装完之后，在浏览器输入http://localhost:15672进行验证
3.4 安装redies
地址：https://github.com/MSOpenTech/redis/releases
启动resies-server
3.5 数据库
分别执行ace-admin/db/init.sql、ace-auth-server/db/init.sql 这两个脚本，执行成功之后，会创建ag_admin_v1和ag_auth_v1两个数据库以及以下一些表:
配置hosts文件
进入：C:\Windows\System32\drivers\etc
将hosts拷贝到桌面然后使用记事本打开，加入以下2句，保存将后将桌面上的hosts文件复制，到原来系统路径下的hosts粘贴覆盖
127.0.0.1 ace-admin
127.0.0.1 ACE-ADMIN
3.6 修改配置
修改ace-admin/src/main/resources/application.yml、ace-auth/src/main/resources/application.yml这两个配置文件中连接数据库的一些信息:
同时注意Rabbit MQ链接配置检查一遍
修改项目里所有的defaultZone参数，他默认用的是docker，但是我们是这本地开发的，所以改成本地的
3.7 启动
1)启动ace-center，是注册发现服务他是所有服务的中心
2)启动ace-auth，是认证中心
3)启动ace-admin，他在ace-modules下面是指向ag_admin_v1数据库的基础数据服务
4)启动ace-gate,网关
5)启动前端项目，AG-Admin-v2.0
找到该目录下将base_api地址 修改为：http://localhost:8104
取消如图文件的注释保存
在cmd中进入项目目录：我的是E:\git\vue\AG-Admin-v2.0
输入：npm install --registry=https://registry.npm.taobao.org
如果已经安装了cnpm，则直接输入cnpm install
等待安装完成后输入npm run dev即可在浏览器打开：localhost:9527
如果是非H5浏览器请下载使用chrome浏览器然后把地址粘贴过来
使用postman登录
四 常见问题FAQ
4.1 ace-auth，或者ace-admin启动过程中控制台有异常输出，控制台输出非mysql连接错误。或者一些类找不到
这个应该是spring cloud版本问题，请将自己maven本地仓库下所有文件删除，C:\Users\Administrator\.m2
然后在ag-admin下面找到pom.xml随便修改一下内容，然后等到ideam提示导入修改，然后再次撤销刚才的修改，再次应用修改，这样做的目的是为了让maven再次下载spring cloud全部依赖，这个过程可能需要等待个10多分钟，等再次下载完成然后按照启动顺序启动。
4.2 提示数据库datasource异常
请检查各自项目下的application.yml文件中的mysql配置是否正确
4.3 提示mq连接异常
请检查application.yml文件中mq配置是否正确，可以通过http://localhost:15672/，guest,guest查看mq能否可以用
4.4 提示redies连接异常
请检查application.yml文件中redies配置是否正确，或者redies是否启动
4.5 登录过程中提示ace-admin相关连接超时
首先应检查ace-admin启动过程中控制台有无异常输出，如果异常输出请检查是否属于上面的问题，如果不是可以尝试修改application.yml里面的超时设置单位为微秒
4.6 ace-gate 部署后运行报找不到main类异常
这个是因为ace-gate的maven配置没有加入spring boot的缘故因此在pom.xml加入一下配置重新编译 部署。
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
<kotlin.version>1.1.51</kotlin.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<dependency>
<groupId>org.isomorphism</groupId>
<artifactId>token-bucket</artifactId>
<version>1.7</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.projectreactor</groupId>
<artifactId>reactor-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.assertj</groupId>
<artifactId>assertj-core</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-stdlib</artifactId>
<version>${kotlin.version}</version>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-reflect</artifactId>
<version>${kotlin.version}</version>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-netflix-hystrix</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-sleuth-zipkin</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.amqp</groupId>
<artifactId>spring-rabbit</artifactId>
</dependency>
<dependency>
<groupId>com.github.wxiaoqi</groupId>
<artifactId>ace-interface</artifactId>
<version>2.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.github.wxiaoqi</groupId>
<artifactId>ace-auth-client</artifactId>
<version>2.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.github.wxiaoqi</groupId>
<artifactId>ace-common</artifactId>
<version>2.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>5.0.4.RELEASE</version>
</dependency>
</dependencies>
<build>
<finalName>ace-gate</finalName>
<plugins>
<!-- 此插件用来生成通用mapper的代码 -->
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.2</version>
<configuration>
<configurationFile>${basedir}/src/main/resources/builder/generatorConfig.xml</configurationFile>
<overwrite>true</overwrite>
<verbose>true</verbose>
</configuration>
<dependencies>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.30</version>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>tk.mybatis</groupId>
<artifactId>mapper</artifactId>
<version>${mapper.version}</version>
</dependency>
</dependencies>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
五 更多交流
@qq群：一群： 837736451 二群 169824183
