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

Tutorial: Orientasi cepat dengan pembungkusnya Amazon GameLift Servers

Selamat datang di tutorial orientasi untukAmazon GameLift Servers. Dalam tutorial ini, Anda dengan cepat menyebarkan server game Anda untuk di-host pada armada sumber daya komputasi berbasis cloud. Gunakan tutorial ini untuk melewatkan pekerjaan mengintegrasikan SDK server Amazon GameLift Servers ke dalam kode game Anda, dan sebagai gantinya menyebarkan game Anda dengan fungsionalitas minimal untuk berkomunikasi dengan Amazon GameLift Servers layanan dan menjalankan sesi permainan. Anda akan menyiapkan solusi hosting dasar dan menggunakannya untuk mengalami berbagai fitur seperti penskalaan otomatis dan perjodohan. Ini juga merupakan cara yang bagus untuk meng-host prototipe game Anda sebagai bagian dari demo langsung atau untuk pengujian.

Manfaat utama dari metode orientasi ini:

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki:

Gambaran Umum

Dalam tutorial ini Anda akan:

Langkah 1: Dapatkan dan bangun pembungkus server game

Gunakan perintah berikut untuk mendapatkan sumber pembungkus server game dan membangun pembungkusnya. Perintah ini menggunakan SSH, tetapi Anda juga dapat pergi ke repositori Github secara langsung.

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 dan Linux

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

Pada build yang berhasil, direktori “out” ditambahkan keamazon-gamelift-servers-game-server-wrapper. Dalam direktori ini ada tiga folder, satu untuk setiap opsi armada hosting yang didukung, yang berisi satu set artefak build. Untuk tutorial ini, Anda menyebarkan ke EC2 armada terkelola, jadi Anda akan menggunakan folder tersebut. gamelift-servers-managed-ec2

Langkah 2: Siapkan build server game Anda

Pada langkah ini, Anda menyiapkan file build server game Anda untuk diunggah ke file. Amazon GameLift Servers

Buat direktori game

Sekarang, siapkan direktori game di mesin lokal Anda. Direktori ini harus berisi semua file yang Anda butuhkan untuk menjalankan server game AndaAmazon GameLift Servers. Ini termasuk pembungkus server game, build server game Anda, dan config.yaml yang membuat pembungkus berfungsi dengan server game Anda.

Gunakan langkah-langkah berikut:

Contoh struktur direktori akan terlihat seperti ini:

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

Langkah 3: Konfigurasikan pembungkus untuk armada Anda

Amazon GameLift Serversmengelola siklus hidup instance komputasi armada, memutar instans baru dengan build server yang diinstal dan mendaur ulang instans sesuai kebutuhan. Layanan ini mengelola siklus hidup proses server game yang berjalan pada setiap instance. EC2 Armada yang Dikelola dapat memiliki instance di beberapa lokasi untuk mendukung pemain di mana pun mereka berada.

Edit file config.yaml untuk mengonfigurasi pembungkus untuk logging, pengaturan port, dan inisialisasi server.

Contoh konfigurasi:

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
        

Langkah 4: Unggah build server game

Anda sekarang telah menyelesaikan semua elemen yang diperlukan dari pembuatan server game Anda (pembungkus server game, config.yaml, dan file server game Anda), dan Anda siap mengunggah build game Anda untuk hosting. Amazon GameLift Servers Cara tercepat untuk mengunggah build game Anda adalah dengan menggunakan AWS CLI perintah upload-build seperti yang ditunjukkan pada contoh berikut.

Mengunggah build game dengan 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
        

Saat Anda membuat build, rekam ID build dari respons API untuk digunakan untuk pembuatan armada.

Langkah 5: Buat EC2 armada yang dikelola

Langkah-langkah berikut menjelaskan konfigurasi armada minimal, sehingga Anda dapat aktif dan berjalan sesegera mungkin.

Untuk membuat armada Anda:

Langkah 6: Buat dan sambungkan ke sesi permainan

Ketika status armada Anda menunjukkan Aktif, ini berarti server game siap dan menunggu untuk menyelenggarakan sesi permainan. Untuk memulai sesi permainan, buat permintaan sesi permainan ke Amazon GameLift Servers layanan. Di sini, Anda akan menggunakan AWS CLI untuk membuat permintaan ini.

Gunakan yang berikut ini untuk membuat sesi permainan:

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

Anda juga dapat meneruskan properti game yang disesuaikan ke server yang dapat dieksekusi. Lihat Argumen Server Game di README untuk detailnya. Ketika menerima create-game-session panggilan, Amazon GameLift Servers menginformasikan pembungkus untuk meluncurkan server game yang dapat dieksekusi dan memulai sesi permainan. Apa yang ada di config.yaml mempengaruhi konfigurasi server game, dan parameter peluncuran yang diatur di konsol menentukan konfigurasi sesi game itu sendiri.

Contoh format untuk menambahkan properti game:

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

Langkah 7: Kelola dan pantau armada Anda

Sekarang armada server game Anda sudah diatur dan sesi permainan dimulai, Anda dapat mengelola dan memantaunya dari Amazon GameLift Servers konsol. Cara terbaik untuk melakukannya adalah dari halaman detail Armada tempat Anda dapat mengedit detail armada atau mengubah penskalaan dan kapasitas armada di tab Penskalaan. Lihat bagian berikut tentang penskalaan server game Anda.

Pilih tab Metrik untuk melihat grafik yang menggambarkan pemantauan untuk metrik Aktivitas dan Perangkat Keras. Untuk detail tentang grafik metrik, pilih tautan Info di sebelah ID armada Anda. Selain itu, meskipun Anda dapat memonitor server game Anda dari tab Metrik, Anda juga dapat menambahkan alarm ke metrik ini di dasbor. CloudWatch

Untuk menavigasi ke CloudWatch dasbor dari konsol:

Langkah 8: Skala server game Anda

Untuk langkah selanjutnya, Anda mengatur penskalaan otomatis. Dengan penskalaan otomatis, Anda secara dinamis menskalakan kapasitas armada Anda sebagai respons terhadap aktivitas server game. Saat pemain tiba dan memulai sesi permainan, penskalaan otomatis menambahkan lebih banyak instance, dan saat permintaan pemain menurun, penskalaan otomatis melepaskan instance yang tidak digunakan. Ini adalah cara yang efektif untuk meminimalkan sumber daya dan biaya hosting Anda sambil tetap memberikan pengalaman pemain yang lancar dan cepat.

Saat Anda mempersiapkan peluncuran game, Anda akan ingin mengatur penskalaan otomatis untuk armada Anda. Penskalaan otomatis direkomendasikan sebagai cara yang efektif untuk meminimalkan sumber daya dan biaya hosting Anda sambil tetap memberikan pengalaman pemain yang lancar dan cepat.

Untuk mengatur kapasitas armada secara manual

Untuk mengatur kapasitas armada secara manual

Untuk menggunakan penskalaan otomatis berbasis target

Untuk menggunakan penskalaan otomatis berbasis target

Penskalaan otomatis berbasis target (pelacakan target) menghubungkan penskalaan armada ke persentase sesi permainan yang tersedia. Saat pemain melonjak untuk memainkan game Anda dan sesi permainan yang tersedia berkurang, itu merespons dengan secara otomatis menambahkan lebih banyak instance ke armada.

Penskalaan otomatis berbasis aturan memberi Anda kontrol yang lebih terperinci, seperti kemampuan untuk menautkan penskalaan ke metrik armada lainnya dan menetapkan ambang batas khusus dan respons penskalaan. Ini menawarkan opsi yang kuat, tetapi juga membutuhkan penggunaan CLI dan pengujian signifikan untuk memahami bagaimana aturan khusus berperilaku dalam tindakan. Tutorial ini berfokus pada pengaturan pertama pendekatan berbasis target.

Memecahkan masalah umum

Berikut ini adalah masalah umum yang mungkin Anda temui saat menjalankan server game dan sesi game Anda. Ketika server atau sesi game tidak berjalan dengan baik, langkah pertama adalah memeriksa log yang mungkin mengungkapkan salah satu masalah yang dijelaskan di bawah ini untuk penerapan atau game baru dalam produksi.

Berikut ini sering terungkap dalam log:

Untuk melihat log peristiwa untuk Amazon GameLift Servers armada Anda

Untuk melihat log peristiwa untuk Amazon GameLift Servers armada Anda

Untuk melihat log sesi permainan

Untuk melihat log sesi permainan

Untuk melihat log sesi game dengan CLI gunakan API. GetGameSessionLogURL Amazon GameLift Serverssecara otomatis menyimpan log selama 14 hari.

Anda juga dapat mengonfigurasi CloudWatch log Amazon untuk armada Anda. Ini memberikan kemampuan logging tambahan dan integrasi dengan layanan AWS pemantauan lainnya.

Untuk akses log waktu nyata atau periode retensi yang diperpanjang melalui CloudWatch:

Langkah selanjutnya