1. Introduzione
Ultimo aggiornamento: 05/05/2020
Microservices Battle Arena
Ti è mai capitato di partecipare a una battaglia a palle di neve in cui ti muovi e lanci palle di neve in modo giocoso contro gli altri? In caso contrario, prova a farlo un giorno. Ma ora, invece di rischiare di essere schiaffeggiato fisicamente, puoi creare un piccolo servizio accessibile alla rete (un microservizio) che parteciperà a una battaglia epica contro altri microservizi. E dato che ospitiamo questa battaglia di microservizi a Spring I/O, i nostri microservizi lanceranno jamón anziché palle di neve.
Ti starai chiedendo… Ma come fa un microservizio a "lanciare" un jamón ad altri microservizi? Un microservizio può ricevere richieste di rete (di solito tramite HTTP) e restituire risposte. Esiste un "gestore dell'arena" che invia al microservizio lo stato attuale dell'arena e il microservizio risponde con un comando che specifica cosa fare.
Naturalmente l'obiettivo è vincere, ma lungo il percorso imparerai a creare ed eseguire il deployment di microservizi su Google Cloud.
Come funziona
Creerai un microservizio con la tecnologia che preferisci (o scegliendo tra gli starter Java, Kotlin o Scala) e poi lo eseguirai il deployment su Google Cloud. Una volta eseguito il deployment, compila un modulo per comunicarci l'URL del tuo microservizio e lo aggiungeremo all'arena.
L'arena contiene tutti i giocatori per una determinata battaglia. La conferenza Spring I/O Bridge avrà la sua arena. Ogni giocatore rappresenta un microservizio che si muove e lancia jamón contro gli altri giocatori.
Circa una volta al secondo, il nostro gestore dell'arena chiamerà il tuo microservizio, inviando lo stato attuale dell'arena (dove si trovano i giocatori) e il tuo microservizio risponderà con un comando su cosa fare. Nell'arena puoi andare avanti, girare a sinistra o a destra o lanciare un jamón. Un jamón lanciato può percorrere fino a tre spazi nella direzione in cui è rivolto il giocatore. Se un jamón "colpisce" un altro giocatore, chi lo ha lanciato guadagna un punto e il giocatore colpito ne perde uno. Le dimensioni dell'arena vengono regolate automaticamente in base al numero attuale di giocatori.
Ecco come appare l'arena con tre giocatori inventati:
Esempio di arena Battle Jamón
Revolving Conflicts
Nell'arena è possibile che più giocatori tentino di eseguire azioni in conflitto. Ad esempio, due giocatori potrebbero provare a spostarsi nello stesso spazio. In caso di conflitto, vince il microservizio con il tempo di risposta più rapido.
Guardare la battaglia
Per vedere come sta andando il tuo microservizio nella battaglia, dai un'occhiata all'arena live.
API Battle
Per funzionare con il nostro gestore dell'arena, il tuo microservizio dovrà implementare un'API specifica per partecipare all'arena. L'arena manager invierà lo stato attuale dell'arena in un HTTP POST all'URL che ci fornisci, con la seguente struttura JSON:
{
"_links": {
"self": {
"href": "https://YOUR_SERVICE_URL"
}
},
"arena": {
"dims": [4,3], // width, height
"state": {
"https://A_PLAYERS_URL": {
"x": 0, // zero-based x position, where 0 = left
"y": 0, // zero-based y position, where 0 = top
"direction": "N", // N = North, W = West, S = South, E = East
"wasHit": false,
"score": 0
}
... // also you and the other players
}
}
}
La risposta HTTP deve avere il codice di stato 200 (OK) con un corpo della risposta contenente la tua prossima mossa, codificata come un singolo carattere maiuscolo:
F <- move Forward
R <- turn Right
L <- turn Left
T <- Throw
E con questo è tutto! Vediamo come eseguire il deployment di un microservizio su Cloud Run, un servizio Google Cloud per l'esecuzione di microservizi e altre applicazioni.
2. Accedi a Google Cloud
Per poter eseguire il deployment del microservizio su Cloud Run, devi accedere a Google Cloud. Applicheremo un credito al tuo account e non dovrai inserire una carta di credito. In genere è meno problematico utilizzare un account personale (ad es. gmail.com) anziché un account G Suite, perché a volte gli amministratori G Suite impediscono ai propri utenti di utilizzare determinate funzionalità di Google Cloud. Inoltre, la console web che utilizzeremo dovrebbe funzionare perfettamente con Chrome o Firefox, ma potrebbe presentare problemi in Safari.
3. Deployment del microservizio
Puoi creare il tuo microservizio con qualsiasi tecnologia ed eseguirne il deployment ovunque, purché sia raggiungibile pubblicamente e conforme all'API Battle. Per semplificare le cose, ti aiuteremo a iniziare da un servizio di esempio e a eseguirne il deployment su Cloud Run.
Scegliere un campione con cui iniziare
Esistono due esempi di microservizi di battaglia da cui puoi iniziare:
Java e Spring Boot | ||
Kotlin e Spring Boot |
Dopo aver deciso con quale esempio iniziare, fai clic sul pulsante "Esegui il deployment su Cloud Run" qui sopra. Verrà avviata Cloud Shell (una console basata sul web per una macchina virtuale nel cloud) in cui verrà clonato il codice sorgente, quindi verrà creato un pacchetto di cui è possibile eseguire il deployment (un'immagine container Docker), che verrà poi caricato in Google Container Registry e di cui verrà eseguito il deployment su Cloud Run.
Quando ti viene chiesto, specifica la regione us-central1.
Lo screenshot seguente mostra l'output di Cloud Shell per la creazione e il deployment di microservizi
Verificare che il microservizio funzioni
In Cloud Shell puoi inviare una richiesta al microservizio appena di cui è stato eseguito il deployment, sostituendo YOUR_SERVICE_URL con l'URL del servizio (che si trova in Cloud Shell dopo la riga "Your application is now live here"):
curl -d '{
"_links": {
"self": {
"href": "https://foo.com"
}
},
"arena": {
"dims": [4,3],
"state": {
"https://foo.com": {
"x": 0,
"y": 0,
"direction": "N",
"wasHit": false,
"score": 0
}
}
}
}' -H "Content-Type: application/json" -X POST -w "\n" \
https://YOUR_SERVICE_URL
Dovresti visualizzare la stringa di risposta F, L, R o T.
4. Richiedere l'inclusione nell'arena
Per essere incluso nell'arena, devi inviare un messaggio al canale #battle-jamon con il tuo nome, l'URL del servizio Cloud Run e, facoltativamente, il tuo nome utente GitHub per l'avatar / la foto del profilo. Una volta convalidate le informazioni, il tuo giocatore verrà visualizzato nell'arena.
5. Apportare e implementare le modifiche
Prima di poter apportare modifiche, devi configurare alcune informazioni in Cloud Shell sul progetto Google Cloud e sul campione che hai utilizzato. Innanzitutto, elenca i tuoi progetti Google Cloud:
gcloud projects list
Probabilmente hai un solo progetto. Copia PROJECT_ID dalla prima colonna e incollalo nel comando seguente (sostituendo YOUR_PROJECT_ID con l'ID progetto effettivo) per impostare una variabile di ambiente che utilizzeremo nei comandi successivi:
export PROJECT_ID=YOUR_PROJECT_ID
Ora imposta un'altra variabile di ambiente per l'esempio che hai utilizzato, in modo che nei comandi successivi possiamo specificare la directory e il nome del servizio corretti:
# Copy and paste ONLY ONE of these export SAMPLE=java-springboot export SAMPLE=kotlin-springboot
Ora puoi modificare l'origine del tuo microservizio da Cloud Shell. Per aprire l'editor web di Cloud Shell, esegui questo comando:
cloudshell edit cloudbowl-microservice-game/samples/$SAMPLE/README.md
Verranno visualizzate ulteriori istruzioni per apportare le modifiche.
Cloud Shell con l'editor con il progetto di esempio aperto
Dopo aver salvato le modifiche, avvia l'applicazione in Cloud Shell:
cd cloudbowl-microservice-game/samples/$SAMPLE ./mvnw spring-boot:run
Una volta che l'applicazione è in esecuzione, apri una nuova scheda di Cloud Shell e testa il servizio utilizzando curl:
curl -d '{
"_links": {
"self": {
"href": "https://foo.com"
}
},
"arena": {
"dims": [4,3],
"state": {
"https://foo.com": {
"x": 0,
"y": 0,
"direction": "N",
"wasHit": false,
"score": 0
}
}
}
}' -H "Content-Type: application/json" -X POST -w "\n" \
http://localhost:8080
Quando è tutto pronto per il deployment delle modifiche, crea il progetto in Cloud Shell utilizzando il comando pack. Questo comando utilizza Buildpacks per rilevare il tipo di progetto, compilarlo e creare l'artefatto di cui è possibile eseguire il deployment (un'immagine container Docker).
pack build gcr.io/$PROJECT_ID/$SAMPLE \ --path ~/cloudbowl-microservice-game/samples/$SAMPLE \ --builder gcr.io/buildpacks/builder
Ora che l'immagine container è stata creata, utilizza il comando docker (in Cloud Shell) per eseguire il push dell'immagine container in Google Container Registry in modo che possa essere accessibile da Cloud Run:
docker push gcr.io/$PROJECT_ID/$SAMPLE
Ora esegui il deployment della nuova versione su Cloud Run:
gcloud run deploy $SAMPLE\
--project=$PROJECT_ID\
--platform=managed\
--region=us-central1\
--image=gcr.io/$PROJECT_ID/$SAMPLE\
--memory=512Mi\
--allow-unauthenticated
Ora l'arena utilizzerà la nuova versione.
6. Complimenti
Congratulazioni, hai creato e implementato correttamente un microservizio che può competere con altri microservizi. In bocca al lupo!
Continua a imparare
Documenti di riferimento
7. Domande frequenti
Perché il mio microservizio non viene visualizzato nell'arena?
Come si svolge la battaglia finale?
Come funziona l'arena prima della battaglia finale?
Come si vince?
Posso sviluppare localmente?