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 Server Amazon GameLift involucro

Benvenuto nel tutorial di onboarding per. Amazon GameLift Servers In questo tutorial, distribuisci rapidamente il tuo server di gioco per essere ospitato su una flotta di risorse di calcolo basate su cloud. Usa questo tutorial per evitare di dover integrare l'SDK del server Amazon GameLift Servers nel codice di gioco e utilizzare 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 live o per i test.

Principali vantaggi di questo metodo di onboarding:

Prerequisiti

Prima di iniziare, assicurati di disporre dei seguenti elementi:

Panoramica di

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 utilizzano 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
            

Una volta completata con successo, viene aggiunta una cartella «out»amazon-gamelift-servers-game-server-wrapper. In questa directory ci sono tre cartelle, una per ogni opzione del parco di hosting supportata, che contengono una serie di artefatti di compilazione. Per questo tutorial, stai eseguendo la distribuzione su flotte EC2 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 per il Amazon GameLift Servers caricamento su.

Crea la directory del gioco

Ora prepara una cartella di gioco sul tuo computer locale. Questa cartella 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 tuo server di gioco.

Utilizza le fasi seguenti:

Un esempio di struttura di directory sarà simile a questa:

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 elaborazione di una flotta, creando nuove istanze con la configurazione 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 flotta EC2 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 per la build del server di gioco (game server wrapper, config.yaml e i file del server di gioco) e sei pronto per caricare la build del gioco per l'hosting. Amazon GameLift Servers Il modo più rapido per caricare la build del gioco è usare il AWS CLI comando 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_2022 \
    --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 flotta EC2 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:

Fase 6: Crea e connettiti a una sessione di gioco

Quando lo stato della tua flotta è 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. Per i dettagli, consulta gli argomenti del server di gioco nel README. Quando riceve la chiamata create-game-session, Amazon GameLift Servers informa il wrapper di lanciare l'eseguibile del server di gioco e iniziare una sessione di gioco. Ciò che contiene 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.

Esempio di formato per aggiungere proprietà di 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 la tua flotta di server di gioco è configurata e una sessione di gioco è iniziata, puoi gestirla e monitorarla dalla Amazon GameLift Servers console. Il modo migliore per farlo è utilizzare la pagina dei dettagli della flotta, dove puoi modificare i dettagli della flotta o modificare la scalabilità e la capacità della flotta nella scheda Scalabilità. Consulta la sezione seguente sulla scalabilità dei tuoi server di gioco.

Scegli la scheda Metriche per visualizzare i grafici che illustrano il monitoraggio delle metriche relative a Attività e Hardware. Per informazioni dettagliate sui grafici delle metriche, scegli il link Informazioni accanto all'ID della tua flotta. Inoltre, mentre puoi monitorare attentamente i tuoi server di gioco dalla scheda Metriche, 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, imposti il ridimensionamento automatico. Con il ridimensionamento automatico puoi scalare dinamicamente la capacità della tua flotta in risposta all'attività del server di gioco. Man mano che i giocatori arrivano e iniziano le sessioni di gioco, il ridimensionamento automatico aggiunge più istanze e, man mano che la domanda dei giocatori diminuisce, il ridimensionamento automatico 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 configurare il ridimensionamento automatico per le tue flotte. Il ridimensionamento automatico è consigliato come metodo efficace per ridurre al minimo le risorse e i costi di hosting, garantendo comunque un'esperienza di gioco fluida e veloce.

Per impostare manualmente la capacità della flotta

Per impostare manualmente la capacità della flotta

Per utilizzare il ridimensionamento automatico basato sugli obiettivi

Per utilizzare il ridimensionamento automatico basato sugli obiettivi

Target-based la scalabilità automatica (tracciamento del bersaglio) collega il ridimensionamento della flotta alla percentuale di sessioni di gioco disponibili. Man mano che i giocatori si affrettano a giocare e le sessioni di gioco disponibili diminuiscono, il sistema risponde aggiungendo automaticamente altre istanze alla flotta.

Rule-based il ridimensionamento automatico offre un controllo più granulare, ad esempio la possibilità di collegare la scalabilità ad altre metriche del parco veicoli e impostare soglie e risposte di scalabilità personalizzate. Offre potenti opzioni, 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 prima impostazione dell'approccio basato sugli obiettivi.

Risolvi i problemi più comuni

Di seguito sono riportati i problemi più comuni che potresti riscontrare durante il funzionamento dei server di gioco e delle sessioni di gioco. Se 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 del tuo GameLift Server Amazon parco istanze

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

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, usa l'GetGameSessionLogURLAPI. Amazon GameLift Serversmemorizza automaticamente i log per 14 giorni.

Puoi anche configurare CloudWatch i log 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:

Fasi successive