🥇"Nuwe epiese." Ons eet die olifant in dele

In hierdie artikel sal ek 'n werksomgewing opstel vir die ontwikkeling van die speletjie "Epics", en sal ook die speletjie self opbreek in dele wat geskik is vir gebruik in OpenFaaS. Ek sal al die manipulasies op Linux doen, ek sal Kubernetes in minikube ontplooi met VirtualBox. My werkmasjien het 2 verwerkerkerne en 12GB RAM; Ek gebruik 'n SSD as die stelselskyf. Ek sal debian 8 as my hoofontwikkelingstelsel gebruik, met emacs, sudo, git en virtualbox-pakkette geïnstalleer, alles anders sal geïnstalleer word deur af te laai vanaf GitHub en ander bronne. Ons sal hierdie toepassings in /usr/local/bin installeer, tensy anders gespesifiseer. Laat ons begin!

Voorbereiding van die werksomgewing

Installeer Go

Ons volg die instruksies van die amptelike webwerf:

$ 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

Kontroleer funksionaliteit:

$ 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

Installeer faas-cli

Ons volg die instruksies van die amptelike webwerf:

$ 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

Daarbenewens kan jy bash-voltooiing aktiveer:

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

Installeer en konfigureer Kubernetes

Vir ontwikkeling is minikube genoeg, so installeer dit en kubelet in /usr/local/bin, en installeer stuur om toepassings te installeer:

$ 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

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

Ons kyk na:

$ 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

Installeer OpenFaaS

Die ontwikkelaars beveel aan om 2 naamruimtes te skep om mee te werk:

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

Voeg 'n bewaarplek vir stuur by:

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

Die grafiek het die vermoë om 'n wagwoord voor installasie te stel, kom ons gebruik dit en stoor die toegangsdata as 'n k8s-geheim:

$ 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

Kom ons ontplooi:

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

Na 'n rukkie voer ons die voorgestelde opdrag uit:

$ 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

Kontroleer funksionaliteit:

$ 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

Installeer Mongodb

Ons installeer alles met behulp van stuur:

$ 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

Ons kyk na:

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

Druk ctrl+D om die houer te verlaat.

Die opstel van emacs

In beginsel was alles reeds gekonfigureer volgens Hierdie artikel, so ek gaan nie in detail in nie.

Opdeel van die spel in funksies

Interaksie met funksies word uitgevoer via die http-protokol, end-tot-end-verifikasie tussen verskillende funksies word deur JWT verskaf. Mongodb word gebruik om tokens te stoor, sowel as spelstatus, spelerdata, volgordes van bewegings van alle speletjies en ander inligting. Kom ons kyk na die interessantste kenmerke van naderby.

registrasie

Die invoer van hierdie funksie is JSON met die speletjie-bynaam en wagwoord. Wanneer hierdie funksie opgeroep word, word gekontroleer dat hierdie alias nie in die databasis is nie; as die kontrole suksesvol is, word die alias en wagwoordhash in die databasis ingevoeg. Registrasie is nodig om aktief aan die spel deel te neem.

Input

Die funksie-invoer is JSON met 'n speletjie-bynaam en wagwoord; as daar 'n bynaam in die databasis is en die wagwoord suksesvol geverifieer is met die een wat voorheen in die databasis gestoor is, word 'n JWT teruggestuur, wat na ander funksies oorgedra moet word wanneer hulle geroep. Verskeie diensrekords word ook in die databasis ingevoeg, byvoorbeeld laaste aanmeldtyd, ens.

Bekyk 'n lys speletjies

Enige ongemagtigde gebruiker kan 'n lys van alle speletjies behalwe aktiewe aanvra. 'n Gemagtigde gebruiker sien ook 'n lys aktiewe speletjies. Die resultaat van die funksie is JSON wat lyste van speletjies bevat (speletjie-ID, mens-leesbare naam, ens.).

Speletjie skepping

Die funksie werk slegs met gemagtigde gebruikers; die maksimum aantal spelers word by die invoer aanvaar, sowel as speletjieparameters (byvoorbeeld watter karakters om in hierdie speletjie te aktiveer, die maksimum aantal spelers, ens.). 'N Afsonderlike parameter van die speletjie is die teenwoordigheid van 'n wagwoord vir aansluiting, wat jou toelaat om nie-openbare speletjies te skep. By verstek word 'n publieke speletjie geskep. Die resultaat van die funksie is JSON, wat 'n skeppingsuksesveld, 'n unieke speletjie-identifiseerder en ander parameters bevat.

Sluit aan by 'n speletjie

Die funksie werk slegs met gemagtigde gebruikers, die invoer is die speletjie-ID en sy wagwoord, as dit 'n nie-publieke speletjie is, is die uitset JSON met die speletjieparameters. Die gemagtigde gebruiker wat by die speletjie aangesluit het, sowel as die skepper van die speletjie, word hierna speletjiedeelnemers genoem.

Bekyk speletjiegebeurtenisse

Enige ongemagtigde gebruiker kan 'n lys van gebeure vir onaktiewe speletjies versoek, en 'n gemagtigde gebruiker kan 'n lys van gebeurtenisse vir enige aktiewe speletjie ontvang. 'n Bykomende parameter tot die funksie kan die gebeurtenisnommer wees wat die gebruiker reeds het. In hierdie geval sal slegs daardie gebeurtenisse wat later plaasgevind het in die lys teruggestuur word. Deur hierdie funksie gereeld te begin, kyk 'n gemagtigde gebruiker wat in die speletjie gebeur. Hierdie funksie gee ook 'n aksieversoek terug, waarop die gebruiker kan reageer deur die speletjie se gebeurtenisversendingfunksie te gebruik.

Stuur tans 'n speletjie-geleentheid

Die funksie werk net vir speletjiedeelnemers: dit is moontlik om die speletjie te begin, 'n skuif te maak, te stem, 'n teksboodskap te skryf wat in die lys van wedstrydgeleenthede vertoon word, ens.
Die gemagtigde gebruiker wat die speletjie geskep het, begin rolle aan alle deelnemers aan die speletjie versprei, insluitend hulself, hulle moet hul rol bevestig deur dieselfde funksie te gebruik. Sodra alle rolle bevestig is, skakel die speletjie outomaties oor na nagmodus.

Spelstatistieke

Die funksie werk net vir speletjiedeelnemers; dit wys die stand van die speletjie, die lys en aantal spelers (byname), rolle en hul status (skuif gemaak of nie), sowel as ander inligting. Soos met die vorige funksie, werk alles net vir speletjiedeelnemers.

Funksies word periodiek bekendgestel

As die speletjie vir 'n geruime tyd nie bekendgestel is nie, wat tydens die skep van die speletjie gespesifiseer is, sal dit outomaties verwyder word van die lys aktiewe speletjies met behulp van die skoonmaakfunksie.

Nog 'n periodieke taak is die gedwonge omskakeling van die spelmodus van nag na dag en terug vir speletjies waarvoor dit nie tydens die beurt gebeur het nie (byvoorbeeld, 'n speler wat op 'n wedstrydgebeurtenis moet reageer, het om een of ander rede nie sy oplossing gestuur nie ).

aankondiging

Inleiding
Die opstel van die ontwikkelingsomgewing, die opbreek van die taak in funksies
Agterkant werk
Frontend werk
Opstel van CICD, organisering van toetse
Begin 'n proefspeletjiesessie
Resultate van

Bron: will.com

"Nuwe Epics". Ons eet die olifant in dele