API 網關 Kong

時間 2020-05-17

標籤 api 網關 kong 简体版

原文原文鏈接

什麼是 API 網關？

所謂網關，主要做用就是鏈接兩個不一樣網絡的設備，而今天所講的 API 網關是指承接和分發客戶端全部請求的網關層。html

爲何須要網關層？最初是單體服務時，客戶端發起的全部請求均可以直接請求到該服務，但隨着產品用戶愈來愈多，單體應用存在顯而易見的單點問題，除此以外，當單體應用大小升至幾個 G 時，持續發佈將會很是緩慢，因此服務的拆分紅爲了必然趨勢。nginx

當服務拆分爲多個以後，咱們不得不面臨一個問題，就是如何控制用戶請求到對應服務節點，因而網關層應運而生，它不只能夠負責負載均衡，還可讓它處理認證校驗、請求限流、日誌記錄以及監控服務節點等等。git

固然，網關層並不須要咱們手動實現，市面上有不少 API 網關開源項目，好比 Zuul、Kong、Tyk 等，今天主要介紹 Kong。github

安裝 Kong

Kong 是一個在 Nginx 中運行的 Lua 程序，由 lua-nginx-module 實現，和 Openresty 一塊兒打包發行，支持多種操做環境下的安裝，能夠用來作 HTTP 基本認證、密鑰認證、TCP、UDP、文件日誌、API 請求限流、請求轉發等等。docker

第一步，建立一個 docker 網絡。數據庫

$ docker network create kong-net

建立用於存儲 Kong 數據的數據庫，可使用 Cassandra 或 PostgreSQL，本示例採用 Cassandra。json

Cassandra 是由 Facebook 開發的分佈式 NoSQL 數據庫。bootstrap

$ docker run -d --name kong-database \
               --network=kong-net \
               -p 9042:9042 \
               cassandra:3

初始化數據到 Cassandra 數據庫。api

$ docker run --rm \
	--network=kong-net \
	-e "KONG_DATABASE=cassandra" \
	-e "KONG_PG_HOST=kong-database" \
	-e "KONG_PG_PASSWORD=kong" \
	-e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
	kong:latest kong migrations bootstrap

啓動 Kong 容器鏈接數據庫。bash

$ docker run -d --name kong \
     --network=kong-net \
     -e "KONG_DATABASE=cassandra" \
     -e "KONG_PG_HOST=kong-database" \
     -e "KONG_PG_PASSWORD=kong" \
     -e "KONG_CASSANDRA_CONTACT_POINTS=kong-database" \
     -e "KONG_PROXY_ACCESS_LOG=/dev/stdout" \
     -e "KONG_ADMIN_ACCESS_LOG=/dev/stdout" \
     -e "KONG_PROXY_ERROR_LOG=/dev/stderr" \
     -e "KONG_ADMIN_ERROR_LOG=/dev/stderr" \
     -e "KONG_ADMIN_LISTEN=0.0.0.0:8001, 0.0.0.0:8444 ssl" \
     -p 8000:8000 \
     -p 8443:8443 \
     -p 0.0.0.0:8001:8001 \
     -p 0.0.0.0:8444:8444 \
     kong:latest

經過 curl 模擬請求本地 8001 端口能夠獲取 Kong 的詳細信息。截止目前整個 kong 服務就跑起來了，接下來能夠註冊服務節點到 kong 中。

$ curl -i http://localhost:8001/

註冊服務

註冊名爲 baidu-service 的服務到 kong，若是請求匹配到該服務會跳轉至 url。

$ curl -i -X POST \
  --url http://localhost:8001/services/ \
  --data 'name=baidu-service' \
  --data 'url=http://baidu.com'

註冊成功以後會獲得以下提示。

HTTP/1.1 201 Created
Date: Sat, 16 May 2020 06:35:56 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
Server: kong/2.0.4
Content-Length: 292
X-Kong-Admin-Latency: 103

{"host":"baidu.com","created_at":1589610956,"connect_timeout":60000,"id":"6660aaa7-5afa-4f02-85f8-11dfb81fba84","protocol":"http","name":"baidu-service","read_timeout":60000,"port":80,"path":null,"updated_at":1589610956,"retries":5,"write_timeout":60000,"tags":null,"client_certificate":null}

服務配置路由

服務添加成功後，須要告知 kong 什麼樣的請求才使用該服務，而這個規則被稱爲 route，也就是路由，路由的做用是按規則匹配客戶端的請求，而後轉發到對應的 service，每一個 route 都對應一個 service，一個 service 可能有多個 route。

$ curl -i -X POST \
  --url http://localhost:8001/services/baidu-service/routes \
  --data 'hosts[]=baidu.com'

以上代碼的做用是當請求域名是 baidu.com 時，則將請求轉發到 baidu-service 指定的 url，咱們能夠經過 curl 模擬測試。

$ curl -i -X GET \
  --url http://localhost:8000/ \
  --header 'Host: baidu.com'

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Content-Length: 81
Connection: keep-alive
Date: Sat, 16 May 2020 06:45:12 GMT
Server: Apache
Last-Modified: Tue, 12 Jan 2010 13:48:00 GMT
ETag: "51-47cf7e6ee8400"
Accept-Ranges: bytes
Cache-Control: max-age=86400
Expires: Sun, 17 May 2020 06:45:12 GMT
X-Kong-Upstream-Latency: 92
X-Kong-Proxy-Latency: 17
Via: kong/2.0.4

<html>
<meta http-equiv="refresh" content="0;url=http://www.baidu.com/">
</html>

負載均衡配置

與 nginx 同理，先建立一個 upstream，名爲 hello。

$ curl -X POST http://localhost:8001/upstreams --data "name=hello"

{"created_at":1589633009,"hash_on":"none","id":"3bab80bb-7e62-40c8-8b7c-7efdcc329675","algorithm":"round-robin","name":"hello","tags":null,"hash_fallback_header":null,"hash_fallback":"none","hash_on_cookie":null,"host_header":null,"hash_on_cookie_path":"\/","healthchecks":{"threshold":0,"active":{"https_verify_certificate":true,"type":"http","http_path":"\/","timeout":1,"unhealthy":{"http_statuses":[429,404,500,501,502,503,504,505],"tcp_failures":0,"timeouts":0,"http_failures":0,"interval":0},"healthy":{"http_statuses":[200,302],"interval":0,"successes":0},"https_sni":null,"concurrency":10},"passive":{"unhealthy":{"http_failures":0,"http_statuses":[429,500,503],"tcp_failures":0,"timeouts":0},"healthy":{"http_statuses":[200,201,202,203,204,205,206,207,208,226,300,301,302,303,304,305,306,307,308],"successes":0},"type":"http"}},"hash_on_header":null,"slots":10000}

爲 upstream 添加兩個負載均衡的節點，我就拿京東和淘寶來作測試了。

curl -X POST http://localhost:8001/upstreams/hello/targets --data "target=jd.com" --data "weight=100"
curl -X POST http://localhost:8001/upstreams/hello/targets --data "target=taobao.com" --data "weight=50"

如上配置就至關於 nginx 中的

upstream hello {
	server jd.com weight=100;
	server taobao.com weight=50;
}

接下來建立一個 service 指向 upstream，host 即對應 upstream 名。

curl -X POST http://localhost:8001/services --data "name=hello" --data "host=hello"

爲 service 建立路由，凡是包含 /hello 的地址所有走 hello upstream。

curl -i -X POST --url http://localhost:8001/services/hello/routes --data 'paths[]=/hello'
curl -X POST --url http://localhost:8001/routes --data 'paths[]=/hello' --data 'service.id=8ad06aa5-be0a-4763-a84d-90b8046765f5'

如今訪問 localhost:8000 就能夠看到已經成功作了負載均衡。

限流

由於服務器不能處理無限量的請求，爲了不請求數高到服務器沒法處理，必須作限流操做。關於限流，kong 使用了 rate-limiting 插件，它能夠在 service、route、consumer 不一樣粒度上控制請求，配置很是簡單。

curl -X POST http://kong:8001/services/{service}/plugins \
    --data "name=rate-limiting"
    --data "config.second=5" \
    --data "config.hour=10000"

config.second 表明一秒鐘內處理的最大請求次數，config.hour 表示一小時內最大請求次數。

Route 的示例

curl -X POST http://kong:8001/routes/{route}/plugins \
    --data "name=rate-limiting"
    --data "config.second=5" \
    --data "config.hour=10000"

Consumer 的示例

curl -X POST http://kong:8001/consumers/{consumer}/plugins \
    --data "name=rate-limiting-advanced" \
    --data "config.second=5" \
    --data "config.hour=10000"

原文首發：https://pingyeaa.com/2020/05/16/architecture/gateway-kong/

我是平也，這有一個專一Gopher技術成長的開源項目「go home」

感謝你們的觀看，若是以爲文章對你有所幫助，歡迎關注公衆號「平也」，聚焦Go語言與技術原理。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。