🥇 „Нови епови“. Слонот го јадеме на делови

Во оваа статија ќе поставам работна средина за развивање на играта „Epics“, а исто така ќе ја разделам самата игра на делови погодни за употреба во OpenFaaS. Ќе ги направам сите манипулации на Linux, ќе го распоредам Kubernetes во minikube користејќи VirtualBox. Мојата работна машина има 2 процесорски јадра и 12 GB RAM; користам SSD како системски диск. Ќе користам дебиан 8 како главен систем за развој, со инсталирани пакети emacs, sudo, git и virtualbox, се друго ќе се инсталира со преземање од GitHub и други извори. Ќе ги инсталираме овие апликации во /usr/local/bin освен ако не е поинаку наведено. Ајде да почнеме!

Подготовка на работната средина

Се инсталира Go

Ги следиме упатствата од официјалната веб-страница:

$ 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

Проверка на функционалноста:

$ 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

Ги следиме упатствата од официјалната веб-страница:

$ 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

Дополнително, можете да овозможите баш-завршување:

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

Инсталирање и конфигурирање на Kubernetes

За развој, minikube е доволно, затоа инсталирај го и кубелет во /usr/local/bin и инсталирај 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

Стартувај 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"

Проверка:

$ 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

Програмерите препорачуваат создавање на 2 места со имиња за работа:

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

Додајте складиште за кормилото:

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

Табелата има можност да постави лозинка пред инсталацијата, ајде да ја искористиме и да ги зачуваме податоците за пристап како тајна на k8s:

$ 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

Ајде да распоредиме:

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

По некое време, ја извршуваме предложената команда:

$ 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

Проверка на функционалноста:

$ 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

Ние инсталираме сè користејќи кормило:

$ 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

Проверка:

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

Притиснете Ctrl+D за да излезете од контејнерот.

Поставување emacs

Во принцип, сè беше веќе конфигурирано според овој напис, затоа нема да навлегувам во детали.

Разложување на играта на функции

Интеракцијата со функциите се врши преку протоколот http, автентикацијата од крај до крај помеѓу различни функции е обезбедена од JWT. Mongodb се користи за складирање на токени, како и состојба на играта, податоци за играчи, секвенци на потези на сите игри и други информации. Ајде внимателно да ги разгледаме најинтересните карактеристики.

регистрација

Влезот на оваа функција е JSON со прекар и лозинка за играта. Кога ќе се повика оваа функција, се проверува дали овој алијас не е во базата на податоци; ако проверката е успешна, алијасот и хашот на лозинката се вметнуваат во базата на податоци. Потребна е регистрација за активно учество во играта.

Внесување

Влезот на функцијата е JSON со прекар и лозинка за играта; ако има прекар во базата на податоци и лозинката е успешно потврдена со претходно зачуваната во базата, се враќа JWT, кој мора да се пренесе на други функции кога тие се повикани. Различни записи за услуги се исто така вметнати во базата на податоци, на пример, последното време за најава итн.

Погледнете список на игри

Секој неовластен корисник може да побара список со сите игри освен активните. Овластен корисник исто така гледа список на активни игри. Резултатот од функцијата е JSON што содржи списоци на игри (ID на играта, име што може да се чита од луѓе, итн.).

Создавање игра

Функцијата работи само со овластени корисници; максималниот број на играчи се прифаќа на влезот, како и параметрите на играта (на пример, кои знаци да се активираат во оваа игра, максималниот број на играчи итн.). Посебен параметар на играта е присуството на лозинка за приклучување, што ви овозможува да креирате не-јавни игри. Стандардно, се создава јавна игра. Резултатот од функцијата е JSON, кој содржи поле за успех на создавањето, единствен идентификатор на играта и други параметри.

Приклучување на игра

Функцијата работи само со овластени корисници, влезот е ID на играта и неговата лозинка, ако ова е нејавна игра, излезот е JSON со параметрите на играта. Овластениот корисник кој се приклучил на играта, како и креаторот на играта, во понатамошниот текст се нарекуваат учесници во играта.

Гледање настани од играта

Секој неовластен корисник може да побара список на настани за неактивни игри, а овластен корисник може да добие список на настани за која било активна игра. Дополнителен параметар на функцијата може да биде бројот на настан што корисникот веќе го има. Во овој случај, само оние настани што се случиле подоцна ќе бидат вратени во списокот. Со периодично вклучување на оваа функција, овластен корисник гледа што се случува во играта. Оваа функција враќа и барање за акција, на кое корисникот може да одговори со помош на функцијата за испраќање настани на играта.

Испраќање игра настан

Функцијата работи само за учесниците во играта: можно е да ја започнете играта, да направите потег, да гласате, да напишете текстуална порака што е прикажана во списокот со настани на играта итн.
Овластениот корисник кој ја создал играта започнува да ги дистрибуира улогите на сите учесници во играта, вклучувајќи ги и самите нив, тие мора да ја потврдат својата улога користејќи ја истата функција. Откако ќе се потврдат сите улоги, играта автоматски се префрла во ноќен режим.

Статистика на играта

Функцијата работи само за учесниците во играта; ја прикажува состојбата на играта, списокот и бројот на играчи (прекари), улогите и нивниот статус (преместување направено или не), како и други информации. Како и со претходната функција, сè работи само за учесниците во играта.

Периодично стартувани функции

Ако играта не е стартувана некое време одредено при креирањето на играта, таа автоматски ќе се отстрани од списокот на активни игри користејќи ја функцијата за бришење.

Друга периодична задача е принудното префрлување на режимот на игра од ноќ на ден и назад за игри за кои тоа не се случило за време на пресвртот (на пример, играч кој треба да реагира на настан на игра не го испратил своето решение поради некоја причина ).

Соопштение

Вовед
Поставување на развојната средина, разложување на задачата во функции
Заднина работа
Предна работа
Поставување CICD, организирање на тестирање
Започнете сесија на пробна игра
Резултатите од

Извор: www.habr.com

„Нови епови“. Слонот го јадеме на делови