„Нови епоси“. Изяждаме слона на части

В тази статия ще създам работна среда за разработване на играта "Epics", а също така ще разделя самата игра на части, подходящи за използване в OpenFaaS. Ще направя всички манипулации на Linux, ще разположа Kubernetes в minikube с помощта на VirtualBox. Работната ми машина има 2 процесорни ядра и 12 GB RAM; използвам SSD като системен диск. Ще използвам debian 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

Освен това можете да активирате bash-завършване:

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

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

За разработка, minikube е достатъчен, така че инсталирайте го и kubelet в /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:

$ 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, съдържащ списъци с игри (идентификатор на игра, четимо за човека име и т.н.).

Създаване на игра

Функцията работи само с оторизирани потребители; на входа се приема максимален брой играчи, както и параметри на играта (например кои герои да се активират в тази игра, максимален брой играчи и т.н.). Отделен параметър на играта е наличието на парола за присъединяване, която ви позволява да създавате непублични игри. По подразбиране се създава публична игра. Резултатът от функцията е JSON, който съдържа поле за успешно създаване, уникален идентификатор на играта и други параметри.

Присъединяване към игра

Функцията работи само с оторизирани потребители, входът е ID на играта и нейната парола, ако това е непублична игра, изходът е JSON с параметрите на играта. Упълномощеният потребител, включил се в играта, както и създателят на играта, се наричат ​​по-нататък участници в играта.

Преглед на събития в играта

Всеки неоторизиран потребител може да поиска списък със събития за неактивни игри, а упълномощен потребител може да получи списък със събития за всяка активна игра. Допълнителен параметър към функцията може да бъде номерът на събитието, който потребителят вече има. В този случай само онези събития, които са настъпили по-късно, ще бъдат върнати в списъка. Чрез периодичното стартиране на тази функция, оторизиран потребител наблюдава какво се случва в играта. Тази функция също връща искане за действие, на което потребителят може да отговори, използвайки функцията за изпращане на събития на играта.

Изпращане на събитие за игра

Функцията работи само за участници в играта: възможно е да стартирате играта, да направите ход, да гласувате, да напишете текстово съобщение, което се показва в списъка със събития в играта и т.н.
Оторизираният потребител, който е създал играта, започва да разпределя роли на всички участници в играта, включително себе си, те трябва да потвърдят ролята си, използвайки същата функция. След като всички роли са потвърдени, играта автоматично превключва на нощен режим.

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

Функцията работи само за участници в играта, показва състоянието на играта, списъка и броя на играчите (никнейми), ролите и техния статус (направен ход или не), както и друга информация. Както при предишната функция, всичко работи само за участниците в играта.

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

Ако играта не е била стартирана известно време, посочено при създаването на играта, тя автоматично ще бъде премахната от списъка с активни игри чрез функцията за изчистване.

Друга периодична задача е принудителното превключване на режима на игра от нощен към дневен и обратно за игри, за които това не се е случило по време на хода (например играч, който трябва да реагира на игрово събитие, не е изпратил своето решение по някаква причина ).

Съобщение

• въведение
• Настройка на средата за разработка, разбиване на задачата на функции
• Бекенд работа
• Frontend работа
• Настройка на CICD, организиране на тестване
• Започнете пробна игрова сесия
• Резултати от

Източник: www.habr.com