View a markdown version of this page

Membuat definisi grup kontainer untuk GameLift Server Amazon armada kontainer - GameLift Server Amazon
Sebelum Anda mulaiBuat definisi grup kontainer server gameBuat file JSON definisi kontainer

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

Membuat definisi grup kontainer untuk GameLift Server Amazon armada kontainer

Definisi grup kontainer menjelaskan cara melakukan deployment aplikasi server game yang dimasukkan ke dalam kontainer ke armada kontainer. Ini adalah cetak biru yang memberi tahu gambar kontainer Amazon GameLift Servers apa yang akan digunakan ke armada dan bagaimana menjalankannya. Saat Anda membuat armada kontainer, Anda menentukan definisi grup kontainer untuk diterapkan ke armada. Untuk informasi selengkapnya tentang grup kontainer, lihatKomponen armada kontainer.

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 Wilayah AWS di 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 Buat gambar kontainer untuk GameLift Server Amazon.

  • 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 AWS CLI untukAmazon GameLift Servers.

  • Verifikasi bahwa AWS pengguna Anda memiliki izin IAM untuk mengakses repositori Amazon ECR. Lihat Contoh izin IAM untuk Amazon GameLift Servers.

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 “sidecar”.)

Topik ini menjelaskan cara membuat definisi grup wadah server game sederhana menggunakan Amazon GameLift Servers konsol atau alat AWS CLI. Untuk informasi lebih rinci tentang fitur opsional, lihatSesuaikan sebuah GameLift Server Amazon armada kontainer.

catatan

Anda dapat mengubah sebagian besar definisi grup kontainer dan pengaturan definisi wadah setelah membuatnya. Jika Anda membuat perubahan pada definisi wadah, Amazon GameLift Servers ambil snapshot baru dari gambar kontainer yang diperbarui.

Untuk membuat definisi grup wadah 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 Servers konsol, pilih Wilayah AWS tempat Anda ingin membuat grup kontainer.

Buka bilah navigasi kiri konsol dan pilih Container 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.

  2. Pilih jenis grup wadah server permainan.

  3. Untuk Batas memori total, masukkan sumber daya memori maksimum yang akan tersedia untuk semua wadah dalam grup kontainer. Untuk bantuan menghitung nilai ini, lihatTetapkan batas sumber daya.

  4. Untuk batas total vCPU, masukkan daya komputasi maksimum yang akan tersedia untuk semua kontainer dalam grup kontainer. Untuk bantuan menghitung nilai ini, lihatTetapkan batas sumber daya.

Langkah 2: Tambahkan definisi wadah

Minimal, grup kontainer server game memiliki satu wadah server game. Di konsol, definisi wadah pertama yang Anda buat adalah wadah server game. Langkah ini menjelaskan cara menentukan pengaturan minimum yang diperlukan untuk definisi wadah server game.

  1. Masukkan nama definisi wadah. Setiap wadah yang ditentukan untuk grup harus memiliki nilai nama yang unik.

  2. 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]

    • URI-gambar+ringkasan: [Akun AWS].dkr.ecr.[Wilayah AWS].amazonaws.com/[repository ID]@[digest]

    • URI gambar+tag: [Akun AWS].dkr.ecr.[Wilayah AWS].amazonaws.com/[repository ID]:[tag]

  3. Tentukan versi Amazon GameLift Servers Server SDK yang digunakan build server game. Untuk armada kontainer, nilai ini harus 5.2.0 atau lebih besar.

  4. 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 wadah server game hanya menjalankan satu proses server per kontainer, rentang port ini hanya membutuhkan beberapa port. Untuk detail selengkapnya, lihat Konfigurasikan koneksi jaringan.

  5. Tambahkan lebih banyak wadah sesuai kebutuhan untuk menjalankan perangkat lunak dukungan tambahan. Kontainer tambahan secara otomatis ditunjuk sebagai wadah pendukung. Grup kontainer server game hanya dapat memiliki satu wadah server game dan hingga delapan kontainer dukungan. Berikan pengaturan minimal yang diperlukan berikut:

    • Nama definisi kontainer

    • URI gambar ECR.

    • Port kontainer internal (Sertakan ini hanya jika wadah memiliki proses yang membutuhkan akses jaringan.)

Langkah 3: Konfigurasikan dependensi

  • Jika definisi grup kontainer Anda memiliki lebih dari satu wadah, Anda dapat secara opsional mengatur dependensi antara kontainer. Untuk informasi selengkapnya, lihat Tetapkan dependensi kontainer.

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 wadah untuk grup.

  2. Setelah selesai meninjau, pilih Buat.

    Jika permintaan Anda berhasil, konsol akan menampilkan halaman detail untuk sumber daya definisi grup kontainer baru. Awalnya stat COPYING usnya adalah, seperti Amazon GameLift Servers mulai mengambil snapshot dari semua gambar wadah untuk grup. Ketika fase ini selesai, status definisi grup kontainer berubah menjadiREADY. 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 JSON file terpisah. Anda dapat mereferensikan file dalam perintah CLI Anda. Lihat Buat file JSON definisi kontainer untuk 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 di Referensi Perintah CLI. AWS

Contoh ini menggambarkan permintaan untuk definisi grup kontainer server game. Ini mengasumsikan bahwa Anda telah membuat file JSON dengan definisi container 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 file JSON definisi kontainer

Saat Anda membuat definisi grup kontainer, Anda juga menentukan wadah untuk grup. Definisi wadah menentukan repositori Amazon ECR tempat gambar 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 wadah dalam grup kontainer. Memelihara file berguna untuk menyimpan, berbagi, dan melacak versi konfigurasi penting ini. Jika Anda menggunakan AWS CLI untuk membuat definisi grup kontainer Anda, Anda dapat mereferensikan file dalam perintah.

Untuk membuat definisi wadah

  1. Buat dan buka .JSON file baru. Contoh:

    [~/work/glc]$ vim SimpleServer.json

  2. Buat definisi wadah terpisah untuk setiap wadah untuk grup. Salin konten contoh berikut dan ubah sesuai kebutuhan untuk wadah Anda. Untuk detail tentang sintaks definisi kontainer, lihat ContainerDefinitionInput di Refer Amazon GameLift Servers ensi API.

  3. Simpan file secara lokal sehingga Anda dapat merujuknya dalam perintah AWS CLI.

contoh

Contoh ini menjelaskan wadah penting untuk grup kontainer server game Anda. Wadah replika penting termasuk 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"
  }