本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

教學課程：使用Amazon GameLift Servers包裝函式快速入門

歡迎使用 的入門教學課程Amazon GameLift Servers。在本教學課程中，您會快速部署遊戲伺服器，以託管在雲端型運算資源的機群上。使用此教學課程略過將適用於 的伺服器開發套件整合Amazon GameLift Servers到您的遊戲程式碼的工作，並改為使用最少的功能部署您的遊戲，以與服務通訊Amazon GameLift Servers並執行遊戲工作階段。您將設定基本託管解決方案，並使用它來體驗各種功能，例如自動擴展和配對。這也是在即時示範或測試中託管遊戲原型的絕佳方式。

此加入方法的主要優點：

先決條件

開始之前，請確定您已：

概觀

在本教學課程中，您將：

步驟 1：取得並建置遊戲伺服器包裝函式

使用以下命令來取得遊戲伺服器包裝函式來源並建置包裝函式。這些命令使用 SSH，但您也可以直接前往 Github 儲存庫。

Windows

> git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
> cd amazon-gamelift-servers-game-server-wrapper
> powershell -file .\build.ps1
            

Mac 和 Linux

$ git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
$ cd amazon-gamelift-servers-game-server-wrapper
$ make
            

在成功的建置上，「輸出」目錄會新增至 amazon-gamelift-servers-game-server-wrapper。在此目錄中有三個資料夾，每個支援的託管機群選項各一個，其中包含一組建置成品。在本教學課程中，您將部署至受管 EC2 機群，因此您將使用 資料夾 gamelift-servers-managed-ec2。

步驟 2：準備您的遊戲伺服器建置

在此步驟中，您會準備遊戲伺服器建置檔案以上傳至 Amazon GameLift Servers。

建立遊戲目錄

現在，在本機電腦上準備遊戲目錄。此目錄必須包含使用 執行遊戲伺服器所需的所有檔案Amazon GameLift Servers。這包括遊戲伺服器包裝函式、遊戲伺服器建置，以及讓包裝函式與遊戲伺服器搭配使用的 config.yaml。

使用下列步驟：

範例目錄結構如下所示：

gamelift-servers-managed-ec2
│-- config.yaml
│-- amazon-gamelift-servers-game-server-wrapper
│-- MyGame
│   │-- server-executable.exe
│   │-- my-game-settings
│   │ ......
            

步驟 3：設定機群的包裝函式

Amazon GameLift Servers 會管理機群運算執行個體的生命週期，在已安裝伺服器建置的情況下啟動新執行個體，並視需要回收執行個體。服務會管理在每個執行個體上執行的遊戲伺服器程序生命週期。Managed EC2 機群可以在多個位置擁有執行個體，無論玩家身在何處都能提供支援。

編輯 config.yaml 檔案以設定記錄、連接埠設定和伺服器初始化的包裝函式。

範例組態：

log-config:
  wrapper-log-level: debug
game-server-logs-dir: ./game-server-logs
ports:
  gamePort: 37016
game-server-details:
  executable-file-path: ./MyGame/my-server-executable
game-server-args:
  - arg: "--port"
    val: "{{.gameport}}"
    pos: 0
        

步驟 4：上傳遊戲伺服器組建

您現在已完成遊戲伺服器組建的所有必要元素 （遊戲伺服器包裝函式、config.yaml 和遊戲伺服器檔案），並準備好將遊戲組建上傳至 Amazon GameLift Servers 進行託管。上傳遊戲組建的最快方法是使用 AWS CLI 命令upload-build，如下列範例所示。

使用 Windows 上傳遊戲組建：

aws gamelift upload-build \
    --name gamelift-test-2025-03-11-1 \
    --build-version gamelift-test-2025-03-11-1 \
    --build-root out/windows/amd64/gamelift-servers-managed-ec2 \
    --operating-system WINDOWS_2016 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

當您建立組建時，請從 API 回應記錄組建 ID，以將其用於建立機群。

步驟 5：建立受管 EC2 機群

下列步驟說明最小機群組態，因此您可以盡快啟動並執行。

若要建立機群：

步驟 6：建立並連線至遊戲工作階段

當您的機群狀態顯示作用中時，這表示遊戲伺服器已準備好並等待託管遊戲工作階段。若要啟動遊戲工作階段，請向 Amazon GameLift Servers服務提出遊戲工作階段請求。在這裡，您將使用 AWS CLI 提出此請求。

使用下列項目來建立遊戲工作階段：

aws gamelift create-game-session \
--fleet-id <FLEET_ID> \
--game-properties '[{"Key": "exampleProperty", "Value": "exampleValue"}]' \
--maximum-player-session-count 3 \
--region us-west-2
        

您也可以將自訂遊戲屬性傳遞至伺服器可執行檔。如需詳細資訊，請參閱 README 中的遊戲伺服器引數。當它收到 create-game-session 呼叫時， 會Amazon GameLift Servers通知包裝函式啟動遊戲伺服器可執行檔並啟動遊戲工作階段。中的內容config.yaml會影響遊戲伺服器的組態，而主控台中設定的啟動參數會決定遊戲工作階段本身的組態。

新增遊戲屬性的範例格式：

defaultArgs:
        - arg: "--port"
          val: "{{.GamePort}}"
          pos: 0
        - arg: "--ipAddress"
          val: "{{.IpAddress}}"
          pos: 1
        - arg: "--gameSessionId"
          val: "{{.GameSessionId}}"
          pos: 2
        

步驟 7：管理和監控您的機群

現在已設定遊戲伺服器機群並啟動遊戲工作階段，您可以從Amazon GameLift Servers主控台管理和監控它。完成此操作的最佳方法是從機群詳細資訊頁面，您可以在擴展索引標籤上編輯機群詳細資訊或變更機群擴展和容量。請參閱下列有關擴展遊戲伺服器的章節。

選擇指標索引標籤，以檢視描述活動和硬體指標監控的圖表。如需指標圖表的詳細資訊，請選擇機群 ID 旁的資訊連結。此外，雖然您可以從指標索引標籤密切監控遊戲伺服器，您也可以在 CloudWatch 儀表板中將警示新增至這些指標。

若要從主控台導覽至 CloudWatch 儀表板：

步驟 8：擴展您的遊戲伺服器

對於下一個步驟，您可以設定自動擴展。透過自動擴展，您可以動態擴展機群容量以回應遊戲伺服器活動。隨著玩家抵達和開始遊戲工作階段，自動擴展會新增更多執行個體，隨著玩家需求減少，自動擴展會釋出未使用的執行個體。這是將託管資源和成本降至最低的有效方法，同時仍提供流暢、快速的玩家體驗。

準備啟動遊戲時，您會想要為機群設定自動擴展。建議您使用自動擴展作為有效方式，將託管資源和成本降至最低，同時仍提供順暢、快速的玩家體驗。

手動設定機群容量

手動設定機群容量

使用目標型自動擴展

使用目標型自動擴展

目標型自動擴展 （目標追蹤） 會將機群擴展連結至可用遊戲工作階段的百分比。隨著玩家玩遊戲的激增和可用的遊戲工作階段減少，它會透過自動新增更多執行個體到機群來回應。

規則型自動擴展可讓您更精細地控制，例如將擴展連結至其他機群指標，以及設定自訂閾值和擴展回應的能力。它提供強大的選項，但還需要使用 CLI 和重大測試來了解自訂規則的運作方式。本教學課程著重於先設定目標型方法。

對常見問題進行故障診斷

以下是您在讓遊戲伺服器和遊戲工作階段執行時可能遇到的常見問題。當伺服器或遊戲工作階段未正確執行時，第一步是檢查日誌，這可能會顯示生產中新部署或遊戲的下列其中一個問題。

日誌中通常會顯示以下內容：

檢視機Amazon GameLift Servers群的事件日誌

檢視機Amazon GameLift Servers群的事件日誌

檢視遊戲工作階段日誌

檢視遊戲工作階段日誌

若要使用 CLI 檢視遊戲工作階段日誌，請使用 GetGameSessionLogURL API。 Amazon GameLift Servers會自動儲存日誌 14 天。

您也可以為機群設定 Amazon CloudWatch logs。這提供額外的記錄功能，以及與其他 AWS 監控服務的整合。

對於透過 CloudWatch 的即時日誌存取或延長保留期間：

後續步驟