本文介绍在Ubuntu操作系统下,采用docker容器安装TYK的实践操作,供入门学习。
Tyk是一个开源的轻量级API网关程序,点击跳转到Tyk官网。辉哥为什么选择TYK网关,参考文章《【实践】5种微服务开源API网关对比,为什么我选择了TRY》。
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
# docker pull tykio/tyk-gateway
# docker pull tykio/tyk-dashboard
# docker pull tykio/tyk-pump-docker-pub
# docker pull redis
# docker pull mongo
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
# docker run -d --name tyk_mongo mongo
# docker run -d --name tyk_redis redis
# 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了。例如辉哥环境如下:
登录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界面的使用权限。
基础配置文件在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,则需要做一些更改,如果自己不确定,可以先执行以上命令,执行过程中有错误信息,则做以下几步:
bootstrap.sh
#!/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 界面系统,另外文章再做介绍。