microgateway 一些参考资料

microgateway 是apigee 开源的自家edgemicro gateway，目前github 上的信息不是很全，以下是一些整理

配置

microgateway 是需要配置管理的，但是github相关文档很少，如果需要参考（合理上网）
https://docs.apigee.com/api-platform/microgateway/edge-microgateway-home，最好还是看下官方文档

• 一个参考配置
  注意此配置部分的plugin 是基于官方的，实际我们如果直接使用microgateway-core，plugin 部分需要调整下

 

edge_config:

  bootstrap: https://apigee.net/edgemicro/bootstrap/organization/org/environment/env...

  jwt_public_key: http://apigee.net/edgemicro/publicKey...

  managementUri: https://api.enterprise.apigee.com

  vaultName: microgateway

  authUri: https://%s-%s.apigee.net/edgemicro-auth

  baseUri: https://edgemicroservices.apigee.net/edgemicro/%s/organization/%s/environment/%s

  bootstrapMessage: Please copy the following property to the edge micro agent config

  keySecretMessage: The following credentials are required to start edge micro

​

edgemicro:

  port: 8000

  max_connections: 1000

  config_change_poll_interval: 600

  logging:

    level: error

    dir: /var/tmp

    stats_log_interval: 60

    rotate_interval: 24

    stack_trace: false

  plugins:

    sequence:

      - oauth

​

headers:

  x-forwarded-for: true

  x-forwarded-host: true

  x-request-id: true

  x-response-time: true

  via: true

​

oauth:

  allowNoAuthorization: false

  allowInvalidAuthorization: false

  gracePeriod: 10

 

 

扩展插件

这个github 上也已经开源了，同时也已经提供了很多，可以直接使用，具体每个插件的配置进入插件目录就可以看了
参考https://github.com/apigee/microgateway-plugins ，如下https://github.com/apigee/microgateway-plugins/tree/master/extauth
readme 就包含了插件的使用，注意有些可能没有，但是插件的模型很简单，看看代码也行，如果看了官方edgemicro的代码，内置插件 
的注册就是类似如下模式注册的

• 一个参考plugin 的使用
  package.json

 

{

  "name": "edge-gayeway",

  "version": "1.0.0",

  "main": "index.js",

  "license": "MIT",

  "dependencies": {

    "config": "^3.3.1",

    "debug": "^4.1.1",

    "microgateway-core": "^3.1.4",

    "microgateway-plugins": "^3.0.14"

  },

  "scripts": {

    "start": "DEBUG=* node app.js"

  }

}

配置
config/default.yaml

 

edgemicro:

  port: 3000

  logging:

    level: warn

proxies:

- base_path: /

  url: http://localhost:8080

 

代码引用plugin

'use strict'

const debug = require('debug')('test')

const microgateway = require('microgateway-core')

// 引用内置的cors plugin

const cors = require("microgateway-plugins/cors")

const config = require('config')

​

const gateway = microgateway(config)

​

debug('starting gateway')

// 添加plugin

gateway.addPlugin("cors",cors.init)

console.log("plugins",gateway.plugins.toString())

gateway.start((err, server) => {

  if (err) {

    debug('gateway err %o', err)

    process.exit(1)

  }

​

  debug('gateway started')

})

说明

目前microgateway文档不是很全，但是整体代码不难，我们可以参考学习下

参考资料

https://www.npmjs.com/package/edgemicro
https://github.com/apigee/microgateway-core