Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tutorial: onboarding rapido con il wrapper Amazon GameLift Servers

Benvenuto nel tutorial di onboarding per. Amazon GameLift Servers In questo tutorial, implementerai rapidamente il tuo server di gioco in modo che sia ospitato su una flotta di risorse di calcolo basate sul cloud. Usa questo tutorial per evitare di integrare l'SDK del server Amazon GameLift Servers nel codice del gioco e distribuisci invece il gioco con le funzionalità minime necessarie per comunicare con il servizio ed eseguire sessioni di gioco. Amazon GameLift Servers Configurerai una soluzione di hosting di base e la utilizzerai per provare l'intera gamma di funzionalità come il ridimensionamento automatico e il matchmaking. È anche un ottimo modo per ospitare un prototipo del tuo gioco come parte di una demo dal vivo o per un test.

Principali vantaggi di questo metodo di onboarding:

Prerequisiti

Prima di iniziare, assicurati di avere:

Panoramica

In questo tutorial potrai:

Passaggio 1: Ottieni e crea il wrapper del server di gioco

Usa i seguenti comandi per ottenere il sorgente del wrapper del server di gioco e creare il wrapper. Questi comandi usano SSH, ma puoi anche accedere direttamente al repository Github.

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

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

In caso di compilazione riuscita, viene aggiunta una directory «out» aamazon-gamelift-servers-game-server-wrapper. In questa directory ci sono tre cartelle, una per ogni opzione della flotta di hosting supportata, che contengono un set di elementi di build. Per questo tutorial, eseguirai la distribuzione su EC2 flotte gestite, quindi utilizzerai la cartella. gamelift-servers-managed-ec2

Passaggio 2: prepara la build del server di gioco

In questo passaggio, prepari i file di build del server di gioco da caricare su. Amazon GameLift Servers

Crea la directory del gioco

Ora prepara una directory di gioco sul tuo computer locale. Questa directory deve contenere tutti i file necessari per far funzionare il server di giocoAmazon GameLift Servers. Ciò include il wrapper del server di gioco, la build del server di gioco e il file config.yaml che fa funzionare il wrapper con il server di gioco.

Utilizza le fasi seguenti:

Un esempio di struttura di cartelle sarà simile a questo:

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

Fase 3: Configura il wrapper per la tua flotta

Amazon GameLift Serversgestisce il ciclo di vita delle istanze di calcolo di una flotta, creando nuove istanze con la build del server installata e riciclando le istanze secondo necessità. Il servizio gestisce il ciclo di vita dei processi del server di gioco che viene eseguito su ogni istanza. Una EC2 flotta gestita può avere istanze in più sedi per supportare i giocatori ovunque si trovino.

Modifica il file config.yaml per configurare il wrapper per la registrazione, la configurazione delle porte e l'inizializzazione del server.

Configurazione di esempio:

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
        

Passaggio 4: carica la build del server di gioco

Ora hai completato tutti gli elementi richiesti della build del tuo server di gioco (game server wrapper, config.yaml e i file del server di gioco) e sei pronto per caricare la build del gioco su come hosting. Amazon GameLift Servers Il modo più rapido per caricare la build del gioco è usare il AWS CLI comando, come mostrato nell'esempio seguenteupload-build.

Caricare una build di gioco con 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
        

Quando crei la build, registra l'ID di build dalla risposta dell'API per utilizzarlo per la creazione della flotta.

Fase 5: Creare la EC2 flotta gestita

I passaggi seguenti descrivono una configurazione minima del parco veicoli, in modo da poter essere operativi il prima possibile.

Per creare la tua flotta:

Passaggio 6: Crea e connettiti a una sessione di gioco

Quando lo stato della tua flotta risulta Attivo, significa che i server di gioco sono pronti e in attesa di ospitare una sessione di gioco. Per iniziare una sessione di gioco, invia una richiesta di sessione di gioco al Amazon GameLift Servers servizio. Qui, utilizzerai il AWS CLI per effettuare questa richiesta.

Usa quanto segue per creare una sessione di gioco:

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

Puoi anche passare proprietà di gioco personalizzate all'eseguibile del tuo server. Vedi gli argomenti del server di gioco nel README per i dettagli. Quando riceve la create-game-session chiamata, Amazon GameLift Servers informa il wrapper di avviare l'eseguibile del server di gioco e avviare una sessione di gioco. Il contenuto config.yaml influisce sulla configurazione del server di gioco e i parametri di avvio impostati nella console determinano la configurazione della sessione di gioco stessa.

Formato di esempio per aggiungere le proprietà del gioco:

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

Fase 7: Gestisci e monitora la tua flotta

Ora che il tuo parco server di gioco è configurato e la sessione di gioco è iniziata, puoi gestirla e monitorarla dalla Amazon GameLift Servers console. Il modo migliore per farlo è accedere alla pagina dei dettagli della flotta, dove puoi modificare i dettagli della flotta o modificare la scalabilità e la capacità della flotta nella scheda Scaling. Consulta la sezione seguente sul ridimensionamento dei server di gioco.

Scegli la scheda Metriche per visualizzare i grafici che illustrano il monitoraggio delle metriche relative all'attività e all'hardware. Per i dettagli sui grafici delle metriche, scegli il link Informazioni accanto all'ID del tuo parco veicoli. Inoltre, puoi monitorare da vicino i tuoi server di gioco dalla scheda Metriche, ma puoi anche aggiungere allarmi a queste metriche nella dashboard. CloudWatch

Per accedere alla CloudWatch dashboard dalla console:

Passaggio 8: ridimensiona i tuoi server di gioco

Per il passaggio successivo, configuri il ridimensionamento automatico. Con la scalabilità automatica puoi scalare dinamicamente la capacità della tua flotta in risposta all'attività dei server di gioco. Man mano che i giocatori arrivano e iniziano le sessioni di gioco, la scalabilità automatica aggiunge altre istanze e, man mano che la domanda dei giocatori diminuisce, la scalabilità automatica rilascia le istanze inutilizzate. Si tratta di un modo efficace per ridurre al minimo le risorse e i costi di hosting, garantendo al contempo un'esperienza di gioco fluida e veloce.

Mentre ti prepari per il lancio del gioco, ti consigliamo di impostare la scalabilità automatica per le tue flotte. La scalabilità automatica è consigliata come metodo efficace per ridurre al minimo le risorse e i costi di hosting, garantendo al contempo un'esperienza di gioco fluida e veloce.

Per impostare manualmente la capacità del parco veicoli

Per impostare manualmente la capacità del parco veicoli

Per utilizzare il ridimensionamento automatico basato sulla destinazione

Per utilizzare il ridimensionamento automatico basato sulla destinazione

La scalabilità automatica basata sugli obiettivi (tracciamento degli obiettivi) collega il ridimensionamento della flotta alla percentuale di sessioni di gioco disponibili. Man mano che i giocatori si affollano a giocare al tuo gioco e le sessioni di gioco disponibili diminuiscono, il sistema risponde aggiungendo automaticamente altre istanze al parco istanze.

La scalabilità automatica basata su regole offre un controllo più granulare, ad esempio la possibilità di collegare la scalabilità ad altre metriche del parco veicoli e di impostare soglie e risposte di scalabilità personalizzate. Offre opzioni potenti, ma richiede anche l'utilizzo della CLI e test significativi per capire come si comportano le regole personalizzate in azione. Questo tutorial si concentra sulla configurazione iniziale dell'approccio basato sugli obiettivi.

Risolvi i problemi più comuni

Di seguito sono riportati i problemi più comuni che potresti riscontrare durante l'esecuzione dei server e delle sessioni di gioco. Quando il server o la sessione di gioco non funzionano correttamente, la prima cosa da fare è controllare i log, che potrebbero rivelare uno dei problemi descritti di seguito per le nuove distribuzioni o i giochi in produzione.

Nei log viene spesso rivelato quanto segue:

Per visualizzare i registri degli eventi della tua flotta Amazon GameLift Servers

Per visualizzare i registri degli eventi della tua flotta Amazon GameLift Servers

Per visualizzare i registri delle sessioni di gioco

Per visualizzare i registri delle sessioni di gioco

Per visualizzare i registri delle sessioni di gioco con la CLI, utilizza l'GetGameSessionLogURLAPI. Amazon GameLift Serversarchivia automaticamente i log per 14 giorni.

Puoi anche configurare CloudWatch i log di Amazon per la tua flotta. Ciò fornisce funzionalità di registrazione aggiuntive e integrazione con altri servizi di AWS monitoraggio.

Per l'accesso ai log in tempo reale o per periodi di conservazione prolungati tramite CloudWatch:

Passaggi successivi