Unggah skrip Server Realtime ke Amazon GameLift

Saat Anda siap untuk menerapkan Server Realtime untuk game Anda, unggah file skrip server Realtime yang telah selesai ke Amazon. GameLift Lakukan ini dengan membuat sumber daya GameLift skrip Amazon dan menentukan lokasi file skrip Anda. Anda juga dapat memperbarui file skrip server yang sudah disebarkan dengan mengunggah file baru untuk sumber daya skrip yang ada.

Saat Anda membuat sumber daya skrip baru, Amazon GameLift memberikan ID skrip unik (misalnya,script-1111aaaa-22bb-33cc-44dd-5555eeee66ff) dan mengunggah salinan file skrip. Waktu upload tergantung pada ukuran file skrip Anda dan kecepatan koneksi Anda.

Setelah Anda membuat sumber daya skrip, Amazon GameLift menerapkan skrip dengan armada Server Realtime baru. Amazon GameLift menginstal skrip server Anda ke setiap instans dalam armada, menempatkan file skrip. /local/game

Untuk memecahkan masalah aktivasi armada yang terkait dengan skrip server, lihat. Debug masalah GameLift armada Amazon

Buat paket file skrip

Skrip server Anda dapat menyertakan satu atau beberapa file yang digabungkan menjadi satu file.zip untuk diunggah. File.zip harus berisi semua file yang perlu dijalankan oleh skrip Anda.

Anda dapat menyimpan file skrip zip di direktori file lokal atau di bucket Amazon Simple Storage Service (Amazon S3).

Unggah file skrip dari direktori lokal

Jika Anda menyimpan file skrip secara lokal, Anda dapat mengunggahnya ke Amazon GameLift dari sana. Untuk membuat sumber daya skrip, gunakan GameLift konsol Amazon atau AWS Command Line Interface(AWS CLI).

Amazon GameLift console

Untuk membuat sumber daya skrip

1. Buka GameLiftkonsol Amazon.

2. Di panel navigasi, pilih Hosting, Skrip.

3. Pada halaman Skrip, pilih Buat skrip.

4. Pada halaman Create script, di bawah Script settings, lakukan hal berikut:

   1. Untuk Nama, masukkan nama skrip.

   2. (Opsional) Untuk Versi, masukkan informasi versi. Karena Anda dapat memperbarui konten skrip, data versi dapat membantu dalam melacak pembaruan.

   3. Untuk Sumber skrip, pilih Unggah file.zip.

   4. Untuk file Script, pilih Pilih file, telusuri file.zip yang berisi skrip Anda, lalu pilih file itu.

5. (Opsional) Di bawah Tag, tambahkan tag ke skrip dengan memasukkan pasangan Key dan Value.

6. Pilih Create (Buat).

   Amazon GameLift menetapkan ID ke skrip baru dan mengunggah file.zip yang ditunjuk. Anda dapat melihat skrip baru, termasuk statusnya, di halaman Skrip.

AWS CLI

Gunakan create-scriptAWS CLIperintah untuk menentukan script baru dan meng-upload file script server Anda.

Untuk membuat sumber daya skrip

1. Tempatkan file.zip ke dalam direktori tempat Anda dapat menggunakan file. AWS CLI

2. Buka jendela baris perintah dan beralih ke direktori tempat Anda menempatkan file.zip.

3. Masukkan create-script perintah dan parameter berikut. Untuk --zip-file parameter, pastikan untuk menambahkan string fileb:// ke nama file.zip. Ini mengidentifikasi file sebagai biner sehingga Amazon GameLift memproses konten terkompresi.

   aws gamelift create-script \
       --name user-defined name of script \
       --script-version user-defined version info \
       --zip-file fileb://name of zip file \
       --region region name

   Contoh

   aws gamelift create-script \
       --name "My_Realtime_Server_Script_1" \
       --script-version "1.0.0" \
       --zip-file fileb://myrealtime_script_1.0.0.zip \
       --region us-west-2

   Menanggapi permintaan Anda, Amazon GameLift mengembalikan objek skrip baru.

4. Untuk melihat skrip baru, hubungidescribe-script.

Unggah file skrip dari Amazon S3

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

Untuk membuat sumber daya skrip

1. Simpan file skrip Anda dalam bucket S3. Buat file.zip yang berisi file skrip server Anda dan unggah ke bucket S3 dalam Akun AWS yang Anda kontrol. Perhatikan objek URI—Anda memerlukan ini saat membuat skrip AmazonGameLift.

   catatan

   Amazon GameLift tidak mendukung pengunggahan dari bucket S3 dengan nama yang berisi periode (.).

2. Berikan GameLift akses Amazon ke file skrip Anda. Untuk membuat peran AWS Identity and Access Management (IAM) yang memungkinkan Amazon GameLift mengakses bucket S3 yang berisi skrip server Anda, ikuti instruksi di dalamnya. Menyiapkan peran layanan IAM untuk Amazon GameLift Setelah Anda membuat peran baru, perhatikan namanya, yang Anda butuhkan saat membuat skrip.

3. Buat skrip. Gunakan GameLift konsol Amazon atau AWS CLI untuk membuat catatan skrip baru. Untuk membuat permintaan ini, Anda harus memiliki PassRole izin IAM, seperti yang dijelaskan dalamContoh izin IAM untuk Amazon GameLift.

Amazon GameLift console

1. Di GameLiftkonsol Amazon, di panel navigasi, pilih Hosting, Skrip.

2. Pada halaman Skrip, pilih Buat skrip.

3. Pada halaman Create script, di bawah Script settings, lakukan hal berikut:

   1. Untuk Nama, masukkan nama skrip.

   2. (Opsional) Untuk Versi, masukkan informasi versi. Karena Anda dapat memperbarui konten skrip, data versi dapat membantu dalam melacak pembaruan.

   3. Untuk sumber Script, pilih URI Amazon S3.

   4. Masukkan URI S3 objek skrip yang Anda unggah ke Amazon S3, lalu pilih versi Object. Jika Anda tidak mengingat URI Amazon S3 dan versi objek, pilih Browse S3, lalu cari objek skrip.

4. (Opsional) Di bawah Tag, tambahkan tag ke skrip dengan memasukkan pasangan Key dan Value.

5. Pilih Create (Buat).

   Amazon GameLift menetapkan ID ke skrip baru dan mengunggah file.zip yang ditunjuk. Anda dapat melihat skrip baru, termasuk statusnya, di halaman Skrip.

AWS CLI

Gunakan create-scriptAWS CLIperintah untuk menentukan script baru dan meng-upload file script server Anda.

1. Buka jendela baris perintah dan beralih ke direktori di mana Anda dapat menggunakanAWS CLI.

2. Masukkan create-script perintah dan parameter berikut. --storage-locationParameter menentukan lokasi bucket Amazon S3 dari file skrip Anda.

   aws gamelift create-script \
       --name [user-defined name of script] \
       --script-version [user-defined version info] \
       --storage-location "Bucket"=S3 bucket name,"Key"=name of zip file in S3 bucket,"RoleArn"=Access role ARN \
       --region region name

   Contoh

   aws gamelift create-script \
       --name "My_Realtime_Server_Script_1" \
       --script-version "1.0.0" \
       --storage-location "Bucket"="gamelift-script","Key"="myrealtime_script_1.0.0.zip","RoleArn"="arn:aws:iam::123456789012:role/S3Access" \
       --region us-west-2

   Menanggapi permintaan Anda, Amazon GameLift mengembalikan objek skrip baru.

3. Untuk melihat skrip baru, hubungi describe-script.

Memperbarui file skrip

Anda dapat memperbarui metadata untuk sumber daya skrip menggunakan GameLift konsol Amazon atau perintah update-scriptAWS CLI.

Anda juga dapat memperbarui konten skrip untuk sumber daya skrip. Amazon GameLift menerapkan konten skrip ke semua instans armada yang menggunakan sumber daya skrip yang diperbarui. Saat skrip yang diperbarui diterapkan, instance menggunakannya saat memulai sesi game baru. Sesi game yang sudah berjalan pada saat pembaruan tidak menggunakan skrip yang diperbarui.

Untuk memperbarui file script

• Untuk file skrip yang disimpan secara lokal, untuk mengunggah file.zip skrip yang diperbarui, gunakan GameLift konsol Amazon atau perintah. update-script

• Untuk file skrip yang disimpan dalam bucket Amazon S3, unggah file skrip yang diperbarui ke bucket S3. Amazon GameLift secara berkala memeriksa file skrip yang diperbarui dan mengambilnya langsung dari bucket S3.