创建或更新发布

本页面介绍如何在部署中创建、更新 Game Servers 发布以及查看其详情。发布可将游戏服务器配置映射到目标大区。如需查看创建部署，添加配置然后发布部署的端到端示例，请参阅配置集群扩缩行为。

图 1.配置版本 1.0 发布到美国大区，版本 1.1 发布到欧洲和日本大区

如需了解详情，请参阅 Game Servers 概览。

准备工作

开始之前，我们建议您先了解 Game Servers 概览中的关键概念。请确保您已执行以下任务：

确保您已启用 Game Services API。

启用 Game Services API

选择已安装 gcloud CLI 的 shell，或者使用 API 客户端：

Cloud Shell

如需启动 Cloud Shell，请执行以下步骤：

进入 Google Cloud 控制台。

Google Cloud 控制台
在控制台的右上角，点击激活 Cloud Shell 按钮：

控制台下方的框架内会打开一个 Cloud Shell 会话。您可以使用此 shell 运行 gcloud 命令。

本地 shell

安装 gcloud CLI。

确认您已为 Google Cloud CLI 设置所需的默认项目（否则，您稍后需要为每个命令明确指定 --project 标志）：

gcloud config list project

如果无法运行以下命令来设置默认项目，请将 PROJECT_ID 替换为所需的项目 ID：

gcloud config set project PROJECT_ID

运行以下命令以验证 Google Cloud CLI 的版本。Game Servers 需要使用 306.0.0 版或更高版本的 gcloud CLI。

gcloud version

如需更新安装，请运行以下命令：

gcloud components update

curl / PowerShell

如需将 REST API 与 curl 或 Windows PowerShell 搭配使用，请执行以下操作：

创建服务帐号。
以 JSON 文件的格式下载私钥。
Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.
Example: Linux or macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
Example: Windows

For PowerShell:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
For command prompt:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

客户端库

您可以使用客户端库以编程方式控制 Google Cloud Game Servers。如需了解库和身份验证的使用说明，请参阅客户端库概览。

更新发布

更新发布的过程与创建发布的过程相同。首先，确保您已创建 Game Servers 配置。如果您要使用另一个配置来定位特定大区，请创建单独的替换配置。

更新发布的默认配置

默认游戏服务器配置会发布到所有大区。如需使用另一个配置来定位特定大区，请参阅替换特定大区的配置。

控制台

在 Google Cloud 控制台中，转到游戏服务器部署页面。

转到 Game Servers
在表格中查找部署。在表格的最后一列中，点击省略号并选择列出配置。您可以通过此页面查看部署的活跃配置和无效配置。
点击管理发布。
（可选）在选择配置列表中，选择应用于所有大区的默认配置。
点击保存。

gcloud

如需使用 Google Cloud CLI 更新 Game Servers 部署的默认配置，请执行以下操作：

替换以下占位值后运行以下命令：
- deploymentID 是部署的唯一标识符。
- configID 是配置的唯一标识符。
```
gcloud game servers deployments update-rollout deploymentID --default-config configID --dry-run
```
输出会返回 targetState，以便您预览更改。

如需应用更改，请运行以下命令：

gcloud game servers deployments update-rollout deploymentID --default-config configID --no-dry-run

REST

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：IAM 设置中列出的 Google Cloud 项目 ID
DEPLOYMENT_ID：用户定义的部署标识符
CONFIG_ID：用户定义的配置标识符

请求 JSON 正文：

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": "CONFIG_ID"
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户帐号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的帐号。

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": "CONFIG_ID"
}
EOF

然后，执行以下命令以发送 REST 请求：

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=defaultGameServerConfig"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

@'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": "CONFIG_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

然后，执行以下命令以发送 REST 请求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=defaultGameServerConfig" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

清除发布的默认配置

清除默认配置，以便从此 Game Servers 集群中移除此部署的队列配置。

控制台

在 Google Cloud 控制台中，转到游戏服务器部署页面。

转到 Game Servers
在表格中查找部署。在表格的最后一列中，点击省略号并选择列出配置。您可以通过此页面查看部署的活跃配置和无效配置。
点击管理发布。
在选择配置列表中，选择（无默认配置）。
点击保存。

gcloud

如需使用 Google Cloud CLI 清除 Game Servers 部署的默认配置，请执行以下操作：

替换以下占位值后运行以下命令：
- deploymentID 是部署的唯一标识符。
```
gcloud game servers deployments update-rollout deploymentID --clear-default-config --dry-run
```
输出会返回 targetState，以便您预览更改。

如需应用更改，请运行以下命令：

gcloud game servers deployments update-rollout deploymentID --clear-default-config --no-dry-run

REST

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：IAM 设置中列出的 Google Cloud 项目 ID
DEPLOYMENT_ID：用户定义的部署标识符

请求 JSON 正文：

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": ""
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": ""
}
EOF

然后，执行以下命令以发送 REST 请求：

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=defaultGameServerConfig"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

@'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": ""
}
'@  | Out-File -FilePath request.json -Encoding utf8

然后，执行以下命令以发送 REST 请求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=defaultGameServerConfig" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

替换特定大区的配置

如果您要使用另一个配置来定位特定大区，请创建单独的替换配置，然后选择一个或多个将接收此替换配置（而非默认配置）的大区。

控制台

在 Google Cloud 控制台中，转到游戏服务器部署页面。

转到 Game Servers
在表格中查找部署。在表格的最后一列中，点击省略号并选择列出配置。您可以通过此页面查看部署的活跃配置和无效配置。
点击管理发布。
（可选）在选择配置列表中，选择应用于与替换配置不匹配的所有大区的默认配置。
在替换配置下，您可以指定一个或多个替换配置，以及要与这些配置关联的大区。
1. 从配置列表中选择一个替换配置，然后从大区列表中选择要与之关联的大区。
2. 使用箭头按钮更改替换配置在列表中的优先顺序。
3. 点击添加。
点击保存。

gcloud

如需使用 Google Cloud CLI 将配置替换应用于特定大区，请执行以下操作：

将以下代码复制到一个文件中，并替换以下占位值：
- realmID 是大区的完全限定标识符，例如 projects/<projectID>/locations/<region>/realms/<realmID2>。
- configID 是配置的唯一标识符。
```
- realmsSelector:
    realms:
        - realmID
  configVersion: configID
```
替换以下占位值后运行以下命令：
- deploymentID 是部署的唯一标识符。
- configOverrideFile 是具有替换配置的文件的路径。
```
gcloud game servers deployments update-rollout deploymentID --config-overrides-file configOverrideFile --dry-run
```
输出会返回 targetState，以便您预览更改。

如需应用更改，请运行以下命令：

gcloud game servers deployments update-rollout deploymentID --config-overrides-file configOverrideFile  --no-dry-run

REST

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：IAM 设置中列出的 Google Cloud 项目 ID
LOCATION：大区的区域（或 global）
DEPLOYMENT_ID：用户定义的部署标识符
REALM_ID：用户定义的大区标识符
OVERRIDE_CONFIG_ID：用户定义的替换配置标识符

请求 JSON 正文：

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": [
  {
    "realmsSelector": {
      "realms": [
        "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"
      ]
    },
    "configVersion": "OVERRIDE_CONFIG_ID"
  }
  ]
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": [
  {
    "realmsSelector": {
      "realms": [
        "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"
      ]
    },
    "configVersion": "OVERRIDE_CONFIG_ID"
  }
  ]
}
EOF

然后，执行以下命令以发送 REST 请求：

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=gameServerConfigOverrides"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

@'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": [
  {
    "realmsSelector": {
      "realms": [
        "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"
      ]
    },
    "configVersion": "OVERRIDE_CONFIG_ID"
  }
  ]
}
'@  | Out-File -FilePath request.json -Encoding utf8

然后，执行以下命令以发送 REST 请求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=gameServerConfigOverrides" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

清除配置替换

清除替换配置，以从目标大区移除此部署的队列配置。

控制台

在 Google Cloud 控制台中，转到游戏服务器部署页面。

转到 Game Servers
在表格中查找部署。在表格的最后一列中，点击省略号并选择列出配置。您可以通过此页面查看部署的活跃配置和无效配置。
点击管理发布。
在替换配置下，点击要清除的替换配置旁边的垃圾桶图标。
点击保存。

gcloud

如需使用 Google Cloud CLI 清除 Game Servers 部署的配置替换，请执行以下操作：

替换以下占位值后运行以下命令：
- deploymentID 是部署的唯一标识符。
```
gcloud game servers deployments update-rollout deploymentID --clear-config-overrides --dry-run
```
输出会返回 targetState，以便您预览更改。

如需应用更改，请运行以下命令：

gcloud game servers deployments update-rollout deploymentID --clear-config-overrides --no-dry-run

REST

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：IAM 设置中列出的 Google Cloud 项目 ID
DEPLOYMENT_ID：用户定义的部署标识符

请求 JSON 正文：

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": []
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": []
}
EOF

然后，执行以下命令以发送 REST 请求：

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=gameServerConfigOverrides"

PowerShell (Windows)

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

@'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": []
}
'@  | Out-File -FilePath request.json -Encoding utf8

然后，执行以下命令以发送 REST 请求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout?updateMask=gameServerConfigOverrides" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

查看有关发布的详细信息

控制台

在 Google Cloud 控制台中，转到游戏服务器部署页面。

转到 Game Servers
在表格中查找部署。在表格的最后一列中，点击省略号并选择列出配置。您可以通过此页面查看部署的活跃配置和无效配置。
点击管理发布。

gcloud

您可以使用 Google Cloud CLI 查看有关部署的详细信息，例如正在使用的配置：

如需查看发布的详细信息，请在替换以下占位值后运行以下命令：

deploymentID 是父级部署的唯一标识符。

gcloud game servers deployments describe-rollout deploymentID

输出会显示发布的详细信息。

您还可以使用 Google Cloud CLI 查看发布后游戏服务器集群的状态：

gcloud game servers deployments fetch-state deploymentID

输出会显示每个游戏服务器集群上的发布所应用的更改。

REST

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：IAM 设置中列出的 Google Cloud 项目 ID
DEPLOYMENT_ID：用户定义的部署标识符

根据您发送的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

执行以下命令：

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout"

PowerShell (Windows)

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout",
  "createTime": CREATE_TIME,
  "updateTime": UPDATE_TIME,
  "defaultGameServerConfig": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/CONFIG_ID",
  "gameServerConfigOverrides": [
    {
      "realmsSelector": {
        "realms": [
          "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"
        ]
      },
      "configVersion": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/OVERRIDE_CONFIG_ID"
    }
  ],
  "etag": "cN31kxa6fWHtaZWUnUZ7LfamUN7Ggz13DWS58Sc5jIQ"
}

排查发布问题

本部分介绍了 Game Servers 可能无法更新游戏服务器集群的原因。一个常见原因可能是 Game Servers 或游戏服务器集群的配置错误。您可以参照以下核对清单来诊断遇到的潜在问题：

检查满足 Agones 集群的以下前提条件：
1. 确保集群正在运行并且安装了 Agones。如需验证 agones-controller pod 是否处于 Running 状态，请运行以下命令：
```
kubectl get pods -n agones-system -l agones.dev/role=controller
```
2. 确保游戏服务器命名空间拥有 Agones 控制器的基于角色的必需的访问权限控制 (RBAC) 权限。
3. 确保 Game Servers 支持已安装的 Agones 版本。
请查阅 Agones 问题排查指南。
检查 Game Servers 部署资源是否配置正确：
1. 如果您使用的是替换配置，请确保该部署适用于包含目标集群的大区。
2. 确保队列规范配置正确。要验证队列规范，请尝试手动启动游戏服务器。
3. 如果未发生计划的更改，请确保正确配置了时间表。时间表的时区遵循大区的时区。

后续步骤

了解如何删除配置。