🥇 «Նոր էպոսներ». Փիղը մեկ-մեկ ուտելը

Այս հոդվածում ես կստեղծեմ «Բիլինա» խաղը մշակելու աշխատանքային միջավայր, ինչպես նաև կբաժանեմ խաղը OpenFaaS-ում օգտագործելու համար հարմար մասերի: Բոլոր մանիպուլյացիաները կկատարվեն օգտագործելով LinuxԵս կտեղադրեմ Kubernetes-ը minikube-ում՝ օգտագործելով VirtualBox-ը: Իմ աշխատանքային համակարգիչն ունի 2 պրոցեսորային միջուկ և 12 ԳԲ օպերատիվ հիշողություն, և ես օգտագործում եմ 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-completion:

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 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՝ խաղի պարամետրերով: Խաղին միացած լիազորված օգտատերը, ինչպես նաև խաղը ստեղծողն այսուհետ կոչվում են խաղի մասնակիցներ:

Դիտեք խաղի իրադարձությունները

Ցանկացած չարտոնված օգտատեր կարող է պահանջել անգործուն խաղերի իրադարձությունների ցանկ, իսկ լիազորված օգտատերը կարող է ստանալ իրադարձությունների ցանկ ցանկացած ակտիվ խաղի համար: Գործառույթի լրացուցիչ պարամետր կարող է լինել իրադարձության համարը, որն արդեն ունի օգտատերը։ Այս դեպքում ցուցակ կվերադարձվեն միայն այն իրադարձությունները, որոնք տեղի են ունեցել ավելի ուշ: Պարբերաբար գործարկելով այս գործառույթը՝ լիազորված օգտատերը հետևում է, թե ինչ է կատարվում խաղում։ Այս ֆունկցիան նաև վերադարձնում է գործողության հարցում, որին օգտատերը կարող է պատասխանել՝ օգտագործելով խաղի իրադարձությունների ուղարկման գործառույթը:

Խաղի իրադարձություն ուղարկելը

Ֆունկցիան գործում է միայն խաղի մասնակիցների համար. այն թույլ է տալիս սկսել խաղը, քայլ կատարել, քվեարկել, գրել տեքստային հաղորդագրություն, որը ցուցադրվում է խաղի իրադարձությունների ցանկում և այլն:
Լիազորված օգտատերը, ով ստեղծել է խաղը, սկսում է դերեր բաշխել խաղի բոլոր մասնակիցներին, այդ թվում՝ իրեն, նրանք պետք է հաստատեն իրենց դերը՝ օգտագործելով նույն գործառույթը: Երբ բոլոր դերերը հաստատվեն, խաղն ավտոմատ կերպով անցնում է գիշերային ռեժիմի:

Խաղի վիճակագրություն

Ֆունկցիան գործում է միայն խաղի մասնակիցների համար, ցույց է տալիս խաղի վիճակը, խաղացողների ցուցակը և քանակը (մականունները), դերերը և նրանց կարգավիճակը (կատարվել է քայլ, թե ոչ), ինչպես նաև այլ տեղեկություններ: Ինչպես նախորդ գործառույթի դեպքում, ամեն ինչ աշխատում է միայն խաղի մասնակիցների համար:

Պարբերաբար գործարկվող գործառույթներ

Եթե խաղը չի գործարկվել որոշակի ժամանակահատվածում, որը նշված է խաղը ստեղծելիս, այն ավտոմատ կերպով կհեռացվի ակտիվ խաղերի ցանկից՝ օգտագործելով մաքրման գործառույթը:

Մեկ այլ պարբերական խնդիր է պարտադրել փոխել խաղի ռեժիմը գիշերից ցերեկ և հետ այն խաղերի համար, որոնք դա չեն արել շրջադարձի ժամանակ (օրինակ, խաղացողը, ով պետք է արձագանքի խաղի իրադարձությանը, ինչ-ինչ պատճառներով չի ուղարկել իր որոշումը):