ProHoster > Blog > Administrácia > "Nové eposy". Slona jeme po častiach

"Nové eposy". Slona jeme po častiach

"Nové eposy". Slona jeme po častiach

V tomto článku nastavím pracovné prostredie pre vývoj hry „Epics“ a rozdelím aj samotnú hru na časti vhodné na použitie v OpenFaaS. Všetky manipulácie urobím na Linuxe, Kubernetes nasadím do minikube pomocou VirtualBoxu. Môj pracovný stroj má 2 jadrá procesora a 12 GB RAM, ako systémový disk používam SSD. Ako hlavný vývojový systém budem používať debian 8, s nainštalovanými balíčkami emacs, sudo, git a virtualbox, všetko ostatné sa nainštaluje stiahnutím z GitHubu a iných zdrojov. Tieto aplikácie nainštalujeme do /usr/local/bin, pokiaľ nie je uvedené inak. Začnime!

Príprava pracovného prostredia

Inštaluje sa Go

Postupujeme podľa pokynov z oficiálnej webovej stránky:

$ 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

Kontrola funkčnosti:

$ 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

Inštalácia faas-cli

Postupujeme podľa pokynov z oficiálnej webovej stránky:

$ 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

Okrem toho môžete povoliť dokončovanie bash:

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

Inštalácia a konfigurácia Kubernetes

Na vývoj stačí minikube, tak si ho a kubelet nainštalujte do /usr/local/bin a nainštalujte helm na inštaláciu aplikácií:

$ 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

Spustiť 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"

skontrolujte:

$ 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

Inštalácia OpenFaaS

Vývojári odporúčajú vytvoriť 2 menné priestory, s ktorými budete pracovať:

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

Pridajte úložisko pre kormidlo:

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

Graf má možnosť nastaviť heslo pred inštaláciou, poďme ho použiť a uložme si prístupové údaje ako k8s tajomstvo:

$ 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

Poďme nasadiť:

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

Po určitom čase spustíme navrhovaný príkaz:

$ 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

Kontrola funkčnosti:

$ 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

Inštalácia Mongodb

Všetko inštalujeme pomocou kormidla:

$ 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

skontrolujte:

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

Stlačením ctrl+D opustíte kontajner.

Nastavenie emacsu

V zásade už bolo všetko nakonfigurované podľa v tomto článku, tak nebudem zachádzať do detailov.

Rozdelenie hry na funkcie

Interakcia s funkciami prebieha cez protokol http, end-to-end autentifikáciu medzi rôznymi funkciami zabezpečuje JWT. Mongodb sa používa na ukladanie tokenov, ako aj stavu hry, údajov hráča, sekvencií ťahov všetkých hier a ďalších informácií. Pozrime sa bližšie na najzaujímavejšie funkcie.

registrácia

Vstup tejto funkcie je JSON s prezývkou hry a heslom. Pri volaní tejto funkcie sa skontroluje, či sa tento alias nenachádza v databáze, ak je kontrola úspešná, do databázy sa vloží alias a hash hesla. Pre aktívnu účasť v hre je potrebná registrácia.

Vstup

Vstup funkcie je JSON s prezývkou hry a heslom; ak je v databáze prezývka a heslo je úspešne overené s heslom predtým uloženým v databáze, vráti sa JWT, ktorý sa musí odovzdať iným funkciám, keď sú volal. Do databázy sa vkladajú aj rôzne servisné záznamy, napríklad čas posledného prihlásenia atď.

Pozrite si zoznam hier

Každý neoprávnený používateľ si môže vyžiadať zoznam všetkých hier okrem aktívnych. Oprávnenému používateľovi sa zobrazí aj zoznam aktívnych hier. Výsledkom funkcie je JSON obsahujúci zoznamy hier (ID hry, človekom čitateľný názov atď.).

Tvorba hry

Funkcia funguje len s oprávnenými používateľmi, na vstupe je akceptovaný maximálny počet hráčov, ako aj parametre hry (napríklad, ktoré postavy v tejto hre aktivovať, maximálny počet hráčov atď.). Samostatným parametrom hry je prítomnosť hesla na pripojenie, ktoré vám umožňuje vytvárať neverejné hry. Štandardne sa vytvorí verejná hra. Výsledkom funkcie je JSON, ktorý obsahuje pole úspešnosti vytvorenia, jedinečný identifikátor hry a ďalšie parametre.

Zapojenie sa do hry

Funkcia funguje len s oprávnenými používateľmi, vstupom je ID hry a jej heslo, ak ide o neverejnú hru, výstup je JSON s parametrami hry. Oprávnený používateľ, ktorý sa do hry zapojil, ako aj tvorca hry sa ďalej nazývajú účastníci hry.

Prezeranie herných udalostí

Každý neoprávnený používateľ môže požiadať o zoznam udalostí pre neaktívne hry a autorizovaný používateľ môže získať zoznam udalostí pre akúkoľvek aktívnu hru. Doplnkovým parametrom funkcie môže byť číslo udalosti, ktoré už používateľ má. V tomto prípade sa do zoznamu vrátia len tie udalosti, ktoré sa vyskytli neskôr. Pravidelným spúšťaním tejto funkcie oprávnený používateľ sleduje, čo sa deje v hre. Táto funkcia tiež vracia požiadavku na akciu, na ktorú môže používateľ reagovať pomocou funkcie odoslania udalosti hry.

Odosielanie hernej udalosti

Funkcia funguje len pre účastníkov hry: je možné spustiť hru, urobiť ťah, hlasovať, napísať textovú správu, ktorá sa zobrazí v zozname herných udalostí atď.
Oprávnený používateľ, ktorý hru vytvoril, začne distribuovať roly všetkým účastníkom hry, vrátane seba, svoju rolu musia potvrdiť pomocou rovnakej funkcie. Po potvrdení všetkých rolí sa hra automaticky prepne do nočného režimu.

Herné štatistiky

Funkcia funguje len pre účastníkov hry, zobrazuje stav hry, zoznam a počet hráčov (prezývky), roly a ich stav (prebehnutý alebo neuskutočnený ťah), ako aj ďalšie informácie. Rovnako ako pri predchádzajúcej funkcii všetko funguje len pre účastníkov hry.

Pravidelne spúšťané funkcie

Ak hra nebola spustená po určitú dobu určenú pri vytváraní hry, automaticky sa odstráni zo zoznamu aktívnych hier pomocou funkcie clear.

Ďalšou periodickou úlohou je nútené prepínanie herného režimu z noci na deň a späť pri hrách, pri ktorých sa tak nestalo počas kola (napríklad hráč, ktorý potrebuje reagovať na hernú udalosť, z nejakého dôvodu neposlal svoje riešenie ).

Oznámenie

  • Úvod
  • Nastavenie vývojového prostredia, rozdelenie úlohy na funkcie
  • Backendová práca
  • Frontendová práca
  • Založenie CICD, organizácia testovania
  • Začnite skúšobnú hru
  • Výsledky

Zdroj: hab.com

Pridať komentár