🥇"Novi epski prizori." Požiranje slona kos za kosom

V tem članku bom postavil delovno okolje za razvoj igre "Bylina" in tudi razdelil igro na dele, primerne za uporabo v OpenFaaS. Vse manipulacije bodo izvedene z uporabo LinuxKubernetes bom namestil v minikube z uporabo VirtualBoxa. Moj delovni računalnik ima 2 jedri procesorja in 12 GB RAM-a, kot sistemski pogon pa uporabljam SSD. Uporabljal ga bom kot primarni razvojni sistem. debian 8, z nameščenimi paketi emacs, sudo, git in virtualbox. Vse ostalo bom namestil s prenosom z GitHub-a in drugih virov. Te aplikacije bodo nameščene v /usr/local/bin, razen če ni določeno drugače. Začnimo!

Priprava delovnega okolja

Namestitev Go

Sledite navodilom z uradne spletne strani:

$ 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

Preverimo funkcionalnost:

$ 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

Namestitev faas-cli

Sledite navodilom z uradne spletne strani:

$ 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

Poleg tega lahko omogočite dokončanje bash:

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

Namestitev in konfiguracija Kubernetesa

Za razvoj zadostuje minikube, zato ga skupaj s kubeletom namestimo v /usr/local/bin. Za nameščanje aplikacij bomo namestili tudi 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

Zaženi minikube:

$ 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"

Preverjamo:

$ 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

Namestitev OpenFaaS-a

Razvijalci priporočajo ustvarjanje dveh imenskih prostorov za delo:

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

Dodaj repozitorij za helm:

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

Grafikon ima možnost nastavitve gesla pred namestitvijo. Uporabimo ga in shranimo dostopne podatke kot skrivnost 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

Izvajamo uvajanje:

$ 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"

Čez nekaj časa zaženite predlagani ukaz:

$ 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

Preverimo funkcionalnost:

$ 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

Namestitev MongoDB

Vse namestimo s pomočjo helma:

$ 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

Preverjamo:

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

Pritisnite ctrl+D za izhod iz vsebnika.

Nastavitev emacsa

Načeloma je bilo vse že nastavljeno ta članek, zato se ne bom spuščal v podrobnosti.

Razdelitev igre na funkcije

Interakcija s funkcijami poteka prek protokola HTTP, pri čemer JWT zagotavlja celovito preverjanje pristnosti med različnimi funkcijami. MongoDB se uporablja za shranjevanje žetonov, pa tudi stanja igre, podatkov o igralcih, zaporedij iger in drugih informacij. Oglejmo si podrobneje najzanimivejše funkcije.

registracija

Ta funkcija prejme niz JSON, ki vsebuje vzdevek in geslo igre. Ko je ta funkcija poklicana, se preveri, ali vzdevek obstaja v bazi podatkov. Če je tako, se zgoščena vrednost vzdevka in gesla vstavi v bazo podatkov. Za aktivno sodelovanje v igri je potrebna registracija.

Vhod

Vhod funkcije je JSON z vzdevkom in geslom igre. Če je vzdevek prisoten v bazi podatkov in je geslo uspešno preverjeno glede na geslo, ki je bilo predhodno shranjeno v bazi podatkov, se vrne JWT, ki ga je treba posredovati drugim funkcijam, ko so te klicane. V bazo podatkov se vstavijo tudi različni zapisi storitev, kot je čas zadnje prijave.

Ogled seznama iger

Vsak nepooblaščen uporabnik lahko zahteva seznam vseh iger razen aktivnih. Pooblaščen uporabnik vidi tudi seznam aktivnih iger. Izhod funkcije je JSON, ki vsebuje sezname iger (ID igre, berljivo ime itd.).

Ustvarjanje igre

Ta funkcija deluje samo z avtoriziranimi uporabniki. Sprejema največje število igralcev in parametre igre (npr. katere like aktivirati v tej igri, največje število igralcev itd.). Ločen parameter igre je prisotnost gesla za pridružitev, ki omogoča ustvarjanje zasebnih iger. Privzeto se ustvari javna igra. Izhod funkcije je datoteka JSON, ki vsebuje polje za uspeh, enolični ID igre in druge parametre.

Pridružitev igri

Funkcija deluje samo z avtoriziranimi uporabniki. Vhodna vrednost sta ID igre in geslo (če gre za zasebno igro), izhodna vrednost pa je JSON s parametri igre. Avtorizirani uporabnik, ki se je pridružil igri, in ustvarjalec igre se imenujeta udeleženca igre.

Ogled dogodkov v igri

Vsak nepooblaščen uporabnik lahko zahteva seznam dogodkov za neaktivne igre, medtem ko lahko pooblaščeni uporabnik dobi seznam dogodkov za katero koli aktivno igro. Številka dogodka, ki jo uporabnik že ima, se lahko funkciji posreduje kot dodaten parameter. V tem primeru bodo vrnjeni le dogodki, ki so se zgodili pred kratkim. Z občasnim izvajanjem te funkcije lahko pooblaščeni uporabnik spremlja aktivnost igre. Ta funkcija vrne tudi zahtevo za dejanje, na katero se lahko uporabnik odzove s funkcijo pošiljanja dogodkov v igri.

Pošiljanje igralnega dogodka

Ta funkcija je na voljo samo udeležencem igre: igralci lahko zaženejo igro, naredijo potezo, glasujejo, napišejo besedilno sporočilo, ki se prikaže na seznamu dogodkov v igri itd.
Pooblaščeni uporabnik, ki je ustvaril igro, sproži dodelitev vlog vsem igralcem, vključno s samim seboj. Svojo vlogo morajo potrditi z isto funkcijo. Ko so vse vloge potrjene, se igra samodejno preklopi v nočni način.

Statistika igre

Ta funkcija deluje samo za udeležence igre in prikazuje stanje igre, seznam in število igralcev (psevdonimov), vloge in njihov status (ali je bila poteza opravljena ali ne) ter druge informacije. Kot prejšnja funkcija tudi ta deluje samo za udeležence igre.

Periodično sprožene funkcije

Če igra ni bila zagnana določeno časovno obdobje, določeno ob ustvarjanju igre, bo s funkcijo čiščenja samodejno odstranjena s seznama aktivnih iger.

Druga periodična naloga je vsiliti preklop iz noči v dan in nazaj pri igrah, ki se med potezo ne preklapljajo (na primer igralec, ki se mora odzvati na dogodek v igri, iz nekega razloga ne odda svoje odločitve).