Eliminazione di un cluster

In questa pagina viene spiegato come eliminare un cluster Game Servers.

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.

Eliminazione di un cluster

L'eliminazione di un cluster Game Servers non elimina alcuna risorsa nel cluster.

Console

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

Vai a Game Servers
Espandi un'area di autenticazione per visualizzare i cluster di server di gioco che fanno parte della stessa.
Nell'ultima colonna della tabella relativa al cluster, fai clic sui puntini di sospensione e seleziona Rimuovi cluster di server di gioco.

gcloud

Puoi eliminare un cluster di Game Servers a livello globale o di una regione utilizzando Google Cloud CLI.

Per eliminare un cluster globale:

Esegui questo comando e sostituisci i valori segnaposto, ad esempio clusterID e realmID, con i valori appropriati:
```
gcloud game servers clusters delete clusterID --realm=realmID --dry-run
```
L'output restituisce targetState in modo da poter visualizzare l'anteprima dell'operazione prima di eliminare il cluster.

Per eliminare il cluster, esegui il comando seguente:

gcloud game servers clusters delete clusterID --realm=realmID --no-dry-run

Per eliminare un cluster a livello di regione:

Esegui questo comando e sostituisci i valori segnaposto, ad esempio clusterID, con i valori appropriati:
```
gcloud game servers clusters delete clusterID --realm=realmID --location=region --dry-run
```
L'output restituisce targetState in modo da poter visualizzare l'anteprima dell'operazione prima di eliminare il cluster.

Per eliminare il cluster, esegui il comando seguente:

gcloud game servers clusters delete clusterID --realm=realmID --location=region --no-dry-run

I segnaposto delle variabili corrispondono alle seguenti descrizioni:

clusterID è l'identificatore univoco specificato per questo cluster.
realmID è l'identificatore univoco specificato per l'area di autenticazione padre di questo cluster.
region è l'area geografica del cluster, se applicabile. Scegli la stessa località del luogo di autenticazione principale.

REST

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

PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM
REALM_LOCATION: la regione del regno o global
REALM_ID: l'identificatore definito dall'utente per l'area di autenticazione
GS_CLUSTER_ID: l'identificatore definito dall'utente per il cluster

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.

Esegui questo comando:

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

PowerShell (Windows)

Esegui questo comando:

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://gameservices.googleapis.com/v1/projects/PROJECT_ID/locations/REALM_LOCATION/realms/REALM_ID/gameServerClusters/GS_CLUSTER_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/gameServerClusters/GS_CLUSTER_ID",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Verifica dell'eliminazione del cluster

Verifica di aver eliminato correttamente il cluster elencando i tuoi cluster globali o a livello di area geografica utilizzando Google Cloud CLI.

Per elencare tutti i cluster, esegui il comando seguente:

gcloud game servers clusters list

Per elencare i cluster in una regione, esegui il comando seguente e sostituisci region con l'area geografica in cui vuoi elencare i cluster:

gcloud game servers clusters list --location=region

Per elencare tutti i cluster in un'area di autenticazione, esegui questo comando e sostituisci realmID con l'area di autenticazione principale e region con l'area geografica del cluster, se applicabile:

gcloud game servers clusters list --realm=realmID --location=region

Il cluster eliminato non compare più nell'output del comando.

Passaggi successivi

Scopri i concetti chiave nella panoramica dei server di gioco.