🥇«Uued Byline'id». Söödame elevanti osade kaupa

Selles artiklis seadistan mängude arendamiseks töötava keskkonna "Büliinid" ning jagan mängu erinevateks osadeks, mida saab kasutada OpenFaaS-is. Kõik toimingud teen Linuxis, Kubernetes käivitame minikube’i abil, kasutades VirtualBoxi. Minu töömasinas on 2 protsessorituuma ja 12 GB RAM-i, süsteemi ketas on SSD. Arenduse peamise süsteemina kasutan Debian 8, millel on installitud paketid emacs, sudo, git ja virtualbox; kõik muu paigaldan GitHubist ja teistest allikatest. Need rakendused installime /usr/local/bin, kui pole teisiti märgitud. Alustame!

Töökeskkonna ettevalmistamine

Go paigaldamine

Järgime ametlikul veebilehel olevat juhendit:

$ 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

Kontrollime töökindlust:

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

Järgime ametlikul veebilehel olevat juhendit:

$ curl -sSL https://cli.openfaas.com | sudo -E sh
x86_64
Laadimine paketist https://github.com/openfaas/faas-cli/releases/download/0.11.3/faas-cli as /tmp/faas-cli
Laadimine lõpetatud.

Käivitamine piisavate õigustega, et proovida faas-cli liigutada /usr/local/bin
Uus versioon faas-cli-st on installitud /usr/local/bin
Loodud alias 'faas' 'faas-cli' jaoks.
  ___                   _____           ____
 / _  _ __   ___ _ __ |  ___|_ _  __ _/ ___|
| | | | '_  / _  '_ | |_ / _` |/ _` ___ 
| |_| | |_) |  __/ | | |  _| (_| | (_| |___) |
 ___/| .__/_ ___|_| |_|_|  __,_|__,_|____/
      |_|

CLI:
 commit:  73004c23e5a4d3fdb7352f953247473477477a64
 versioon: 0.11.3

Lisaks saab lubada bash-completion kasutamise:

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

Kubernetesi installimine ja seadistamine

Arendamiseks piisab minikube’ist, nii et installime selle ja kubeleti /usr/local/bin, samuti paigaldame rakenduste jaoks 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

Käivitame minikube:

$ minikube start
  minikube v1.6.2 Debian 8.11-l
  Automaatiliselt valiti 'virtualbox' draiver (alternatiivid: [])
  Laadimine VM alglaadimisfail ...
    > 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
  Virtuaalboxi VM loomine (CPU-d=2, Mälu=8192MB, Disk=20000MB) ...
  Kubernetes v1.17.0 ettevalmistamine Docker '19.03.5' ...
  kubeadm v1.17.0 laadimine
  kubelet v1.17.0 laadimine
  Pildid alla laadimine ...
  Kubernetes käivitamine ...  Ootame, kuni klaster on online ...
  Sooritatud! kubectl on nüüd konfigureeritud kasutama "minikube"

Kontrollime:

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

OpenFaaS'i installimine

Arendajad soovitavad luua 2 namespace'i tööks:

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

Lisame helm'i registri:

$ helm repo add openfaas https://openfaas.github.io/faas-netes/
"openfaas" on teie registritesse lisatud

Chart'is on võimalus määrata parool enne installimist, kasutame seda ja salvestame sisselogimisandmed k8s saladusena:

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

Teostame juurutamise:

$ helm repo update
Oodake, kuni saame teie chart'i registritest uusimad ...
...Edukas uuendus "openfaas" chart'i registrist
Uuendus lõpetatud.  Head Helmingut!
$ helm upgrade openfaas --install openfaas/openfaas --namespace openfaas --set functionNamespace=openfaas-fn --set generateBasicAuth=false
Väljalaskmine "openfaas" ei eksisteeri. Paigaldame selle nüüd.
NIMI: openfaas
VIIMASE KORRA PAIGALDATUD: Reede, 25. dets 2019 10:28:22
NAMESPACE: openfaas
STATUS: paigaldatud
REVISION: 1
TESTI KOMPLEKT: Puudub
MÄRKUSED:
Kinnitage, et openfaas on käivitunud, käivitades:

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

Mõne aja pärast käivitame soovitatud käsu:

$ 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

Kontrollime töökindlust:

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

Installeerime kõik helm'i abil:

$ helm repo add stable https://kubernetes-charts.storage.googleapis.com/
"stable" on lisatud teie hoidlatesse
$ 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:
** Palun olge kannatlik, kuni skeem paigaldatakse **

MongoDB-d saab ligipääseda sadama kaudu 27017 järgmise DNS-nime kaudu teie klastris:

    mongodb-1577466908.default.svc.cluster.local

Root parooli saamiseks käivitage:

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

Andmebaasiga ühenduse loomiseks käivitage järgmine käsk:

    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

Selleks, et luua ühendus oma andmebaasiga klastrist väljaspool, täitke järgmised käsud:

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

Kontrollime:

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)
Kui te ei näe käskluse käivitamise käsurealt, proovige vajutada Enter.

> db.version();
4.0.14

Väljumiseks vajutage ctrl+D.

Emacsi seadistamine

Põhimõtteliselt oli kõik juba seadistatud selles artiklis, nii et ma ei hakka seda üksikasjalikult kirjeldama.

Mängu jagamine funktsioonideks

Funktsioonide vahelise suhtlemise tagab HTTP-protokoll, samas kui erinevate funktsioonide vahelise autentimise tagab JWT. Tokenite, mängu staatuse, mängijate andmete, mängude käikude sekvenste ja muu teabe salvestamiseks kasutatakse MongoDB-d. Vaatame lähemalt mõned huvitavad funktsioonid.

Registreerimine

Selle funktsiooni sisendiks on JSON mängu hüüdnime ja parooliga. Funktsiooni väljakutsumise korral kontrollitakse, kas hüüdnime ei ole andmebaasis, ja eduka kontrolli korral lisatakse hüüdnimi ja parooli hash andmebaasi. Registreerimine on vajalik aktiivseks osalemiseks mängus.

Sissepääs

Funktsiooni sisendiks on JSON mängu hüüdnime ja parooli, mille olemasolu korral andmebaasis ja paroolikontrolli eduka sooritamise korral tagastatakse JWT, mida tuleb edastada teistele funktsioonidele nende kutsumisel. Samuti tehakse andmebaasi erinevate teenusrekordite sisestamine, näiteks viimase sisenemise aeg jms.

Mängude nimekirja vaatamine

Igasugune autoriseerimata kasutaja võib küsida kõigi mängude nimekirja, välja arvatud aktiivsed. Autoriseeritud kasutaja näeb ka aktiivsete mängude nimekirja. Funktsiooni tulemuseks on JSON, mis sisaldab mängude loendeid (mängu identifikaator, loetav nimi jms).

Mängu loomine

Funktsioon töötab ainult autoriseeritud kasutajatega, sisendiks on maksimaalne mängijate arv ja mängu parameetrid (näiteks milliseid tegelasi selles mängus aktiveerida, maksimaalne mängijate arv jms). Üks eraldi mängu parameeter on sisenemisparooli olemasolu, mis võimaldab luua mitteavalikke mänge. Vaikimisi luuakse avalik mäng, funktsiooni täitmise tulemusena saadakse JSON, milles on edukuse määratlemise väli, mängu unikaalne identifikaator ja muud parameetrid.

Mänguga liitumine

Funktsioon töötab ainult autoriseeritud kasutajatega, sisendiks on mängu identifikaator ja selle parool, kui see on mitteavalik mäng, väljundiks on mängu parameetritega JSON. Autoriseeritud kasutajat, kes on mänguga liitunud, ning mängu looja nimetatakse edaspidi mängu osalisteks.

Mängu sündmuste vaatamine

Igasugune autoriseerimata kasutaja võib küsida mitteaktiivsete mängude sündmuste nimekirja, aga autoriseeritud kasutaja saab saada aktiivsete mängude sündmuste nimekirja. Funktsiooni lisaparameetrina võib edastada sündmuse numbri, mis kasutajal juba on. Sellisel juhul tagastatakse ainult need sündmused, mis on toimunud hiljem. Autoriseeritud kasutaja vaatab perioodiliselt, mis mängus toimub, käivitades selle funktsiooni. Samuti tagastab see funktsioon toimingu taotluse, millele kasutaja saab reageerida mängu sündmuse saatmise funktsiooniga.

Mängu sündmuse saatmine

Funktsioon töötab ainult mängijatele: võimalus mängu alustada, käiku teha, hääletada, kirjutada tekstisõnum, mis kuvatakse mängu sündmuste loendis jne.
Autoriseeritud kasutaja, kes on mängu loonud, jagab rolle kõigile mängijatele, sealhulgas endale, nad peavad kinnitama oma rolli sama funktsiooni kaudu. Kui kõik rollid on kinnitatud, läheb mäng automaatselt öörežiimi.

Mängu statistika

Funktsioon töötab ainult mängijatele, näitab mängu staatust, mängijate nimekirja ja arvu (pseudonüümid), rolle ja nende staatust (kas on käik tehtud või mitte) ning muud teavet. Nagu eelneva funktsiooni puhul, toimib kõik ainult mängijate jaoks.

Perioodiliselt käitatavad funktsioonid

Kui mängu ei ole teatud aja jooksul, mis määratakse mängu loomisel, käitatud - eemaldatakse see automaatselt aktiivsete mängude loendist koristusfunktsiooni abil.

Veel üks perioodiline ülesanne - sundida mängu režiimi ööst päeva ja vastupidi, kui see ei ole käigul aset leidnud (näiteks mängija, kes peab reageerima mängusündmustele, ei ole mingil põhjusel oma lahendust esitanud).