Creazione o aggiornamento di un'implementazione

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina spiega come creare, aggiornare e visualizzare i dettagli di un'implementazione di Game Servers in un deployment. Un'implementazione delle mappe di server di gioco configura per scegliere come target i regni. Per visualizzare un esempio end-to-end di come creare un deployment, aggiungere una configurazione, quindi implementarla, vedi Configurare il comportamento di scalabilità del cluster.


Figura 1. La configurazione 1.0 è stata implementata per il regno degli Stati Uniti e la versione 1.1 per i regni in Europa e Giappone.

Per ulteriori informazioni, consulta la panoramica sui server di gioco.

Prima di iniziare

Prima di iniziare, ti consigliamo di familiarizzare con i concetti chiave nella panoramica dei server di gioco. Assicurati di aver eseguito anche le seguenti attività:

  • Assicurati di aver attivato l'API Game Services.
  • Abilitare l'API Game Services
  • Scegli una shell con gcloud CLI installata o utilizza un client API:
  • Cloud Shell

    Per avviare Cloud Shell, esegui questi passaggi:

    1. Vai a Google Cloud Console.

      Console Google Cloud

    2. Nell'angolo in alto a destra della console, fai clic sul pulsante Attiva Cloud Shell:

    Una sessione di Cloud Shell si apre all'interno di un frame più in basso nella console. Utilizza questa shell per eseguire i comandi gcloud.

    shell locale

    Installa l'interfaccia a riga di comando gcloud.

    Verifica di aver impostato il progetto predefinito che preferisci per Google Cloud CLI (altrimenti devi specificare esplicitamente il flag --project per ogni comando):

    gcloud config list project
    

    In caso contrario, puoi eseguire il comando seguente per impostare un progetto predefinito, sostituendo PROJECT_ID con l'ID progetto desiderato :

    gcloud config set project PROJECT_ID
    

    Esegui questo comando per verificare la tua versione di Google Cloud CLI. Game Servers richiede la versione 306.0.0 o successiva dell'interfaccia a riga di comando gcloud.

    gcloud version
    

    Per aggiornare l'installazione, esegui il comando seguente:

    gcloud components update
    

    curl / PowerShell

    Per utilizzare l'API REST con curl o Windows PowerShell, procedi come segue:

    1. Crea un account di servizio.
    2. Scarica una chiave privata come file JSON.
    3. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene la chiave dell'account di servizio. Questa variabile si applica solo alla sessione shell corrente, quindi se apri una nuova sessione, impostala di nuovo.

    Libreria client

    I server di gioco Google Cloud possono essere controllati in modo programmatico utilizzando una libreria client. Consulta la Panoramica delle librerie client per le istruzioni sull'utilizzo della libreria e sull'autenticazione.

Aggiornamento di un'implementazione

La procedura di aggiornamento di un'implementazione equivale alla creazione di un'implementazione. Innanzitutto, assicurati di aver creato una configurazione di Game Servers. Se vuoi scegliere come target aree di autenticazione specifiche con una configurazione diversa, crea una configurazione di override separata.

Aggiornamento della configurazione predefinita di un'implementazione

La configurazione predefinita del server di gioco è stata implementata per tutti i domini. Per scegliere come target aree di targeting specifiche con una configurazione diversa, consulta l'articolo su come eseguire l'override della configurazione per alcuni aree di autenticazione.

Console

  1. In Google Cloud Console, vai alla pagina Deployment di Game Servers.

    Vai a Server di gioco

  2. Trova un deployment nella tabella. Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Configurazioni elenco. Da questa pagina puoi visualizzare le configurazioni attive e inattive per il deployment.

  3. Fai clic su Gestisci implementazione.

  4. (Facoltativo) Nell'elenco Seleziona una configurazione, scegli una configurazione predefinita che si applichi a tutti i domini.

  5. Fai clic su Salva.

gcloud CLI

Per aggiornare la configurazione predefinita di un'implementazione di Game Servers utilizzando Google Cloud CLI:

  1. Esegui questo comando dopo aver sostituito i seguenti valori segnaposto:

    • deploymentID è l'identificatore univoco del deployment.
    • configID è un identificatore univoco per la configurazione.
    gcloud game servers deployments update-rollout deploymentID --default-config configID --dry-run
    

    L'output restituisce targetState per consentirti di visualizzare l'anteprima delle modifiche.

  2. Per applicare le modifiche, esegui il comando seguente:

    gcloud game servers deployments update-rollout deploymentID --default-config configID --no-dry-run
    

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM.
  • DEPLOYMENT_ID: un identificatore definito dall'utente per il deployment
  • CONFIG_ID: un identificatore definito dall'utente per la configurazione

Corpo JSON richiesta:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": "CONFIG_ID"
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Cancellazione della configurazione predefinita di un'implementazione

Cancella la configurazione predefinita per rimuovere la configurazione del parco risorse per questo deployment da tutti i cluster di Game Servers.

Console

  1. In Google Cloud Console, vai alla pagina Deployment di Game Servers.

    Vai a Server di gioco

  2. Trova un deployment nella tabella. Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Configurazioni elenco. Da questa pagina puoi visualizzare le configurazioni attive e inattive per il deployment.

  3. Fai clic su Gestisci implementazione.

  4. Nell'elenco Seleziona una configurazione, seleziona (nessuna configurazione predefinita).

  5. Fai clic su Salva.

gcloud CLI

Per cancellare la configurazione predefinita di un'implementazione di Game Servers utilizzando Google Cloud CLI:

  1. Esegui questo comando dopo aver sostituito il seguente valore segnaposto:

    • deploymentID è l'identificatore univoco del deployment.
    gcloud game servers deployments update-rollout deploymentID --clear-default-config --dry-run
    

    L'output restituisce targetState per consentirti di visualizzare l'anteprima delle modifiche.

  2. Per applicare le modifiche, esegui il comando seguente:

    gcloud game servers deployments update-rollout deploymentID --clear-default-config --no-dry-run
    

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM.
  • DEPLOYMENT_ID: un identificatore definito dall'utente per il deployment

Corpo JSON richiesta:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "defaultGameServerConfig": ""
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Override della configurazione per alcuni realm

Se vuoi scegliere come target configurazioni specifiche con una configurazione diversa, crea una configurazione di override separata e seleziona uno o più aree di autenticazione che riceveranno questa configurazione di override (e non quella predefinita).

Console

  1. In Google Cloud Console, vai alla pagina Deployment di Game Servers.

    Vai a Server di gioco

  2. Trova un deployment nella tabella. Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Configurazioni elenco. Da questa pagina puoi visualizzare le configurazioni attive e inattive per il deployment.

  3. Fai clic su Gestisci implementazione.

  4. (Facoltativo) Nell'elenco Seleziona una configurazione, scegli una configurazione predefinita che si applichi a tutti i domini che non corrispondono a una configurazione di sostituzione.

  5. In Override config (Configura configurazioni di override), puoi specificare una o più configurazioni di override e le aree di autenticazione a cui associarle.

    1. Seleziona una configurazione di override dall'elenco Config e il regno da associare dall'elenco Realm.
    2. Utilizza i pulsanti freccia per modificare l'ordine di priorità delle configurazioni di override nell'elenco.
    3. Fai clic su Add (Aggiungi).
  6. Fai clic su Salva.

gcloud CLI

Per applicare sostituzioni di configurazione a particolari aree di autenticazione utilizzando Google Cloud CLI:

  1. Copia il seguente codice in un file e sostituisci i seguenti valori segnaposto:

    • realmID è l'identificatore completo di un'area di autenticazione, ad esempio projects/<projectID>/locations/<region>/realms/<realmID2>.
    • configID è un identificatore univoco per la configurazione.
    - realmsSelector:
        realms:
            - realmID
      configVersion: configID
    
  2. Esegui questo comando dopo aver sostituito i seguenti valori segnaposto:

    • deploymentID è l'identificatore univoco del deployment.
    • configOverrideFile è il percorso del file con la configurazione di override.
    gcloud game servers deployments update-rollout deploymentID --config-overrides-file configOverrideFile --dry-run
    

    L'output restituisce targetState per consentirti di visualizzare l'anteprima delle modifiche.

  3. Per applicare le modifiche, esegui il comando seguente:

    gcloud game servers deployments update-rollout deploymentID --config-overrides-file configOverrideFile  --no-dry-run
    

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM.
  • LOCATION: l'area geografica per il regno (o global)
  • DEPLOYMENT_ID: un identificatore definito dall'utente per il deployment
  • REALM_ID: l'identificatore definito dall'utente per l'area di autenticazione
  • OVERRIDE_CONFIG_ID: un identificatore definito dall'utente per la configurazione di override

Corpo JSON richiesta:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": [
  {
    "realmsSelector": {
      "realms": [
        "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"
      ]
    },
    "configVersion": "OVERRIDE_CONFIG_ID"
  }
  ]
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Cancellazione delle sostituzioni di configurazione

Cancella la configurazione di override per rimuovere la configurazione del parco risorse per questo deployment dagli account di destinazione.

Console

  1. In Google Cloud Console, vai alla pagina Deployment di Game Servers.

    Vai a Server di gioco

  2. Trova un deployment nella tabella. Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Configurazioni elenco. Da questa pagina puoi visualizzare le configurazioni attive e inattive per il deployment.

  3. Fai clic su Gestisci implementazione.

  4. In Override config (Configura configurazioni di override), fai clic sull'icona del cestino accanto alle configurazioni di override che vuoi cancellare.

  5. Fai clic su Salva.

gcloud CLI

Per cancellare le sostituzioni di configurazione di un'implementazione di Game Servers utilizzando Google Cloud CLI:

  1. Esegui questo comando dopo aver sostituito il seguente valore segnaposto:

    • deploymentID è l'identificatore univoco del deployment.
    gcloud game servers deployments update-rollout deploymentID --clear-config-overrides --dry-run
    

    L'output restituisce targetState per consentirti di visualizzare l'anteprima delle modifiche.

  2. Per applicare le modifiche, esegui il comando seguente:

    gcloud game servers deployments update-rollout deploymentID --clear-config-overrides --no-dry-run
    

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM.
  • DEPLOYMENT_ID: un identificatore definito dall'utente per il deployment

Corpo JSON richiesta:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "gameServerConfigOverrides": []
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/global/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Visualizzare i dettagli di un'implementazione

Console

  1. In Google Cloud Console, vai alla pagina Deployment di Game Servers.

    Vai a Server di gioco

  2. Trova un deployment nella tabella. Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Configurazioni elenco. Da questa pagina puoi visualizzare le configurazioni attive e inattive per il deployment.

  3. Fai clic su Gestisci implementazione.

gcloud CLI

Puoi visualizzare i dettagli di un'implementazione, ad esempio le configurazioni in uso, utilizzando Google Cloud CLI:

Per visualizzare i dettagli di un'implementazione, esegui questo comando dopo aver sostituito il seguente valore segnaposto:

  • deploymentID è l'identificatore univoco del deployment padre.
gcloud game servers deployments describe-rollout deploymentID

L'output mostra i dettagli dell'implementazione.

Puoi anche visualizzare lo stato dei cluster dei server di gioco dopo l'applicazione dell'implementazione, utilizzando Google Cloud CLI:

gcloud game servers deployments fetch-state deploymentID

L'output mostra le modifiche applicate dall'implementazione su ogni cluster del server di gioco.

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM.
  • DEPLOYMENT_ID: un identificatore definito dall'utente per il deployment

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/rollout",
  "createTime": CREATE_TIME,
  "updateTime": UPDATE_TIME,
  "defaultGameServerConfig": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/CONFIG_ID",
  "gameServerConfigOverrides": [
    {
      "realmsSelector": {
        "realms": [
          "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"
        ]
      },
      "configVersion": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID/configs/OVERRIDE_CONFIG_ID"
    }
  ],
  "etag": "cN31kxa6fWHtaZWUnUZ7LfamUN7Ggz13DWS58Sc5jIQ"
}

Risolvere i problemi relativi alle implementazioni

Questa sezione descrive i motivi per cui Game Servers potrebbe non essere in grado di aggiornare i cluster di server di gioco. Una causa comune può essere dovuta all'errata configurazione dei server di gioco o dei cluster di server di gioco. Consulta il seguente elenco di controllo per diagnosticare i potenziali problemi riscontrati:

  • Verifica che siano soddisfatti i seguenti prerequisiti per un cluster Agones:
    1. Assicurati che il cluster sia in esecuzione e che Agones sia installato. Per verificare che il pod agones-controller sia nello stato Running, esegui questo comando:
      kubectl get pods -n agones-system -l agones.dev/role=controller
      
    2. Assicurati che per il server di gioco namespace siano previste le autorizzazioni necessarie per i controlli di accesso basati sui ruoli (RBAC) per il controller Agones.
    3. Assicurati che la versione installata di Agones sia supportata da Game Servers.
  • Consulta la guida alla risoluzione dei problemi di Agones.
  • Verifica che la risorsa di deployment di Game Servers sia configurata correttamente:
    1. Se utilizzi una configurazione di override, assicurati che il deployment si applichi al regno con il cluster di destinazione.
    2. Assicurati che la specifica del parco risorse sia configurata correttamente. Per convalidare le specifiche del parco risorse, prova ad aprire manualmente un server di gioco.
    3. Se non è stata apportata una modifica pianificata, assicurati che la pianificazione sia configurata correttamente. Il fuso orario di una pianificazione segue il fuso orario del realm.

Passaggi successivi

Scopri come eliminare una configurazione.