让各位久等了，经过将近两个月的设计开发，Apinto Dashboard V1.0 Beta版本于2022年6月19日正式发布🎉🎉。

此次发布的Apinto Dashboard是开源网关Apinto 的衍生项目，它为Apinto提供了可视化配置界面。

从此，我们将告别繁复的命令行curl命令，只需要在ui界面轻轻一点，就可以自动生成配置，上手成本极低。我们可以快速将后端接口托管到网关中，并可以配置鉴权、流控等安全性操作，用Apinto构建安全可靠的服务Api。

特性

通过UI界面动态更新Apinto网关配置

动态加载模版，根据需要开启/隐藏相关界面

修改文件config.yml的professions配置，即可在侧边栏中隐藏/显示

配置信息：

导航栏：

Json Scheme交互，自动渲染界面，约束配置数据

交互数据如下：

界面渲染：

提供丰富的操作日志，监控配置变更记录

在Dashboard的所有都会记录在操作日志列表中，点击详情可以看到相关操作涉及的数据改动详情。我们也可以通过搜索功能，查找某个时间段的记录，这样我们以后排查问题的时候也能判断是否有非法操作。

友好的操作体验，自动获取流程依赖

Dashboard提供友好的操作体验，在我们配置插件的时候，可以自行选择直接输入完整json配置，也可以选择使用UI配置，配置完成后，json部分将自动同步，ui也是页面也是根据json-scheme语法自动生成。

以后开发apinto的模块或者拓展时，只需要定义好配置的类型、label、最大值最小值等相关限制，就可自动生成页面。

整个操作也是联动的，比如我们现在需要为路由新增一个鉴权，此时，只要在路由页面点击增加鉴权插件，然后在选择框里选择相应的鉴权，提交即可，这样，带有鉴权的路由便生成完成。

相信大家已经迫不及待想去试用了，接下来我将给大家介绍下如何部署Apinto Dashboard。

部署

由于Apinto Dashboard 是Apinto 的可视化UI项目，因此在部署该项目前，需要确保Apinto项目已经部署完成。

若未部署Apinto ，请参考教程Apinto部署

1. 下载并解压安装包

wget https://github.com/eolinker/apinto-dashboard/releases/download/v1.0.3-beta/apinto-dashboard-v1.0.3-beta.linux.x64.tar.gz && tar -zxvf apinto-dashboard-v1.0.3-beta.linux.x64.tar.gz && cd apinto-dashboard、

2. 启动程序

nohup ./apinto-dashboard > logs/stdout_apinto-dashboard_"$(date '+%Y%m%d-%H%M%S')".log 2>&1 &

该命令会将日志输出到logs 目录下以stdoutapinto-dashboard 为前缀的日志文件中

3. 浏览器打开Apinto Dashboard 地址

本示例在本地部署，因此ip为127.0.0.1，端口为8081，在浏览器中输入账号密码登录即可

至此，Dashboard部署完毕，如果大家需要了解更多的使用信息，请点击更多

写在最后

• APINO 简介：Apinto是一个基于 Golang 开发的微服务网关，能够实现高性能 HTTP API 转发、多租户管理、API 访问权限控制等目的，拥有强大的自定义插件系统，用户可以自行扩展，能够快速帮助企业进行 API 服务治理、提高 API 服务的稳定性和安全性。接下来我们将提供插件市场，通过Apinto强大的插件拓展能力，用户可像乐高积木一样根据需要自行拓展Apinto的插件，丰富Apinto的能力。

• 官网网址：https://www.apinto.com

• Github 链接：https://github.com/eolinker/apinto

• 论坛地址：https://community.apinto.com/

• 帮助文档：https://help.apinto.com/docs

• QQ群号：725853895

• 微信群二维码：
  

前言

通过开源网关团队的努力，Apinto Ingress Controller将在3月下旬正式推出。

在此之前，Apinto更新配置只能通过Open API的方式更新，且只支持宿主机部署、容器部署，更新配置也相对比较麻烦。

因此，Apinto Ingress Controller的推出意味着我们可以将Apinto部署在Kubernetes中，并且通过配置文件的形式实时更新。

设计

虽然原生 ingress controller 支持在 yaml 中 annotation 定义脚本片段，但更多是为了支持高级功能而实现的一个临时方案，一方面大量的annotation脚本不好管理，不好维护，另一方面，对特性的支持也不太友好。

而Apinto有路由、服务、负载、鉴权、插件等多种类型的资源，需要有更加灵活的方式去定义资源。因此我们选择了编写Kubernetes CRD文件的方式去定义Apinto的资源。

下面为Apinto Router CRD的简单定义：

apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: apintorouters.apinto.com
spec:
  group: apinto.com
  scope: Namespaced
  names:
    plural: apintorouters
    singular: apintorouter
    kind: ApintoRouter
    shortNames:
      - ar
      - router
  versions:
    - name: v1beta
      served: true
      storage: true
      schema:
        openAPIV3Schema:
          type: object
          properties:
            spec:
              type: object
              required: ["name", "listen", "driver", "target", "rules"]
              properties:
                name:
                  type: string
                  minLength: 1
                driver:
                  type: string
                  enum: ["http"]
                listen:
                  type: integer
                  minimum: 1
                  maximum: 65535
                target:
                  type: string
                  pattern: '\w+(@service)$'
                method:
                  type: array
                  items:
                    type: string
                    enum: ["*", "DELETE", "GET", "HEAD", "OPTIONS", "PATCH", "POST", "PUT", "TRACE"]
                host:
                  type: array
                  items:
                    type: string
                    pattern: '[a-zA-Z0-9][-a-zA-Z0-9]{0,62}(\.[a-zA-Z0-9][-a-zA-Z0-9]{0,62})+\.?'
                protocol:
                  type: string
                  enum: ["http","https"]
                cert:
                  type: array
                  items:
                    type: object
                    properties:
                      key:
                        type: string
                        minLength: 1
                      crt:
                        type: string
                        minLength: 1
                rules:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      location:
                        type: string
                        minLength: 1
                      header:
                        type: object
                        x-kubernetes-preserve-unknown-fields: true
                      query:
                        type: object
                        x-kubernetes-preserve-unknown-fields: true
                plugins:
                  type: object
                  x-kubernetes-preserve-unknown-fields: true

架构设计如下：

用户提交YAML文件时，会触发ValidatingWebhook操作，Kubernetes此时会回调定义好的Admission Server地址，Apinto Client将YAML文件配置转换成Apinto Gateway的可读配置，Apinto Gateway会校验配置信息的完整性和可靠性，校验完成后，将结果依次返回，最后返回操作结果给用户。

开始使用

自定义资源的配置顺序与apinto一致，均有依赖关系。

以配置路由以及服务为例：

服务 service.yml

apiVersion: apinto.com/v1beta
kind: ApintoService
metadata:
  name: demo-anonymous
spec:
  name: demo-anonymous
  driver: http
  desc: "示例服务"
  timeout: 30000
  anonymous:
    type: round-robin
    config: "http://demo-apinto.eolink.com:8280" #该接口返回http调用信息
  retry: 2
  rewrite_url: /

路由 router.yml

apiVersion: apinto.com/v1beta
kind: ApintoRouter
metadata:
  name: apinto.router
spec:
  name: apinto.router# 路由名称
  listen: 8080    # 监听端口
  driver: http # 驱动
  protocol: http
  method:
    - GET
  rules:      # 规则列表
    - location: "/demo"  # 匹配路径
  target: demo-anonymous@service    # 目标服务ID，格式为：{服务名称}@service

创建服务和路由

kubectl create -f service.yml
kubectl create -f router.yml

创建完服务以及路由之后，调用apinto暴露到集群外的服务来查看是否存在该路由

curl -X GET 'http://{node_ip}:{admin_port}/api/router/apinto.router'

返回

{
	"create": "2022-03-23 06:14:48",
	"driver": "http",
	"id": "apinto.router@router",
	"listen": 8080,
	"method": ["GET"],
	"name": "apinto.router",
	"profession": "router",
	"protocol": "http",
	"rules": [{
		"location": "/demo"
	}],
	"target": "demo-anonymous@service",
	"update": "2022-03-23 06:14:48"
}

通过调用apinto暴露到集群外的服务来请求该路由

curl -X GET 'http://{node_ip}:{http_port}/demo'

返回

{
	"body": "",
	"header": {
		"Accept": ["*/*"],
		"User-Agent": ["curl/7.75.0"],
		"X-Forwarded-For": ["10.24.1.1,10.24.1.1"]
	},
	"host": "192.2.9.43:31080",  
	"method": "GET",
	"path": "/demo",
	"remote_addr": "192.4.5.22:19091", 
	"url": "/demo"
}

备注：以上的ip数据非原始数据

使用示例点此进行跳转。

写在最后

Apinto是一个基于 Golang 开发的微服务网关，能够实现高性能 HTTP API 转发、多租户管理、API 访问权限控制等目的，拥有强大的自定义插件系统可以自行扩展，能够快速帮助企业进行 API 服务治理、提高 API 服务的稳定性和安全性。

目前Apinto及其周边项目已经开源，我们希望通过Apinto强大的插件拓展能力，用户可像乐高积木一样根据需要自行拓展Apinto的插件，以满足不同的业务市场需求。

这是一个开放和积极的项目，我们诚挚地邀请您一起参与到我们的项目开源工作中。每一个贡献都是有意义的，包括但不限于：

• 查找bugs，取得性能上的提升
• 帮助完善文档，提供用户操作体验
• 提交你们的issue，让我们知道您的奇思妙想
• 参与自定义插件的开发，丰富apinto的能力
• …

期待各位的参与，一起让这个项目变得更好。

联系我们

• 帮助文档：https://help.apinto.com
• QQ群: 725853895
• 官网：https://www.apinto.com
• 论坛：https://community.apinto.com
• Github ：https://github.com/eolinker/apinto
• 微信群：