

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

# 從檔案目錄建立組建
<a name="gamelift-build-cli-uploading-upload-build"></a>

若要建立存放在任何位置的遊戲組建，包括本機目錄，請使用 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html) AWS CLI 命令。此命令會在 Amazon GameLift Servers 中建立新的建置記錄，並從您指定的位置上傳檔案。

**傳送上傳請求。**在命令列視窗中，輸入下列**upload-build**命令和參數。

```
aws gamelift upload-build \
    --name user-defined name of build \
    --operating-system supported OS \
    --server-sdk-version server SDK for Amazon GameLift Servers version \
    --build-root build path \
    --build-version user-defined build number \
    --region region name
```
+ **operating-system** – 遊戲伺服器的建置執行期環境。您必須指定作業系統值。您稍後無法更新此項目。
+ **server-sdk-version** – 遊戲Amazon GameLift Servers伺服器與之整合的伺服器 SDK 版本。如果您不提供值， Amazon GameLift Servers會使用預設值 `4.0.2`。如果您指定不正確的伺服器 SDK 版本，則呼叫 `InitSdk` 以建立Amazon GameLift Servers與服務的連線時，遊戲伺服器建置可能會失敗。
+ **build-root** – 建置檔案的目錄路徑。
+ **name** – 新建置的描述性名稱。
+ **build-version** – 組建檔案的版本詳細資訊。
+ **region** – 您要建立建置的 AWS 區域。在您計劃部署機群的區域中建立建置。如果您要在多個區域中部署遊戲，請在每個區域中建立組建。
**注意**  
使用 檢視您目前的預設區域[https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html)。若要變更您的預設區域，請使用 [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html)命令。

*範例*

```
aws gamelift upload-build \
    --operating-system AMAZON_LINUX_2023 \
    --server-sdk-version "5.0.0" \
    --build-root "~/mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2
```

```
aws gamelift upload-build \
    --operating-system WINDOWS_2022 \
    --server-sdk-version "5.0.0" \
    --build-root "C:\mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2
```

為了回應您的上傳請求， Amazon GameLift Servers提供上傳進度。成功上傳時， 會Amazon GameLift Servers傳回新的建置記錄 ID。上傳時間取決於遊戲檔案的大小和連線速度。