"ახალი ეპოსი". სპილოს ნაწილ-ნაწილ ვჭამთ

ამ სტატიაში მე შევქმნი სამუშაო გარემოს თამაშის "Epics"-ის განვითარებისთვის, ასევე თავად დავყოფ თამაშს OpenFaaS-ში გამოსაყენებლად შესაფერის ნაწილებად. ყველა მანიპულაციას გავაკეთებ ლინუქსზე, კუბერნეტსს minikube-ში განვათავსებ VirtualBox-ის გამოყენებით. ჩემს სამუშაო მანქანას აქვს 2 პროცესორის ბირთვი და 12 GB ოპერატიული მეხსიერება; მე ვიყენებ 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 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 თამაშის პარამეტრებით. ავტორიზებული მომხმარებელი, რომელიც შეუერთდა თამაშს, ისევე როგორც თამაშის შემქმნელს, შემდგომში თამაშის მონაწილეებს უწოდებენ.

თამაშის მოვლენების ნახვა

ნებისმიერ არაავტორიზებულ მომხმარებელს შეუძლია მოითხოვოს მოვლენების სია არააქტიური თამაშებისთვის, ხოლო ავტორიზებულ მომხმარებელს შეუძლია მიიღოს მოვლენების სია ნებისმიერი აქტიური თამაშისთვის. ფუნქციის დამატებითი პარამეტრი შეიძლება იყოს მოვლენის ნომერი, რომელიც მომხმარებელს უკვე აქვს. ამ შემთხვევაში, მხოლოდ ის მოვლენები, რომლებიც მოგვიანებით მოხდა, დაბრუნდება სიაში. ამ ფუნქციის პერიოდული გაშვებით, ავტორიზებული მომხმარებელი უყურებს რა ხდება თამაშში. ეს ფუნქცია ასევე აბრუნებს მოქმედების მოთხოვნას, რომელზეც მომხმარებელს შეუძლია უპასუხოს თამაშის მოვლენის გაგზავნის ფუნქციის გამოყენებით.

თამაშის ღონისძიების გაგზავნა

ფუნქცია მუშაობს მხოლოდ თამაშის მონაწილეებისთვის: შესაძლებელია თამაშის დაწყება, ნაბიჯის გადადგმა, ხმის მიცემა, ტექსტური შეტყობინების დაწერა, რომელიც ნაჩვენებია თამაშის მოვლენების სიაში და ა.შ.
ავტორიზებული მომხმარებელი, რომელმაც შექმნა თამაში, იწყებს როლების განაწილებას თამაშის ყველა მონაწილეზე, მათ შორის თავადაც, მათ უნდა დაადასტურონ თავიანთი როლი იმავე ფუნქციის გამოყენებით. ყველა როლის დადასტურების შემდეგ, თამაში ავტომატურად გადადის ღამის რეჟიმში.

თამაშის სტატისტიკა

ფუნქცია მუშაობს მხოლოდ თამაშის მონაწილეებისთვის; ის აჩვენებს თამაშის მდგომარეობას, მოთამაშეთა სიას და რაოდენობას (მეტსახელებს), როლებს და მათ სტატუსს (გადაადგილება თუ არა), ასევე სხვა ინფორმაციას. როგორც წინა ფუნქციით, ყველაფერი მუშაობს მხოლოდ თამაშის მონაწილეებისთვის.

პერიოდულად გაშვებული ფუნქციები

თუ თამაში არ არის გაშვებული გარკვეული დროის განმავლობაში თამაშის შექმნისას მითითებული, ის ავტომატურად წაიშლება აქტიური თამაშების სიიდან წმინდა ფუნქციის გამოყენებით.

კიდევ ერთი პერიოდული დავალება არის თამაშის რეჟიმის იძულებითი გადართვა ღამიდან დღეზე და უკან იმ თამაშებისთვის, რომლებშიც ეს არ მომხდარა მობრუნების დროს (მაგალითად, მოთამაშეს, რომელსაც უნდა მოეხდინა რეაგირება თამაშის მოვლენაზე, რატომღაც არ გაუგზავნა გამოსავალი. ).

ანონსი

• შესავალი
• განვითარების გარემოს დაყენება, ამოცანის ფუნქციებად დაყოფა
• Backend სამუშაო
• ფრონტენდის მუშაობა
• CICD-ის დაყენება, ტესტირების ორგანიზება
• დაიწყეთ საცდელი თამაშის სესია
• შედეგები

წყარო: www.habr.com