🥇 "Novi Epi." Slona jemo po delih

V tem članku bom postavil delovno okolje za razvoj igre "Epics", prav tako pa bom samo igro razdelil na dele, primerne za uporabo v OpenFaaS. Vse manipulacije bom izvajal na Linuxu, Kubernetes bom namestil v minikube s pomočjo VirtualBoxa. Moj delovni stroj ima 2 procesorski jedri in 12 GB RAM-a, kot sistemski disk uporabljam SSD. Kot glavni razvojni sistem bom uporabljal debian 8, z nameščenimi paketi emacs, sudo, git in virtualbox, vse ostalo se bo namestilo s prenosom iz GitHub-a in drugih virov. Te aplikacije bomo namestili v /usr/local/bin, razen če ni določeno drugače. Začnimo!

Priprava delovnega okolja

Namestitev Go

Sledimo navodilom z uradne spletne strani:

$ 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

Preverjanje 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

Namestitev faas-cli

Sledimo navodilom z uradne spletne strani:

$ 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

Poleg tega lahko omogočite bash-dokončanje:

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

Namestitev in konfiguracija Kubernetesa

Za razvoj zadostuje minikube, zato ga in kubelet namestite v /usr/local/bin, za nameščanje aplikacij pa namestite 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

Zaženi 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"

Preverjamo:

$ 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

Namestitev OpenFaaS

Razvijalci priporočajo ustvarjanje dveh imenskih prostorov za delo:

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

Dodajte repozitorij za krmilo:

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

Grafikon ima možnost nastavitve gesla pred namestitvijo, uporabimo ga in shranimo dostopne podatke kot skrivnost k8s:

$ 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

Razmestimo:

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

Čez nekaj časa zaženemo predlagani ukaz:

$ 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

Preverjanje 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

Namestitev Mongodb

Vse montiramo s krmilom:

$ 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

Preverjamo:

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 izhod iz vsebnika.

Nastavitev emacsa

Načeloma je bilo vse že konfigurirano glede na ta članek, zato ne bom šel v podrobnosti.

Razčlenitev igre na funkcije

Interakcija s funkcijami poteka prek protokola http, avtentikacijo med različnimi funkcijami pa zagotavlja JWT. Mongodb se uporablja za shranjevanje žetonov, pa tudi stanja igre, podatkov o igralcih, zaporedij potez vseh iger in drugih informacij. Oglejmo si podrobneje najbolj zanimive lastnosti.

registracija

Vnos te funkcije je JSON z vzdevkom igre in geslom. Ko se ta funkcija pokliče, se preveri, ali tega vzdevka ni v bazi podatkov; če je preverjanje uspešno, se vzdevek in zgoščena vrednost gesla vstavita v bazo podatkov. Za aktivno sodelovanje v igri je potrebna registracija.

Vhod

Vnos funkcije je JSON z vzdevkom in geslom za igro; če obstaja vzdevek v bazi podatkov in je geslo uspešno preverjeno s tistim, ki je bil predhodno shranjen v bazi podatkov, se vrne JWT, ki ga je treba posredovati drugim funkcijam, ko so klical. V bazo se vnesejo tudi različni servisni zapisi, na primer čas zadnje prijave itd.

Oglejte si seznam iger

Vsak nepooblaščen uporabnik lahko zahteva seznam vseh iger razen aktivnih. Pooblaščeni uporabnik vidi tudi seznam aktivnih iger. Rezultat funkcije je JSON, ki vsebuje sezname iger (ID igre, človeku berljivo ime itd.).

Ustvarjanje igre

Funkcija deluje samo s pooblaščenimi uporabniki, pri vnosu je sprejeto največje število igralcev, pa tudi parametri igre (na primer, katere znake aktivirati v tej igri, največje število igralcev itd.). Ločen parameter igre je prisotnost gesla za pridružitev, ki vam omogoča ustvarjanje nejavnih iger. Privzeto je ustvarjena javna igra. Rezultat funkcije je JSON, ki vsebuje polje za uspešno ustvarjanje, edinstven identifikator igre in druge parametre.

Pridružitev igri

Funkcija deluje samo s pooblaščenimi uporabniki, vnos je ID igre in njeno geslo, če je to nejavna igra, je izhod JSON s parametri igre. Pooblaščeni uporabnik, ki je pristopil k igri, ter ustvarjalec igre, se v nadaljevanju imenujemo udeleženci igre.

Ogled dogodkov v igri

Vsak nepooblaščen uporabnik lahko zahteva seznam dogodkov za neaktivne igre, pooblaščeni uporabnik pa lahko prejme seznam dogodkov za katero koli aktivno igro. Dodaten parameter k funkciji je lahko številka dogodka, ki jo uporabnik že ima. V tem primeru bodo na seznam vrnjeni samo tisti dogodki, ki so se zgodili pozneje. Z občasnim zagonom te funkcije pooblaščeni uporabnik spremlja dogajanje v igri. Ta funkcija vrne tudi zahtevo za dejanje, na katero se lahko uporabnik odzove s funkcijo pošiljanja dogodkov v igri.

Pošiljanje dogodka igre

Funkcija deluje samo za udeležence igre: možno je začeti igro, narediti potezo, glasovati, napisati besedilno sporočilo, ki se prikaže na seznamu dogodkov v igri ipd.
Pooblaščeni uporabnik, ki je ustvaril igro, začne deliti vloge vsem udeležencem v igri, vključno s samim seboj, svojo vlogo morajo potrditi z isto funkcijo. Ko so vse vloge potrjene, igra samodejno preklopi v nočni način.

Statistika igre

Funkcija deluje samo za udeležence igre, prikazuje stanje igre, seznam in število igralcev (vzdevki), vloge in njihov status (izvedena poteza ali ne) ter druge informacije. Kot pri prejšnji funkciji vse deluje samo za udeležence igre.

Občasno zagnane funkcije

Če igra ni bila zagnana nekaj časa, določenega ob ustvarjanju igre, bo samodejno odstranjena s seznama aktivnih iger s funkcijo počisti.

Druga občasna naloga je prisilno preklapljanje načina igre iz nočnega v dnevnega in nazaj za igre, pri katerih se to ni zgodilo med potezo (na primer igralec, ki se mora odzvati na dogodek v igri, iz nekega razloga ni poslal svoje rešitve ).

Obvestilo

Predstavitev
Postavitev razvojnega okolja, razčlenitev naloge na funkcije
Zaledno delo
Frontend delo
Postavitev CICD, organizacija testiranja
Začnite poskusno igro
Rezultati

Vir: www.habr.com

"Novi epiki". Slona jemo po delih