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

Tutorial: Onboarding cepat dengan GameLift Server Amazon pembungkus

Selamat datang di tutorial onboarding 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 game. Anda akan menyiapkan solusi hosting dasar dan menggunakannya untuk mengalami berbagai fitur seperti penskalaan otomatis dan perjodohan. Ini juga cara yang bagus untuk meng-host prototipe game Anda sebagai bagian dari demo langsung atau untuk pengujian.

Manfaat utama dari metode onboarding ini:

Prasyarat

Sebelum memulai, 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 pembungkus. Perintah ini menggunakan SSH, tetapi Anda juga dapat pergi ke GitHub repositori 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. Di direktori ini ada tiga folder, satu untuk setiap opsi armada hosting yang didukung, yang berisi satu set artefak build. Untuk tutorial ini, Anda menerapkan ke armada EC2 yang dikelola, jadi Anda akan menggunakan folder. gamelift-servers-managed-ec2

Langkah 2: Siapkan build server game Anda

Pada langkah ini, Anda menyiapkan file build server game Anda untuk diunggah keAmazon 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 instans komputasi armada, memutar instans baru dengan build server Anda diinstal, dan mendaur ulang instans sesuai kebutuhan. Layanan ini mengelola siklus proses server game yang berjalan pada setiap instance. Armada EC2 Terkelola dapat memiliki instans 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 build server game Anda (pembungkus server game, config.yaml, dan file server game Anda), dan Anda siap untuk 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_2022 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

Saat Anda membuat build, catat ID build dari respons API untuk menggunakannya untuk pembuatan armada.

Langkah 5: Buat armada EC2 yang dikelola

Langkah-langkah berikut menjelaskan konfigurasi armada minimal, sehingga Anda dapat siap dan menjalankannya 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 game 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 panggilan create-game-session, beri Amazon GameLift Servers tahu pembungkus untuk meluncurkan server game yang dapat dieksekusi dan memulai sesi game. Apa yang ada 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 diatur dan sesi game dimulai, Anda dapat mengelola dan memantaunya dari Amazon GameLift Servers konsol. Cara terbaik untuk mencapai hal ini adalah dari halaman detail Armada tempat Anda dapat mengedit detail armada atau mengubah penskalaan dan kapasitas armada pada tab Pen skalaan. 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 memantau server game Anda dengan cermat dari tab Metrik, Anda juga dapat menambahkan alarm ke metrik ini di CloudWatch dasbor.

Untuk menavigasi ke CloudWatch dasbor dari konsol:

Langkah 8: Skalakan 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 berkurang, 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 bersiap untuk peluncuran game, Anda pasti 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

Target-based autoscaling (pelacakan target) menghubungkan penskalaan armada ke persentase sesi game yang tersedia. Saat pemain meningkat untuk memainkan game Anda dan sesi game yang tersedia berkurang, ia merespons dengan secara otomatis menambahkan lebih banyak instance ke armada.

Rule-based penskalaan otomatis 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 benar, langkah pertama adalah memeriksa log yang dapat mengungkapkan salah satu masalah yang dijelaskan di bawah ini untuk penerapan baru atau game dalam produksi.

Berikut ini sering terungkap dalam log:

Untuk melihat log peristiwa untuk GameLift Server Amazon armada

Untuk melihat log peristiwa untuk Amazon GameLift Servers armada Anda

Untuk melihat log sesi game

Untuk melihat log sesi game

Untuk melihat log sesi game dengan CLI gunakan GetGameSessionLogURL API. 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 real-time atau periode retensi yang diperpanjang melalui CloudWatch:

Langkah selanjutnya