"Uued eeposed". Me sööme elevanti osade kaupa

"Uued eeposed". Me sööme elevanti osade kaupa

Selles artiklis panen paika töökeskkonna mängu "Epics" arendamiseks ning jagan ka mängu enda OpenFaaS-is kasutamiseks sobivateks osadeks. Teen kõik manipulatsioonid Linuxis, juurutan Kubernetese minikube VirtualBoxi abil. Minu töömasinal on 2 protsessorituuma ja 12 GB muutmälu, süsteemikettana kasutan SSD-d. Peamise arendussüsteemina kasutan debian 8, kuhu on paigaldatud emacs, sudo, git ja virtualbox paketid, kõik muu paigaldatakse GitHubist ja muudest allikatest alla laadides. Kui pole teisiti määratud, installime need rakendused kausta /usr/local/bin. Alustame!

Töökeskkonna ettevalmistamine

Go installimine

Järgime ametliku veebisaidi juhiseid:

$ 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

Funktsionaalsuse kontrollimine:

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

Järgime ametliku veebisaidi juhiseid:

$ 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

Lisaks saate lubada bashi lõpetamise:

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

Kubernetese installimine ja konfigureerimine

Arenduseks piisab minikube'ist, nii et installige see ja kubelet kausta /usr/local/bin ja installige rakenduste installimiseks 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

Käivitage 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"

Kontrollime:

$ 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-i installimine

Arendajad soovitavad töötamiseks luua 2 nimeruumi:

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

Lisa tüürihoidla:

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

Diagrammil on võimalus enne installimist määrata parool, kasutame seda ja salvestame juurdepääsuandmed k8s saladusena:

$ 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

Võtame kasutusele:

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

Mõne aja pärast käivitame pakutud käsu:

$ 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

Funktsionaalsuse kontrollimine:

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

Paigaldame kõik tüüri abil:

$ 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

Kontrollime:

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

Konteinerist väljumiseks vajutage klahvikombinatsiooni ctrl+D.

Emacsi seadistamine

Põhimõtteliselt oli kõik juba vastavalt seadistatud see artikkel, nii et ma ei hakka detailidesse laskuma.

Mängu funktsioonideks jaotamine

Funktsioonidega suhtlemine toimub http-protokolli kaudu, erinevate funktsioonide vahelist otspunkti autentimist pakub JWT. Mongodb-i kasutatakse žetoonide, samuti mängu oleku, mängija andmete, kõigi mängude käikude jadade ja muu teabe salvestamiseks. Vaatame lähemalt kõige huvitavamaid funktsioone.

Registreeru

Selle funktsiooni sisendiks on JSON koos mängu hüüdnime ja parooliga. Selle funktsiooni kutsumisel kontrollitakse, et seda varjunime andmebaasis pole; kui kontroll õnnestub, lisatakse alias ja parooliräsi andmebaasi. Aktiivseks mängus osalemiseks on vajalik registreerimine.

Logi sisse

Funktsiooni sisendiks on mängu hüüdnime ja parooliga JSON; kui andmebaasis on hüüdnimi ja parool on edukalt kontrollitud varem andmebaasi salvestatuga, tagastatakse JWT, mis tuleb edastada teistele funktsioonidele, kui need on helistas. Samuti sisestatakse andmebaasi erinevaid teeninduskirjeid, näiteks viimase sisselogimise aeg jne.

Vaadake mängude loendit

Kõik volitamata kasutajad võivad taotleda kõigi mängude loendit, välja arvatud aktiivsed. Volitatud kasutaja näeb ka aktiivsete mängude loendit. Funktsiooni tulemuseks on JSON, mis sisaldab mängude loendeid (mängu ID, inimloetav nimi jne).

Mängu loomine

Funktsioon töötab ainult volitatud kasutajatega; sisendis aktsepteeritakse maksimaalset mängijate arvu, samuti mängu parameetreid (näiteks milliseid märke selles mängus aktiveerida, maksimaalne mängijate arv jne). Mängu eraldiseisvaks parameetriks on liitumiseks parooli olemasolu, mis võimaldab luua mitteavalikke mänge. Vaikimisi luuakse avalik mäng. Funktsiooni tulemuseks on JSON, mis sisaldab loomise õnnestumise välja, unikaalset mänguidentifikaatorit ja muid parameetreid.

Mänguga liitumine

Funktsioon töötab ainult volitatud kasutajatega, sisendiks on mängu ID ja selle parool, kui tegemist on mitteavaliku mänguga, on väljundiks JSON koos mängu parameetritega. Mänguga liitunud volitatud kasutajat ja ka mängu loojat nimetatakse edaspidi mängus osalejateks.

Mängusündmuste vaatamine

Iga volitamata kasutaja saab taotleda mitteaktiivsete mängude sündmuste loendit ja volitatud kasutaja saab iga aktiivse mängu sündmuste loendi. Funktsiooni lisaparameetriks võib olla sündmuse number, mis kasutajal juba on. Sel juhul tagastatakse loendisse ainult need sündmused, mis toimusid hiljem. Selle funktsiooni perioodiliselt käivitades jälgib volitatud kasutaja mängus toimuvat. See funktsioon tagastab ka toimingupäringu, millele kasutaja saab vastata mängu sündmuste saatmise funktsiooni abil.

Mängusündmuse saatmine

Funktsioon töötab ainult mängus osalejatele: võimalik on alustada mängu, teha liigutus, hääletada, kirjutada tekstisõnum, mis kuvatakse mängusündmuste nimekirjas jne.
Mängu loonud volitatud kasutaja hakkab rolle jagama kõikidele mängus osalejatele, kaasa arvatud endale, nad peavad oma rolli kinnitama sama funktsiooni kasutades. Kui kõik rollid on kinnitatud, lülitub mäng automaatselt öörežiimi.

Mängude statistika

Funktsioon töötab ainult mängus osalejate jaoks, see näitab mängu olekut, mängijate nimekirja ja arvu (hüüdnimesid), rolle ja nende staatust (liigutus tehtud või mitte), samuti muud teavet. Nagu eelmise funktsiooni puhul, töötab kõik ainult mängus osalejate jaoks.

Perioodiliselt käivitatavad funktsioonid

Kui mängu ei ole mängu loomisel määratud aja jooksul käivitatud, eemaldatakse see automaatselt aktiivsete mängude loendist, kasutades kustutamise funktsiooni.

Teine perioodiline ülesanne on mängurežiimi sunniviisiline ümberlülitamine öölt päevale ja tagasi mängude puhul, mille puhul seda käigu ajal ei juhtunud (näiteks mängija, kes peab mängusündmusele reageerima, ei saatnud mingil põhjusel oma lahendust ).

Kuulutus

  • Sissejuhatus
  • Arenduskeskkonna seadistamine, ülesande jaotamine funktsioonideks
  • Taustatöö
  • Frontend töö
  • CICD seadistamine, testimise korraldamine
  • Alustage proovimängu seanssi
  • Tulemused

Allikas: www.habr.com

Lisa kommentaar