🥇„Neue Epen.“ Wir essen den Elefanten in Teilen

In diesem Artikel werde ich eine Arbeitsumgebung für die Entwicklung des Spiels „Epics“ einrichten und auch das Spiel selbst in Teile zerlegen, die für die Verwendung in OpenFaaS geeignet sind. Ich werde alle Manipulationen unter Linux durchführen und Kubernetes in Minikube mithilfe von VirtualBox bereitstellen. Meine Arbeitsmaschine verfügt über 2 Prozessorkerne und 12 GB RAM; als Systemfestplatte verwende ich eine SSD. Ich werde Debian 8 als mein Hauptentwicklungssystem verwenden, mit installierten Emacs-, Sudo-, Git- und Virtualbox-Paketen, alles andere wird durch Herunterladen von GitHub und anderen Quellen installiert. Wir werden diese Anwendungen in /usr/local/bin installieren, sofern nicht anders angegeben. Lass uns anfangen!

Vorbereitung der Arbeitsumgebung

Go installieren

Wir folgen den Anweisungen auf der offiziellen Website:

$ 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

Funktionalität prüfen:

$ 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

Installation von faas-cli

Wir folgen den Anweisungen auf der offiziellen Website:

$ 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

Darüber hinaus können Sie die Bash-Vervollständigung aktivieren:

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

Kubernetes installieren und konfigurieren

Für die Entwicklung reicht Minikube aus, also installieren Sie es und Kubelet in /usr/local/bin und installieren Sie helm, um Anwendungen zu installieren:

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

Wir prüfen:

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

Die Entwickler empfehlen die Erstellung von zwei Namespaces für die Arbeit:

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

Fügen Sie ein Repository für Helm hinzu:

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

Das Diagramm bietet die Möglichkeit, vor der Installation ein Passwort festzulegen. Verwenden Sie es und speichern Sie die Zugangsdaten als k8s-Geheimnis:

$ 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

Lassen Sie uns Folgendes bereitstellen:

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

Nach einiger Zeit führen wir den vorgeschlagenen Befehl aus:

$ 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

Funktionalität prüfen:

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

Wir installieren alles mit 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

Wir prüfen:

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ücken Sie Strg+D, um den Container zu verlassen.

Emacs einrichten

Im Prinzip war schon alles entsprechend konfiguriert Dieser Artikel, deshalb werde ich nicht ins Detail gehen.

Das Spiel in Funktionen aufteilen

Die Interaktion mit Funktionen erfolgt über das http-Protokoll, eine End-to-End-Authentifizierung zwischen verschiedenen Funktionen wird von JWT bereitgestellt. Mongodb wird zum Speichern von Token sowie des Spielstatus, Spielerdaten, Zugfolgen aller Spiele und anderer Informationen verwendet. Schauen wir uns die interessantesten Funktionen genauer an.

Anmelden

Die Eingabe dieser Funktion ist JSON mit dem Spitznamen und dem Passwort des Spiels. Beim Aufruf dieser Funktion wird geprüft, ob dieser Alias nicht in der Datenbank vorhanden ist; bei erfolgreicher Prüfung werden Alias und Passwort-Hash in die Datenbank eingefügt. Für die aktive Teilnahme am Spiel ist eine Anmeldung erforderlich.

Eingang

Die Funktionseingabe ist JSON mit einem Spiel-Spitznamen und einem Passwort. Wenn in der Datenbank ein Spitzname vorhanden ist und das Passwort erfolgreich mit dem zuvor in der Datenbank gespeicherten Passwort überprüft wird, wird ein JWT zurückgegeben, das bei Bedarf an andere Funktionen übergeben werden muss angerufen. In die Datenbank werden auch verschiedene Serviceaufzeichnungen eingefügt, beispielsweise der letzte Anmeldezeitpunkt usw.

Sehen Sie sich eine Liste mit Spielen an

Jeder nicht autorisierte Benutzer kann eine Liste aller Spiele mit Ausnahme der aktiven anfordern. Ein autorisierter Benutzer sieht außerdem eine Liste der aktiven Spiele. Das Ergebnis der Funktion ist JSON, das Listen von Spielen enthält (Spiel-ID, für Menschen lesbarer Name usw.).

Spiel erstellen

Die Funktion funktioniert nur mit autorisierten Benutzern; am Eingang werden die maximale Spielerzahl sowie Spielparameter akzeptiert (z. B. welche Charaktere in diesem Spiel aktiviert werden sollen, die maximale Spielerzahl usw.). Ein separater Parameter des Spiels ist das Vorhandensein eines Beitrittspassworts, mit dem Sie nicht öffentliche Spiele erstellen können. Standardmäßig wird ein öffentliches Spiel erstellt. Das Ergebnis der Funktion ist JSON, das ein Feld für den Erstellungserfolg, eine eindeutige Spielkennung und andere Parameter enthält.

Teilnahme an einem Spiel

Die Funktion funktioniert nur mit autorisierten Benutzern, die Eingabe ist die Spiel-ID und ihr Passwort, wenn es sich um ein nicht öffentliches Spiel handelt, ist die Ausgabe JSON mit den Spielparametern. Der autorisierte Benutzer, der dem Spiel beigetreten ist, sowie der Ersteller des Spiels werden im Folgenden als Spielteilnehmer bezeichnet.

Spielereignisse ansehen

Jeder nicht autorisierte Benutzer kann eine Ereignisliste für inaktive Spiele anfordern, und ein autorisierter Benutzer kann eine Ereignisliste für jedes aktive Spiel erhalten. Ein zusätzlicher Parameter der Funktion kann die Ereignisnummer sein, die der Benutzer bereits hat. In diesem Fall werden nur die später eingetretenen Ereignisse in der Liste zurückgegeben. Durch den regelmäßigen Start dieser Funktion beobachtet ein autorisierter Benutzer, was im Spiel passiert. Diese Funktion gibt auch eine Aktionsanforderung zurück, auf die der Benutzer mithilfe der Event-Dispatch-Funktion des Spiels reagieren kann.

Senden eines Spielereignisses

Die Funktion funktioniert nur für Spielteilnehmer: Es ist möglich, das Spiel zu starten, einen Zug auszuführen, abzustimmen, eine Textnachricht zu schreiben, die in der Liste der Spielereignisse angezeigt wird usw.
Der autorisierte Benutzer, der das Spiel erstellt hat, beginnt mit der Rollenverteilung an alle Teilnehmer des Spiels, einschließlich sich selbst. Sie müssen ihre Rolle mit derselben Funktion bestätigen. Sobald alle Rollen bestätigt sind, wechselt das Spiel automatisch in den Nachtmodus.

Spielstatistik

Die Funktion funktioniert nur für Spielteilnehmer; sie zeigt den Stand des Spiels, die Liste und Anzahl der Spieler (Spitznamen), Rollen und deren Status (Zug gemacht oder nicht) sowie andere Informationen an. Wie bei der vorherigen Funktion funktioniert alles nur für Spielteilnehmer.

Regelmäßig gestartete Funktionen

Wenn das Spiel über einen beim Erstellen des Spiels angegebenen Zeitraum nicht gestartet wurde, wird es mithilfe der Löschfunktion automatisch aus der Liste der aktiven Spiele entfernt.

Eine weitere periodische Aufgabe ist das erzwungene Umschalten des Spielmodus von Nacht auf Tag und zurück für Spiele, bei denen dies während der Runde nicht geschehen ist (z. B. hat ein Spieler, der auf ein Spielereignis reagieren muss, seine Lösung aus irgendeinem Grund nicht gesendet). ).

Ankündigung

Einführung
Einrichten der Entwicklungsumgebung, Aufteilen der Aufgabe in Funktionen
Backend-Arbeit
Frontend-Arbeit
CICD einrichten, Tests organisieren
Starten Sie eine Probespielsitzung
Ergebnisse

Source: habr.com

„Neue Epen“. Wir essen den Elefanten in Teilen