網關服務Kong、Konga搭建記錄

安裝

使用docker-compose安裝是最方便的
在/opt/目錄下創建kong文件夾，然後創建一個docker-compose.yml文件並編輯

cd /opt
mkdir kong
cd kong
vi docker-compose.yml

在docker-compose.yml添加如下配置（20220528親測可用）

version: '3'
services: 
  kong-database:
    image: postgres:9.6
    restart: always  #每次總是啓動
    networks: 
      - kong-net
    environment:
      POSTGRES_USER: kong
      POSTGRES_DB: kong
      POSTGRES_PASSWORD: kong
    ports:
      - "5432:5432"
#######################
# 執行數據庫遷移
######################
  kong-migration:
    image: kong:latest
    command: "kong migrations bootstrap"
    networks: 
      - kong-net
    restart: on-failure
    environment:
      - KONG_DATABASE=postgres
      - KONG_PG_DATABASE=kong
      - KONG_PG_PASSWORD=kong
      - KONG_PG_HOST=kong-database
    links: 
      - kong-database #連接的是kong-database服務的
    depends_on:
      - kong-database #依賴於kong-database服務
#####################
# kong gateway
#####################
  kong:
    image: kong:latest
    restart: always
    networks:
      - kong-net
    environment:
      KONG_DATABASE: postgres
      KONG_PG_HOST: kong-database
      KONG_PG_PASSWORD: kong
      KONG_PROXY_LISTEN: 0.0.0.0:8000          # 代理監聽http
      KONG_PROXY_LISTEN_SSL: 0.0.0.0:8443       # 代理監聽https
      KONG_ADMIN_LISTEN: 0.0.0.0:8001     # Kong的管理API，不可暴露在公網
    depends_on:
      - kong-migration
    links: 
      - kong-database
    healthcheck:
      test: ["CMD", "curl", "-f", "http://kong:8001"]
      interval: 5s
      timeout: 2s
      retries: 15
    ports:
      - "8001:8001"
      - "8000:8000"
      - "8443:8443"
#######################
#以下兩個是konga  GUI
#######################
  konga-prepare:
    image: pantsel/konga:latest
    command: "-c prepare -a postgres -u postgresql://kong:kong@kong-database:5432/konga"  #注意是用戶名：密碼@數據庫服務名稱：端口
    networks:
      - kong-net
    restart: on-failure
    links:
      - kong-database
    depends_on:
      - kong        #依賴kong服務
      - kong-database #依賴kong-database服務
  konga:
    image: pantsel/konga:latest
    restart: always
    networks:
      - kong-net
    environment:
      DB_ADAPTER: postgres
      DB_HOST: kong-database
      DB_USER: kong
      DB_DATABASE: konga
      DB_PASSWORD: kong #必須加上密碼，不然會失敗
    depends_on:
      - kong
      - kong-database
    ports:
      - "1337:1337" #控制檯訪問端口
networks:
  kong-net:
    driver: bridge

docker-compose.yml文件參考自
https://wenku.baidu.com/view/eda035c19889680203d8ce2f0066f5335a81670e.html

訪問Konga控制檯

假設使用的是本地搭建
使用瀏覽器訪問127.0.0.1:1337
注：端口號在docker-compose.yml中指定了1337

若是使用雲服務器，注意做好DNS解析以及Nginx配置
這裏給出一份可用的kong.conf

server{
    listen 80;
    server_name  kong.YOUR_DOMAIN.com;
    charset utf-8;

    # 接口
    location / {
      proxy_pass http://127.0.0.1:1337;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Forwarded-Port $server_port;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
    }
}

使用瀏覽器訪問kong.YOUR_DOMAIN:1337

首次進入配置管理員

打開界面後，是要創建一個管理員賬號的，按說明填寫即可

配置Kong管理API

先理解一下概念：
我們現在操作的可視化平臺是Konga
Konga通過調用Kong的admin url，對Kong網關進行配置管理
所以這一步我們需要將Konga和Kong搭上線

在Connection頁面配置要管理的Kong網關

主要填寫參數說明：
Name：必填，唯一，用於備忘
Kong Admin URL：Kong網關的管理路徑，默認端口是8001，在docker-compose.yml可修改對外暴露的端口號

這裏有個提示很顯眼：Kong's admin API should not be publicly exposed
故我們在雲服務器部署時，都應該注意8001的這個端口不應隨意暴露出去，以免發生黑客攻擊風險

爲什麼配置出來是http://kong:8001？
因爲本次使用的是docker-compose部署，Kong和Konga還有Postgres這幾個容器都處於kong-net這個網絡環境下，可以直接通過容器名訪問到對方
Konga是在接收到瀏覽器請求後，通過後臺服務調用Kong admin URL
如果用了其他方式部署，則需要按實際情況填寫Kong admin URL，並且注意不要暴露到公網上！