🥇"Novi epovi." Slona jedemo u dijelovima

U ovom ću članku postaviti radno okruženje za razvoj igre "Epics", a također ću razbiti samu igru na dijelove prikladne za korištenje u OpenFaaS-u. Izvršit ću sve manipulacije na Linuxu, implementirati ću Kubernetes u minikube koristeći VirtualBox. Moj radni stroj ima 2 procesorske jezgre i 12 GB RAM-a; koristim SSD kao sistemski disk. Koristit ću debian 8 kao glavni razvojni sustav, s instaliranim paketima emacs, sudo, git i virtualbox, sve ostalo će se instalirati preuzimanjem s GitHuba i drugih izvora. Te ćemo aplikacije instalirati u /usr/local/bin osim ako nije drugačije navedeno. Započnimo!

Priprema radnog okruženja

Instaliranje Go

Pratimo upute sa službene stranice:

$ 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

Provjera funkcionalnosti:

$ 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

Instalacija faas-cli

Pratimo upute sa službene stranice:

$ 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

Dodatno, možete omogućiti bash-dovršavanje:

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

Instalacija i konfiguracija Kubernetesa

Za razvoj je dovoljan minikube pa ga instalirajte i kubelet u /usr/local/bin, a za instaliranje aplikacija instalirajte 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

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

Provjeravamo:

$ 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

Instaliranje OpenFaaS-a

Programeri preporučuju stvaranje 2 prostora imena za rad:

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

Dodajte spremište za kormilo:

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

Grafikon ima mogućnost postavljanja lozinke prije instalacije, iskoristimo je i spremimo pristupne podatke kao k8s tajnu:

$ 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

Rasporedimo:

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

Nakon nekog vremena pokrećemo predloženu naredbu:

$ 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

Provjera funkcionalnosti:

$ 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

Instaliranje Mongodb-a

Sve montiramo pomoću 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

Provjeravamo:

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 izlaz iz spremnika.

Postavljanje emacsa

U principu, sve je već konfigurirano prema ovaj članak, pa neću ići u detalje.

Rastavljanje igre na funkcije

Interakcija s funkcijama provodi se putem http protokola, end-to-end provjeru autentičnosti između različitih funkcija osigurava JWT. Mongodb se koristi za pohranjivanje tokena, kao i stanja igre, podataka o igraču, nizova poteza svih igara i drugih informacija. Pogledajmo pobliže najzanimljivije značajke.

registracija

Unos ove funkcije je JSON s nadimkom igre i lozinkom. Kada se ova funkcija pozove, provjerava se da ovaj alias nije u bazi podataka; ako je provjera uspješna, alias i hash zaporke se umeću u bazu podataka. Za aktivno sudjelovanje u igri potrebna je registracija.

ulaz

Unos funkcije je JSON s nadimkom igre i lozinkom; ako postoji nadimak u bazi podataka i lozinka je uspješno verificirana onom prethodno spremljenom u bazi podataka, vraća se JWT koji se mora proslijediti drugim funkcijama kada su nazvao. U bazu podataka ubacuju se i razni servisni zapisi, na primjer vrijeme posljednje prijave itd.

Pogledajte popis igara

Svaki neovlašteni korisnik može zatražiti popis svih igara osim aktivnih. Ovlašteni korisnik također vidi popis aktivnih igara. Rezultat funkcije je JSON koji sadrži popise igara (ID igre, čovjeku čitljiv naziv itd.).

Stvaranje igre

Funkcija radi samo s ovlaštenim korisnicima; na ulazu se prihvaća maksimalan broj igrača, kao i parametri igre (na primjer, koje likove aktivirati u ovoj igri, maksimalan broj igrača itd.). Zaseban parametar igre je prisutnost lozinke za pridruživanje, koja vam omogućuje stvaranje nejavnih igara. Prema zadanim postavkama stvara se javna igra. Rezultat funkcije je JSON, koji sadrži polje uspješnosti stvaranja, jedinstveni identifikator igre i druge parametre.

Pridruživanje igri

Funkcija radi samo s ovlaštenim korisnicima, ulaz je ID igre i njezina lozinka, ako je ovo nejavna igra, izlaz je JSON s parametrima igre. Ovlašteni korisnik koji je pristupio igri, kao i kreator igre, u daljnjem tekstu se nazivaju sudionici igre.

Pregled događaja u igri

Svaki neovlašteni korisnik može zatražiti popis događaja za neaktivne igre, a ovlašteni korisnik može dobiti popis događaja za bilo koju aktivnu igru. Dodatni parametar funkciji može biti broj događaja koji korisnik već ima. U tom će slučaju na popisu biti vraćeni samo oni događaji koji su se dogodili kasnije. Povremenim pokretanjem ove funkcije ovlašteni korisnik prati što se događa u igrici. Ova funkcija također vraća zahtjev za radnjom na koji korisnik može odgovoriti pomoću funkcije slanja događaja u igri.

Slanje događaja igre

Funkcija radi samo za sudionike igre: moguće je pokrenuti igru, napraviti potez, glasati, napisati tekstualnu poruku koja se prikazuje na popisu događaja igre itd.
Ovlašteni korisnik koji je kreirao igru počinje raspodjelu uloga svim sudionicima u igri, uključujući i sebe, svoju ulogu moraju potvrditi istom funkcijom. Nakon što su sve uloge potvrđene, igra se automatski prebacuje na noćni način rada.

Statistika igre

Funkcija radi samo za sudionike igre, prikazuje stanje igre, popis i broj igrača (nadimak), uloge i njihov status (učinjen potez ili ne), kao i druge informacije. Kao i kod prethodne funkcije, sve radi samo za sudionike igre.

Povremeno pokretane funkcije

Ako igra nije pokrenuta neko vrijeme određeno prilikom izrade igre, automatski će se ukloniti s popisa aktivnih igara pomoću funkcije brisanja.

Još jedan periodični zadatak je prisilno prebacivanje načina igre iz noćnog u dnevni i natrag za igre za koje se to nije dogodilo tijekom poteza (na primjer, igrač koji treba reagirati na događaj u igri nije poslao svoje rješenje iz nekog razloga ).

Obavijest

Uvod
Postavljanje razvojnog okruženja, rastavljanje zadatka na funkcije
Pozadinski rad
Frontend rad
Postavljanje CICD-a, organiziranje testiranja
Započnite probnu sesiju igre
Rezultati

Izvor: www.habr.com

"Novi epovi". Slona jedemo u dijelovima