🥇"มหากาพย์ใหม่" กินช้างทีละชิ้น

ในบทความนี้ ผมจะตั้งค่าสภาพแวดล้อมการทำงานสำหรับการพัฒนาเกม "Bylina" และแบ่งตัวเกมออกเป็นส่วนๆ ที่เหมาะสมสำหรับการใช้งานใน OpenFaaS โดยการดำเนินการทั้งหมดจะทำโดยใช้ Linuxผมจะติดตั้ง Kubernetes บน minikube โดยใช้ VirtualBox เครื่องที่ทำงานของผมมี CPU 2 คอร์ และ RAM 12GB โดยใช้ SSD เป็นไดรฟ์ระบบ ผมจะใช้เครื่องนี้เป็นระบบพัฒนาหลัก debian 8. ติดตั้งแพ็กเกจ emacs, sudo, git และ virtualbox ไว้แล้ว ส่วนที่เหลือผมจะดาวน์โหลดจาก GitHub และแหล่งอื่นๆ มาติดตั้งเอง แอปพลิเคชันเหล่านี้จะถูกติดตั้งใน /usr/local/bin เว้นแต่จะระบุไว้เป็นอย่างอื่น มาเริ่มกันเลย!

การจัดเตรียมสภาพแวดล้อมการทำงาน

กำลังติดตั้ง Go

ปฏิบัติตามคำแนะนำจากเว็บไซต์อย่างเป็นทางการ:

$ curl -L0 https://dl.google.com/go/go1.13.5.linux-amd64.tar.gz -o go.tar.gz
$ sudo tar -C /usr/local -xzf go.tar.gz
$ echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile

มาตรวจสอบฟังก์ชันกัน:

$ mkdir -p ~/go/src/hello && cd ~/go/src/hello
$ echo 'package main

import "fmt"

func main() {
fmt.Printf("hello, worldn")
}' > hello.go
$ go build
$ ./hello
hello, world

การติดตั้ง faas-cli

ปฏิบัติตามคำแนะนำจากเว็บไซต์อย่างเป็นทางการ:

$ curl -sSL https://cli.openfaas.com | sudo -E sh
x86_64
Downloading package https://github.com/openfaas/faas-cli/releases/download/0.11.3/faas-cli as /tmp/faas-cli
Download complete.

Running with sufficient permissions to attempt to move faas-cli to /usr/local/bin
New version of faas-cli installed to /usr/local/bin
Creating alias 'faas' for 'faas-cli'.
  ___                   _____           ____
 / _  _ __   ___ _ __ |  ___|_ _  __ _/ ___|
| | | | '_  / _  '_ | |_ / _` |/ _` ___ 
| |_| | |_) |  __/ | | |  _| (_| | (_| |___) |
 ___/| .__/ ___|_| |_|_|  __,_|__,_|____/
      |_|

CLI:
 commit:  73004c23e5a4d3fdb7352f953247473477477a64
 version: 0.11.3

นอกจากนี้ คุณยังสามารถเปิดใช้งาน bash-completion ได้:

faas-cli completion --shell bash | sudo tee /etc/bash_completion.d/faas-cli

การติดตั้งและกำหนดค่า Kubernetes

สำหรับการพัฒนา minikube ก็เพียงพอแล้ว ดังนั้นเรามาติดตั้งมันและ kubelet ใน /usr/local/bin กัน สำหรับการติดตั้งแอปพลิเคชัน เราจะติดตั้ง helm ด้วย:

$ curl https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 -o minikube && chmod +x minikube && sudo mv minikube /usr/local/bin/
$ curl https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl -o kubectl && chmod +x kubectl && sudo mv kubectl /usr/local/bin/
$ curl https://get.helm.sh/helm-v3.0.2-linux-amd64.tar.gz | tar -xzvf - linux-amd64/helm --strip-components=1; sudo mv helm /usr/local/bin

เรียกใช้มินิคิวบ์:

$ minikube start
  minikube v1.6.2 on Debian 8.11
  Automatically selected the 'virtualbox' driver (alternates: [])
  Downloading VM boot image ...
    > minikube-v1.6.0.iso.sha256: 65 B / 65 B [--------------] 100.00% ? p/s 0s
    > minikube-v1.6.0.iso: 150.93 MiB / 150.93 MiB [-] 100.00% 5.67 MiB p/s 27s
  Creating virtualbox VM (CPUs=2, Memory=8192MB, Disk=20000MB) ...
  Preparing Kubernetes v1.17.0 on Docker '19.03.5' ...
  Downloading kubeadm v1.17.0
  Downloading kubelet v1.17.0
  Pulling images ...
  Launching Kubernetes ...  Waiting for cluster to come online ...
  Done! kubectl is now configured to use "minikube"

เราตรวจสอบ:

$ kubectl get pods --all-namespaces
NAMESPACE     NAME                               READY   STATUS    RESTARTS   AGE
kube-system   coredns-6955765f44-knlcb           1/1     Running   0          29m
kube-system   coredns-6955765f44-t9cpn           1/1     Running   0          29m
kube-system   etcd-minikube                      1/1     Running   0          28m
kube-system   kube-addon-manager-minikube        1/1     Running   0          28m
kube-system   kube-apiserver-minikube            1/1     Running   0          28m
kube-system   kube-controller-manager-minikube   1/1     Running   0          28m
kube-system   kube-proxy-hv2wc                   1/1     Running   0          29m
kube-system   kube-scheduler-minikube            1/1     Running   0          28m
kube-system   storage-provisioner                1/1     Running   1          29m

การติดตั้ง OpenFaaS

นักพัฒนาแนะนำให้สร้างเนมสเปซ 2 แห่งสำหรับการทำงาน:

$ kubectl apply -f https://raw.githubusercontent.com/openfaas/faas-netes/master/namespaces.yml
namespace/openfaas created
namespace/openfaas-fn created

เพิ่มที่เก็บข้อมูลสำหรับ helm:

$ helm repo add openfaas https://openfaas.github.io/faas-netes/
"openfaas" has been added to your repositories

แผนภูมิมีตัวเลือกสำหรับตั้งรหัสผ่านก่อนการติดตั้ง ลองใช้และบันทึกข้อมูลการเข้าถึงเป็นรหัสลับ k8s กัน:

$ PASSWORD=verysecurerandompasswordstring
$ kubectl -n openfaas create secret generic basic-auth --from-literal=basic-auth-user=admin --from-literal=basic-auth-password="$PASSWORD"
secret/basic-auth created

เรากำลังดำเนินการปรับใช้:

$ helm repo update
Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "openfaas" chart repository
Update Complete.  Happy Helming!
$ helm upgrade openfaas --install openfaas/openfaas --namespace openfaas --set functionNamespace=openfaas-fn --set generateBasicAuth=false
Release "openfaas" does not exist. Installing it now.
NAME: openfaas
LAST DEPLOYED: Fri Dec 25 10:28:22 2019
NAMESPACE: openfaas
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
To verify that openfaas has started, run:

  kubectl -n openfaas get deployments -l "release=openfaas, app=openfaas"

หลังจากนั้นสักระยะหนึ่ง ให้รันคำสั่งที่แนะนำ:

$ kubectl -n openfaas get deployments -l "release=openfaas, app=openfaas"
NAME                READY   UP-TO-DATE   AVAILABLE   AGE
alertmanager        1/1     1            1           114s
basic-auth-plugin   1/1     1            1           114s
faas-idler          1/1     1            1           114s
gateway             1/1     1            1           114s
nats                1/1     1            1           114s
prometheus          1/1     1            1           114s
queue-worker        1/1     1            1           114s

มาตรวจสอบฟังก์ชันกัน:

$ kubectl rollout status -n openfaas deploy/gateway
deployment "gateway" successfully rolled out
$ kubectl port-forward -n openfaas svc/gateway 8080:8080 &
[1] 6985
Forwarding from 127.0.0.1:8080 -> 8080
$ echo -n $PASSWORD | faas-cli login --username admin --password-stdin
Calling the OpenFaaS server to validate the credentials...
Handling connection for 8080
WARNING! Communication is not secure, please consider using HTTPS. Letsencrypt.org offers free SSL/TLS certificates.
credentials saved for admin http://127.0.0.1:8080
$ faas-cli list
Function                        Invocations     Replicas

การติดตั้ง MongoDB

เราติดตั้งทุกอย่างโดยใช้ helm:

$ helm repo add stable https://kubernetes-charts.storage.googleapis.com/
"stable" has been added to your repositories
$ helm install stable/mongodb --generate-name
NAME: mongodb-1577466908
LAST DEPLOYED: Fri Dec 25 11:15:11 2019
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
** Please be patient while the chart is being deployed **

MongoDB can be accessed via port 27017 on the following DNS name from within your cluster:

    mongodb-1577466908.default.svc.cluster.local

To get the root password run:

    export MONGODB_ROOT_PASSWORD=$(kubectl get secret --namespace default mongodb-1577466908 -o jsonpath="{.data.mongodb-root-password}" | base64 --decode)

To connect to your database run the following command:

    kubectl run --namespace default mongodb-1577466908-client --rm --tty -i --restart='Never' --image bitnami/mongodb --command -- mongo admin --host mongodb-1577466908 --authenticationDatabase admin -u root -p $MONGODB_ROOT_PASSWORD

To connect to your database from outside the cluster execute the following commands:

    kubectl port-forward --namespace default svc/mongodb-1577466908 27017:27017 &
    mongo --host 127.0.0.1 --authenticationDatabase admin -p $MONGODB_ROOT_PASSWORD

เราตรวจสอบ:

kubectl run --namespace default mongodb-1577466908-client --rm --tty -i --restart='Never' --image bitnami/mongodb --command -- mongo admin --host mongodb-1577466908 --authenticationDatabase admin -u root -p $(kubectl get secret --namespace default mongodb-1577466908 -o jsonpath="{.data.mongodb-root-password}" | base64 --decode)
If you don't see a command prompt, try pressing enter.

> db.version();
4.0.14

กด ctrl+D เพื่อออกจากคอนเทนเนอร์

การตั้งค่า emacs

ตามหลักการทุกอย่างก็ถูกกำหนดไว้แล้ว บทความนี้ดังนั้นผมจะไม่ลงรายละเอียด

การแบ่งเกมออกเป็นฟังก์ชั่น

การโต้ตอบกับฟังก์ชันต่างๆ ทำได้ผ่านโปรโตคอล HTTP โดยมีการตรวจสอบสิทธิ์แบบ end-to-end ระหว่างฟังก์ชันต่างๆ ที่ JWT จัดเตรียมไว้ MongoDB ใช้สำหรับจัดเก็บโทเค็น รวมถึงสถานะเกม ข้อมูลผู้เล่น ลำดับเกม และข้อมูลอื่นๆ ลองมาดูฟังก์ชันที่น่าสนใจที่สุดกัน

การลงทะเบียน

ฟังก์ชันนี้รับสตริง JSON ที่มีชื่อเล่นและรหัสผ่านของเกม เมื่อเรียกใช้ฟังก์ชันนี้ ระบบจะตรวจสอบว่ามีชื่อเล่นอยู่ในฐานข้อมูลหรือไม่ หากมี ระบบจะแทรกแฮชชื่อเล่นและรหัสผ่านลงในฐานข้อมูล การลงทะเบียนเป็นสิ่งจำเป็นสำหรับการเข้าร่วมเกม

ทางเข้า

อินพุตของฟังก์ชันคือ JSON พร้อมชื่อเล่นและรหัสผ่านของเกม หากมีชื่อเล่นอยู่ในฐานข้อมูลและรหัสผ่านได้รับการยืนยันกับรหัสผ่านที่เก็บไว้ในฐานข้อมูลก่อนหน้านี้แล้ว ระบบจะส่งคืน JWT ซึ่งควรส่งต่อไปยังฟังก์ชันอื่นๆ เมื่อเรียกใช้งาน บันทึกบริการต่างๆ จะถูกแทรกลงในฐานข้อมูล เช่น เวลาล็อกอินครั้งล่าสุด

การดูรายชื่อเกม

ผู้ใช้ที่ไม่ได้รับอนุญาตสามารถขอรายชื่อเกมทั้งหมดได้ ยกเว้นเกมที่เปิดใช้งานอยู่ ผู้ใช้ที่ได้รับอนุญาตก็จะเห็นรายชื่อเกมที่เปิดใช้งานอยู่เช่นกัน ผลลัพธ์ของฟังก์ชันจะเป็น JSON ซึ่งประกอบด้วยรายชื่อเกม (เช่น ID เกม ชื่อที่มนุษย์สามารถอ่านได้)

การสร้างเกม

ฟังก์ชันนี้ใช้งานได้เฉพาะกับผู้ใช้ที่ได้รับอนุญาตเท่านั้น โดยรองรับจำนวนผู้เล่นสูงสุดและพารามิเตอร์เกม (เช่น ตัวละครที่จะเปิดใช้งานในเกมนี้ จำนวนผู้เล่นสูงสุด ฯลฯ) พารามิเตอร์เกมแยกต่างหากคือรหัสผ่านสำหรับเข้าร่วม ซึ่งอนุญาตให้สร้างเกมส่วนตัวได้ โดยค่าเริ่มต้น เกมสาธารณะจะถูกสร้างขึ้น ผลลัพธ์ของฟังก์ชันคือไฟล์ JSON ที่มีฟิลด์ "สำเร็จ" รหัสเกมเฉพาะ และพารามิเตอร์อื่นๆ

การเข้าร่วมเกม

ฟังก์ชันนี้ใช้งานได้เฉพาะกับผู้ใช้ที่ได้รับอนุญาตเท่านั้น ข้อมูลที่ป้อนคือ ID และรหัสผ่านของเกม (หากเป็นเกมส่วนตัว) และผลลัพธ์คือ JSON พร้อมพารามิเตอร์ของเกม ผู้ใช้ที่ได้รับอนุญาตที่เข้าร่วมเกม รวมถึงผู้สร้างเกม จะถูกเรียกว่าผู้เข้าร่วมเกม

การดูเหตุการณ์เกม

ผู้ใช้ที่ไม่ได้รับอนุญาตสามารถขอรายการเหตุการณ์สำหรับเกมที่ไม่ได้ใช้งาน ในขณะที่ผู้ใช้ที่ได้รับอนุญาตสามารถรับรายการเหตุการณ์สำหรับเกมใดๆ ที่กำลังใช้งานอยู่ได้ หมายเลขเหตุการณ์ที่ผู้ใช้มีอยู่แล้วสามารถส่งเป็นพารามิเตอร์เพิ่มเติมให้กับฟังก์ชันได้ ในกรณีนี้ ระบบจะส่งคืนเฉพาะเหตุการณ์ที่เกิดขึ้นล่าสุดเท่านั้น การเรียกใช้ฟังก์ชันนี้เป็นระยะๆ จะทำให้ผู้ใช้ที่ได้รับอนุญาตสามารถตรวจสอบกิจกรรมของเกมได้ ฟังก์ชันนี้ยังส่งคืนคำขอการดำเนินการ ซึ่งผู้ใช้สามารถตอบสนองได้โดยใช้ฟังก์ชัน game event sender

การส่งกิจกรรมเกม

คุณสมบัตินี้มีให้เฉพาะผู้เข้าร่วมเกมเท่านั้น ผู้เล่นสามารถเปิดเกม ทำการเคลื่อนไหว โหวต เขียนข้อความที่ปรากฏในรายการกิจกรรมของเกม ฯลฯ
ผู้ใช้ที่ได้รับอนุญาตซึ่งเป็นผู้สร้างเกมจะเป็นผู้เริ่มการกระจายบทบาทให้กับผู้เล่นทุกคน รวมถึงตัวผู้เล่นเองด้วย พวกเขาต้องยืนยันบทบาทของตนโดยใช้ฟังก์ชันเดียวกัน เมื่อยืนยันบทบาททั้งหมดแล้ว เกมจะเปลี่ยนเป็นโหมดกลางคืนโดยอัตโนมัติ

สถิติของเกม

ฟีเจอร์นี้ใช้งานได้เฉพาะกับผู้เข้าร่วมเกมเท่านั้น โดยจะแสดงสถานะเกม รายชื่อและจำนวนผู้เล่น (นามแฝง) บทบาทและสถานะ (ไม่ว่าจะมีการเคลื่อนไหวหรือไม่) และข้อมูลอื่นๆ เช่นเดียวกับฟีเจอร์ก่อนหน้านี้ ฟีเจอร์นี้ใช้งานได้เฉพาะกับผู้เข้าร่วมเกมเท่านั้น

ฟังก์ชันที่เรียกใช้เป็นระยะ

หากไม่ได้เปิดเกมเป็นระยะเวลาหนึ่งตามที่ระบุไว้เมื่อสร้างเกม เกมดังกล่าวจะถูกลบออกจากรายการเกมที่ใช้งานอยู่โดยอัตโนมัติโดยใช้ฟังก์ชันการล้างข้อมูล

งานตามระยะเวลาอีกอย่างหนึ่งคือการบังคับเปลี่ยนจากกลางคืนเป็นกลางวันและกลับมาเป็นอีกครั้งสำหรับเกมที่ไม่เปลี่ยนระหว่างเทิร์น (ตัวอย่างเช่น ผู้เล่นที่ต้องตอบสนองต่อเหตุการณ์ในเกมจะไม่ส่งการตัดสินใจของตนด้วยเหตุผลบางประการ)