Crea un Amazon GameLift Anywhere parco istanze - Amazon GameLift

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à.

Crea un Amazon GameLift Anywhere parco istanze

Questo argomento descrive come creare un Amazon GameLift Anywhere flotta. Con una flotta Anywhere, puoi utilizzare le principali funzionalità di gestione delle sessioni di GameLift gioco di Amazon mentre offri sessioni di gioco con le tue risorse di elaborazione. Crea una flotta Anywhere per il tuo hardware locale o altre risorse basate sul cloud.

Le flotte Anywhere vengono comunemente utilizzate insieme alle flotte GameLift gestite da Amazon in una soluzione di hosting ibrida. Forniscono inoltre ambienti di test utili per lo sviluppo di un gioco da ospitare con Amazon GameLift. Consulta questi argomenti per saperne di più su quando e come incorporare Amazon GameLift Anywhere flotte in una soluzione di hosting di giochi:

Poiché le flotte Anywhere sono autogestite, la creazione di una flotta richiede del lavoro aggiuntivo. Per preparare una flotta Anywhere a ospitare sessioni di gioco e giocatori, devi completare le seguenti attività:

Prima di iniziare

Prima di creare una flotta Anywhere, esegui le seguenti operazioni. Per una guida più dettagliata, consulta Roadmap di sviluppo per l'hosting con Amazon Anywhere GameLift oRoadmap di sviluppo per l'hosting ibrido con Amazon GameLift.

  • Integra il codice del tuo server di gioco con la SDK versione 5.x (o successiva) del GameLift server Amazon. Non è necessario completare tutte le attività di integrazione del gioco, ma solo quelle necessarie per la creazione di un server di gioco. Una pratica comune consiste nel configurare la macchina locale come una flotta Anywhere e utilizzare un'interfaccia a riga di comando per testare l'integrazione del server di gioco (vediConfigura test locali con Amazon GameLift Anywhere). Puoi incorporare componenti aggiuntivi (come un client di gioco GameLift compatibile con Amazon) durante lo sviluppo.

  • Package del software del server di gioco per l'installazione sui computer della tua flotta Anywhere. Il pacchetto deve includere la versione integrata del server di gioco e tutto il software di supporto necessario per far funzionare il server di gioco.

  • Decidi se utilizzare Amazon GameLift Agent con la tua flotta Anywhere. L'Agent è uno strumento di gestione dei processi on-computing che automatizza alcune delle attività chiave relative alla gestione dei processi e dei calcoli del server da utilizzare con Amazon. GameLift Per ulteriori informazioni, consulta Collabora con Amazon GameLift Agent.

Crea una posizione personalizzata

Crea una posizione personalizzata per rappresentare la posizione fisica delle tue risorse di elaborazione. Quando crei una flotta Anywhere, devi avere almeno una posizione personalizzata già definita. Puoi creare altre sedi personalizzate e aggiungerle a una flotta esistente in qualsiasi momento.

Per creare una sede personalizzata

Usa la GameLift console Amazon o AWS Command Line Interface (AWS CLI) per creare una posizione personalizzata.

Console

Nella GameLift console Amazon, utilizza il pannello di navigazione per aprire la pagina Sedi. Scegli Crea posizione per aprire la finestra di dialogo Crea.

  1. Nella finestra di dialogo, inserite un nome per la località. Come procedura consigliata, utilizzate un nome che descriva una posizione significativa per un set di risorse di calcolo. Potrebbe trattarsi di posizioni geografiche, il nome di un data center o un altro identificatore di posizione. Amazon GameLift aggiunge il nome della tua sede personalizzata con custom-.

  2. (Facoltativo) Aggiungi tag alla tua posizione personalizzata. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili. Assegna tag alle AWS risorse che desideri classificare in modi utili, ad esempio per scopo, proprietario o ambiente. Scegli Aggiungi nuovo tag per ogni tag che desideri aggiungere.

  3. Scegli Create (Crea) .

AWS CLI

Crea una posizione personalizzata utilizzando il create-locationcomando. Fornisci un location-name valore, che deve iniziare concustom-. Come procedura consigliata, utilizzate un nome che descriva una posizione significativa per un set di risorse di elaborazione. Potrebbe trattarsi di posizioni geografiche, il nome di un data center o un altro identificatore di posizione.

aws gamelift create-location \ --location-name custom-location-1

Output

{ "Location": { "LocationName": "custom-location-1", "LocationArn": "arn:aws:gamelift:us-east-1:111122223333:location/custom-location-1" } }

Crea una flotta Anywhere

Crea una flotta Anywhere per un set di risorse di elaborazione di tua proprietà. Una nuova flotta Anywhere inizia vuota; aggiungi computer alla flotta registrandoli.

Al momento della creazione, un nuovo Anywhere la flotta si sposta rapidamente tra gli stati della flotta da NEW aACTIVE. Puoi aggiungere computer alla flotta una volta raggiunta la soglia. ACTIVE

Per creare una flotta Anywhere

Usa la GameLift console Amazon o AWS Command Line Interface (AWS CLI) per creare una flotta Anywhere.

Console

Nella GameLift console Amazon, utilizza il pannello di navigazione per aprire la pagina Fleets. Scegli Crea flotta per avviare il flusso di lavoro di creazione della flotta.

Passaggio 1 Scegli il tipo di elaborazione

Seleziona l'opzione Anywhere e scegli Avanti.

Fase 2 Definire i dettagli della flotta

In questo passaggio, specifica alcune impostazioni chiave a livello di flotta.

  1. Compila la sezione dei dettagli della flotta:

    1. Inserisci un nome per la flotta. Ti consigliamo di utilizzare uno schema di denominazione della flotta che faciliti l'identificazione dei tipi di flotta durante la visualizzazione degli elenchi di flotte.

    2. Fornisci una breve descrizione della flotta.

  2. Imposta questi dettagli aggiuntivi opzionali in base alle esigenze. Puoi aggiornare queste impostazioni del parco veicoli in un secondo momento.

    1. Quando crei una flotta per la produzione o i test preliminari alla produzione, utilizza questa impostazione per specificare un valore di costo orario per i calcoli del parco macchine. Amazon GameLift può utilizzare queste informazioni durante il processo di posizionamento della sessione di gioco per selezionare le risorse di hosting in base ai costi.

    2. Se desideri combinare i dati metrici per questo parco veicoli e altri, specifica il nome di un gruppo Metric. Utilizza lo stesso nome di gruppo metrico per tutte le flotte che desideri combinare. Visualizza le metriche per il gruppo di metriche per vedere i dati aggregati.

  3. Aggiungi tag opzionali alla tua posizione personalizzata. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili. Assegna tag alle AWS risorse che desideri classificare in modi utili, ad esempio per scopo, proprietario o ambiente. Scegli Aggiungi nuovo tag per ogni tag che desideri aggiungere.

  4. Scegli Avanti per continuare il flusso di lavoro.

Passaggio 3 Seleziona posizioni personalizzate

In questo passaggio, identifica la posizione fisica dei computer che intendi aggiungere a questa flotta. Ora puoi specificare una o più sedi e aggiungere o rimuovere sedi in un secondo momento, se necessario.

  1. In Posizioni personalizzate, seleziona una o più sedi per i computer della flotta. L'elenco include tutte le località personalizzate che sono state definite nella sezione attualmente selezionata Regione AWS. Per definire una nuova posizione personalizzata da aggiungere alla flotta, scegli Crea sede.

  2. Scegli Avanti per continuare il flusso di lavoro.

Passaggio 4: rivedi e crea

Controlla le impostazioni prima di creare la flotta.

Quando sei pronto per implementare la nuova flotta, scegli Crea. Amazon avvia GameLift immediatamente il processo di attivazione del parco veicoli, assegnando un ID univoco e assegnando alla flotta NEW lo stato desiderato. Puoi monitorare i progressi della flotta nella pagina Flotte.

AWS CLI

Usa il create-fleetcomando per creare una flotta di tipi di calcolo. ANYWHERE Fornisci un nome e almeno una posizione personalizzata. Amazon GameLift crea la risorsa Anywhere fleet con l'impostazione predefinita corrente Regione AWS (oppure puoi aggiungere un tag --region per specificarne un altro Regione AWS).

La seguente richiesta di esempio crea una nuova flotta con le impostazioni minime richieste. Sostituisci FleetName e custom-location con le tue informazioni.

aws gamelift create-fleet \ --name FleetName \ --compute-type ANYWHERE \ --locations "Location=custom-location"

Example response

{ "FleetAttributes": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "Name": "HardwareAnywhere", "CreationTime": "2023-02-23T17:57:42.293000+00:00", "Status": "ACTIVE", "MetricGroups": [ "default" ], "CertificateConfiguration": { "CertificateType": "DISABLED" }, "ComputeType": "ANYWHERE" } }

Al momento della creazione, un nuovo Anywhere la flotta passa rapidamente allo stato della flottaACTIVE. È possibile aggiungere computer alla flotta una volta raggiunta ACTIVE la destinazione.

Nota che la risposta non include le ubicazioni del parco veicoli. Puoi recuperare i dettagli completi della flotta chiamando describe-fleet-attributese describe-fleet-location-attributes.

Aggiungi un computer alla flotta

Per aggiungere una risorsa di calcolo a una flotta e prepararla per ospitare sessioni di gioco, esegui le seguenti attività:

  • Registrate il computer con il parco macchine. La registrazione indica ad Amazon GameLift quali risorse di hosting fisico fanno parte della flotta.

  • Richiedi un token di autenticazione per il calcolo. Ogni server di gioco in esecuzione sul computer necessita di questo token per connettersi al GameLift servizio Amazon. I token di autenticazione sono temporanei e devono essere aggiornati regolarmente.

Nota

Se stai distribuendo il software del tuo server di gioco con Amazon GameLift Agent, puoi saltare questo passaggio. L'agente registra automaticamente ogni calcolo e mantiene un token di autenticazione valido per il calcolo. Per informazioni, consulta Collabora con Amazon GameLift Agent.

Puoi registrare un calcolo e richiedere un token di autenticazione utilizzando AWS CLI o effettuando chiamate programmatiche verso AWS SDK Amazon. GameLift Queste azioni non sono disponibili tramite la GameLift console Amazon.

Come best practice, consigliamo di automatizzare entrambe queste attività aggiungendo uno script di avvio a ciascun calcolo. Lo script di avvio chiama automaticamente entrambi i comandi register-compute eget-compute-auth-token. Puoi anche automatizzare le attività per aggiornare regolarmente il token di autenticazione per tutta la durata del calcolo e annullare la registrazione del calcolo allo spegnimento.

Ciascuna delle azioni di avvio restituisce valori specifici del calcolo che è necessario archiviare sul computer. Quando un processo del server di gioco viene avviato sul computer, deve passare questi valori come parametri del server quando inizializza una connessione con il GameLift servizio Amazon (vedi ServerParameters nella guida al server). SDK Ti consigliamo di impostare questi valori specifici del calcolo (o le relative posizioni memorizzate) come variabili di ambiente. Se utilizzi Amazon GameLift Agent, questa attività viene gestita automaticamente. I valori specifici del calcolo sono i seguenti:

  • register-computerestituisce un valore per. GameLiftServiceSdkEndpoint Imposta questo valore sul parametro webSocketUrl del server.

  • compute-auth-tokenrestituisce il token di autenticazione. Imposta questo valore sul parametro authToken del server.

AWS CLI

Le seguenti istruzioni descrivono come inviare manualmente ogni richiesta utilizzando AWS CLI.

Per registrare un computer

Chiama register-computeper registrare un computer. Identifica l'ID del parco macchine a cui aggiungere il calcolo. Fornisci le seguenti informazioni di calcolo: un nome, un indirizzo IP e una posizione significativi. La posizione del computer deve essere una posizione personalizzata già associata alla flotta. Se desideri utilizzare una posizione personalizzata diversa, utilizza la GameLift console Amazon per aggiornare la flotta o chiama il AWS CLI comando create-fleet-locationsper aggiungere una posizione personalizzata alla flotta.

Nell'esempio seguente, sostituisci i valori segnaposto per il calcolo e la flotta. Il fleet-id valore viene restituito quando si crea una flotta Anywhere. Puoi recuperare i dettagli completi della flotta chiamando describe-fleet-attributese describe-fleet-location-attributes.

aws gamelift register-compute \ --compute-name HardwareAnywhere \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --ip-address 10.1.2.3 \ --location custom-location-1

Output di esempio

{ "Compute": { "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-west-2:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-west-2:111122223333:compute/HardwareAnywhere", "IpAddress": "10.1.2.3", "ComputeStatus": "Active", "Location": "custom-location-1", "CreationTime": "2023-02-23T18:09:26.727000+00:00", "GameLiftServiceSdkEndpoint": "wss://us-west-2.api.amazongamelift.com" } }

Per richiedere un token di autenticazione

Chiama get-compute-auth-tokenper richiedere un token di autenticazione valido. Registra un calcolo. Identifica l'ID della flotta e il nome del calcolo.

Nell'esempio seguente, sostituisci i valori segnaposto per il calcolo e la flotta. Il fleet-id valore viene restituito quando si crea una flotta Anywhere. Puoi recuperare i dettagli completi della flotta describe-fleet-attributeschiamando. Per trovare informazioni di calcolo, chiama list-computecon l'ID della flotta per vedere tutti i computer registrati nel parco macchine.

aws gamelift get-compute-auth-token \ --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa \ --compute-name HardwareAnywhere

Output di esempio

{ "FleetId": "fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "FleetArn": "arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa", "ComputeName": "HardwareAnywhere", "ComputeArn": "arn:aws:gamelift:us-east-1:111122223333:compute/HardwareAnywhere", "AuthToken": "0c728041-3e84-4aaa-b927-a0fb202684c0", "ExpirationTimestamp": "2023-02-23T18:47:54+00:00" }

Avvia un server di gioco

Dopo aver creato una flotta Anywhere e aver aggiunto uno o più computer alla flotta, sei pronto per iniziare a utilizzare i tuoi server di gioco.

Passaggio 1 Installa il software del server di gioco

Installa la build del tuo server di gioco e tutto il software dipendente su ogni computer della tua flotta Anywhere. La build del server di gioco deve essere integrata con la SDK versione 5.x (o successiva) del GameLift server Amazon con la funzionalità minima richiesta per comunicare con il GameLift servizio Amazon.

Passaggio 2 Prepara i tuoi computer per far funzionare un server di gioco

Assicurati che ogni computer sia registrato e disponga di un token di autenticazione valido. Se utilizzi degli script per gestire queste attività, assicurati che gli script vengano eseguiti su ogni computer prima di avviare qualsiasi processo del server di gioco.

Se hai distribuito Amazon GameLift Agent con il software del server di gioco, assicurati che l'eseguibile dell'Agent venga avviato.

Passaggio 3 Avvia un processo del server di gioco

Esegui un'istanza del file eseguibile del tuo server di gioco su un computer. Se la build del server di gioco è integrata correttamente, il processo del server di gioco richiama l'SDKazione del server InitSDK() con una serie di parametri validi del server. Quando il processo server è pronto per ospitare una sessione di gioco, chiamaProcessReady().

Nota

Se hai distribuito il software del server di gioco con Amazon GameLift Agent, puoi saltare questo passaggio. L'agente avvia automaticamente i processi del server di gioco in base alle istruzioni di runtime fornite.

È possibile monitorare l'avanzamento visualizzando le metriche dei processi del server per l'attivazione e i processi attivi del server. Per informazioni, consulta GameLiftMetriche Amazon per le flotte. Se il processo del server di gioco non riesce a inizializzarsi, verifica che il processo stia recuperando i valori dei parametri del server corretti per il computer su cui è in esecuzione.