„Nauji epai“. Dramblį valgome dalimis

„Nauji epai“. Dramblį valgome dalimis

Šiame straipsnyje sukursiu darbo aplinką žaidimui „Epics“ kurti, o patį žaidimą suskaidysiu į dalis, tinkamas naudoti OpenFaaS. Atliksiu visas manipuliacijas Linux, Kubernetes įdiegsiu minikube naudodamas VirtualBox. Mano darbo mašinoje yra 2 procesoriaus branduoliai ir 12 GB RAM; kaip sistemos diską naudoju SSD. Kaip pagrindinę kūrimo sistemą naudosiu debian 8, su įdiegtais emacs, sudo, git ir virtualbox paketais, visa kita bus įdiegta atsisiunčiant iš GitHub ir kitų šaltinių. Jei nenurodyta kitaip, šias programas įdiegsime /usr/local/bin. Pradėkime!

Darbo aplinkos paruošimas

„Go“ diegimas

Vykdome instrukcijas iš oficialios svetainės:

$ 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

Tikrinamos funkcijos:

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

Vykdome instrukcijas iš oficialios svetainės:

$ 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

Be to, galite įjungti bash užbaigimą:

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

„Kubernetes“ diegimas ir konfigūravimas

Kūrimui pakanka minikube, todėl įdiekite jį ir kubelet į /usr/local/bin, o programoms įdiegti įdiekite 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

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

Mes patikriname:

$ 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“ diegimas

Kūrėjai rekomenduoja sukurti 2 vardų erdves, su kuriomis galėtumėte dirbti:

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

Pridėti vairo saugyklą:

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

Diagrama turi galimybę prieš įdiegiant nustatyti slaptažodį, naudokite jį ir išsaugokime prieigos duomenis kaip k8s paslaptį:

$ 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

Įdiegkime:

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

Po kurio laiko paleidžiame siūlomą komandą:

$ 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

Tikrinamos funkcijos:

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

Viską montuojame naudodami vairą:

$ 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

Mes patikriname:

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

Paspauskite ctrl + D, kad išeitumėte iš sudėtinio rodinio.

„Emacs“ nustatymas

Iš esmės viskas jau buvo sukonfigūruota pagal Šis straipsnis, todėl į detales nesileisiu.

Žaidimo suskirstymas į funkcijas

Sąveika su funkcijomis vykdoma naudojant http protokolą, JWT užtikrina skirtingų funkcijų autentifikavimą nuo galo iki galo. Mongodb naudojamas žetonams, taip pat žaidimo būsenai, žaidėjo duomenims, visų žaidimų judesių sekoms ir kitai informacijai saugoti. Pažvelkime atidžiau į įdomiausias funkcijas.

Prisiregistruoti

Šios funkcijos įvestis yra JSON su žaidimo slapyvardžiu ir slaptažodžiu. Kai ši funkcija iškviečiama, patikrinama, ar šio slapyvardžio nėra duomenų bazėje; jei patikrinimas sėkmingas, slapyvardis ir slaptažodžio maiša įterpiami į duomenų bazę. Norint aktyviai dalyvauti žaidime būtina registracija.

Indėlis

Funkcijos įvestis yra JSON su žaidimo slapyvardžiu ir slaptažodžiu; jei duomenų bazėje yra slapyvardis ir slaptažodis sėkmingai patikrintas naudojant anksčiau duomenų bazėje išsaugotą slaptažodį, grąžinamas JWT, kuris turi būti perduotas kitoms funkcijoms, kai jos yra paskambino. Į duomenų bazę taip pat įterpiami įvairūs paslaugų įrašai, pavyzdžiui, paskutinio prisijungimo laikas ir pan.

Peržiūrėkite žaidimų sąrašą

Bet kuris neįgaliotas vartotojas gali paprašyti visų žaidimų, išskyrus aktyvius, sąrašo. Įgaliotas vartotojas taip pat mato aktyvių žaidimų sąrašą. Funkcijos rezultatas yra JSON, kuriame yra žaidimų sąrašai (žaidimo ID, žmogaus skaitomas pavadinimas ir kt.).

Žaidimo kūrimas

Funkcija veikia tik su įgaliotais vartotojais, įvestyje priimamas maksimalus žaidėjų skaičius, taip pat žaidimo parametrai (pavyzdžiui, kokius simbolius aktyvinti šiame žaidime, maksimalus žaidėjų skaičius ir pan.). Atskiras žaidimo parametras yra prisijungimo slaptažodžio buvimas, leidžiantis kurti neviešus žaidimus. Pagal numatytuosius nustatymus sukuriamas viešas žaidimas. Funkcijos rezultatas yra JSON, kuriame yra sėkmės laukas, unikalus žaidimo identifikatorius ir kiti parametrai.

Prisijungimas prie žaidimo

Funkcija veikia tik su įgaliotais vartotojais, įvestis yra žaidimo ID ir jo slaptažodis, jei tai neviešas žaidimas, išvestis yra JSON su žaidimo parametrais. Prie žaidimo prisijungęs įgaliotas vartotojas, taip pat žaidimo kūrėjas toliau vadinami žaidimo dalyviais.

Žaidimo įvykių peržiūra

Bet kuris neįgaliotas vartotojas gali prašyti neaktyvių žaidimų įvykių sąrašo, o įgaliotas vartotojas gali gauti bet kurio aktyvaus žaidimo įvykių sąrašą. Papildomas funkcijos parametras gali būti įvykio numeris, kurį vartotojas jau turi. Tokiu atveju sąraše bus grąžinti tik tie įvykiai, kurie įvyko vėliau. Periodiškai paleisdamas šią funkciją įgaliotas vartotojas stebi, kas vyksta žaidime. Ši funkcija taip pat grąžina veiksmo užklausą, į kurią vartotojas gali atsakyti naudodamas žaidimo įvykių išsiuntimo funkciją.

Žaidimo įvykio siuntimas

Funkcija veikia tik žaidimo dalyviams: galima pradėti žaidimą, atlikti ėjimą, balsuoti, parašyti trumpąją žinutę, kuri rodoma žaidimo įvykių sąraše ir kt.
Žaidimą sukūręs įgaliotas vartotojas pradeda skirstyti vaidmenis visiems žaidimo dalyviams, įskaitant save, savo vaidmenį turi patvirtinti naudodamiesi ta pačia funkcija. Patvirtinus visus vaidmenis, žaidimas automatiškai persijungia į naktinį režimą.

Žaidimo statistika

Funkcija veikia tik žaidimo dalyviams, rodo žaidimo būseną, žaidėjų sąrašą ir skaičių (slapyvardžius), vaidmenis ir jų būseną (perkėlimas atliktas ar ne), taip pat kitą informaciją. Kaip ir su ankstesne funkcija, viskas veikia tik žaidimo dalyviams.

Periodiškai paleidžiamos funkcijos

Jei žaidimas nebuvo paleistas kurį laiką, nurodytą kuriant žaidimą, jis bus automatiškai pašalintas iš aktyvių žaidimų sąrašo naudojant išvalymo funkciją.

Kita periodinė užduotis – priverstinis žaidimo režimo perjungimas iš nakties į dieną ir atgal žaidimams, kuriems tai neįvyko eismo metu (pavyzdžiui, žaidėjas, kuriam reikia reaguoti į žaidimo įvykį, dėl kokių nors priežasčių neatsiuntė savo sprendimo ).

Skelbimas

  • įvedimas
  • Kūrimo aplinkos nustatymas, užduoties suskaidymas į funkcijas
  • Užpakalinis darbas
  • Frontend darbas
  • CICD nustatymas, testavimo organizavimas
  • Pradėkite bandomojo žaidimo sesiją
  • rezultatai

Šaltinis: www.habr.com

Добавить комментарий