创建和部署 Linux 容器映像
本节概述了帮助您创建和部署 Linux 容器映像的具体步骤。 如创建虚拟机 (VM)中所述，使用我们的服务时，您可以将虚拟机配置为根据您的预算和需求在全球范围内自动作为游戏服务器启动。为此，您不必显式创建虚拟机，而是定义参数以确定它们如何代表您创建。此过程称为部署或创建构建。 PlayFab Multiplayer Servers 可以部署基于 Linux 和基于 Windows 的游戏服务器。为 Linux 容器部署构建的方式与 Windows 容器类似，但有一些重要区别。要了解更多信息，请参阅 Windows 和 Linux 容器映像的差异。如果要使用 PowerShell/API 管理 Linux 容器，请参阅使用 API 管理 Linux 容器映像。 使用基于 Linux 的游戏服务器时，您必须创建并将容器映像上传到容器注册表，而不是使用托管的容器映像。为了便于上传容器，您的账户附带了一个 Azure 容器注册表。所需知识
设置 Windows 开发设备
仅当您要使用 Windows 开发设备创建 Linux 容器映像时才需要此步骤。或者，您可以使用安装了 Docker 的 Linux OS 设备、虚拟机或双操作系统。 适用于 Linux 的 Windows 子系统 (WSL) 使您可以在熟悉的 Windows 环境中使用开发设备编写和管理 Linux 容器映像。使用 WSL 意味着您无需承担传统 Linux 虚拟机或双引导设置的开销。- 安装 WSL 2。请确保重启计算机并使用 WSL 2。您还需要安装 Linux 内核更新包。
- 安装使用 WSL 的 Linux 发行版。虽然我们的虚拟机使用 Ubuntu，但您可以为容器映像选择任何发行版。考虑使用 Ubuntu 20.04 长期支持 (LTS) 或更高版本。
- 使用 WSL 2 安装 Windows 版 Docker Desktop。如需直接下载链接，请转到 Windows 版 Docker Desktop（外部链接）。
- 打开 PowerShell
- 运行 wsl -l -v 以检查 docker-desktop 和 ubuntu 应用程序是否都在运行 WSL 2（版本 2）
- 打开 WSL 终端
- 运行 docker version 确认已安装 Docker 且使用的 OS 为 Linux
获取 PlayFab 容器注册表登录凭据
Azure 容器注册表账户与您的 PlayFab 账户相关联。只有您可以访问上传到那里的容器。此 Azure 容器注册表免费。- 在 Game Manager 中，选择您的游戏标题，然后选择 Multiplayer > Servers。选择 New build 打开构建创建页面。
- 选择 Linux 作为虚拟机操作系统。
- 请注意登录凭据 — 名称、密码和 customer5555555.azurecr.io，因为稍后需要此信息
创建 Linux 容器映像并推送到 Azure 容器注册表
以下步骤可帮助您创建并推送自定义 Linux 容器映像。将游戏服务器应用程序与 GSDK 集成
与使用 Windows 服务器类似，您必须将游戏服务器代码与 PlayFab Multiplayer Server SDK (GSDK) 集成。GSDK 集成可以是容器映像的一部分。 有关说明，请参阅创作游戏服务器构建和将标题与 PlayFab Game Server SDK (GSDK) 集成。创建 Dockerfile
Dockerfile 是没有扩展名的文本文件，包含构建给定容器映像所需的所有命令。- 打开 记事本 或任何合适的编辑器
- 添加运行和构建容器所需的特定命令。有关此文件的示例，请参阅 Wrapper 示例中提供的 DockerFile。有关如何创建此文件的详细信息，请参阅 Dockerfile 格式（外部链接）和创建 Dockerfile 时的最佳实践（外部链接）
- 将文件另存为 Dockerfile，最好保存在空文件夹/目录中。您应将构建容器映像所需的其他文件添加到此文件夹中。
- 选择 文件> 另存为… 打开保存选项
- 转到要保存文件的文件夹
- 在 文件名： 下，使用 “Dockerfile”，包括引号。
- 对于 保存类型：，选择 所有文件
- 选择 UTF-8 编码
- 选择 保存
构建并上传 Linux 容器映像
- 打开安装了 Docker 的 Linux 终端。
- 使用之前步骤中获取的登录凭据运行以下 Docker 命令。然后按照屏幕上的说明输入用户名和密码。
- 构建容器映像
- 然后运行 cd /mnt/c/path/to/your/Dockerfile 切换到 Dockerfile 所在的路径。 有关更多信息，请参阅访问 C 驱动器。
- 上传容器映像
检查您的容器是否已上传
上传容器后，返回 Game Manager 中的 New Build 页面并选择 Refresh Images。您可以在列表中看到该映像并进行选择。或者，您可以使用 ListContainerImages API 调用列出您上传的容器映像。 现在您可以部署服务器了。有关说明，请参阅 PlayFab 门户 — Game Manager 和使用 PowerShell/API。Windows 和 Linux 容器映像的差异
对于许多开发人员而言，使用 Windows 托管容器是首选的简单和默认选择。然而，部署在虚拟机上的 Linux 容器映像享有更便宜的小时费率。无论您使用 Windows 还是 Linux 容器映像，都可以完全自定义游戏服务器。使用 Windows 服务器时，您可以通过上传资产来自定义托管容器映像。
使用 API 管理 Linux 容器映像
您可以使用 API 来管理 Linux 容器映像。对于其余构建生命周期（查看使用情况、更新区域和 standingBy 配置、删除），请使用 Game Manager 管理。- GetContainerRegistryCredentials：检索容器注册表地址、用户名和密码
- ListContainerImages 和 ListContainerImageTags：确保您的新映像和标签已列出（有时映像可能需要几分钟才能在系统中完全注册）
- CreateBuildWithCustomContainer：使用自定义容器创建构建。指定您先前上传的带标签的映像。确保在请求上设置以下属性：
- ContainerImageReference - 之前上传的映像名称和标签。这些值在 ListContainerImages 和 ListContainerImageTags 中可见。
- ContainerFlavor - “CustomLinux”
- ContainerRunCommand（可选）- 如果您的容器没有默认命令，请使用此属性提供要运行的命令以及任何参数。
为基于 Linux 进程的服务器打包资产
在进程模式（而不是容器模式）下使用 Linux 时，您将游戏服务器作为资产存档而不是容器映像上传。本节介绍重要的打包要求。支持的存档格式
资产应作为.tar.gz 或 .tar 文件上传，以便在提取期间保留 Unix 文件权限（例如执行位）。
Tar.gz 和 tar 存档结构要求
提取.tar 或 .tar.gz 存档时，PlayFab Multiplayer Servers 会剥离存档的第一个目录级别（相当于 tar --strip-components=1）。您的存档必须包含一个顶级包装目录，其中包含所有游戏文件。
正确的结构 — 文件在顶级目录内：
设置启动命令
对于基于进程的服务器，启动命令应相对于提取后的根资产文件夹（即，相对于剥离顶级目录后文件所在的位置）。 例如，如果您的存档包含MyGameServer/MyGame.x86_64，则提取后文件位于资产文件夹的根目录。将启动命令设置为：
MyGameServer/bin/MyGame.x86_64），请将启动命令设置为：
使用 API 管理基于 Linux 进程的构建
您可以使用 API 管理基于 Linux 进程的构建。对于其余构建生命周期（查看使用情况、更新区域和 standingBy 配置、删除），请使用 Game Manager 管理。- CreateBuildWithProcessBasedServer：创建将游戏服务器作为进程运行的构建。确保在请求上设置以下属性：
- OsPlatform - “Linux”
- GameAssetReferences - 游戏资产列表（上传为
.tar.gz或.tar文件）。每个资产都需要一个与上传的资产名称匹配的 FileName。 - StartMultiplayerServerCommand - 游戏服务器启动时要运行的命令。路径应相对于提取后的根资产文件夹（例如
MyGame.x86_64 -server）。 - Ports - 要为构建映射的端口。
- MultiplayerServerCountPerVm - 要在单个虚拟机上托管的游戏服务器实例数。
- RegionConfigurations - 要部署到的区域，具有备用和最大服务器数。