

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Buat sumber daya Amazon GameLift Servers build untuk hosting terkelola
<a name="gamelift-build-cli-uploading-builds"></a>

Saat membuat bangunan dan mengunggah file Anda, Anda memiliki beberapa pilihan:
+ [Membuat bangunan dari direktori file](gamelift-build-cli-uploading-upload-build.md). Ini adalah opsi paling sederhana dan paling umum digunakan.
+ [Buat build dengan file di Amazon Simple Storage Service (Amazon S3](gamelift-build-cli-uploading-create-build.md)). Dengan opsi ini, Anda dapat mengelola versi build di Amazon S3.

Dengan kedua metode tersebut, Amazon GameLift Servers buat sumber daya build baru dengan ID build unik dan metadata lainnya. Build dimulai dalam status **Inisialisasi**. Setelah Amazon GameLift Servers memperoleh file server game, build pindah ke status **Ready**. 

Saat build sudah siap, Anda dapat menyebarkannya ke Amazon GameLift Servers armada baru. Untuk informasi selengkapnya, lihat [Buat EC2 armada Amazon GameLift Servers terkelola](fleets-creating.md) .Saat Amazon GameLift Servers menyiapkan armada baru, ia mengunduh file build ke setiap instance armada dan menginstal file build.

# Membuat bangunan dari direktori file
<a name="gamelift-build-cli-uploading-upload-build"></a>

Untuk membuat build game yang disimpan di lokasi mana pun, termasuk direktori lokal, gunakan [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 perintah. Perintah ini membuat catatan build baru Amazon GameLift Servers dan mengunggah file dari lokasi yang Anda tentukan.

**Kirim permintaan unggahan.** Di jendela baris perintah, masukkan **upload-build** perintah dan parameter berikut.

```
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**— Lingkungan runtime build server game. Anda harus menentukan nilai OS. Anda tidak dapat memperbarui ini nanti.
+ **server-sdk-version**— Versi SDK Amazon GameLift Servers server yang terintegrasi dengan server game Anda. Jika Anda tidak memberikan nilai, Amazon GameLift Servers gunakan nilai default`4.0.2`. Jika Anda menentukan versi SDK server yang salah, build server game mungkin gagal saat memanggil `InitSdk` untuk membuat sambungan ke Amazon GameLift Servers layanan.
+ **build-root**— Jalur direktori file build Anda.
+ **name**— Nama deskriptif untuk bangunan baru.
+ **build-version**— Detail versi untuk file build.
+ **region**— AWS Wilayah tempat Anda ingin membuat bangunan Anda. Buat build di Wilayah tempat Anda berencana untuk menyebarkan armada. Jika Anda menerapkan game di beberapa Wilayah, buat build di setiap Wilayah.
**catatan**  
Lihat Wilayah default Anda saat ini menggunakan [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). Untuk mengubah Region default Anda, gunakan [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html)perintah.

*Contoh*

```
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
```

Menanggapi permintaan unggahan Anda, Amazon GameLift Servers berikan kemajuan unggahan. Pada unggahan yang berhasil, Amazon GameLift Servers mengembalikan ID catatan build baru. Waktu pengunggahan bergantung pada ukuran file game dan kecepatan koneksi Anda.

# Membuat bangunan dengan file di Amazon S3
<a name="gamelift-build-cli-uploading-create-build"></a>

Anda dapat menyimpan file build Anda di Amazon S3 dan mengunggahnya Amazon GameLift Servers dari sana. Saat membuat build, Anda menentukan lokasi bucket S3, dan Amazon GameLift Servers mengambil file build langsung dari Amazon S3.

**Untuk membuat sumber daya build**

1. **Simpan file build Anda di Amazon S3.** Buat file.zip yang berisi file build yang dikemas dan unggah ke bucket S3 di file Anda. Akun AWS Perhatikan label bucket dan nama file, Anda akan memerlukannya saat membuat Amazon GameLift Servers build.

1. **Berikan Amazon GameLift Servers akses ke file build Anda.** Buat peran IAM dengan mengikuti instruksi di[Mengakses file build game di Amazon S3](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc). Setelah membuat peran, perhatikan Amazon Resource Name (ARN) peran baru, Anda akan memerlukannya saat membuat build.

1. **Buat build.** Gunakan Amazon GameLift Servers konsol atau AWS CLI untuk membuat catatan build baru. Anda harus memiliki `PassRole` izin, seperti yang dijelaskan dalam[Contoh izin IAM untuk Amazon GameLift Servers](gamelift-iam-policy-examples.md).

------
#### [ Console ]

1. Di [Amazon GameLift Serverskonsol](https://console.aws.amazon.com/gamelift/), di panel navigasi, pilih **Hosting**, **Builds**.

1. Pada halaman **Builds**, pilih **Buat build**.

1. Pada halaman **Buat build**, di bawah **pengaturan Build**, lakukan hal berikut:

   1. Untuk **Nama**, masukkan nama skrip.

   1. Untuk **Versi**, masukkan versi. Karena Anda dapat memperbarui konten build, data versi dapat membantu Anda melacak pembaruan.

   1. Untuk **Sistem operasi (OS)**, pilih OS build server game Anda. Anda tidak dapat memperbarui nilai ini nanti.

   1. **Untuk **build server Game**, masukkan **URI S3** dari objek build yang Anda upload ke Amazon S3, dan pilih versi Object.** Jika Anda tidak ingat URI Amazon S3 dan versi objek, pilih **Browse S3** dan cari objek build.

   1. Untuk **peran IAM**, pilih peran yang Anda buat yang memberikan Amazon GameLift Servers akses ke bucket S3 dan objek build.

1. (Opsional) Di bawah **Tag**, tambahkan tag ke build dengan memasukkan pasangan **Kunci** dan **Nilai**.

1. Pilih **Buat**.

Amazon GameLift Serversmenetapkan ID ke build baru dan mengunggah file.zip yang ditunjuk. Anda dapat melihat build baru, termasuk statusnya, di halaman **Builds**.

------
#### [ AWS CLI ]

Untuk menentukan build baru dan mengunggah file build server Anda, gunakan [https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html)perintah.

1. Buka jendela baris perintah dan beralih ke direktori tempat Anda dapat menggunakan file AWS CLI.

1. Masukkan **create-build** perintah berikut:

   ```
   aws gamelift create-build \
       --name user-defined name of build \
       --server-sdk-version server SDK for Amazon GameLift Servers version \
       --operating-system supported OS \
       --build-version user-defined build number \
       --storage-location "Bucket"=S3 bucket label,"Key"=Build .zip file name,"RoleArn"=Access role ARN} \
       --region region name
   ```
   + **name**— Nama deskriptif untuk bangunan baru.
   + **server-sdk-version**— Versi SDK server untuk Amazon GameLift Servers Anda gunakan untuk mengintegrasikan server game Anda. Amazon GameLift Servers Jika Anda tidak memberikan nilai, Amazon GameLift Servers gunakan nilai default`4.0.2`.
   + **operating-system**— Lingkungan runtime build server game. Anda harus menentukan nilai OS. Anda tidak dapat memperbarui ini nanti.
   + **build-version**— Detail versi untuk file build. Informasi ini dapat berguna karena setiap versi baru server game Anda memerlukan sumber daya build baru.
   + **storage-location**
     + **Bucket**— Nama bucket S3 yang berisi build Anda. Misalnya, “my\$1build\$1files”.
     + **Key**— Nama file.zip yang berisi file build Anda. Misalnya, “my\$1game\$1build\$17.0.1, 7.0.2".
     + **RoleARN**— ARN ditugaskan ke peran IAM yang Anda buat. Misalnya, “arn:aws:iam: :111122223333:role/”. GameLiftAccess Untuk contoh kebijakan, lihat [Mengakses file build game di Amazon S3](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc).
   + **region**— Buat build di AWS Wilayah tempat Anda berencana untuk menyebarkan armada. Jika Anda menerapkan game di beberapa Wilayah, buat build di setiap Wilayah.
**catatan**  
Sebaiknya periksa Wilayah default Anda saat ini menggunakan [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html)perintah [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html). Untuk mengubah Region default Anda, gunakan [https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html)perintah.

   *Contoh*

   ```
   aws gamelift create-build \
       --operating-system WINDOWS_2022 \
       --storage-location "Bucket"="my_game_build_files","Key"="mygame_build_101.zip","RoleArn"="arn:aws:iam::111122223333:role/gamelift" \
       --name "My Game Nightly Build" \
       --build-version "build 101" \
       --region us-west-2
   ```

1. Untuk melihat build baru, gunakan [https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html)perintah.

------