🥇"Epik Baharu." Makan gajah sehelai demi sehelai

Dalam artikel ini, saya akan menyediakan persekitaran kerja untuk membangunkan permainan "Bylina" dan juga memecahkan permainan itu sendiri kepada bahagian-bahagian yang sesuai untuk digunakan dalam OpenFaaS. Semua manipulasi akan dilakukan menggunakan LinuxSaya akan menggunakan Kubernetes dalam minikube menggunakan VirtualBox. Mesin kerja saya mempunyai 2 teras CPU dan 12GB RAM, dan saya menggunakan SSD sebagai pemacu sistem. Saya akan menggunakannya sebagai sistem pembangunan utama. debian 8, dengan pakej emacs, sudo, git dan virtualbox dipasang. Saya akan memasang semua yang lain dengan memuat turun dari GitHub dan sumber lain. Aplikasi ini akan dipasang dalam /usr/local/bin melainkan dinyatakan sebaliknya. Mari mulakan!

Menyediakan persekitaran kerja

Memasang Go

Ikuti arahan dari laman web rasmi:

$ 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

Mari semak fungsi:

$ 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

Memasang faas-cli

Ikuti arahan dari laman web rasmi:

$ 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

Selain itu, anda boleh mendayakan bash-completion:

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

Memasang dan Mengkonfigurasi Kubernetes

Untuk pembangunan, minikube sudah memadai, jadi mari pasang dan kubelet dalam /usr/local/bin. Untuk memasang aplikasi, kami juga akan memasang 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

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

Kami menyemak:

$ 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

Memasang OpenFaaS

Pembangun mengesyorkan membuat 2 ruang nama untuk kerja:

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

Tambah repositori untuk helm:

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

Carta mempunyai pilihan untuk menetapkan kata laluan sebelum pemasangan. Mari gunakannya dan simpan data akses sebagai rahsia 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

Kami sedang melaksanakan penempatan:

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

Selepas beberapa lama, jalankan arahan yang dicadangkan:

$ 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

Mari semak fungsi:

$ 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

Memasang MongoDB

Kami memasang semuanya menggunakan 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

Kami menyemak:

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

Tekan ctrl+D untuk keluar dari bekas.

Menyediakan emacs

Pada dasarnya, semuanya telah disediakan artikel ini, jadi saya tidak akan menerangkan secara terperinci.

Memecahkan permainan kepada fungsi

Interaksi dengan fungsi dicapai melalui protokol HTTP, dengan pengesahan hujung ke hujung antara fungsi berbeza yang disediakan oleh JWT. MongoDB digunakan untuk menyimpan token, serta keadaan permainan, data pemain, urutan permainan dan maklumat lain. Mari kita lihat lebih dekat pada fungsi yang paling menarik.

pendaftaran

Fungsi ini menerima rentetan JSON yang mengandungi nama panggilan dan kata laluan permainan. Apabila fungsi ini dipanggil, semakan dibuat untuk melihat sama ada nama panggilan wujud dalam pangkalan data. Jika ya, cincang nama samaran dan kata laluan dimasukkan ke dalam pangkalan data. Pendaftaran diperlukan untuk mengambil bahagian secara aktif dalam permainan.

Вход

Input fungsi ialah JSON dengan nama panggilan dan kata laluan permainan. Jika nama panggilan hadir dalam pangkalan data dan kata laluan berjaya disahkan terhadap yang disimpan sebelumnya dalam pangkalan data, JWT dikembalikan, yang harus dihantar ke fungsi lain apabila ia dipanggil. Pelbagai rekod perkhidmatan juga dimasukkan ke dalam pangkalan data, seperti masa log masuk terakhir.

Melihat senarai permainan

Mana-mana pengguna yang tidak dibenarkan boleh meminta senarai semua permainan kecuali yang aktif. Pengguna yang dibenarkan juga melihat senarai permainan aktif. Output fungsi ialah JSON yang mengandungi senarai permainan (ID permainan, nama yang boleh dibaca manusia, dsb.).

Penciptaan permainan

Fungsi ini hanya berfungsi dengan pengguna yang dibenarkan. Ia menerima bilangan maksimum pemain dan parameter permainan (cth., watak mana yang akan diaktifkan dalam permainan ini, bilangan maksimum pemain, dsb.). Parameter permainan yang berasingan ialah kehadiran kata laluan sertai, yang membolehkan penciptaan permainan peribadi. Secara lalai, permainan awam dibuat. Output fungsi ialah fail JSON yang mengandungi medan kejayaan, ID permainan unik dan parameter lain.

Menyertai permainan

Fungsi ini hanya berfungsi dengan pengguna yang dibenarkan. Input ialah ID dan kata laluan permainan (jika ia permainan peribadi), dan output ialah JSON dengan parameter permainan. Pengguna sah yang menyertai permainan, serta pencipta permainan, dirujuk sebagai peserta permainan.

Melihat acara permainan

Mana-mana pengguna yang tidak dibenarkan boleh meminta senarai acara untuk permainan yang tidak aktif, manakala pengguna yang dibenarkan boleh mendapatkan senarai acara untuk mana-mana permainan yang aktif. Nombor acara, yang telah dimiliki pengguna, boleh dihantar sebagai parameter tambahan kepada fungsi tersebut. Dalam kes ini, hanya peristiwa yang berlaku lebih baru-baru ini akan dikembalikan. Dengan menjalankan fungsi ini secara berkala, pengguna yang dibenarkan boleh memantau aktiviti permainan. Fungsi ini juga mengembalikan permintaan untuk tindakan, yang pengguna boleh bertindak balas menggunakan fungsi penghantar acara permainan.

Menghantar acara permainan

Ciri ini hanya tersedia untuk peserta permainan: pemain boleh melancarkan permainan, bergerak, mengundi, menulis mesej teks yang muncul dalam senarai acara permainan, dsb.
Pengguna sah yang mencipta permainan memulakan pengagihan peranan kepada semua pemain, termasuk mereka sendiri. Mereka mesti mengesahkan peranan mereka menggunakan fungsi yang sama. Setelah semua peranan disahkan, permainan secara automatik bertukar kepada mod malam.

Perangkaan permainan

Ciri ini hanya berfungsi untuk peserta permainan dan memaparkan keadaan permainan, senarai dan bilangan pemain (nama samaran), peranan dan status mereka (sama ada perpindahan telah dibuat atau tidak), dan maklumat lain. Seperti ciri sebelumnya, ciri ini hanya berfungsi untuk peserta permainan.

Fungsi yang dicetuskan secara berkala

Jika permainan tidak dilancarkan untuk tempoh masa tertentu, dinyatakan semasa mencipta permainan, ia akan dialih keluar secara automatik daripada senarai permainan aktif menggunakan fungsi pembersihan.

Satu lagi tugas berkala ialah memaksa pertukaran dari malam ke siang dan kembali untuk permainan yang tidak bertukar semasa giliran (contohnya, pemain yang perlu bertindak balas terhadap acara permainan tidak menyerahkan keputusan mereka atas sebab tertentu).