ProHoster > Blog > Administratioun > "Nei Epos". Mir iessen den Elefant an Deeler

"Nei Epos". Mir iessen den Elefant an Deeler

"Nei Epos". Mir iessen den Elefant an Deeler

An dësem Artikel wäert ech en Aarbechtsëmfeld opbauen fir d'Spill "Epics" z'entwéckelen, a wäert och d'Spill selwer an Deeler opbriechen, déi gëeegent sinn fir an OpenFaaS ze benotzen. Ech wäert all Manipulatiounen op Linux maachen, ech wäert Kubernetes a Minikube mat VirtualBox ofsetzen. Meng Aarbechtsmaschinn huet 2 Prozessor Cores an 12GB RAM; Ech benotzen eng SSD als Systemdisk. Ech benotzen debian 8 als mäin Haaptentwécklungssystem, mat emacs, sudo, git a virtualbox Packagen installéiert, alles anescht gëtt installéiert andeems Dir vu GitHub an aner Quellen erofluet. Mir wäerten dës Uwendungen an /usr/local/bin installéieren, wann net anescht uginn. Loosst eis ufänken!

D'Aarbechtsëmfeld virbereeden

Installéiere Go

Mir befollegen d'Instruktioune vun der offizieller Websäit:

$ 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

Iwwerpréift Funktionalitéit:

$ 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

Installatioun faas-cli

Mir befollegen d'Instruktioune vun der offizieller Websäit:

$ 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

Zousätzlech kënnt Dir Bash-Completion aktivéieren:

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

Kubernetes installéieren an konfiguréieren

Fir d'Entwécklung ass Minikube genuch, also installéiere se a kubelet an /usr/local/bin, an installéiert Helm fir Uwendungen z'installéieren:

$ 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

Minikube starten:

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

Mir iwwerpréiwen:

$ 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

Installéiert OpenFaaS

D'Entwéckler recommandéieren 2 Nummraim ze kreéieren fir mat ze schaffen:

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

Füügt e Repository fir Helm:

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

D'Chart huet d'Fäegkeet e Passwuert virun der Installatioun ze setzen, loosst eis et benotzen an d'Zougangsdaten als k8s Geheimnis späicheren:

$ 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

Loosst eis ofsetzen:

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

No enger Zäit lafen mir de proposéierte Kommando:

$ 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

Iwwerpréift Funktionalitéit:

$ 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

Installatioun Mongodb

Mir installéieren alles mam Helm:

$ 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

Mir iwwerpréiwen:

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

Dréckt Ctrl+D fir aus dem Container erauszekommen.

Emacs opsetzen

Am Prinzip war alles schonn no konfiguréiert dësen Artikel, also ginn ech net an den Detail.

Ofbriechen d'Spill a Funktiounen

Interaktioun mat Funktiounen gëtt iwwer den http Protokoll duerchgefouert, end-to-end Authentifikatioun tëscht verschiddene Funktiounen gëtt vum JWT geliwwert. Mongodb gëtt benotzt fir Tokens ze späicheren, souwéi Spillzoustand, Spillerdaten, Sequenze vu Beweegunge vun all Spiller an aner Informatioun. Loosst eis déi interessantst Features méi no kucken.

Immatrikulatioun

Den Input vun dëser Funktioun ass JSON mam Spill Spëtznumm a Passwuert. Wann dës Funktioun genannt gëtt, gëtt gepréift datt dësen Alias ​​net an der Datebank ass; wann de Scheck erfollegräich ass, ginn den Alias ​​a Passwuert Hash an d'Datebank agebaut. Aschreiwung ass néideg fir aktiv um Spill matzemaachen.

Element

D'Funktiounsinput ass JSON mat engem Spill Spëtznumm a Passwuert; wann et e Spëtznumm an der Datebank ass an d'Passwuert erfollegräich verifizéiert ass mat deem wat virdru an der Datebank gespäichert ass, gëtt e JWT zréckginn, deen un aner Funktiounen weidergeleet gëtt wann se sinn genannt. Verschidde Service records ginn och an d'Datebank agebaut, zum Beispill, lescht Login Zäit, etc.

Kuckt eng Lëscht vu Spiller

All onerlaabt Benotzer kann eng Lëscht vun all Spiller ufroen ausser aktiv. En autoriséierte Benotzer gesäit och eng Lëscht vun aktive Spiller. D'Resultat vun der Funktioun ass JSON mat Lëschte vu Spiller (Spill ID, mënschlech liesbaren Numm, etc.).

Spill Kreatioun

D'Funktioun funktionnéiert nëmme mat autoriséierte Benotzer; déi maximal Unzuel u Spiller gëtt um Input akzeptéiert, souwéi Spillparameter (zum Beispill, wéi eng Charaktere fir an dësem Spill ze aktivéieren, déi maximal Unzuel u Spiller, etc.). E separate Parameter vum Spill ass d'Präsenz vun engem Passwuert fir matzemaachen, wat Iech erlaabt net-ëffentlech Spiller ze kreéieren. Par défaut gëtt en ëffentlecht Spill erstallt. D'Resultat vun der Funktioun ass JSON, deen e Kreatioun Erfollegsfeld, en eenzegaartege Spillidentifizéierer an aner Parameteren enthält.

Bei engem Spill

D'Funktioun funktionnéiert nëmme mat autoriséierten Benotzer, den Input ass d'Spill ID a säi Passwuert, wann dëst en net ëffentlecht Spill ass, ass d'Ausgab JSON mat de Spillparameter. Den autoriséierte Benotzer deen an d'Spill bäikomm ass, wéi och den Ersteller vum Spill, ginn heino Spilldeeler genannt.

Gesinn Spill Evenementer

All onerlaabt Benotzer kann eng Lëscht vun Evenementer fir inaktiv Spiller Ufro, an autoriséiert Benotzer kann eng Lëscht vun Evenementer fir all aktiv Spill kréien. En zousätzleche Parameter fir d'Funktioun kann d'Evenementnummer sinn, déi de Benotzer schonn huet. An dësem Fall ginn nëmmen déi Eventer déi spéider geschitt sinn an der Lëscht zréck. Andeems Dir dës Funktioun periodesch lancéiert, kuckt en autoriséierte Benotzer wat am Spill geschitt. Dës Funktioun gëtt och eng Handlungsufro zréck, op déi de Benotzer kann äntweren mat der Spill Event Dispatch Funktioun.

Schéckt e Spill Event

D'Funktioun funktionnéiert nëmme fir Participanten: et ass méiglech d'Spill unzefänken, eng Beweegung ze maachen, ze stëmmen, en SMS ze schreiwen deen an der Lëscht vun de Spillevenementer ugewise gëtt, asw.
Den autoriséierte Benotzer, deen d'Spill erstallt huet, fänkt un Rollen un all Participanten am Spill ze verdeelen, och selwer, si mussen hir Roll mat der selwechter Funktioun bestätegen. Wann all Rollen bestätegt sinn, wiesselt d'Spill automatesch an den Nuetsmodus.

Spill Statistiken

D'Funktioun funktionnéiert nëmme fir Participanten; et weist den Zoustand vum Spill, d'Lëscht an d'Zuel vun de Spiller (Spëtznimm), Rollen an hire Status (Beweegung gemaach oder net), souwéi aner Informatioun. Wéi mat der viregter Funktioun funktionnéiert alles nëmme fir Participanten.

Periodesch lancéiert Funktiounen

Wann d'Spill fir eng Zäit net lancéiert gouf uginn wann Dir d'Spill erstellt, gëtt et automatesch aus der Lëscht vun aktive Spiller geläscht mat der kloerer Funktioun.

Eng aner periodesch Aufgab ass den forcéierten Ëmschalten vum Spillmodus vun Nuecht op Dag an zréck fir Spiller fir déi dëst net während dem Tour geschitt ass (zum Beispill e Spiller deen op e Spill Event reagéiere muss huet seng Léisung aus iergendengem Grond net geschéckt ).

Announcement

  • Aféierung
  • D'Entwécklungsëmfeld opzestellen, d'Aufgab a Funktiounen opzedeelen
  • Backend Aarbecht
  • Frontend Aarbecht
  • CICD opsetzen, Testen organiséieren
  • Start eng Prouf Spill Sessioun
  • Resultater

Source: will.com

Setzt e Commentaire