1. 摘要

本文介绍在Ubuntu操作系统下，采用docker容器安装TYK的实践操作，供入门学习。

2.安装说明

Tyk是一个开源的轻量级API网关程序，点击跳转到Tyk官网。辉哥为什么选择TYK网关，参考文章《【实践】5种微服务开源API网关对比，为什么我选择了TRY》。

2.1 安装Docker

Docker 是*一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移植的镜像中，然后发布到任何流行的 Linux或Windows 机器上，也可以实现虚拟化。
从Ubuntu的仓库直接下载安装。

sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker

检查是否安装成功：

ubuntu@ip-172-31-12-147:/home/arta$ docker -v
Docker version 18.09.5, build e8ff056

2.2 下载TYK及依赖镜像

2.2.1 拉取TYK的Docker镜像

# docker pull tykio/tyk-gateway
# docker pull tykio/tyk-dashboard
# docker pull tykio/tyk-pump-docker-pub

2.2.2 拉取TYK运行需要依赖的Docker镜像

# docker pull redis
# docker pull mongo

2.2.3 查看DOCKER 镜像列表

root@ip-172-31-11-188:/home/ubuntu/tyk/tyk-dashboard-docker# docker image ls
REPOSITORY                  TAG                 IMAGE ID            CREATED             SIZE
mongo                       latest              9c02a5a12c52        4 days ago          413MB
tykio/tyk-dashboard         latest              d603a4f174e7        10 days ago         288MB
tykio/tyk-gateway           <none>              9a9352edc14b        10 days ago         331MB
redis                       latest              598a6f110d01        2 weeks ago         118MB
tykio/tyk-pump-docker-pub   latest              38519d9e8235        7 weeks ago         137MB
tykio/tyk-gateway           latest              620379bd9231        3 months ago        359MB

2.3 启动运行TYK

2.3.1 启动redis和mongo

# docker run -d --name tyk_mongo mongo
# docker run -d --name tyk_redis redis

2.3.2 启动TYK容器

# docker run -d -p 3080:3080 --link tyk_redis:redis --name tyk_gateway tykio/tyk-gateway
# docker run -d --name tyk_dashboard -p 3000:3000 --link tyk_redis:redis --link tyk_mongo:mongo --link tyk_gateway:tyk_gateway tykio/tyk-dashboard
# docker run -d --name tyk_pump --link tyk_redis:redis --link tyk_mongo:mongo tykio/tyk-pump-docker-pub

此时你可以访问Ubuntu的ip:3000 查看dashboard了。例如辉哥环境如下：

2.4 获取激活码

登录TYK官网（https://tyk.io/api-gateway/on-premise/），点击“GET A DEV LICENCE”，可以获得3个月的界面版本的试用权限。

期限选择3个月（1年的没有了），填写相关信息后，注册邮箱就可以收到注册码了。https://tyk.io/product/tyk-on-premises-free-edition/

注册邮箱收到的注册码：

把注册码复制出来填写到网址（例如http://52.2.107.183:3000/）的激活码区，然后点击“ACTIVE KEY”，即可获得TYK界面的使用权限。

2.5 创建基础配置，设置用户信息

基础配置文件在github上,地址如下：https://github.com/TykTechnologies/tyk-dashboard-docker

在ubuntu中自己找一个位置（随意），执行如下命令（前提需要ubuntu已经安装git，如果没有安装请自行google）

git clone https://github.com/TykTechnologies/tyk-dashboard-docker

下载完成后，进入到对应的文件夹

cd tyk-dashboard-docker/

进入文件夹后，找到 bootstrap.sh 文件，如果Ubuntu安装的是python3以下的版本，则直接运行如下命令即可。

# ./bootstrap.sh 52.82.107.183
Creating Organisation
ORGID: 5d3d53cf0a73f30001bc0071
Adding new user
USER AUTH: df769ab92f364737762979d96d6f9049
NEW ID: 5d3d53cff45b6e41f722f796
Setting password

DONE
====
Login at http://52.82.107.183:3000/
User: uwdjif6tkl@example.com
Pass: test123

浏览器上输入对应的地址，使用产生的用户名和密码就可以登录TYK界面系统了。

如果是以上版本包括python3,则需要做一些更改，如果自己不确定，可以先执行以上命令，执行过程中有错误信息，则做以下几步：

1、清空bootstrap.sh文件内容

bootstrap.sh

2、将以下内容保存到文件中

#!/bin/bash
# Usage ./bootstrap.sh DASHBOARD_HOSTNAME

LOCALIP=$1
RANDOM_USER=$(env LC_CTYPE=C tr -dc "a-z0-9" < /dev/urandom | head -c 10)
PASS="test123"

echo "Creating Organisation"
ORGDATA=$(curl --silent --header "admin-auth: 12345" --header "Content-Type:application/json" --data '{"owner_name": "Default Org.","owner_slug": "default", "cname_enabled": true, "cname": ""}' http://$LOCALIP:3000/admin/organisations 2>&1)
#echo $ORGDATA
ORGID=$(echo $ORGDATA | python3 -c 'import json,sys;obj=json.load(sys.stdin);print(obj["Meta"])')
echo "ORGID: $ORGID" 

echo "Adding new user"
USER_DATA=$(curl --silent --header "admin-auth: 12345" --header "Content-Type:application/json" --data '{"first_name": "John","last_name": "Smith","email_address": "'$RANDOM_USER'@default.com","password":"'$PASS'", "active": true,"org_id": "'$ORGID'"}' http://$LOCALIP:3000/admin/users 2>&1)
#echo $USER_DATA
USER_CODE=$(echo $USER_DATA | python3 -c 'import json,sys;obj=json.load(sys.stdin);print(obj["Message"])')
echo "USER AUTH: $USER_CODE" 

USER_LIST=$(curl --silent --header "authorization: $USER_CODE" http://$LOCALIP:3000/api/users 2>&1)
#echo $USER_LIST

USER_ID=$(echo $USER_LIST | python3 -c 'import json,sys;obj=json.load(sys.stdin);print(obj["users"][0]["id"])')
echo "NEW ID: $USER_ID"

echo "Setting password"
OK=$(curl --silent --header "authorization: $USER_CODE" --header "Content-Type:application/json" http://$LOCALIP:3000/api/users/$USER_ID/actions/reset --data '{"new_password":"'$PASS'"}')

echo ""

内容替换完成后执行：

./bootstrap.sh Ubuntu主机ip

如果执行报错，八成是文件中python相关问题，可以自行排查解决，执行后输出信息如下：

root@ubuntu:~/tyk-dashboard-docker# ./bootstrap.sh 192.168.174.131
Creating Organisation
ORGID: 5c17635489d49c00014fffb3
Adding new user
USER AUTH: 2700cd3dd5c94aa74e66a61ccb0d8195
NEW ID: 5c1763544b084caaaa850abe
Setting password

DONE
====
Login at http://192.168.174.131:3000/
User: j4aawfows5@default.com
Pass: test123

信息的结尾处包含了访问地址以及用户名和密码，就可以登录了。

如何使用TKY 界面系统，另外文章再做介绍。