雲原生專案實踐DevOps(GitOps)+K8S+BPF+SRE，從0到1使用Golang開發生產級麻將遊戲伺服器—第4篇

為少發表於2021-02-17

遊客登入鑑權之業務程式碼實戰

系列文章

介紹

這將是一個完整的，完全踐行 DevOps/GitOps 與 Kubernetes 上雲流程的 Golang 遊戲伺服器開發的系列教程。

這個系列教程是對開源專案 Nanoserver 的完整拆解，旨在幫助大家快速上手 Golang（遊戲）伺服器後端開發。通過實踐去理解 Golang 開發的精髓 —— Share memory by communication(通過通訊共享記憶體)。

同時這個專案可能還會涉及到 Linux 效能調優（BPF 相關的工具）和系統保障（SRE）的相關的工作。

Step-By-Step 開發 Mahjong Server

單體架構理解 Mahjong Server 業務 -> Nano Distributed Game Server（分散式） + 微服務 改造。
Demo：go-mahjong-server

VSCode REST Client 外掛

如果你是用 VSCode 作為 IDE，這個外掛不錯：

遊客登入業務

業務分析

從0到1使用Golang開發生產級麻將遊戲伺服器—第3篇

業務 E-R 圖

API：查詢遊客登入是否啟用

REST Client 測試 API

Request：

POST http://192.168.31.125:12307/v1/user/login/query HTTP/1.1
content-type: application/json

{
    "channelId": "konglai",
    "appId": "konglai"
}

Response：

HTTP/1.1 200 OK
Access-Control-Allow-Headers: Origin, Content-Type, Authorization
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Origin: *
Content-Type: application/json; charset=utf-8
Date: Sun, 07 Feb 2021 15:00:16 GMT
Content-Length: 24
Connection: close

{
  "code": 0,
  "guest": true
}

業務邏輯分析

比較簡單，就是根據伺服器 configs/config.toml 檔案的配置，進行驗證：

...
[login]
guest = true
lists = ["test", "konglai"]
...

API：遊客登入

REST Client 測試 API

Request：

POST http://127.0.0.1:12307/v1/user/login/guest HTTP/1.1
content-type: application/json

{
    "channelId": "konglai",
    "appId": "konglai",
    "imei": "c0a4ce912c48a3d0b17b59e6b97f1dca"
}

Response：

{
	"code": 0,
	"name": "G1",
	"uid": 1,
	"headUrl": "http://wx.qlogo.cn/mmopen/s962LEwpLxhQSOnarDnceXjSxVGaibMRsvRM4EIWic0U6fQdkpqz4Vr8XS8D81QKfyYuwjwm2M2ibsFY8mia8ic51ww/0",
	"fangka": 10,
	"sex": 1,
	"ip": "192.168.31.125",
	"port": 33251,
	"playerIp": "192.168.31.125",
	"config": {
		"version": "1.9.3",
		"android": "https://fir.im/tand",
		"ios": "https://fir.im/tios",
		"heartbeat": 30,
		"forceUpdate": true,
		"title": "血戰到底",
		"desc": "純正四川玩法，快捷便利的掌上血戰，輕鬆組局，隨時隨地盡情遊戲",
		"daili1": "kefuweixin01",
		"daili2": "kefuweixin01",
		"kefu1": "kefuweixin01",
		"appId": "xxx",
		"appKey": "xxx"
	},
	"messages": ["系統訊息：健康遊戲，禁止賭博", "歡迎進入遊戲"],
	"clubList": [],
	"debug": 0
}

業務邏輯分析

DB Model

db/model/struct.go

type User struct {
	Id              int64
	Algo            string `xorm:"not null VARCHAR(16) default"`
	Hash            string `xorm:"not null VARCHAR(64) default"`
	Salt            string `xorm:"not null VARCHAR(64) default"`
	Role            int    `xorm:"not null TINYINT(3) default 1"`
	Status          int    `xorm:"not null TINYINT(3) default 1"`
	IsOnline        int    `xorm:"not null TINYINT(1) default 1"`
	LastLoginAt     int64  `xorm:"not null index BIGINT(11) default"`
	PrivKey         string `xorm:"not null VARCHAR(512) default"`
	PubKey          string `xorm:"not null VARCHAR(128) default"`
	Coin            int64  `xorm:"not null BIGINT(20) default 0"`
	RegisterAt      int64  `xorm:"not null index BIGINT(20) default 0"`
	FirstRechargeAt int64  `xorm:"not null index BIGINT(20) default 0"`
	Debug           int    `xorm:"not null index TINYINT(1) default 0"`
}

使用者表	描述
Id	自增ID
Algo	加密演算法
Hash	加密hash
Salt	加密撒鹽
Role	賬號型別（RoleTypeAdmin=1 管理員賬號，RoleTypeThird=2 三方平臺賬號）
Status	賬號狀態（StatusNormal=1 正常，StatusDeleted=2 刪除，StatusFreezed=3 凍結，StatusBound=4 繫結）
IsOnline	是否線上（UserOffline=1 離線，UserOnline=2 線上）
LastLoginAt	最後登入時間
PrivKey	賬號證書私鑰
PubKey	賬號證書公鑰
Coin	房卡數量
RegisterAt	註冊時間
FirstRechargeAt	首充時間
Debug	使用者資訊除錯


type Register struct {
	Id           int64
	Uid          int64  `xorm:"not null index BIGINT(20) default"`
	Remote       string `xorm:"not null VARCHAR(40) default"`
	Ip           string `xorm:"not null VARCHAR(40) default"`
	Imei         string `xorm:"not null VARCHAR(128) default"`
	Os           string `xorm:"not null VARCHAR(20) default"`
	Model        string `xorm:"not null VARCHAR(20) default"`
	AppId        string `xorm:"not null index VARCHAR(32) default"`
	ChannelId    string `xorm:"not null index VARCHAR(32) default"`
	RegisterAt   int64  `xorm:"not null index BIGINT(11) default"`
	RegisterType int    `xorm:"not null index TINYINT(8) default"`
}

使用者註冊記錄表	描述
Id	自增ID
Uid	使用者ID
Remote	外網IP
Ip	內網IP
Model	硬體型號
Imei	裝置的imei號
Os	os版本號
AppId	應用id
ChannelId	渠道id
RegisterAt	註冊時間
RegisterType	註冊型別（RegTypeThird=5 三方平臺新增賬號）

type Login struct {
	Id        int64
	Uid       int64  `xorm:"not null index BIGINT(20) default"`
	Remote    string `xorm:"not null VARCHAR(40) default"`
	Ip        string `xorm:"not null VARCHAR(40) default"`
	Model     string `xorm:"not null VARCHAR(64) default"`
	Imei      string `xorm:"not null VARCHAR(32) default"`
	Os        string `xorm:"not null VARCHAR(64) default"`
	AppId     string `xorm:"not null VARCHAR(64) default"`
	ChannelId string `xorm:"not null VARCHAR(32) default"`
	LoginAt   int64  `xorm:"not null BIGINT(11) default"`
	LogoutAt  int64  `xorm:"not null BIGINT(11) default"`
}

使用者登入記錄表	描述
Id	自增ID
Uid	使用者ID
Remote	外網IP
Ip	內網IP
Model	硬體型號
Imei	裝置的imei號
Os	os版本號
AppId	應用id
ChannelId	渠道id
LoginAt	登入時間
LogoutAt	登出時間

根據 AppID(使用者來自於哪一個應用) 與 Device.IMEI(裝置的imei號)，確定當前遊客是否已經註冊

user, err := db.QueryGuestUser(data.AppID, data.Device.IMEI)

db.QueryGuestUser，會從 register 或 user 表中去查詢使用者是否存在。

相關 protocol 的定義：

protocol/login.go

type LoginRequest struct {
	AppID     string `json:"appId"`     //使用者來自於哪一個應用
	ChannelID string `json:"channelId"` //使用者來自於哪一個渠道
	IMEI      string `json:"imei"`
	Device    Device `json:"device"`
}

protocol/common.go

type Device struct {
	IMEI   string `json:"imei"`   //裝置的imei號
	OS     string `json:"os"`     //os版本號
	Model  string `json:"model"`  //硬體型號
	IP     string `json:"ip"`     //內網IP
	Remote string `json:"remote"` //外網IP
}

如果沒有註冊，則生成一個新使用者，並且註冊一條使用者記錄

涉及到的相關 db 常量的定義：

db/const.go

const (
	StatusNormal  = 1 //正常
	StatusDeleted = 2 //刪除
	StatusFreezed = 3 //凍結
	StatusBound   = 4 //繫結
)

const (
	UserOffline = 1 //離線
	UserOnline  = 2 //線上
)

// Users表中role欄位的取值
const (
	RoleTypeAdmin = 1 //管理員賬號
	RoleTypeThird = 2 //三方平臺賬號
)

生成一個新使用者：

const defaultCoin = 10 // 預設給的房卡數量是 10

user = &model.User{
  Status:   db.StatusNormal,
  IsOnline: db.UserOffline,
  Role:     db.RoleTypeThird,
  Coin:     defaultCoin,
}

db.InsertUser(user)

註冊一條使用者記錄

db.RegisterUserLog(user, data.Device, data.AppID, data.ChannelID, protocol.RegTypeThird) //註冊記錄

構造 login 響應資料

相關 protocol 的定義：

protocol/login.go

type LoginResponse struct {
	Code     int          `json:"code"`
	Name     string       `json:"name"`
	Uid      int64        `json:"uid"`
	HeadUrl  string       `json:"headUrl"`
	FangKa   int64        `json:"fangka"`
	Sex      int          `json:"sex"` //[0]未知 [1]男 [2]女
	IP       string       `json:"ip"`
	Port     int          `json:"port"`
	PlayerIP string       `json:"playerIp"`
	Config   ClientConfig `json:"config"`
	Messages []string     `json:"messages"`
	ClubList []ClubItem   `json:"clubList"`
	Debug    int          `json:"debug"`
}

type ClientConfig struct {
	Version     string `json:"version"`
	Android     string `json:"android"`
	IOS         string `json:"ios"`
	Heartbeat   int    `json:"heartbeat"`
	ForceUpdate bool   `json:"forceUpdate"`

	Title string `json:"title"` // 分享標題
	Desc  string `json:"desc"`  // 分享描述

	Daili1 string `json:"daili1"`
	Daili2 string `json:"daili2"`
	Kefu1  string `json:"kefu1"`

	AppId  string `json:"appId"`
	AppKey string `json:"appKey"`
}

protocol/club.go

type (
	ClubItem struct {
		Id        int64  `json:"id"`
		Name      string `json:"name"`
		Desc      string `json:"desc"`
		Member    int    `json:"member"`
		MaxMember int    `json:"maxMember"`
	}
  // ....
)

插入登入記錄，返回客戶端所需資料

device := protocol.Device{
		IP:     ip(r.RemoteAddr),
		Remote: r.RemoteAddr,
	}
db.InsertLoginLog(user.Id, device, data.AppID, data.ChannelID)

return resp, nil

一圖勝千言，秒懂

關於遊戲伺服器登入與 Nano 遊戲伺服器通訊相關程式碼實戰，我們下篇再詳細討論。

我是為少
微信：uuhells123
公眾號：黑客下午茶
加我微信（互相學習交流），關注公眾號（獲取更多學習資料~）

雲原生專案實踐DevOps(GitOps)+K8S+BPF+SRE，從0到1使用Golang開發生產級麻將遊戲伺服器—第1篇
2021-02-01
devGitK8SGolang遊戲伺服器
雲原生專案實踐DevOps(GitOps)+K8S+BPF+SRE，從0到1使用Golang開發生產級麻將遊戲伺服器—第2篇
2021-02-04
devGitK8SGolang遊戲伺服器
雲原生專案實踐DevOps(GitOps)+K8S+BPF+SRE，從0到1使用Golang開發生產級麻將遊戲伺服器—第6篇
2021-02-23
devGitK8SGolang遊戲伺服器
雲原生專案實踐DevOps(GitOps)+K8S+BPF+SRE，從0到1使用Golang開發生產級麻將遊戲伺服器—第3篇
2021-02-07
devGitK8SGolang遊戲伺服器
雲原生專案實踐DevOps(GitOps)+K8S+BPF+SRE，從0到1使用Golang開發生產級麻將遊戲伺服器—第5篇
2021-02-21
devGitK8SGolang遊戲伺服器
從.net開發做到雲原生運維(八)——DevOps實踐
2022-04-15
運維dev
node專案從0到1實戰
2022-02-15
專案DevOps研發雲CI實踐之路
2017-10-11
dev
從0到1，企業如何實現精益生產？
2023-05-05
從0到1使用kubebuiler開發operator
2022-05-19
UI
QQ日跡Omi實戰開發，從0到1
2017-07-17
將專案從 GitHub 部署到伺服器
2016-02-01
Github伺服器
雲原生時代 PHP/Golang 專案如何實現微服務
2022-05-28
PHPGolang微服務
從0到1完成nutch分散式爬蟲專案實戰
2019-01-08
分散式爬蟲
雲原生推動全雲開發與實踐
2021-06-07
從0到1，開發一個動畫庫(1)
2018-01-29
動畫
DevOps 從理論到實踐指南
2019-10-29
dev
從專案到產品：生產線類比的終結
2020-04-14
使用 Docker 開發 PHP 專案（五）：生產環境
2020-07-27
DockerPHP
從0到1到無窮，vivo大規模機器學習實踐
2018-05-07
機器學習
一本實踐的專案開發《Python專案開發實戰（第2版）》
2018-06-10
Python
國泰產險金融級雲原生保險中臺落地實踐
2019-07-11
UI元件庫從0到1開發心得
2019-02-14
UI元件
Flutter 開發從 0 到 1（五）原始碼
2020-11-16
Flutter原始碼
如何理解敏捷開發的從0到1
2021-11-05
敏捷
企業級Redis開發運維從入門到實踐（1）—Redis 初識
2018-09-13
Redis運維
《從0到1搭建一個IM專案》專案初始化
2022-12-28
任發科：DevOps的前世來生，從《目標》、《鳳凰專案》到《持續交付》
2017-10-27
dev
從0到1使用VUE-CLI3開發實戰(六)：這是一個有程式碼潔癖的專案
2019-01-26
Vue
使用 SmartIDE 開發golang專案
2022-12-14
IDEGolang
《五行》從0到1設計遊戲——專案管理經驗總結
2021-05-10
遊戲專案管理
GitOps 應用實踐系列 - Argo CD 從入門到核心
2021-10-26
GitGo
python專案開發例項-Python專案案例開發從入門到實戰——爬蟲、遊戲
2020-10-28
Python爬蟲遊戲
mirrord：輕鬆地將流量從生產環境映象到開發環境
2022-03-08
開發環境
從0到1實現Promise
2018-09-28
Promise
從0到1使用VUE-CLI3開發實戰（四）: Axios封裝
2019-02-16
VueiOS封裝
將雲原生進行到底：騰訊百萬級別容器雲平臺實踐揭秘
2022-12-29
Vue3 全家桶，從 0 到 1 實戰專案，新手有福了
2021-12-23
Vue

雲原生專案實踐DevOps(GitOps)+K8S+BPF+SRE，從0到1使用Golang開發生產級麻將遊戲伺服器—第4篇

遊客登入鑑權之業務程式碼實戰

系列文章

介紹

Step-By-Step 開發 Mahjong Server

VSCode REST Client 外掛

遊客登入業務

業務分析

業務 E-R 圖

API：查詢遊客登入是否啟用

REST Client 測試 API

業務邏輯分析

API：遊客登入

REST Client 測試 API

業務邏輯分析

相關文章