Tässä artikkelissa luon työympäristön pelin "Epics" kehittämiseen ja jaan myös itse pelin OpenFaaS:ssä käytettäviksi sopiviin osiin. Teen kaikki manipulaatiot Linuxissa, otan Kubernetesin käyttöön minikubessa VirtualBoxin avulla. Työkoneessani on 2 prosessoriydintä ja 12 Gt RAM-muistia; käytän SSD-levyä järjestelmälevynä. Käytän pääkehitysjärjestelmänä debian 8:aa, emacs-, sudo-, git- ja virtualbox-paketit asennettuina, kaikki muu asennetaan lataamalla GitHubista ja muista lähteistä. Asennamme nämä sovellukset hakemistoon /usr/local/bin, ellei toisin mainita. Aloitetaan!
Työympäristön valmistelu
Asennetaan Go
Noudatamme virallisilla verkkosivuilla olevia ohjeita:
Kehittäjät suosittelevat kahden nimitilan luomista käytettäväksi:
$ kubectl apply -f https://raw.githubusercontent.com/openfaas/faas-netes/master/namespaces.yml
namespace/openfaas created
namespace/openfaas-fn created
Lisää arkisto ruorille:
$ helm repo add openfaas https://openfaas.github.io/faas-netes/
"openfaas" has been added to your repositories
Kaaviossa on mahdollisuus asettaa salasana ennen asennusta, käytetään sitä ja tallennetaan pääsytiedot k8s-salaisuuteen:
$ 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"
Jonkin ajan kuluttua suoritamme ehdotetun komennon:
$ 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:n asennus
Asennamme kaiken ruorilla:
$ 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
tarkista:
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
Poistu säilöstä painamalla ctrl+D.
Emacsin asetukset
Periaatteessa kaikki oli jo konfiguroitu sen mukaan tässä artikkelissa, joten en mene yksityiskohtiin.
Pelin jakaminen toimintoihin
Vuorovaikutus toimintojen kanssa tapahtuu http-protokollan kautta, JWT tarjoaa päästä päähän -todennusta eri toimintojen välillä. Mongodb:tä käytetään pelimerkkien sekä pelin tilan, pelaajatietojen, kaikkien pelien siirtosarjojen ja muiden tietojen tallentamiseen. Katsotaanpa tarkemmin mielenkiintoisimpia ominaisuuksia.
Rekisteröidy
Tämän toiminnon syöttö on JSON, jossa on pelin lempinimi ja salasana. Kun tätä toimintoa kutsutaan, tarkistetaan, ettei tämä alias ole tietokannassa; jos tarkistus onnistuu, alias ja salasana hash lisätään tietokantaan. Aktiivinen osallistuminen peliin edellyttää rekisteröitymistä.
sisäänkäynti
Toiminnon syöttö on JSON pelin lempinimellä ja salasanalla; jos tietokannassa on lempinimi ja salasana on varmistettu onnistuneesti tietokantaan aiemmin tallennetulla salasanalla, palautetaan JWT, joka on välitettävä muille toiminnoille, kun ne ovat nimeltään. Tietokantaan lisätään myös erilaisia palvelutietueita, esimerkiksi viimeinen kirjautumisaika jne.
Katso luettelo peleistä
Jokainen luvaton käyttäjä voi pyytää luettelon kaikista peleistä paitsi aktiivisista peleistä. Valtuutettu käyttäjä näkee myös luettelon aktiivisista peleistä. Toiminnon tulos on JSON, joka sisältää peliluettelot (pelitunnus, ihmisen luettava nimi jne.).
Pelin luominen
Toiminto toimii vain valtuutetuilla käyttäjillä; syötteeseen hyväksytään maksimi pelaajien määrä sekä pelin parametrit (esimerkiksi mitä merkkejä tässä pelissä aktivoidaan, pelaajien enimmäismäärä jne.). Pelin erillinen parametri on salasanan olemassaolo liittymistä varten, jonka avulla voit luoda ei-julkisia pelejä. Oletuksena luodaan julkinen peli. Toiminnon tulos on JSON, joka sisältää luomisen onnistumiskentän, yksilöllisen pelitunnisteen ja muita parametreja.
Peliin liittyminen
Toiminto toimii vain valtuutettujen käyttäjien kanssa, syötteenä on pelin tunnus ja salasana, jos kyseessä on ei-julkinen peli, tulos on JSON peliparametreineen. Peliin liittyneitä valtuutettuja käyttäjiä sekä pelin luojaa kutsutaan jatkossa pelin osallistujiksi.
Pelitapahtumien katselu
Kuka tahansa luvaton käyttäjä voi pyytää tapahtumaluettelon ei-aktiivisille peleille, ja valtuutettu käyttäjä voi saada luettelon tapahtumista mille tahansa aktiiviselle pelille. Toiminnon lisäparametri voi olla tapahtumanumero, joka käyttäjällä on jo. Tässä tapauksessa vain ne tapahtumat, jotka tapahtuivat myöhemmin, palautetaan luetteloon. Ajoittain käynnistämällä tämän toiminnon valtuutettu käyttäjä seuraa, mitä pelissä tapahtuu. Tämä toiminto palauttaa myös toimintapyynnön, johon käyttäjä voi vastata pelin tapahtumanvälitystoiminnolla.
Pelitapahtuman lähettäminen
Toiminto toimii vain pelin osallistujille: on mahdollista aloittaa peli, tehdä liike, äänestää, kirjoittaa tekstiviesti, joka näkyy pelitapahtumaluettelossa jne.
Pelin luonut valtuutettu käyttäjä alkaa jakaa rooleja kaikille pelin osallistujille, mukaan lukien itselleen, heidän on vahvistettava roolinsa samalla toiminnolla. Kun kaikki roolit on vahvistettu, peli siirtyy automaattisesti yötilaan.
Pelin tilastot
Toiminto toimii vain pelin osallistujille, se näyttää pelin tilan, pelaajien listan ja lukumäärän (lempinimet), roolit ja niiden tilan (siirto tehty tai ei) sekä muita tietoja. Kuten edellisessä toiminnossa, kaikki toimii vain pelin osallistujille.
Ajoittain käynnistettävät toiminnot
Jos peliä ei ole käynnistetty tiettyyn aikaan pelin luomisen yhteydessä määritettyyn aikaan, se poistetaan automaattisesti aktiivisten pelien luettelosta tyhjennystoiminnolla.
Toinen jaksollinen tehtävä on pelitilan pakotettu vaihtaminen yöstä päivälle ja takaisin sellaisissa peleissä, joissa näin ei tapahtunut vuoron aikana (esimerkiksi pelaaja, jonka on reagoitava pelitapahtumaan, ei jostain syystä lähettänyt ratkaisuaan ).