1. 简介
上次更新日期：2020 年 2 月 12 日
微服务战斗竞技场
您是否曾经在打雪仗时四处移动，然后顽皮地向他人投掷雪球？如果不是，那天试试吧！但现在，你不必冒着被物理攻击的风险，而是可以构建一个可访问的小型网络（微服务）服务，与其他微服务展开一场史诗般的战斗。自从我们在佐治亚州亚特兰大举行这场微服务之战以来，我们的微服务将迎来水桃，而不是滚雪球。
您可能想知道...但微服务是如何“抛出”的其他微服务？微服务可以接收网络请求（通常通过 HTTP）并返回响应。还有“场地管理员”它会向你的微服务发送 arena 的当前状态，然后你的微服务将用一个命令做出响应，指明要做什么。
当然，目标就是赢得客户，但在此过程中，您将了解如何在 Google Cloud 上构建和部署微服务。
运作方式
您将使用自己需要的任何技术（或者从 Java、Kotlin 或 Scala 入门级）构建微服务，然后在 Google Cloud 上部署微服务。部署后，您需要填写一份表单，告知我们您的微服务的网址，然后我们会将您的微服务添加到该 arena 中。
竞技场包含指定战斗的所有玩家。对于 DevNexus 大会，每天都会有一个场馆。每个玩家都代表一个到处移动并向其他玩家扔桃子的微服务。
我们的竞技场管理员大约每秒会调用一次您的微服务，并发送当前的竞技场状态（玩家所在的位置），您的微服务将做出响应并给出要执行操作的命令。在竞技场中，你可以前进、左转或右转，或者投掷桃子。抛出的桃子会在玩家所面对的方向上最多移动 3 个空间。如果桃子“命中”在另一位玩家中，投球手获得一分，击中玩家则会失去一分。竞技场大小会根据当前玩家人数自动调整。
下面是三名组员组队时的竞技场外观：
桃子竞技场示例
循环冲突
在竞技场中，可能会有多个玩家试图执行有冲突的操作。例如，两个玩家可能会尝试移动到同一个空间。如果发生冲突，将优先选择响应时间最短的微服务。
观看战斗
如需了解您的微服务在战斗中的表现，请查看实时竞技场！
战斗 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 | ||
Java 与Quarkus | ||
Kotlin 和Micronaut | ||
Kotlin 和Quarkus | ||
Scala 和Play 框架 | ||
Go |
决定从哪个示例开始后，请点击“在 Cloud Run 上部署”按钮。这将启动 Cloud Shell（针对云端虚拟机的 Web 控制台），在那里克隆来源，然后将其构建为可部署的软件包（Docker 容器映像），再将其上传到 Google Container Registry，再部署在 Cloud Run 上。
当系统询问时，请指定 us-central1 区域。
下面的屏幕截图显示了构建和部署微服务时 Cloud Shell 的输出
验证微服务能否正常运行
在 Cloud Shell 中，您可以向新部署的微服务发出请求，将 YOUR_SERVICE_URL 替换为服务的网址（位于 Cloud Shell 中的“您的应用现已上线”行之后）：
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 中修改微服务的来源。如需打开 Cloud Shell 基于网络的编辑器，请运行以下命令：
cloudshell edit cloudbowl-microservice-game/samples/$SAMPLE/README.md
随后您会看到有关如何进行更改的详细说明。
使用编辑器打开示例项目的 Cloud Shell
保存更改后，使用 pack 命令在 Cloud Shell 中构建项目。此命令使用 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. 恭喜
恭喜，您已成功构建并部署了一个可与其他微服务交互的微服务！祝您好运！