Carica uno script Realtime Servers su Amazon GameLift

Quando sei pronto per distribuire server in tempo reale per il tuo gioco, carica i file di script del server Realtime completi su Amazon. GameLift Puoi farlo creando una risorsa di GameLift script Amazon e specificando la posizione dei tuoi file di script. È inoltre possibile aggiornare i file di script del server già distribuiti caricando nuovi file per una risorsa di script esistente.

Quando crei una nuova risorsa di script, Amazon GameLift le assegna un ID di script univoco (ad esempioscript-1111aaaa-22bb-33cc-44dd-5555eeee66ff) e carica una copia dei file di script. Il tempo di caricamento dipende dalla dimensione dei file di script e dalla velocità di connessione.

Dopo aver creato la risorsa dello script, Amazon GameLift distribuisce lo script con una nuova flotta di Realtime Servers. Amazon GameLift installa lo script del tuo server su ogni istanza del parco istanze, inserendo i file di /local/game script.

Per risolvere i problemi di attivazione della flotta relativi allo script del server, vedere. Esegui il debug dei problemi relativi alla GameLift flotta Amazon

File di script del pacchetto

Lo script del server può includere uno o più file combinati in un unico file.zip per il caricamento. Il file.zip deve contenere tutti i file necessari per l'esecuzione dello script.

Puoi archiviare i tuoi file di script compressi in una directory di file locale o in un bucket Amazon Simple Storage Service (Amazon S3).

Caricare file di script da una directory locale

Se i tuoi file di script sono archiviati localmente, puoi caricarli su Amazon GameLift da lì. Per creare la risorsa script, usa la GameLift console Amazon o il AWS Command Line Interface(AWS CLI).

Amazon GameLift console

Per creare una risorsa di script

1. Apri la GameLiftconsole Amazon.

2. Nel riquadro di navigazione, scegli Hosting, Script.

3. Nella pagina Script, scegli Crea script.

4. Nella pagina Crea script, in Impostazioni dello script, procedi come segue:

   1. In Nome, inserisci un nome di script.

   2. (Facoltativo) In Versione, inserisci le informazioni sulla versione. Poiché puoi aggiornare il contenuto di uno script, i dati di versione possono essere utili per tenere traccia degli aggiornamenti.

   3. Per Origine dello script, scegli Carica un file.zip.

   4. Per i file di script, scegliete Scegli file, cercate il file.zip che contiene lo script, quindi scegliete quel file.

5. (Facoltativo) In Tag, aggiungi i tag allo script inserendo le coppie Chiave e Value.

6. Seleziona Create (Crea).

   Amazon GameLift assegna un ID al nuovo script e carica il file.zip designato. Puoi visualizzare il nuovo script, incluso il suo stato, nella pagina Script.

AWS CLI

Usa il create-scriptAWS CLIcomando per definire il nuovo script e caricare i file di script del server.

Per creare una risorsa di script

1. Posiziona il file.zip in una directory in cui puoi usare. AWS CLI

2. Apri una finestra della riga di comando e passa alla directory in cui hai inserito il file.zip.

3. Immettete il create-script comando e i parametri seguenti. Per il --zip-file parametro, assicuratevi di aggiungere la stringa fileb:// al nome del file.zip. Identifica il file come binario in modo che Amazon GameLift elabori il contenuto compresso.

   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

   Esempio

   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

   In risposta alla tua richiesta, Amazon GameLift restituisce il nuovo oggetto script.

4. Per visualizzare il nuovo script, chiamadescribe-script.

Caricare file di script da Amazon S3

Puoi archiviare i tuoi file di script in un bucket Amazon S3 e caricarli su Amazon GameLift da lì. Quando crei lo script, specifichi la posizione del bucket S3 e Amazon GameLift recupera i file di script da Amazon S3.

Per creare una risorsa di script

1. Archivia i tuoi file di script in un bucket S3. Crea un file.zip contenente i file di script del tuo server e caricalo in un bucket S3 in un bucket Account AWS che controlli. Prendi nota dell'URI dell'oggetto: ne hai bisogno quando crei uno script AmazonGameLift.

   Nota

   Amazon GameLift non supporta il caricamento da bucket S3 con nomi che contengono un punto (.).

2. GameLiftConcedi ad Amazon l'accesso ai tuoi file di script. Per creare un ruolo AWS Identity and Access Management (IAM) che GameLift consenta ad Amazon di accedere al bucket S3 contenente lo script del server, segui le istruzioni in. Configura un ruolo di servizio IAM per Amazon GameLift Dopo aver creato il nuovo ruolo, prendi nota del suo nome, che ti serve per creare uno script.

3. Creare uno script. Usa la GameLift console Amazon o il AWS CLI per creare un nuovo record di script. Per effettuare questa richiesta, è necessario disporre dell'PassRoleautorizzazione IAM, come descritto inEsempi di autorizzazioni IAM per Amazon GameLift.

Amazon GameLift console

1. Nella GameLiftconsole Amazon, nel pannello di navigazione, scegli Hosting, Scripts.

2. Nella pagina Script, scegli Crea script.

3. Nella pagina Crea script, in Impostazioni dello script, procedi come segue:

   1. In Nome, inserisci un nome di script.

   2. (Facoltativo) In Versione, inserisci le informazioni sulla versione. Poiché puoi aggiornare il contenuto di uno script, i dati di versione possono essere utili per tenere traccia degli aggiornamenti.

   3. Per l'origine dello script, scegli l'URI Amazon S3.

   4. Inserisci l'URI S3 dell'oggetto script che hai caricato su Amazon S3, quindi scegli la versione dell'oggetto. Se non ricordi l'URI di Amazon S3 e la versione dell'oggetto, scegli Browse S3, quindi cerca l'oggetto script.

4. (Facoltativo) In Tag, aggiungi i tag allo script inserendo le coppie Chiave e Value.

5. Seleziona Create (Crea).

   Amazon GameLift assegna un ID al nuovo script e carica il file.zip designato. Puoi visualizzare il nuovo script, incluso il suo stato, nella pagina Script.

AWS CLI

Usa il create-scriptAWS CLIcomando per definire il nuovo script e caricare i file di script del server.

1. Apri una finestra della riga di comando e passa a una directory in cui puoi usare ilAWS CLI.

2. Immettete il create-script comando e i parametri seguenti. Il --storage-location parametro specifica la posizione del bucket Amazon S3 dei tuoi file di script.

   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

   Esempio

   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

   In risposta alla tua richiesta, Amazon GameLift restituisce il nuovo oggetto script.

3. Per visualizzare il nuovo script, chiama describe-script.

Aggiornamento dei file di script

Puoi aggiornare i metadati per una risorsa di script utilizzando la GameLift console Amazon o il update-scriptAWS CLIcomando.

Puoi anche aggiornare il contenuto dello script per una risorsa di script. Amazon GameLift distribuisce il contenuto degli script su tutte le istanze della flotta che utilizzano la risorsa di script aggiornata. Quando viene distribuito lo script aggiornato, le istanze lo utilizzano all'avvio di nuove sessioni di gioco. Le sessioni di gioco già in esecuzione al momento dell'aggiornamento non utilizzano lo script aggiornato.

Per aggiornare i file di script

• Per i file di script archiviati localmente, per caricare il file.zip dello script aggiornato, utilizza la GameLift console Amazon o il update-script comando.

• Per i file di script archiviati in un bucket Amazon S3, carica i file di script aggiornati nel bucket S3. Amazon verifica GameLift periodicamente la presenza di file di script aggiornati e li recupera direttamente dal bucket S3.