Battle Peach - 微服务战场

1. 简介

上次更新时间：2020 年 2 月 12 日

微服务竞技场

您是否曾参加过雪球大战，在其中四处移动，并向他人投掷雪球？如果还没有，不妨找个时间试试！但现在，您无需担心被实体击打，只需构建一个可通过网络访问的小型服务（微服务），即可参与与其他微服务之间的史诗级战斗。由于我们将在佐治亚州亚特兰大举办首届微服务大赛，因此我们的微服务将投掷桃子，而不是雪球。

您可能想知道…但微服务如何向其他微服务“抛出”桃子呢？微服务可以接收网络请求（通常通过 HTTP）并返回响应。有一个“竞技场管理器”会向您的微服务发送竞技场的当前状态，然后您的微服务会以命令的形式做出响应，指定要执行的操作。

当然，目标是获胜，但在此过程中，您将了解如何在 Google Cloud 上构建和部署微服务。

运作方式

您将使用任意技术构建微服务（或从 Java、Kotlin 或 Scala 启动器中选择），然后将微服务部署到 Google Cloud 上。部署完成后，您需要填写一个表单，告知我们微服务的网址，然后我们会将其添加到竞技场中。

竞技场包含给定战斗中的所有玩家。对于 DevNexus 大会，每天都会有一个活动场地。每个玩家代表一个四处移动并向其他玩家投掷桃子的微服务。

我们的竞技场管理器大约每秒会调用一次您的微服务，发送当前的竞技场状态（玩家所在的位置），而您的微服务会返回一个命令，指示该做什么。在竞技场中，您可以向前移动、向左或向右转动，或者投掷桃子。投出的桃子最多可沿玩家面向的方向移动三格。如果桃子“击中”另一位玩家，投掷者得 1 分，被击中的玩家失 1 分。系统会根据当前玩家数量自动调整竞技场大小。

以下是包含 3 名虚构球员的竞技场：

“战斗桃子”竞技场示例

循环冲突

在竞技场中，可能会有多位玩家尝试执行冲突的操作。例如，两名玩家可能会尝试移动到同一格。如果发生冲突，响应时间最短的微服务胜出。

观看比赛

如需了解您的微服务在战斗中的表现，请查看实时竞技场！

Battle API

为了与我们的竞技场管理器配合使用，您的微服务需要实现特定的 API 才能参与竞技场。竞技场管理器将通过 HTTP POST 向您提供的网址发送当前竞技场状态，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
    }
  }
}

您的 HTTP 响应必须是状态代码 200 (OK)，并且响应正文包含您的下一步行动，编码为单个大写字符，可以是以下任一字符：

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

就是这么简单！我们来逐步了解如何在 Cloud Run（一种用于运行微服务和其他应用的 Google Cloud 服务）上部署微服务。

2. 部署微服务

您可以使用任何技术构建微服务，并将其部署在任何位置，只要该微服务可公开访问且符合 Battle API 即可。为方便起见，您可以先从一个仅选择随机命令的示例项目开始。

选择要从哪个选段开始

您可以从以下三个对战微服务示例入手：

Java 和 Spring Boot	来源	在 Cloud Run 上部署
Java 和 Quarkus	来源	在 Cloud Run 上部署
Kotlin 和 Micronaut	来源	在 Cloud Run 上部署
Kotlin 和 Quarkus	来源	在 Cloud Run 上部署
Scala 和 Play 框架	来源	在 Cloud Run 上部署
Go	来源	在 Cloud Run 上部署

确定要从哪个示例开始后，点击上方的“在 Cloud Run 上部署”按钮。此命令将启动 Cloud Shell（一个基于网络的云端虚拟机控制台），源代码将在其中克隆，然后构建为可部署的软件包（一个 Docker 容器映像），该软件包随后会上传到 Google Container Registry，然后部署到 Cloud Run。

当系统询问时，指定 us-central1 区域。

以下屏幕截图显示了微服务构建和部署的 Cloud Shell 输出

验证微服务是否正常运行

在 Cloud Shell 中，您可以向新部署的微服务发出请求，将 YOUR_SERVICE_URL 替换为您的服务的网址（该网址位于 Cloud Shell 中“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

您应该会看到 F、L、R 或 T 的响应字符串。

申请加入竞技场

您需要填写一份简短的表单才能加入竞技场。最难的部分是确定要使用什么作为个人资料照片。您可以使用 GitHub 图片或 LinkedIn 图片，也可以由我们为您随机选择一个头像。我们审核完提交的内容后，您的球员将显示在球场中。

做出更改并部署

在进行更改之前，您需要在 Cloud Shell 中设置一些有关 GCP 项目和所用示例的信息。首先，列出您的 GCP 项目：

gcloud projects list

您可能只有一个项目。复制第一列中的 PROJECT_ID，并将其粘贴到以下命令中（将 YOUR_PROJECT_ID 替换为您的实际项目 ID），以设置一个环境变量，供我们在后续命令中使用：

export PROJECT_ID=YOUR_PROJECT_ID

现在，为所使用的示例设置另一个环境变量，以便在后续命令中指定正确的目录和服务名称：

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

现在，您可以在 Cloud Shell 中修改微服务的源代码。如需打开基于 Web 的 Cloud Shell 编辑器，请运行以下命令：

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

然后，您会看到有关如何进行更改的进一步说明。

Cloud Shell，其中包含已打开示例项目的编辑器

保存更改后，在 Cloud Shell 中使用 pack 命令构建项目。此命令使用 Buildpack 检测项目类型、对其进行编译，并创建可部署的制品（一个 Docker 容器映像）。

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

现在，您的容器映像已创建完毕，请使用 docker 命令（在 Cloud Shell 中）将容器映像推送到 Google Container Registry，以便 Cloud Run 随后可以访问该映像：

docker push gcr.io/$PROJECT_ID/$SAMPLE

现在，在 Cloud Run 上部署新版本：

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

现在，竞技场将使用您的新版本！

3. 恭喜

恭喜！您已成功构建并部署了一个可以与其他微服务对战的微服务！祝您好运！

后续操作

参考文档

Cloud Run 文档