Creazione di un'area di autenticazione

In questa pagina viene spiegato come creare, elencare, descrivere e aggiornare le aree di gioco Game Servers. Un realm è un raggruppamento definito dall'utente di cluster di server di gioco basati sui requisiti di latenza del gioco per le popolazioni di giocatori.

Prima di iniziare

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

Assicurati di aver attivato l'API Game Services.

Abilita 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:

Vai alla console Google Cloud.

Console Google Cloud
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

Installare l'interfaccia a riga di comando gcloud.

Verifica di aver impostato il progetto predefinito desiderato per Google Cloud CLI (in caso contrario dovrai specificare il flag --project in modo esplicito per ogni comando in un secondo momento):

gcloud config list project

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

gcloud config set project PROJECT_ID

Esegui il comando seguente per verificare la tua versione di Google Cloud CLI. Game Servers richiede la versione 306.0.0 o successiva dellgcloud CLI.

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, segui questi passaggi:

Crea un account di servizio.
Scarica una chiave privata come file JSON.
Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso del file JSON che contiene le tue credenziali. Questa variabile si applica solo alla sessione di shell attuale. Pertanto, se apri una nuova sessione, imposta di nuovo la variabile.
Esempio: Linux o macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

Ad esempio:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
Esempio: Windows

Per PowerShell:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

Ad esempio:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
Per il prompt dei comandi:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
Sostituisci KEY_PATH con il percorso del file JSON che contiene le tue credenziali.

Libreria client

I server di gioco Google Cloud possono essere controllati in modo programmatico utilizzando una libreria client. Per istruzioni sull'utilizzo della libreria e l'autenticazione, consulta la panoramica sulle librerie client.

Creazione di un'area di autenticazione

Le aree di autenticazione possono essere globali o a livello di area geografica. Un regno globale è una buona opzione se i cluster registrati in un regno provengono da regioni che coprono varie località geografiche, come il Nord America e il Sud America o l'Europa e l'Asia. Un regno a livello di regione è una buona opzione se i cluster si trovano nella stessa regione, come Europe West. In caso di interruzione della rete tra regioni, un'area di autenticazione globale potrebbe non essere in grado di gestire i cluster in ogni area geografica. Per aumentare la resilienza contro le interruzioni di rete tra aree geografiche, assicurati di creare aree di autenticazione delle aree geografiche il più vicine possibile ai cluster di server di gioco associati.

Ad esempio, se crei cluster nelle regioni europe-west1, europe-west2 e europe-west3 per servire gli utenti nella zona occidentale degli Stati Uniti, puoi anche creare un'area di autenticazione regionale in una di queste aree geografiche. Con questa configurazione, l'area di autenticazione può continuare a gestire i cluster in caso di impossibilità di raggiungere queste aree geografiche da altre aree geografiche del mondo a causa di un'interruzione della rete.

Se non sai dove creare il tuo regno, usalo come regno globale. Man mano che i tuoi requisiti cambiano, puoi creare un nuovo regno in una regione più vicina ai cluster che deve gestire. A questo punto, puoi spostare i cluster esistenti nel nuovo regno a livello di regione eliminando e annullando la registrazione dei cluster dal regno globale, quindi registrandoli nel nuovo regno.

Console

Nella console Google Cloud, vai alla pagina Realm e cluster.

Vai a Game Servers
Fai clic su Crea realm.
Nella casella Nome area di autenticazione, inserisci un identificatore univoco per l'area di autenticazione.
Nella casella Fuso orario, seleziona un fuso orario per questo realm. Quando pianifichi eventi basati sul tempo, come i criteri di scalabilità, il fuso orario viene applicato a questo fuso orario.
Fai clic su Crea.

gcloud

Puoi creare aree di autenticazione utilizzando Google Cloud CLI. Per creare un'area di autenticazione globale, esegui il comando seguente e sostituisci i valori segnaposto, ad esempio realmID, con i valori appropriati:

gcloud game servers realms create realmID --time-zone tz

Per creare un'area di autenticazione a livello di area geografica, esegui questo comando e sostituisci i valori segnaposto, ad esempio realmID, con i valori appropriati:

gcloud game servers realms create realmID --time-zone tz --location=region

I segnaposto delle variabili corrispondono alle seguenti descrizioni:

realmID è un identificatore univoco che puoi specificare per questo regno.
tz è il fuso orario di questo regno. Quando pianifichi eventi basati sul tempo, come i criteri di scalabilità, il fuso orario è relativo a questo fuso orario.
region è l'area geografica del regno. Se vuoi controllare i domini in errore, specifica un'area geografica. Ti consigliamo di creare un'area di autenticazione globale e di omettere questa opzione.

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: la regione del regno. Se vuoi controllare i domini in errore, specifica una regione dall'elenco delle località supportate. Ti consigliamo di specificare un'area di autenticazione global.
REALM_ID: un identificatore definito dall'utente per il nuovo dominio
TIME_ZONE: il fuso orario di questo regno (ad esempio US/Eastern). Pianifica gli eventi basati sul tempo, ad esempio i criteri di scalabilità, per questo fuso orario.

Corpo JSON richiesta:

{
  "timeZone": "TIME_ZONE"
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all' interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login, oppure utilizzando Cloud Shell, che esegue automaticamente l'accesso all'interfaccia a riga di comando di gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

cat > request.json << 'EOF'
{
  "timeZone": "TIME_ZONE"
}
EOF

Quindi, esegui il comando seguente per inviare la richiesta REST:

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms?realmId=REALM_ID"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

@'
{
  "timeZone": "TIME_ZONE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi, esegui il comando seguente per inviare la richiesta REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms?realmId=REALM_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.gaming.v1.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Elenco aree di autenticazione

Console

Nella console Google Cloud, vai alla pagina Realm e cluster.

Vai a Game Servers
Puoi utilizzare la casella di filtro per filtrare l'elenco di aree di autenticazione in base alle diverse proprietà.

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: la regione dei realm o global

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "realms": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm1",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "timeZone": "US/Eastern",
      "etag": "PlXtLrUJ5pHQoZk0Lz-pWkPFN_dt3PXhIpRrJ5HHWu8"
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm2",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "timeZone": "America/Eirunepe",
      "etag": "ay1tXqeujLSsSd93n6uhlZwlxdNTOfG7El992Tsiz98"
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/realms/realm3",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "timeZone": "Asia/Anadyr",
      "etag": "cBxzV2AWK_zgijSmYA-oXPWv3giwhUzssoWcqjPZFuk"
    }
  ]
}

gcloud

Puoi elencare i regni globali o a livello di area geografica utilizzando Google Cloud CLI.

Per elencare le aree di autenticazione globali e regionali, esegui questo comando:

gcloud game servers realms list

Per elencare le aree geografiche in una località specifica, esegui il comando seguente e sostituisci region con global o un'area geografica di Google Cloud:

gcloud game servers realms list --location=region

Aree descrittive

Console

Nella console Google Cloud, vai alla pagina Realm e cluster.

Vai a Game Servers
Puoi utilizzare la casella di filtro per filtrare l'elenco di aree di autenticazione in base alle diverse proprietà.
Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Visualizza dettagli.

gcloud

Puoi ottenere dettagli su un'area di autenticazione, ad esempio l'ora di creazione o il fuso orario, utilizzando Google Cloud CLI.

Per descrivere un'area di autenticazione globale, esegui questo comando e sostituisci realmID con l'identificatore di un'area di autenticazione creata in precedenza:

gcloud game servers realms describe realmID

Se hai creato uno o più aree di autenticazione non globali, puoi descrivere i dettagli relativi a un'area geografica in una regione specifica. Per descrivere un'area di autenticazione in un'area geografica, sostituisci realmID con l'identificatore di un'area di autenticazione che hai creato in precedenza e l'region con l'area geografica in cui si trova l'area di autenticazione:

gcloud game servers realms describe realmID --location=region

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: la regione del regno o global
REALM_ID: un identificatore definito dall'utente per l'area di autenticazione

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Esegui questo comando:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID"

PowerShell (Windows)

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID",
  "createTime": CREATE_TIME,
  "updateTime": UPDATE_TIME,
  "timeZone": "Asia/Anadyr",
  "etag": "cBxzV2AWK_zgijSmYA-oXPWv3giwhUzssoWcqjPZFuk"
}

Aggiornamento di un'area di autenticazione

gcloud

Per aggiornare un campo di un'area di autenticazione, esegui il comando gcloud game servers realms update dopo aver sostituito realmID e region per un'area di autenticazione esistente. Il seguente comando aggiorna il valore del fuso orario per un'area di autenticazione. Sostituisci tz con un valore di fuso orario supportato.

gcloud game servers realms update realmID --location=region \
    --time-zone=tz --no-dry-run

Per trovare i flag per altri campi di realm, consulta il riferimento gcloud.

REST

Il seguente esempio aggiorna il campo timeZone. Per aggiornare altri campi, aggiungi i nomi dei campi al parametro di ricerca ?updateMask= e richiedi il corpo JSON.

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

PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM
LOCATION: la regione del regno
REALM_ID: l'identificatore definito dall'utente per l'area di autenticazione
TIME_ZONE: il fuso orario aggiornato per questo dominio (ad esempio US/Eastern). Puoi pianificare gli eventi basati sul tempo, ad esempio i criteri di scalabilità, per questo fuso orario.

Corpo JSON richiesta:

{
  "timeZone": "TIME_ZONE"
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

cat > request.json << 'EOF'
{
  "timeZone": "TIME_ZONE"
}
EOF

Quindi, esegui il comando seguente per inviare la richiesta REST:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID?updateMask=timeZone"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json. Esegui questo comando nel terminale per creare o sovrascrivere questo file nella directory attuale:

@'
{
  "timeZone": "TIME_ZONE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Quindi, esegui il comando seguente per inviare la richiesta REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/realms/REALM_ID?updateMask=timeZone" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

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

Passaggi successivi

Scopri come registrare un cluster.
Scopri come eliminare un regno.