「ニューエピック」。私たちは象を部分的に食べる

この記事では、ゲーム「Epics」を開発するための作業環境をセットアップし、ゲーム自体を OpenFaaS での使用に適した部分に分割します。すべての操作は Linux 上で行い、VirtualBox を使用して Minikube に Kubernetes をデプロイします。私の仕事用マシンには 2 つのプロセッサ コアと 12GB の 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-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 のリポジトリを追加します。

$ 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 が返されます。これは、他の関数が実行されるときに渡す必要があります。と呼ばれた。最終ログイン時刻など、さまざまなサービス レコードもデータベースに挿入されます。

ゲームのリストを見る

権限のないユーザーは、アクティブなゲームを除くすべてのゲームのリストを要求できます。許可されたユーザーには、アクティブなゲームのリストも表示されます。この関数の結果は、ゲームのリスト (ゲーム ID、人間が判読できる名前など) を含む JSON です。

ゲーム作成

この機能は、許可されたユーザーに対してのみ機能します。最大プレイヤー数とゲーム パラメーター (たとえば、このゲームでアクティブにするキャラクター、最大プレイヤー数など) が入力で受け入れられます。ゲームの別のパラメータとして、参加用のパスワードが存在します。これにより、非公開のゲームを作成できます。デフォルトでは、パブリック ゲームが作成されます。関数の結果は JSON であり、作成成功フィールド、一意のゲーム ID、その他のパラメーターが含まれます。

ゲームに参加する

この関数は承認されたユーザーに対してのみ機能します。入力はゲーム ID とそのパスワードです。非公開ゲームの場合、出力はゲーム パラメーターを含む JSON です。以下、ゲームに参加した正規ユーザおよびゲーム作成者をゲーム参加者と呼びます。

ゲームイベントの表示

権限のないユーザーは非アクティブなゲームのイベントのリストを要求でき、権限のあるユーザーはアクティブなゲームのイベントのリストを受け取ることができます。関数への追加パラメータとして、ユーザーがすでに持っているイベント番号を指定できます。この場合、後で発生したイベントのみがリストに返されます。この機能を定期的に起動することで、許可されたユーザーはゲーム内で何が起こっているかを監視します。この関数はアクション リクエストも返します。ユーザーはゲームのイベント ディスパッチ関数を使用してこれに応答できます。

ゲームイベントの送信

この機能はゲーム参加者のみが利用できます。ゲームの開始、行動、投票、ゲーム イベントのリストに表示されるテキスト メッセージの書き込みなどが可能です。
ゲームを作成した権限のあるユーザーは、自分自身を含むゲームの参加者全員にロールの配布を開始します。同じ機能を使用してロールを確認する必要があります。すべての役割が確認されると、ゲームは自動的にナイトモードに切り替わります。

ゲーム統計

この機能はゲーム参加者に対してのみ機能し、ゲームの状態、プレイヤーのリストと人数 (ニックネーム)、役割とステータス (着手の有無)、その他の情報が表示されます。前の機能と同様に、すべてはゲーム参加者に対してのみ機能します。

定期的に起動される機能

ゲーム作成時に指定した期間、ゲームが起動されなかった場合、クリア機能を使用してアクティブなゲームのリストから自動的に削除されます。

もう 1 つの定期的なタスクは、ゲーム モードを夜から昼に強制的に切り替え、ターン中にこれが起こらなかったゲームに戻すことです (たとえば、ゲーム イベントに反応する必要があるプレイヤーが何らかの理由で解決策を送信しませんでした) ）。

お知らせ

• 導入
• 開発環境をセットアップし、タスクを機能に分割する
• バックエンド作業
• フロントエンド作業
• CICD のセットアップ、テストの組織化
• トライアルゲームセッションを開始する
• 結果

出所： habr.com