1. Pengantar
Terakhir Diperbarui: 12-02-2020
Microservices Battle Arena
Pernahkah Anda terlibat dalam pertarungan bola salju di mana Anda bergerak dan melempar bola salju ke orang lain dengan riang? Jika belum, coba kapan-kapan. Namun, alih-alih berisiko dipukul secara fisik, Anda dapat membangun layanan kecil yang dapat diakses jaringan (microservice) yang akan berpartisipasi dalam pertempuran epik melawan microservice lainnya. Karena kami mengadakan pertarungan microservice pertama ini di Atlanta, Georgia, microservice kami akan melempar buah persik, bukan bola salju.
Anda mungkin bertanya-tanya... Namun, bagaimana cara microservice "melempar" buah persik ke microservice lain? Microservice dapat menerima permintaan jaringan (biasanya melalui HTTP) dan menampilkan respons. Ada "pengelola arena" yang akan mengirimkan status arena saat ini ke microservice Anda, lalu microservice Anda akan merespons dengan perintah yang menentukan apa yang harus dilakukan.
Tentu saja tujuannya adalah menang, tetapi di sepanjang perjalanan Anda akan belajar cara membangun dan men-deploy microservice di Google Cloud.
Cara Kerjanya
Anda akan membangun microservice dengan teknologi apa pun yang Anda inginkan (atau memilih dari starter Java, Kotlin, atau Scala), lalu men-deploy microservice di Google Cloud. Setelah di-deploy, Anda akan mengisi formulir untuk memberi tahu kami URL untuk mikroservice Anda, lalu kami akan menambahkannya ke arena.
Arena berisi semua pemain untuk pertarungan tertentu. Untuk konferensi DevNexus, akan ada satu arena untuk setiap hari. Setiap pemain mewakili microservice yang bergerak dan melemparkan buah persik ke pemain lain.
Sekitar sekali per detik, pengelola arena akan memanggil microservice Anda, mengirimkan status arena saat ini (tempat pemain berada), dan microservice Anda akan merespons dengan perintah untuk melakukan sesuatu. Di arena, Anda dapat bergerak maju, berbelok ke kiri atau kanan, atau melempar buah persik. Persik yang dilempar akan bergerak hingga tiga petak ke arah pemain menghadap. Jika buah persik "mengenai" pemain lain, pelempar akan mendapatkan satu poin dan pemain yang terkena akan kehilangan satu poin. Ukuran arena disesuaikan secara otomatis untuk jumlah pemain saat ini.
Berikut tampilan arena dengan tiga pemain fiktif:
Contoh arena Battle Peach
Konflik yang Berulang
Di arena, beberapa pemain dapat mencoba melakukan tindakan yang bertentangan. Misalnya, dua pemain mungkin mencoba berpindah ke ruang yang sama. Jika terjadi konflik, microservice dengan waktu respons tercepat akan menang.
Menyaksikan Pertempuran
Untuk melihat performa mikroservice Anda dalam pertarungan, lihat arena live.
Battle API
Untuk berinteraksi dengan pengelola arena kami, microservice Anda harus menerapkan API tertentu untuk berpartisipasi dalam arena. Pengelola arena akan mengirim status arena saat ini dalam HTTP POST ke URL yang Anda berikan kepada kami, dengan struktur JSON berikut:
{
"_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
}
}
}
Respons HTTP Anda harus berupa kode status 200 (OK) dengan isi respons yang berisi langkah selanjutnya, yang dienkode sebagai satu karakter huruf besar dari:
F <- move Forward
R <- turn Right
L <- turn Left
T <- Throw
Selesai. Mari kita pelajari cara men-deploy microservice di Cloud Run, layanan Google Cloud untuk menjalankan microservice dan aplikasi lainnya.
2. Men-deploy Microservice Anda
Anda dapat membuat microservice dengan teknologi apa pun dan men-deploy-nya di mana saja selama dapat dijangkau secara publik dan sesuai dengan Battle API. Untuk mempermudah, Anda dapat memulai dengan project contoh yang hanya memilih perintah acak.
Pilih Sampel Anda untuk Memulai
Ada tiga contoh microservice pertarungan yang dapat Anda gunakan sebagai titik awal:
Java & Spring Boot | ||
Java & Quarkus | ||
Kotlin & Micronaut | ||
Kotlin & Quarkus | ||
Scala & Play Framework | ||
Go |
Setelah Anda memutuskan sampel mana yang akan digunakan untuk memulai, klik tombol "Deploy on Cloud Run" di atas. Tindakan ini akan meluncurkan Cloud Shell (konsol berbasis web ke mesin virtual di cloud) tempat sumber akan di-clone, lalu dibangun ke dalam paket yang dapat di-deploy (image container Docker), yang kemudian diupload ke Google Container Registry, lalu di-deploy di Cloud Run.
Saat ditanya, tentukan wilayah us-central1.
Screenshot di bawah menunjukkan output Cloud Shell untuk build dan deployment microservice
Memverifikasi fungsi microservice
Di Cloud Shell, Anda dapat membuat permintaan ke mikroservice yang baru di-deploy, dengan mengganti YOUR_SERVICE_URL dengan URL layanan Anda (yang ada di Cloud Shell setelah baris "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
Anda akan melihat string respons F, L, R, atau T.
Minta Penyertaan di Arena
Anda harus mengisi formulir singkat agar dapat masuk ke arena. Bagian tersulitnya adalah menentukan gambar profil yang ingin Anda gunakan. Anda dapat menggunakan gambar GitHub, gambar LinkedIn, atau kami akan memilih avatar acak untuk Anda. Setelah kami meninjau kiriman, pemain Anda akan muncul di arena.
Membuat & Menerapkan Perubahan
Sebelum dapat melakukan perubahan, Anda perlu menyiapkan beberapa informasi di Cloud Shell tentang project GCP dan sampel yang Anda gunakan. Pertama, cantumkan project GCP Anda:
gcloud projects list
Anda mungkin hanya memiliki satu project. Salin PROJECT_ID dari kolom pertama dan tempelkan ke perintah berikut (ganti YOUR_PROJECT_ID dengan Project ID Anda yang sebenarnya), untuk menetapkan variabel lingkungan yang akan kita gunakan dalam perintah selanjutnya:
export PROJECT_ID=YOUR_PROJECT_ID
Sekarang tetapkan variabel lingkungan lain untuk sampel yang Anda gunakan sehingga di perintah selanjutnya kita dapat menentukan direktori dan nama layanan yang benar:
# Copy and paste ONLY ONE of these export SAMPLE=java-springboot export SAMPLE=kotlin-micronaut export SAMPLE=scala-play
Sekarang, Anda dapat mengedit sumber untuk microservice dari dalam Cloud Shell. Untuk membuka editor berbasis web Cloud Shell, jalankan perintah ini:
cloudshell edit cloudbowl-microservice-game/samples/$SAMPLE/README.md
Kemudian, Anda akan melihat petunjuk lebih lanjut untuk melakukan perubahan.
Cloud Shell dengan editor yang membuka project sampel
Setelah menyimpan perubahan, bangun project Anda di Cloud Shell menggunakan perintah pack. Perintah ini menggunakan Buildpack untuk mendeteksi jenis project, mengompilasinya, dan membuat artefak yang dapat di-deploy (image container Docker).
pack build gcr.io/$PROJECT_ID/$SAMPLE \ --path cloudbowl-microservice-game/samples/$SAMPLE \ --builder heroku/buildpacks
Setelah image container Anda dibuat, gunakan perintah docker (di Cloud Shell) untuk mengirim image container ke Google Container Registry sehingga dapat diakses oleh Cloud Run:
docker push gcr.io/$PROJECT_ID/$SAMPLE
Sekarang deploy versi baru di Cloud Run:
gcloud run deploy $SAMPLE\
--project=$PROJECT_ID\
--platform=managed\
--region=us-central1\
--image=gcr.io/$PROJECT_ID/$SAMPLE\
--memory=512Mi\
--allow-unauthenticated
Sekarang arena akan menggunakan versi baru Anda.
3. Selamat
Selamat, Anda telah berhasil membuat dan men-deploy microservice yang dapat bertarung dengan microservice lain. Semoga berhasil!
Apa selanjutnya?
- Menambahkan pelacakan terdistribusi ke aplikasi Spring Boot
- Menggunakan AI Platform untuk membuat microservice Anda menjadi sangat pintar