🥇"Uued Büliinid". Söödame elevanti osade kaupa

Selles artiklis seadistan ma mängu «Büliin» arendamiseks töökeskkonna ning jagan tänase mängu osi, mida saab kasutada OpenFaaS-is. Kõiki toiminguid teen Linuxis ning Kubernetes'i seadistan minikube'i abil, kasutades VirtualBoxi. Minu töökesimusel on 2 protsessorituuma ja 12 GB RAM-i, süsteemidiskina kasutan SSD-d. Arendamiseks kasutan peamise süsteemina Debian 8, millel on installitud paketid emacs, sudo, git ja virtualbox; kõik muu installin GitHubist ja muudest allikatest. Need rakendused installime /usr/local/bin, kui pole muud sätestatud. Alustame!

Töökeskkonna ettevalmistamine

Go installimine

Järgige ametlikel veebilehtedel ametlikke juhiseid:

$ 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öövõimet:

$ 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ärgige ametlikel veebilehtedel ametlikke juhiseid:

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

Käivitamine piisavate õigustega faas-cli liigutamiseks /usr/local/bin
Uus versioon faas-cli'ist on installitud /usr/local/bin
Alias 'faas' on loodud 'faas-cli' jaoks.
  ___                   _____           ____
 / _  _ __   ___ _ __ |  ___|_ _  __ _/ ___|
| | | | '_  / _  '_ | |_ / _` |/ _` ___ 
| |_| | |_) |  __/ | | |  _| (_| | (_| |___) |
 ___/| .__/ ___|_| |_|_|  __,_|__,_|____/
      |_|

CLI:
 commit:  73004c23e5a4d3fdb7352f953247473477477a64
 version: 0.11.3

Lisaks saab aktiveerida bash-completion'i:

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

Kubernetesi installimine ja seadistamine

Arenduseks piisab minikubist, seega installime selle ja kubeleti /usr/local/bin, rakenduste installimiseks installime ka helm'i:

$ 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
  Automaatne 'virtualbox' draiveri valik (alternatiiv: [])
  Virtuaalmasina alglaadimise pildi allalaadimine ...
    > 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
  Virtuaalmasina loomine virtualboxis (CPU-d=2, Mälu=8192MB, Disk=20000MB) ...
  Kubernetes v1.17.0 ettevalmistamine Docker '19.03.5' ...
  kubeadm v1.17.0 allalaadimine
  kubelet v1.17.0 allalaadimine
  Piltide allalaadimine ...
  Kubernetes käivitamine ... Ootame klastrit online ...
  Valmis! kubectl on nüüd seadistatud kasutama "minikube"

Kontrollin:

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

OpenFaaS'i installatsioon

Arendajad soovitavad luua 2 nimemärki 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 hoidla:

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

Graafikus on võimalus seada parool enne installimist, kasutame seda ja salvestame juurdepääsuandmed k8s salajana:

$ 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

Teeme juurutamise:

$ helm repo update
Palun oota, kuni toome sinu graafikute registritest uusimad andmed...
...Eduklalt saime värskenduse "openfaas" graafiku registrist
Uuendamine lõpule viidud. Head Helmist!
$ helm upgrade openfaas --install openfaas/openfaas --namespace openfaas --set functionNamespace=openfaas-fn --set generateBasicAuth=false
Vabastus "openfaas" ei eksisteeri. Paigaldame selle nüüd.
NIMI: openfaas
VIIMATI PAIGALDATUD: Reede 25. detsember 2019 10:28:22
NIMETUS: openfaas
OLEK: paigaldatud
REVISION: 1
TESTIDE KOMPLEKT: Puudub
MÄRKUSED:
Kinnitamaks, et openfaas on käivitunud, käivita:

  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"
NIMI                VALMIS   UP-TO-DATE   SAADAVAL   VANUS
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öövõimet:

$ kubectl rollout status -n openfaas deploy/gateway
deployment "gateway" edukatiiviõigust tõhusalt täidetud
$ kubectl port-forward -n openfaas svc/gateway 8080:8080 &
[1] 6985
Edastamine 127.0.0.1:8080 -> 8080
$ echo -n $PASSWORD | faas-cli login --username admin --password-stdin
Kutsumine OpenFaaS serverisse volituste valideerimiseks...
Seos 8080 jaoks
HOIATUS! Suhtlus ei ole turvaline, palun kaaluge HTTPS-i kasutamist. Letsencrypt.org pakub tasuta SSL/TLS sertifikaate.
võtmed salvestatud admin http://127.0.0.1:8080
$ faas-cli list
Funktsioon                        Kutsed     Replikad

Mongodb installimine

Installeerime kõik helm'i abil:

$ helm repo add stable https://kubernetes-charts.storage.googleapis.com/
"stable" on teie reposse lisatud
$ helm install stable/mongodb --generate-name
NIMI: mongodb-1577466908
VIIMASE KÄITAMISE KUUPÄEV: Reede 25. dets 11:15:11 2019
NIMES: default
OLEK: paigaldatud
REVISION: 1
TESTIMISGRUPP: Puudub
MÄRGID:
** Palun olge kannatlik, kui kaardid on paigaldamisel **

MongoDB-le pääseb ligi 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)

Teie andmebaasi ühendamiseks 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

Teie andmebaasi ühendamiseks väljaspool klastrit käivitage 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

Kontrollin:

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äsku, proovige vajutada enter.

> db.version();
4.0.14

Vajutame ctrl+D, et konteinerist välja minna.

Emacsi seadistamine

Põhimõtteliselt oli kõik juba seadistatud selles artiklis, seega ei hakka ma detailselt üles kirjutama.

Mängu jagamine funktsioonideks

Funktsioonide vahel kommunikatsioon toimub http protokolli kaudu, erinevate funktsioonide vahel tagatakse läbipaistev autentimine JWT abil. Tokeneid, samuti mängu olekut, mängijate andmeid, käikude jadasid ja muud teavet hoitakse mongodb-s. Vaatame välja mõned huvitavamad funktsioonid.

Registreerimine

Selle funktsiooni sisendiks on JSON mängijate hüüdnime ja parooliga. Kui seda funktsiooni kutsutakse, kontrollitakse, et seda hüüdnime ei oleks andmebaasis, ja kui kontroll on edukas, siis sisestatakse hüüdnimi ja parooli hash andmebaasi. Registreerimine on vajalik aktiivseks osalemiseks mängus.

Sisend

Funktsiooni sisendiks on JSON mängija hüüdnime ja parooliga. Kui hüüdnimet on andmebaasis olemas ja parool on edukalt valideeritud, tagastatakse JWT, mida tuleb edastada teistele funktsioonidele nende kutsumisel. Samuti toimub erinevate teenuste sisenemiste, näiteks viimase sissepääsu aja, andmebaasi sisestamine.

Mängude loendi vaatamine

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

Mängu loomine

Funktsioon töötab ainult registreeritud kasutajatega, sisendina võetakse maksimaalne mängijate arv ja mängu parameetrid (näiteks, milliseid tegelasi selles mängus aktiveerida, maksimaalne mängijate arv jne). Eraldi mängu parameetriks on parooli olemasolu liitumiseks, mis võimaldab luua mittetegevusi mänge. Vaikimisi luuakse avalik mäng. Funktsiooni tulemuseks on JSON, milles on loomise edukuse väli, mängu unikaalne identifikaator ning muud parameetrid.

Liitu mänguga

Funktsioon töötab ainult registreeritud kasutajatega, sisendina - mängu identifikaator ja selle parool, kui see on mittetegevuslik mäng, väljastatakse - JSON mängu parameetritega. Registreeritud kasutaja, kes liitub mänguga, ja mängu looja nimetatakse edaspidi mängu osalisteks.

Mängu sündmuste vaatamine

Iga volitamata kasutaja saab taotleda passiivsete mängude sündmuste loetelu, samas kui volitatud kasutaja saab saada loetelu kõikidest aktiivsetest mängudest. Funktsiooni täiendavaks parameetriks võib olla sündmuse number, mis kasutajal juba on. Sellisel juhul tagastatakse loendis ainult need sündmused, mis on toimunud hiljem. Perioodiliselt selle funktsiooni kasutamine võimaldab volitatud kasutajal näha, mis mängus toimub. Funktsioon tagastab ka tegevuse kutsumise, millele kasutaja saab reageerida mängu sündmuse saatmise funktsiooni kaudu.

Saatke mängu sündmus

Funktsioon töötab ainult mängu osalejate jaoks: on võimalik mäng käivitada, käik teha, hääletada, kirjutada tekstisõnum, mis kuvatakse mängu sündmuste loendis jne.
Volitatud kasutaja, kes on mängu loonud, käivitab rollide jagamise kõikidele mängu osalejatele, sealhulgas endale, ning nad peavad oma rolli kinnitama sama funktsiooni kaudu. Kui kõik rollid on kinnitatud, läheb mäng automaatselt öörežiimi.

Mängu statistika

Funktsioon töötab ainult mängu liikmete jaoks, näidates mängu seisundit, mängijate nimekirja ja arvu (väljaanded), rolle ning nende staatust (kas käik on tehtud või mitte) ning muud teavet. Nagu eelneva funktsiooni puhul, töötab kõik ainult mängu liikmete jaoks.

Perioodiliselt käivitatavad funktsioonid

Kui mängu ei ole teatud aja jooksul käivitatud, nagu määratud mängu loomisel, eemaldatakse see automaatselt aktiivsete mängude loendist puhastamise funktsiooni abil.

Veel üks perioodiline ülesanne on mängurežiimi sundülemine ööst päevaks ja tagasi mängude jaoks, millel seda ei toimunud käigus (näiteks mängija, kes peab reageerima mängusündmusele, ei ole mingil põhjusel oma lahendust saatnud).