Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat definisi grup kontainer untuk armada Amazon GameLift Servers kontainer
Definisi grup kontainer menjelaskan cara menerapkan aplikasi server game kontainer Anda ke armada kontainer. Ini adalah cetak biru yang memberi tahu gambar kontainer Amazon GameLift Servers apa yang akan diterapkan ke armada dan cara menjalankannya. Saat membuat armada kontainer, Anda menentukan definisi grup kontainer yang akan diterapkan ke armada. Untuk informasi selengkapnya tentang grup kontainer, lihat[Komponen armada kontainer](containers-howitworks.md#containers-howitworks-components).
## Sebelum Anda mulai
Kiat tentang apa yang harus dilakukan sebelum Anda mulai membuat definisi grup kontainer:
+ Selesaikan gambar kontainer Anda dan dorong ke repositori Amazon Elastic Container Registry (Amazon ECR) di tempat yang sama di Wilayah AWS mana Anda berencana untuk membuat grup kontainer. Amazon GameLift Serversmenangkap snapshot dari setiap gambar pada saat Anda membuat definisi grup kontainer, dan menggunakan snapshot saat menerapkan ke armada kontainer. Lihat [Membangun gambar kontainer untuk Amazon GameLift Servers](containers-prepare-images.md).
+ Buat definisi kontainer Anda sebagai file JSON. Definisi grup kontainer mencakup satu atau lebih definisi kontainer. Anda dapat menggunakan file JSON jika Anda membuat definisi grup kontainer menggunakan file. AWS CLIfor Amazon GameLift Servers
+ Verifikasi bahwa AWS pengguna Anda memiliki izin IAM untuk mengakses repositori Amazon ECR. Lihat [Contoh izin IAM untuk Amazon GameLift Servers](gamelift-iam-policy-examples.md).
## Buat definisi grup kontainer server game
Grup kontainer server game menjalankan perangkat lunak server game Anda. Grup kontainer server game memiliki satu wadah server game, yang menjalankan server game yang dapat dieksekusi. Ini juga dapat memiliki satu atau lebih wadah dukungan untuk menjalankan perangkat lunak tambahan untuk mendukung server game Anda. (Ini kadang-kadang disebut sebagai wadah “sespan”.)
Topik ini menjelaskan cara membuat definisi grup kontainer server game sederhana menggunakan Amazon GameLift Servers konsol atau alat AWS CLI. Untuk informasi lebih rinci tentang fitur opsional, lihat[Sesuaikan armada Amazon GameLift Servers kontainer](containers-design-fleet.md).
**catatan**
Anda dapat mengubah sebagian besar definisi grup kontainer dan pengaturan definisi kontainer setelah membuatnya. Jika Anda membuat perubahan pada definisi kontainer, Amazon GameLift Servers ambil snapshot baru dari gambar kontainer yang diperbarui.
**Untuk membuat definisi grup kontainer server game sederhana:**
Petunjuk berikut menjelaskan cara membuat definisi grup kontainer dengan parameter minimal yang diperlukan dan menggunakan nilai Amazon GameLift Servers default.
------
#### [ Console ]
Di [Amazon GameLift Serverskonsol](https://console.aws.amazon.com/gamelift/), pilih Wilayah AWS tempat Anda ingin membuat grup kontainer.
Buka bilah navigasi kiri konsol dan pilih **Kontainer terkelola: Definisi grup**. Pada halaman definisi grup kontainer, pilih **Buat definisi grup**.
**Langkah 1: Tentukan detail definisi grup kontainer**
1. Masukkan nama definisi grup kontainer. Nama harus unik untuk Akun AWS dan Wilayah.
1. Pilih jenis grup kontainer **server Game**.
1. Untuk **batas memori Total**, masukkan sumber daya memori maksimum agar tersedia untuk semua kontainer dalam grup kontainer. Untuk bantuan menghitung nilai ini, lihat[Tetapkan batas sumber daya](containers-design-fleet.md#containers-design-fleet-limits).
1. Untuk **batas total vCPU**, masukkan daya komputasi maksimum untuk menyediakan semua kontainer dalam grup kontainer. Untuk bantuan menghitung nilai ini, lihat[Tetapkan batas sumber daya](containers-design-fleet.md#containers-design-fleet-limits).
**Langkah 2: Tambahkan definisi wadah**
Minimal, grup kontainer server game memiliki satu wadah server game. Di konsol, definisi kontainer pertama yang Anda buat adalah wadah server game. Langkah ini menjelaskan cara menentukan pengaturan minimum yang diperlukan untuk definisi kontainer server game.
1. Masukkan **nama** definisi kontainer. Setiap kontainer yang ditentukan untuk grup harus memiliki nilai nama yang unik.
1. Tautkan ke gambar kontainer dengan build server game Anda. Masukkan **URI gambar Amazon ECR untuk gambar** kontainer di repositori publik atau pribadi. Anda dapat menggunakan salah satu format berikut:
+ Hanya URI gambar: `[Akun AWS].dkr.ecr.[Wilayah AWS].amazonaws.com/[repository ID]`
+ Gambar URI \$1 intisari: `[Akun AWS].dkr.ecr.[Wilayah AWS].amazonaws.com/[repository ID]@[digest]`
+ Gambar URI \$1 tag: `[Akun AWS].dkr.ecr.[Wilayah AWS].amazonaws.com/[repository ID]:[tag]`
1. Tentukan **versi Amazon GameLift Servers Server SDK** yang digunakan oleh build server game. Untuk armada kontainer, nilai ini harus 5.2.0 atau lebih besar.
1. Dalam **rentang port kontainer internal**, atur protokol dan tentukan rentang port. Ukuran rentang harus lebih besar dari jumlah proses server game bersamaan yang akan berjalan di wadah ini. Jika kontainer server game hanya menjalankan satu proses server per kontainer, rentang port ini hanya membutuhkan beberapa port. Untuk detail selengkapnya, lihat [Konfigurasikan koneksi jaringan](containers-design-fleet.md#containers-custom-network).
1. Tambahkan lebih banyak kontainer sesuai kebutuhan untuk menjalankan perangkat lunak pendukung tambahan. Wadah tambahan secara otomatis ditunjuk sebagai wadah pendukung. Grup kontainer server game hanya dapat memiliki satu wadah server game dan hingga delapan kontainer pendukung. Berikan pengaturan minimal yang diperlukan berikut:
+ **Nama** definisi kontainer
+ **URI gambar ECR**.
+ **Port kontainer internal** (Sertakan ini hanya jika kontainer memiliki proses yang membutuhkan akses jaringan.)
**Langkah 3: Konfigurasikan dependensi**
+ Jika definisi grup kontainer Anda memiliki lebih dari satu kontainer, Anda dapat mengatur dependensi antar kontainer secara opsional. Untuk informasi selengkapnya, lihat [Tetapkan dependensi kontainer](containers-design-fleet.md#containers-design-fleet-dependencies).
**Langkah 3: Tinjau dan buat**
1. Tinjau semua pengaturan definisi grup kontainer Anda. Gunakan **Edit** untuk membuat perubahan pada bagian mana pun, termasuk setiap definisi kontainer Anda untuk grup.
1. Setelah selesai meninjau, pilih **Buat**.
Jika permintaan Anda berhasil, konsol akan menampilkan halaman detail untuk sumber definisi grup kontainer baru. Awalnya statusnya adalah`COPYING`, karena Amazon GameLift Servers mulai mengambil snapshot dari semua gambar kontainer untuk grup. Ketika fase ini selesai, status definisi grup kontainer berubah menjadi`READY`. Definisi grup kontainer harus dalam `READY` status sebelum Anda dapat membuat armada kontainer dengannya.
------
#### [ AWS CLI ]
Saat Anda menggunakan AWS CLI untuk membuat definisi grup kontainer, pertahankan konfigurasi definisi kontainer Anda dalam file terpisah. `JSON` Anda dapat mereferensikan file dalam perintah CLI Anda. Lihat [Buat `JSON` file definisi kontainer](#containers-definitions-create) contoh skema.
**Buat definisi grup kontainer**
Untuk membuat definisi grup kontainer baru, gunakan perintah `create-container-group-definition` CLI. Untuk informasi selengkapnya tentang perintah ini, lihat [create-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-container-group-definition.html)di Referensi *Perintah AWS CLI*.
Contoh ini menggambarkan permintaan untuk definisi grup kontainer server game. Ini mengasumsikan bahwa Anda telah membuat file JSON dengan definisi wadah untuk grup ini.
```
aws gamelift create-container-group-definition \
--name MyAdventureGameContainerGroup \
--operating-system AMAZON_LINUX_2023 \
--container-group-type GAME_SERVER \
--total-memory-limit-mebibytes 4096 \
--total-vcpu-limit 1 \
--game-server-container-definition file://MyAdventureGameContainers.json
```
------
## Buat `JSON` file definisi kontainer
Saat Anda membuat definisi grup kontainer, Anda juga menentukan kontainer untuk grup. Definisi kontainer menentukan repositori Amazon ECR tempat image kontainer disimpan, dan konfigurasi opsional untuk port jaringan, batas penggunaan CPU dan memori, dan pengaturan lainnya. Sebaiknya buat satu `JSON` file dengan konfigurasi untuk semua kontainer dalam grup kontainer. Memelihara file berguna untuk menyimpan, berbagi, versi melacak konfigurasi penting ini. Jika Anda menggunakan AWS CLI untuk membuat definisi grup kontainer Anda, Anda dapat mereferensikan file dalam perintah.
**Untuk membuat definisi kontainer**
1. Buat dan buka `.JSON` file baru. Contoh:
```
[~/work/glc]$ vim SimpleServer.json
```
1. Buat definisi kontainer terpisah untuk masing-masing kontainer untuk grup. Salin konten contoh berikut dan modifikasi sesuai kebutuhan untuk wadah Anda. Untuk detail tentang sintaks definisi container, lihat [ContainerDefinitionInput](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ContainerDefinitionInput.html)di *Referensi Amazon GameLift Servers API*.
1. Simpan file secara lokal sehingga Anda dapat merujuknya dalam perintah AWS CLI.
### Contoh: Definisi wadah server game
**Example**
Contoh ini menjelaskan wadah penting untuk grup kontainer server game Anda. Wadah replika penting mencakup aplikasi server game Anda, Amazon GameLift Servers Agen, dan dapat menyertakan perangkat lunak pendukung lainnya untuk hosting game Anda. Definisi harus menyertakan nama, URI gambar, dan konfigurasi port. Contoh ini juga menetapkan beberapa batas sumber daya khusus kontainer.
```
{
"ContainerName": "MyAdventureGameServer",
"ImageUri": "111122223333.dkr.ecr.us-east-1.amazonaws.com/gl-containers:myadventuregame-server",
"PortConfiguration": {
"ContainerPortRanges": [
{
"FromPort": 2000,
"Protocol": "TCP",
"ToPort": 2010
}
]
},
"ServerSdkVersion": "5.2.0"
}
```