🥇 "Jaunie epika." Mēs ēdam ziloni pa daļām

Šajā rakstā es izveidošu darba vidi spēles "Epics" izstrādei, kā arī sadalīšu pašu spēli daļās, kas piemērotas lietošanai OpenFaaS. Es izdarīšu visas manipulācijas uz Linux, es izvietošu Kubernetes minikube, izmantojot VirtualBox. Manā darba mašīnā ir 2 procesoru kodoli un 12 GB RAM; kā sistēmas disku es izmantoju SSD. Kā galveno izstrādes sistēmu izmantošu debian 8, ar uzinstalētām emacs, sudo, git un virtualbox pakotnēm, viss pārējais tiks instalēts lejupielādējot no GitHub un citiem avotiem. Mēs instalēsim šīs lietojumprogrammas mapē /usr/local/bin, ja vien nav norādīts citādi. Sāksim!

Darba vides sagatavošana

Go instalēšana

Mēs izpildām norādījumus no oficiālās vietnes:

$ 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

Pārbauda funkcionalitāti:

$ 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 instalēšana

Mēs izpildām norādījumus no oficiālās vietnes:

$ 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

Turklāt varat iespējot bash pabeigšanu:

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

Kubernetes instalēšana un konfigurēšana

Izstrādei pietiek ar minikube, tāpēc instalējiet to un kubelet mapē /usr/local/bin un instalējiet helm, lai instalētu lietojumprogrammas:

$ 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

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

Pārbaude:

$ 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

OpenFaaS instalēšana

Izstrādātāji iesaka izveidot 2 nosaukumvietas, ar kurām strādāt:

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

Pievienojiet stūres repozitoriju:

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

Diagrammai ir iespēja iestatīt paroli pirms instalēšanas, izmantosim to un saglabāsim piekļuves datus kā k8s noslēpumu:

$ 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

Izvietosim:

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

Pēc kāda laika mēs palaižam piedāvāto komandu:

$ 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

Pārbauda funkcionalitāti:

$ 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

Mongodb instalēšana

Mēs visu uzstādām, izmantojot stūri:

$ 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

Pārbaude:

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

Nospiediet ctrl+D, lai izietu no konteinera.

Emacs iestatīšana

Principā viss jau bija konfigurēts atbilstoši Šis raksts, tāpēc es neiedziļināšos.

Spēles sadalīšana funkcijās

Mijiedarbība ar funkcijām tiek veikta, izmantojot http protokolu, JWT nodrošina pilnīgu autentifikāciju starp dažādām funkcijām. Mongodb tiek izmantots, lai saglabātu žetonus, kā arī spēles stāvokli, spēlētāja datus, visu spēļu gājienu secības un citu informāciju. Sīkāk apskatīsim interesantākās funkcijas.

Reģistrēšanās

Šīs funkcijas ievade ir JSON ar spēles segvārdu un paroli. Kad šī funkcija tiek izsaukta, tiek pārbaudīts, vai šis aizstājvārds nav datu bāzē; ja pārbaude ir veiksmīga, aizstājvārds un paroles jaucējvārds tiek ievietoti datu bāzē. Lai aktīvi piedalītos spēlē, nepieciešama reģistrācija.

Ievade

Funkcijas ievade ir JSON ar spēles segvārdu un paroli; ja datu bāzē ir segvārds un parole ir veiksmīgi pārbaudīta ar iepriekš datubāzē saglabāto, tiek atgriezts JWT, kas jānodod citām funkcijām, kad tās ir sauca. Datubāzē tiek ievietoti arī dažādi servisa ieraksti, piemēram, pēdējais pieteikšanās laiks u.c.

Skatiet spēļu sarakstu

Jebkurš neautorizēts lietotājs var pieprasīt visu spēļu sarakstu, izņemot aktīvās. Autorizēts lietotājs redz arī aktīvo spēļu sarakstu. Funkcijas rezultāts ir JSON, kurā ir spēļu saraksti (spēles ID, cilvēkiem lasāms nosaukums utt.).

Spēles izveide

Funkcija darbojas tikai ar autorizētiem lietotājiem, ievadē tiek pieņemts maksimālais spēlētāju skaits, kā arī spēles parametri (piemēram, kuras rakstzīmes šajā spēlē jāaktivizē, maksimālais spēlētāju skaits utt.). Atsevišķs spēles parametrs ir pievienošanās paroles klātbūtne, kas ļauj izveidot nepubliskas spēles. Pēc noklusējuma tiek izveidota publiska spēle. Funkcijas rezultāts ir JSON, kurā ir veiksmīgas izveides lauks, unikāls spēles identifikators un citi parametri.

Pievienošanās spēlei

Funkcija darbojas tikai ar autorizētiem lietotājiem, ievade ir spēles ID un tās parole, ja šī ir nepubliska spēle, izvade ir JSON ar spēles parametriem. Autorizētais lietotājs, kurš pievienojies spēlei, kā arī spēles veidotājs turpmāk tiek saukts par spēles dalībniekiem.

Spēļu notikumu apskate

Jebkurš neautorizēts lietotājs var pieprasīt neaktīvo spēļu notikumu sarakstu, un pilnvarots lietotājs var saņemt notikumu sarakstu jebkurai aktīvai spēlei. Funkcijas papildu parametrs var būt notikuma numurs, kas lietotājam jau ir. Šajā gadījumā sarakstā tiks atgriezti tikai tie notikumi, kas notika vēlāk. Periodiski palaižot šo funkciju, autorizēts lietotājs skatās, kas notiek spēlē. Šī funkcija arī atgriež darbības pieprasījumu, uz kuru lietotājs var atbildēt, izmantojot spēles notikumu nosūtīšanas funkciju.

Spēles pasākuma nosūtīšana

Funkcija darbojas tikai spēles dalībniekiem: ir iespējams uzsākt spēli, veikt gājienu, balsot, uzrakstīt īsziņu, kas tiek parādīta spēles notikumu sarakstā utt.
Autorizētais lietotājs, kurš izveidoja spēli, sāk sadalīt lomas visiem spēles dalībniekiem, ieskaitot sevi, viņiem ir jāapstiprina sava loma, izmantojot to pašu funkciju. Kad visas lomas ir apstiprinātas, spēle automātiski pārslēdzas uz nakts režīmu.

Spēles statistika

Funkcija darbojas tikai spēles dalībniekiem, tā parāda spēles stāvokli, spēlētāju sarakstu un skaitu (segvārdus), lomas un to statusu (pārvietošanās veikta vai ne), kā arī citu informāciju. Tāpat kā ar iepriekšējo funkciju, viss darbojas tikai spēles dalībniekiem.

Periodiski palaistas funkcijas

Ja spēle nav palaista kādu laiku, kas norādīts, veidojot spēli, tā tiks automātiski izņemta no aktīvo spēļu saraksta, izmantojot dzēšanas funkciju.

Vēl viens periodisks uzdevums ir piespiedu spēles režīma pārslēgšana no nakts uz dienu un atpakaļ spēlēm, kurām tas nenotika gājiena laikā (piemēram, spēlētājs, kuram jāreaģē uz spēles notikumu, kaut kādu iemeslu dēļ nav nosūtījis savu risinājumu ).

Paziņojums

Ievads
Izstrādes vides iestatīšana, uzdevuma sadalīšana funkcijās
Aizmugurējais darbs
Frontend darbs
CICD izveide, testēšanas organizēšana
Sāciet izmēģinājuma spēles sesiju
Rezultāti

Avots: www.habr.com

"Jaunie epika". Mēs ēdam ziloni pa daļām