🥇 "Epopeia berriak". Elefantea jaten dugu zatika

Artikulu honetan, "Epics" jokoa garatzeko lan-ingurune bat ezarriko dut eta, gainera, jokoa bera OpenFaaS-en erabiltzeko egokiak diren zatitan banatuko dut. Manipulazio guztiak Linuxen egingo ditut, Kubernetes zabalduko dut minikube-n VirtualBox erabiliz. Nire lan-makinak 2 prozesadore nukleo eta 12 GB RAM ditu; SSD bat erabiltzen dut sistema-disko gisa. Debian 8 erabiliko dut nire garapen sistema nagusi gisa, emacs, sudo, git eta virtualbox paketeak instalatuta, gainerako guztia GitHub eta beste iturrietatik deskargatuz instalatuko da. Aplikazio hauek /usr/local/bin-en instalatuko ditugu, bestela zehaztu ezean. Has gaitezen!

Lan ingurunea prestatzea

Go instalatzen

Webgune ofizialeko argibideak jarraitzen ditugu:

$ 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

Funtzionalitatea egiaztatzea:

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

Webgune ofizialeko argibideak jarraitzen ditugu:

$ 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

Gainera, bash-osatzea gaitu dezakezu:

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

Kubernetes instalatzea eta konfiguratzea

Garapenerako, minikube nahikoa da, beraz, instalatu eta kubelet /usr/local/bin-en eta instalatu Helm aplikazioak instalatzeko:

$ 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

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

Egiaztatzen dugu:

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

Garatzaileek 2 izen-espazio sortzea gomendatzen dute lan egiteko:

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

Gehitu helm-erako biltegi bat:

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

Diagramak instalatu aurretik pasahitz bat ezartzeko gaitasuna du, erabil ditzagun eta gorde ditzagun sarbide datuak k8s sekretu gisa:

$ 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

Zabal dezagun:

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

Denbora pixka bat igaro ondoren, proposatutako komandoa exekutatuko dugu:

$ 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

Funtzionalitatea egiaztatzea:

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

Helm erabiliz dena instalatzen dugu:

$ 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

Egiaztatzen dugu:

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

Sakatu ctrl+D edukiontzitik irteteko.

Emacs konfiguratzen

Printzipioz, dena jada konfiguratuta zegoen Artikulu honetan, beraz, ez naiz xehetasunetan sartuko.

Jokoa funtzioetan banatzea

Funtzioekin elkarreragina http protokoloaren bidez egiten da, eta funtzio ezberdinen arteko autentifikazioa JWT-k eskaintzen du. Mongodb tokenak gordetzeko erabiltzen da, baita jokoaren egoera, jokalarien datuak, joko guztien mugimendu-sekuentziak eta bestelako informazioa ere. Ikus ditzagun ezaugarri interesgarrienak gertutik.

Izena emateko

Funtzio honen sarrera JSON da jokoaren goitizena eta pasahitzarekin. Funtzio hau deitzen denean, alias hori datu-basean ez dagoela egiaztatzen da; egiaztapena arrakastatsua bada, aliasa eta pasahitzaren hash-a datu-basean sartzen dira. Izena ematea beharrezkoa da jokoan aktiboki parte hartzeko.

Input

Funtzioaren sarrera JSON da jokoaren goitizena eta pasahitzarekin; datu-basean goitizen bat badago eta pasahitza aurretik datu-basean gordetakoarekin ongi egiaztatzen bada, JWT bat itzultzen da, eta horiek daudenean beste funtzio batzuetara pasatu beharko da. deitua. Datu-basean zerbitzu-erregistro ezberdinak ere sartzen dira, adibidez, azken saioa hasteko ordua, etab.

Ikusi jokoen zerrenda

Baimenik gabeko edozein erabiltzailek joko guztien zerrenda eska dezake aktiboenak izan ezik. Baimendutako erabiltzaile batek joko aktiboen zerrenda ere ikusten du. Funtzioaren emaitza jokoen zerrendak dituen JSON da (jokoaren IDa, gizakiek irakur daitekeen izena, etab.).

Jokoen sorrera

Funtzioak baimendutako erabiltzaileekin bakarrik funtzionatzen du; sarreran gehienezko jokalari kopurua onartzen da, baita jokoaren parametroak ere (adibidez, joko honetan zein karaktere aktibatu, gehienezko jokalari kopurua, etab.). Jokoaren parametro bereizi bat sartzeko pasahitz baten presentzia da, publikoak ez diren jokoak sortzeko aukera ematen duena. Lehenespenez, joko publiko bat sortzen da. Funtzioaren emaitza JSON da, sorkuntza arrakastaren eremua, jokoaren identifikatzaile esklusiboa eta beste parametro batzuk dituena.

Jokoan sartzea

Funtzioak baimendutako erabiltzaileekin bakarrik funtzionatzen du, sarrera jokoaren IDa eta bere pasahitza da, hau publikoa ez den joko bat bada, irteera JSON da jokoaren parametroekin. Jokoan sartu den baimendutako erabiltzaileari, baita jokoaren sortzaileari ere, jokoaren parte-hartzaile deitzen dira aurrerantzean.

Joko-gertaerak ikustea

Baimenik gabeko edozein erabiltzailek joko inaktiboetarako gertaeren zerrenda eska dezake, eta baimendutako erabiltzaile batek edozein joko aktiborako gertaeren zerrenda jaso dezake. Funtzioaren parametro gehigarri bat erabiltzaileak dagoeneko duen gertaera-zenbakia izan daiteke. Kasu honetan, geroago gertatutako gertaerak bakarrik itzuliko dira zerrendan. Funtzio hau aldian-aldian abiaraziz gero, baimendutako erabiltzaile batek jokoan gertatzen dena ikusten du. Funtzio honek ekintza eskaera bat ere itzultzen du, eta erabiltzaileak jokoaren gertaerak bidaltzeko funtzioa erabiliz erantzun diezaioke.

Joko-gertaera bat bidaltzen

Funtzioak jokoko parte-hartzaileentzat bakarrik funtzionatzen du: jokoa abiarazi, mugimendu bat egin, bozkatu, joko-gertaeren zerrendan bistaratzen den testu-mezu bat idaztea, etab.
Jokoa sortu duen erabiltzaile baimendua jokoko parte-hartzaile guztiei rolak banatzen hasten da, beraiek barne. Funtzio bera erabiliz bere rola berretsi behar dute. Rol guztiak baieztatu ondoren, jokoa automatikoki gaueko modura aldatzen da.

Jokoen estatistikak

Funtzioak jokoaren parte-hartzaileentzat bakarrik funtzionatzen du; jokoaren egoera, jokalarien zerrenda eta kopurua (goitizenak), rolak eta haien egoera (mugimendua egina edo ez) erakusten du, baita beste informazio batzuk ere. Aurreko funtzioarekin bezala, dena jokoko parte-hartzaileentzat bakarrik funtzionatzen du.

Aldian-aldian abiarazitako funtzioak

Jokoa sortzean zehaztutako denboraren batean abiarazi ez bada, automatikoki kenduko da joko aktiboen zerrendatik garbi funtzioa erabiliz.

Aldizkako beste zeregin bat joko modua gauetik egunera behartuta aldatzea da txandan gertatu ez den jokoetarako (adibidez, joko-gertaera baten aurrean erreakzionatu behar duen jokalari batek ez du bere irtenbidea bidali arrazoiren bategatik). ).

Anuntzio

Sarrera
Garapen-ingurunea konfiguratzea, zeregina funtzioetan banatuz
Backend lana
Frontend lana
CICD konfiguratzea, probak antolatzea
Hasi proba-joko saio bat
Emaitzak

Iturria: www.habr.com

"Epopeia berriak". Elefantea zatika jaten dugu