U ovom članku ću postaviti radno okruženje za razvoj igre “Epics”, a samu igru ću također razbiti na dijelove pogodne za korištenje u OpenFaaS-u. Radit ću sve manipulacije na Linuxu, Kubernetes ću postaviti u minikube koristeći VirtualBox. Moja radna mašina ima 2 procesorska jezgra i 12GB RAM-a; koristim SSD kao sistemski disk. Koristit ću debian 8 kao svoj glavni razvojni sistem, s instaliranim paketima emacs, sudo, git i virtualbox, sve ostalo će biti instalirano preuzimanjem sa GitHuba i drugih izvora. Ove aplikacije ćemo instalirati u /usr/local/bin osim ako nije drugačije navedeno. Hajde da počnemo!
Programeri preporučuju kreiranje 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:
$ 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 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
Sve ugrađujemo pomoću kormila:
$ 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 da izađete iz kontejnera.
Postavljanje emacsa
U principu, sve je već bilo konfigurisano prema tome ovaj članak, pa neću ulaziti u detalje.
Rastavljanje igre na funkcije
Interakcija sa funkcijama se vrši preko http protokola, end-to-end autentikacija između različitih funkcija je obezbeđena od strane JWT. Mongodb se koristi za pohranjivanje tokena, kao i stanja igre, podataka igrača, sekvenci poteza svih igara i drugih informacija. Pogledajmo bliže najzanimljivije karakteristike.
Registrirajte se
Ulaz ove funkcije je JSON sa nadimkom igre i lozinkom. Kada se ova funkcija pozove, provjerava se da ovaj pseudonim nije u bazi podataka; ako je provjera uspješna, alias i hash lozinke se ubacuju u bazu podataka. Za aktivno učešće u igri potrebna je registracija.
Вход
Unos funkcije je JSON sa nadimkom igre i lozinkom; ako postoji nadimak u bazi podataka i lozinka je uspješno verificirana s onom koja je prethodno sačuvana u bazi, vraća se JWT, koji se mora proslijediti drugim funkcijama kada su pozvao. U bazu podataka se ubacuju i različiti servisni zapisi, na primjer vrijeme posljednje prijave itd.
Pogledajte listu igara
Svaki neovlašteni korisnik može zatražiti popis svih igara osim aktivnih. Ovlašteni korisnik također vidi listu aktivnih igara. Rezultat funkcije je JSON koji sadrži liste igara (ID igre, ljudsko čitljivo ime, itd.).
Kreiranje igre
Funkcija radi samo sa ovlaštenim korisnicima; na ulazu se prihvaća maksimalan broj igrača, kao i parametri igre (npr. koje likove aktivirati u ovoj igrici, maksimalan broj igrača itd.). Poseban parametar igre je prisustvo lozinke za pridruživanje, koja vam omogućava da kreirate nejavne igre. Po defaultu se kreira javna igra. Rezultat funkcije je JSON, koji sadrži polje uspjeha kreiranja, jedinstveni identifikator igre i druge parametre.
Pridruživanje igri
Funkcija radi samo sa ovlaštenim korisnicima, ulaz je ID igre i njena lozinka, ako je ovo nejavna igra, izlaz je JSON sa parametrima igre. Ovlašteni korisnik koji je pristupio igri, kao i kreator igre, u daljem tekstu se nazivaju učesnici igre.
Pregled događaja u igri
Svaki neovlašteni korisnik može zatražiti listu događaja za neaktivne igre, a ovlašteni korisnik može dobiti listu događaja za bilo koju aktivnu igru. Dodatni parametar funkciji može biti broj događaja koji korisnik već ima. U ovom slučaju, samo oni događaji koji su se desili kasnije će biti vraćeni na listu. Povremenim pokretanjem ove funkcije, ovlašteni korisnik prati šta se dešava u igrici. Ova funkcija također vraća zahtjev za akciju, na koji korisnik može odgovoriti pomoću funkcije za slanje događaja u igri.
Slanje događaja igre
Funkcija radi samo za učesnike igre: moguće je započeti igru, povući potez, glasati, napisati tekstualnu poruku koja se prikazuje na listi događaja igre itd.
Ovlašteni korisnik koji je kreirao igru počinje dijeliti uloge svim učesnicima u igri, uključujući i sebe, oni moraju potvrditi svoju ulogu koristeći istu funkciju. Kada su sve uloge potvrđene, igra se automatski prebacuje u noćni način rada.
Statistika igre
Funkcija radi samo za učesnike igre, prikazuje stanje u igri, listu i broj igrača (nadimke), uloge i njihov status (pokret napravljen ili ne), kao i druge informacije. Kao i kod prethodne funkcije, sve radi samo za učesnike igre.
Povremeno pokrenute funkcije
Ako igra nije bila pokrenuta neko vrijeme navedeno pri kreiranju igre, automatski će biti uklonjena sa liste aktivnih igara pomoću funkcije brisanja.
Drugi periodični zadatak je prisilno prebacivanje načina igre iz noćnog u dan i nazad za igre za koje se to nije dogodilo tokom okreta (na primjer, igrač koji treba reagirati na događaj igre nije iz nekog razloga poslao svoje rješenje ).