Supprimer un cluster

Cette page explique comment supprimer un cluster de Game Servers.

Avant de commencer

Avant de commencer, nous vous recommandons de vous familiariser avec les concepts clés de la page Présentation de Game Servers. Assurez-vous également que vous avez également effectué les tâches suivantes :

Assurez-vous d'avoir activé l'API des services de jeux.

Activer l'API Game Services

Choisissez une interface système sur laquelle gcloud CLI est installée ou utilisez un client API:

Cloud Shell

Pour lancer Cloud Shell, procédez comme suit :

Accédez à Google Cloud Console.

Google Cloud Console
Dans l'angle supérieur droit de la console, cliquez sur le bouton Activer Cloud Shell :

Une session Cloud Shell s'ouvre dans un cadre situé en bas de la console. Cette interface système vous permet d'exécuter les commandes gcloud.

Shell local

Installer gcloud CLI

Vérifiez que vous avez défini le projet par défaut souhaité pour Google Cloud CLI (sinon, vous devrez spécifier l'indicateur --project explicitement pour chaque commande ultérieurement):

gcloud config list project

Si non, vous pouvez exécuter la commande suivante pour définir un projet par défaut, en remplaçant PROJECT_ID par l'ID de projet souhaité :

gcloud config set project PROJECT_ID

Exécutez la commande suivante pour vérifier votre version de Google Cloud CLI. Game Servers nécessite la version 306.0.0 ou ultérieure de gcloud CLI.

gcloud version

Pour mettre à jour votre installation, exécutez la commande suivante :

gcloud components update

curl/PowerShell

Pour utiliser l'API REST avec curl ou Windows PowerShell, procédez comme suit :

Créer un compte de service
Téléchargez une clé privée sous la forme d'un fichier JSON.
Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.
Example: Linux or macOS
```
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:
```
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
```
Example: Windows

For PowerShell:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

For example:
```
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
```
For command prompt:
```
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
```
Replace KEY_PATH with the path of the JSON file that contains your credentials.

Bibliothèque cliente

Google Cloud Game Servers peut être contrôlé par programmation à l'aide d'une bibliothèque cliente. Pour obtenir des instructions sur l'utilisation de la bibliothèque et l'authentification, consultez la page Présentation des bibliothèques clientes.

Supprimer un cluster

La suppression d'un cluster Game Servers ne supprime aucune ressource du cluster.

Console

Dans la console Google Cloud, accédez à la page Domaines et clusters.

Accéder à Game Servers
Développez un domaine pour afficher les clusters de serveurs de jeu qui lui appartiennent.
Dans la dernière colonne de la table du cluster, cliquez sur les points de suspension , puis sélectionnez Supprimer le cluster du serveur de jeu.

gcloud

Vous pouvez supprimer un cluster Game Servers mondial ou régional à l'aide de Google Cloud CLI.

Pour supprimer un cluster global :

Exécutez la commande suivante et remplacez les valeurs des espaces réservés tels que clusterID et realmID par des valeurs appropriées :
```
gcloud game servers clusters delete clusterID --realm=realmID --dry-run
```
Le résultat affiche targetState pour vous permettre de prévisualiser l'opération avant de supprimer le cluster.

Pour supprimer le cluster, exécutez la commande suivante :

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

Pour supprimer un cluster régional, procédez comme suit :

Exécutez la commande suivante et remplacez les valeurs des espaces réservés tels que clusterID par les valeurs appropriées :
```
gcloud game servers clusters delete clusterID --realm=realmID --location=region --dry-run
```
Le résultat affiche targetState pour vous permettre de prévisualiser l'opération avant de supprimer le cluster.

Pour supprimer le cluster, exécutez la commande suivante :

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

Les espaces réservés de variables correspondent aux descriptions suivantes :

clusterID est l'identifiant unique que vous avez spécifié pour ce cluster.
realmID est l'identifiant unique que vous avez spécifié pour le domaine parent de ce cluster.
region est la région du cluster, le cas échéant. Choisissez le même lieu que le domaine parent.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants:

PROJECT_ID : ID de votre projet Google Cloud répertorié dans les paramètres IAM.
REALM_LOCATION : région du domaine ou global
REALM_ID : identifiant défini par l'utilisateur pour le domaine
GS_CLUSTER_ID : identifiant défini par l'utilisateur pour le cluster

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter gcloud auth list pour vérifier le compte actuellement actif.

exécutez la commande suivante :

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)

exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

{
  "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
}

Vérifiez que votre cluster a bien été supprimé

Vérifiez que vous avez supprimé le cluster en répertoriant vos clusters mondiaux ou régionaux à l'aide de Google Cloud CLI.

Pour répertorier tous les clusters, exécutez la commande suivante :

gcloud game servers clusters list

Pour répertorier les clusters d'une région, exécutez la commande suivante et remplacez region par la région dans laquelle vous souhaitez répertorier les clusters :

gcloud game servers clusters list --location=region

Pour répertorier tous les clusters d'un domaine, exécutez la commande suivante et remplacez realmID par le domaine parent et region par la région du cluster, le cas échéant :

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

Le cluster supprimé n'apparaît plus dans le résultat de la commande.

Étapes suivantes

Découvrez les concepts clés dans la présentation de Game Servers.