Battle One - Mikro Hizmetler Savaş Alanı

1. Giriş

Son Güncelleme Tarihi: 26.08.2020

Mikro Hizmetler Savaş Meydanı

Hiç etrafta dolanıp başkalarına kartopu fırlattığınız bir kartopu savaşı yaptınız mı? Yoksa bir gün tekrar deneyin! Ancak artık fiziksel olarak dövülme riskine girmek yerine, diğer mikro hizmetlere karşı destansı bir savaşta yer alacak küçük, ağa bağlı bir hizmet (mikro hizmet) oluşturabilirsiniz. Bu mikro hizmet savaşını SpringOne'da düzenlediğimiz için mikro hizmetlerimiz kartopu yerine yaprak fırlatacak.

Merak ediyor olabilirsiniz... Peki bir mikro hizmet nasıl "fırlatıcı" bir yaprağı var mı? Mikro hizmetler, ağ istekleri (genellikle HTTP üzerinden) alabilir ve yanıtlar döndürebilir. Bir "arena yöneticisi" vardır mikro hizmetinize arenanın mevcut durumunu gönderir ve mikro hizmetiniz ne yapılacağını belirten bir komutla yanıt verir.

Elbette hedefiniz kazanmak olsa da bu süreçte Google Cloud'da mikro hizmetler derleme ve dağıtma hakkında bilgi edineceksiniz.

İşleyiş şekli

İstediğiniz herhangi bir teknolojiyle mikro hizmet derleyecek (veya Java, Kotlin ya da Scala başlatıcılar arasından seçim yapmanız) ve ardından mikro hizmeti Google Cloud'da dağıtacaksınız. Dağıtımdan sonra, mikro hizmetinizin URL'sini bize bildirmek için bir form dolduracaksınız. Ardından, mikro hizmetinizin URL'sini arenaya ekleyeceğiz.

Arenada belirli bir savaştaki tüm oyuncular yer alır. SpringOne konferansının kendi arenası olacaktır. Her oyuncu, etrafta dolaşıp diğer oyunculara yaprak fırlatan bir mikro hizmeti temsil eder.

Arena yöneticimiz yaklaşık saniyede bir kez mikro hizmetinizi arayarak mevcut arena durumunu (oyuncuların bulunduğu yer) gönderir ve mikro hizmetiniz, ne yapılması gerektiğine dair bir komutla yanıt verir. Arenada ileri gidebilir, sola veya sağa dönebilir ya da yaprak atabilirsiniz. Fırlatılan bir yaprak, oyuncunun baktığı yönde en fazla üç boşluk hareket eder. Bir yaprak "isabet ederse" atış yapan oyuncu bir puan alır ve vuran oyuncu bir puan kaybeder. Arena boyutu, mevcut oyuncu sayısına göre otomatik olarak ayarlanır.

Eski bir arena şu şekilde görünür:

20628e6bd442bd11.png

Örnek Battle One arenası

Dönen Çatışmalar

Arenada birden fazla oyuncu birbiriyle çelişen işlemler gerçekleştirmeye çalışabilir. Örneğin, iki oyuncu aynı alana taşınmaya çalışabilir. Çakışma durumunda, en hızlı yanıt süresine sahip mikro hizmet kazanır.

Savaşı izleme

Mikro hizmetinizin savaşta performansını öğrenmek için canlı arenaya göz atın.

Battle API

Arena yöneticimizle birlikte çalışmak için mikro hizmetinizin arenaya katılmak için belirli bir API uygulaması gerekir. Arena yöneticisi, mevcut arena durumunu HTTP POST'ta bize gönderdiğiniz URL'ye aşağıdaki JSON yapısıyla gönderir:

{
  "_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
    }
  }
}

HTTP yanıtınız, sonraki taşımanızı içeren ve aşağıdakilerden birinin tek büyük harfli karakteri olarak kodlanmış bir yanıt gövdesine sahip 200 (Tamam) durum kodu olmalıdır:

F <- move Forward
R <- turn Right
L <- turn Left
T <- Throw

Hepsi bu kadar! Mikro hizmetleri ve diğer uygulamaları çalıştırmaya yönelik bir Google Cloud hizmeti olan Cloud Run'da mikro hizmet dağıtmaya göz atalım.

2. Google Cloud'a giriş yapın

Mikro hizmetinizi Cloud Run'da dağıtabilmek için Google Cloud'a giriş yapmanız gerekir. Böylece hesabınıza kredi uygulanır ve kredi kartı girmeniz gerekmez. G Suite hesapları yerine kişisel bir hesap (ör. gmail.com) kullanmak genellikle daha az sorunludur; çünkü bazen G Suite yöneticileri, kullanıcılarının belirli Google Cloud özelliklerini kullanmasını engeller. Ayrıca, kullanacağımız web konsolunun Chrome veya Firefox ile sorunsuz çalışması beklenir ancak Safari'de sorunlar yaşanabilir.

3. Mikro Hizmetinizi Dağıtma

Mikro hizmetinizi dilediğiniz teknolojiyle derleyebilir, herkese açık olduğu ve Battle API'ye uygun olduğu sürece istediğiniz yere dağıtabilirsiniz. Ancak işleri kolaylaştırmak için örnek bir hizmetten başlamanıza ve bu hizmeti Cloud Run'da dağıtmanıza yardımcı olacağız.

Başlamak İçin Sana Özel içeriklerini seçin

Başlayabileceğiniz iki savaş mikro hizmet örneği vardır:

Java ve Yazlık Bot

Kaynak

Cloud Run'da dağıtma

Kotlin ve Yazlık Bot

Kaynak

Cloud Run'da dağıtma

Hangi örnekle başlayacağınıza karar verdikten sonra "Cloud Run'da dağıt"ı tıklayın. düğmesini tıklayın. Bu işlem, kaynağın klonlanacağı, ardından dağıtılabilir bir pakete (bir Docker container görüntüsü) yerleştirileceği ve ardından Google Container Registry'ye yüklenip Cloud Run'a dağıtılacağı Cloud Shell'i (buluttaki bir sanal makineye yönelik web tabanlı bir konsol) başlatacaktır.

Sorulduğunda, us-central1 bölgesini belirtin.

Aşağıdaki ekran görüntüsünde, mikro hizmet derlemesi ve dağıtımı için Cloud Shell çıkışı gösterilmektedir

d88e40430706a32b.png

Mikro hizmetin çalıştığını doğrulama

Cloud Shell'de, yeni dağıtılan mikro hizmetinize YOUR_SERVICE_URL yerine hizmetinizin URL'sini yazarak istek gönderebilirsiniz. Hizmet URL'si, Cloud Shell'de "Uygulamanız artık burada yayında" satırından sonra yer alır:

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

F, L, R veya T yanıt dizesini görürsünüz.

4. Arenaya Katılım İsteğinde Bulunma

Arenaya katılmak için #3-sponsor-google-cloud Slack kanalına adınızı, Cloud Run hizmet URL'sini ve avatarı / profil fotoğrafı için isteğe bağlı olarak GitHub kullanıcı adınızı içeren bir mesaj göndermeniz gerekir. Bilgiler doğrulandıktan sonra, oyuncunuz arenada görünür.

5. Marka ve Değişiklikleri Dağıtma

Değişiklik yapmadan önce, Cloud Shell'de GCP projesi ve kullandığınız örnekle ilgili bazı bilgileri ayarlamanız gerekir. İlk olarak GCP projelerinizi listeleyin:

gcloud projects list

Muhtemelen yalnızca bir projeniz vardır. İlk sütundaki PROJECT_ID değerini kopyalayıp aşağıdaki komuta yapıştırın (YOUR_PROJECT_ID değerini gerçek proje kimliğinizle değiştirin). Böylece, sonraki komutlarda kullanacağımız bir ortam değişkeni belirleyebilirsiniz:

export PROJECT_ID=YOUR_PROJECT_ID

Şimdi, sonraki komutlarda doğru dizini ve hizmet adını belirtebilmemiz için, kullandığınız örnekle ilgili başka bir ortam değişkeni ayarlayın:

# Copy and paste ONLY ONE of these
export SAMPLE=java-springboot
export SAMPLE=kotlin-springboot

Artık mikro hizmetinizin kaynağını Cloud Shell içinden düzenleyebilirsiniz. Cloud Shell web tabanlı düzenleyiciyi açmak için şu komutu çalıştırın:

cloudshell edit cloudbowl-microservice-game/samples/$SAMPLE/README.md

Ardından, değişiklik yapmayla ilgili diğer talimatları görürsünüz.

f910c9ef7b51c406.png

Örnek projenin açık olduğu düzenleyiciyi içeren Cloud Shell

Değişikliklerinizi kaydettikten sonra uygulamayı Cloud Shell'de başlatın:

cd cloudbowl-microservice-game/samples/$SAMPLE
./mvnw spring-boot:run

Uygulama çalışmaya başladıktan sonra yeni bir Cloud Shell sekmesi açın ve curl'ü kullanarak hizmeti test edin:

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

Değişikliklerinizi dağıtmaya hazır olduğunuzda pack komutunu kullanarak projenizi Cloud Shell'de derleyin. Bu komut, proje türünü algılamak, derlemek ve dağıtılabilir yapıyı (Docker container görüntüsü) oluşturmak için Buildpacks'i kullanır.

pack build gcr.io/$PROJECT_ID/$SAMPLE \
  --path ~/cloudbowl-microservice-game/samples/$SAMPLE \
  --builder gcr.io/buildpacks/builder

Container görüntünüz oluşturulduğuna göre container görüntüsünü Google Container Registry'ye aktarmak için Docker komutunu (Cloud Shell'de) kullanın. Böylece, Cloud Run bu görüntüye erişebilir:

docker push gcr.io/$PROJECT_ID/$SAMPLE

Şimdi yeni sürümü Cloud Run'da dağıtın:

gcloud run deploy $SAMPLE\
          --project=$PROJECT_ID\
          --platform=managed\
          --region=us-central1\
          --image=gcr.io/$PROJECT_ID/$SAMPLE\
          --memory=512Mi\
          --allow-unauthenticated

Artık arena yeni sürümünüzü kullanacak.

6. Yerel Olarak Geliştirin

Aşağıdaki adımları uygulayarak kendi IDE'nizi kullanarak projeniz üzerinde yerel olarak çalışabilirsiniz:

  1. [Cloud Shell'de] Örneği sıkıştırın:

cd ~/cloudbowl-microservice-game/samples; zip -r cloudbowl-sample.zip $SAMPLE

  1. [Cloud Shell'de] ZIP dosyasını makinenize indirin:

cloudshell download-file cloudbowl-sample.zip

  1. [Makinenizde] Dosyanın sıkıştırmasını açın ve & değişikliklerinizi test edin
  2. [Makinenizde] gcloud KSA'yı yükleme
  3. [Makinenizde] Google Cloud'a giriş yapın:

gcloud auth login

  1. [Makinenizde] PROJECT_ID ve SAMPLE ortam değişkenlerini Cloud Shell'dekilerle aynı değerlere ayarlayın.
  2. [Makinenizde] Container'ı derlemek için Cloud Build'i kullanın (kök proje dizininden):

gcloud alpha builds submit . --pack=image=gcr.io/$PROJECT_ID/$SAMPLE

  1. [Makinenizde] Yeni container'ı dağıtın:

gcloud run deploy $SAMPLE --project=$PROJECT_ID --platform=managed --region=us-central1 --image=gcr.io/$PROJECT_ID/$SAMPLE --memory=512Mi --allow-unauthenticated

7. Tebrikler

Tebrikler, diğer mikro hizmetlerle savaşabilecek bir mikro hizmeti başarıyla derleyip dağıttınız. İyi şanslar!

Öğrenmeye Devam Edin

Referans Belgeler

8. SSS

Mikro hizmetim neden arenada gösterilmiyor?