思享工具箱

AG-Admin微服务框架入门

摘要：
AG Admin基于SpringCloud微服务开发平台，拥有统一的授权和认证微服务云框架。它包括服务注册和发现、用户管理、资源权限管理、网关API管理等多个模块，支持多个业务系统的并行开发，是一个完整的微服务脚手架开发框架。AG admin采用前端和后端分离架构。前端基于vue-Admin元素框架。项目地址为：https://github.com/PanJiaChen/vue-element-admin2.基本安装1.下载并安装git。熟悉git的使用，因为现有的开源项目都在git开源中国或github中。因为AGAdmin前端是一个基于vue-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盘根目录。

 AG-Admin微服务框架入门第1张

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弄到自己家里来

克隆到本地

  AG-Admin微服务框架入门第2张

3.2 AG-Admin组成结构

使用idea打开

 AG-Admin微服务框架入门第3张

在这里先认识一下API网关就可以了，API网关是所有服务对外暴露API接口的唯一有效入口，也就是前端访问后台都是走API网关就可以了，至于API网关具体怎么回事先不要捉急去深究。其他没有标注的暂时不用去关心，我们先入门，别急。

3.3 安装Rabbit MQ

1)由于Rabbit MQ是基于erlang因此先把erlang装上，下载地址

http://www.erlang.org/downloads

安装完成之后创建一个名为ERLANG_HOME的环境变量，其值指向erlang的安装目录，同时将%ERLANG_HOME%in加入到Path中

 AG-Admin微服务框架入门第4张

 AG-Admin微服务框架入门第5张

进入cmd输入：erl出现下图说明安装配置ok，如果不行请检查上行步骤

 AG-Admin微服务框架入门第6张

下载安装Rabbit MQ，地址：http://www.rabbitmq.com/download.html

 AG-Admin微服务框架入门第7张

AG-Admin微服务框架入门第8张

默认安装的RabbitMQ 监听端口是5672,默认用户名：guest，密码：guest。

2)、RabbitMQ-Plugins插件安装

这个插件相当于是一个管理界面，方便我们在浏览器界面查看RabbitMQ各个消息队列以及exchange的工作情况，安装方法是：打开命令行cd进入rabbitmq的sbin目录(我的目录是：C:Program FilesRabbitMQ Server abbitmq_server-3.7.2sbin)，输入：

rabbitmq-plugins enable rabbitmq_management

命令，稍等会会发现出现plugins安装成功的提示

 AG-Admin微服务框架入门第9张

然后重启服务，使用命令(此时最后以管理员运行CMD)：

net stop RabbitMQ && net start RabbitMQ

AG-Admin微服务框架入门第10张

插件安装完之后，在浏览器输入http://localhost:15672进行验证
 AG-Admin微服务框架入门第11张
3.4 安装redies
地址：https://github.com/MSOpenTech/redis/releases
 AG-Admin微服务框架入门第12张
启动resies-server
 AG-Admin微服务框架入门第13张
AG-Admin微服务框架入门第14张
3.5 数据库
分别执行ace-admin/db/init.sql、ace-auth-server/db/init.sql 这两个脚本，执行成功之后，会创建ag_admin_v1和ag_auth_v1两个数据库以及以下一些表:
 AG-Admin微服务框架入门第15张
配置hosts文件
进入：C:WindowsSystem32driversetc
将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这两个配置文件中连接数据库的一些信息:
 AG-Admin微服务框架入门第16张
同时注意Rabbit MQ链接配置检查一遍
 AG-Admin微服务框架入门第17张
修改项目里所有的defaultZone参数，他默认用的是docker，但是我们是这本地开发的，所以改成本地的
 AG-Admin微服务框架入门第18张
3.7 启动
1)启动ace-center，是注册发现服务他是所有服务的中心
 AG-Admin微服务框架入门第19张
2)启动ace-auth，是认证中心
 AG-Admin微服务框架入门第20张
3)启动ace-admin，他在ace-modules下面是指向ag_admin_v1数据库的基础数据服务
 AG-Admin微服务框架入门第21张
4)启动ace-gate,网关
 AG-Admin微服务框架入门第22张
5)启动前端项目，AG-Admin-v2.0
找到该目录下将base_api地址 修改为：http://localhost:8104
 AG-Admin微服务框架入门第23张
取消如图文件的注释保存
 AG-Admin微服务框架入门第24张
在cmd中进入项目目录：我的是E:gitvueAG-Admin-v2.0
输入：npm install --registry=https://registry.npm.taobao.org
如果已经安装了cnpm，则直接输入cnpm install
 AG-Admin微服务框架入门第25张
等待安装完成后输入npm run dev即可在浏览器打开：localhost:9527
如果是非H5浏览器请下载使用chrome浏览器然后把地址粘贴过来
 AG-Admin微服务框架入门第26张
使用postman登录
 AG-Admin微服务框架入门第27张
 四 常见问题FAQ 
4.1 ace-auth，或者ace-admin启动过程中控制台有异常输出，控制台输出非mysql连接错误。或者一些类找不到
这个应该是spring cloud版本问题，请将自己maven本地仓库下所有文件删除，C:UsersAdministrator.m2
 AG-Admin微服务框架入门第28张
然后在ag-admin下面找到pom.xml随便修改一下内容，然后等到ideam提示导入修改，然后再次撤销刚才的修改，再次应用修改，这样做的目的是为了让maven再次下载spring cloud全部依赖，这个过程可能需要等待个10多分钟，等再次下载完成然后按照启动顺序启动。
 AG-Admin微服务框架入门第29张
 AG-Admin微服务框架入门第30张
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里面的超时设置单位为微秒
 AG-Admin微服务框架入门第31张
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
 
 
 标签：#localhost#header | 浏览：343 | 发布日期：
免责声明：文章转载自《AG-Admin微服务框架入门》仅用于学习参考。如对内容有疑问，请及时联系本站处理。 
上篇状态机设计——从简单的按键消抖开始Perl之哈希与列表下篇
宿迁高防，2C2G15M，22元/月；香港BGP，2C5G5M，25元/月 雨云优惠码：MjYwNzM=
 相关文章 
Zookeeper权限控制
Zookeeper提供了ACL（Access Control List）权限控制。 使用权限控制，可以控制节点的操作权限，保证安全性。 权限设置：将权限模式、授权对象、权限信息组成一条"scheme:id:permission"格式的ACL请求信息。 权限模式（Scheme）： 　　1）World模式，默认的，任何人可以对zk上任意节点操作 　　2）IP模...
spring-cloud之服务治理组件Eureka
前言 前几天我们分享了webflux的相关知识点，由于越分享发现内容越多，所以webflux的相关知识就先告一段落，但是就目前分享的内容来说，已经足够让我们对webflux有一个最近基本的认识，至于其他内容，我们后期继续分享。 昨天天太热了，不在状态，也脉动不回来，所以也就没有分享新的东西。 今天也热，感觉像进了烤箱一样，但是学习还是不能太懈怠，该坚持的不...
host头攻击
一、问题源起 　　HTTP1.1规范中在增加了HOST头信息，用于存储服务端与客户端的路由信息。 　　例如： 　　　　Request的Header里就有一个标名请求，它是用来记录服务端网站域名的。 　　　　如果前端或者后台正好用到这个值，比如jsp的 　　　　　　String basePath = request.getScheme()+"://"+req...
elementui 在表格表头里面添加按钮
在表格表头里面添加按钮  在列中动态绑定 :render-header，             <el-table-column align='center'                 prop="dataSource"                 label="数据源"                 width="200" :re...
Vue上拉加载下拉刷新---vue-easyrefresh
vue-easyrefresh简介 正如名字一样，EasyRefresh很容易就能在基于Vue的Web应用上实现下拉刷新以及上拉加载操作，支持主流的PC和移动浏览器。它的功能灵感来源于与Android的SmartRefreshLayout，同样也吸取了很多三方库的优点。EasyRefresh中集成了多种风格的Header和Footer，但是它并没有局限性，...
mac-git-将云端文件pull到本地
云端新增加了一个文件，本地只有一个2.text  将云端pull到本地： (base) localhost:Merge_Conflict ligaijiang$ git log #查看git日志 commit f169235a4423fe33c690949937136bc2b0abf26b (HEAD -> master, origin/mast...
最新文章
随机推荐
 思享工具箱导航