Creazione di un deployment

In questa pagina viene spiegato come creare, elencare, descrivere e aggiornare i deployment di Game Servers. Un deployment gestisce una o più versioni software di cui puoi eseguire il deployment in uno o tutti i realm. Per un esempio end-to-end di come creare un deployment, aggiungi una configurazione, quindi eseguine l'implementazione, vedi Configurazione del comportamento di scalabilità dei cluster.

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 deployment

Console

Nella console Google Cloud, vai alla pagina Deployment di server di giochi.

Vai a Game Servers
Fai clic su Crea deployment.
Nella casella Nome, inserisci un identificatore univoco per questo deployment.
(Facoltativo) Nella casella Descrizione, inserisci una descrizione per questo deployment.
Fai clic su Crea.

gcloud

Puoi creare un deployment utilizzando Google Cloud CLI.

Per creare un deployment, esegui il comando seguente e sostituisci deploymentID con un valore appropriato:

gcloud game servers deployments create deploymentID

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

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'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
}
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/global/gameServerDeployments?deploymentId=DEPLOYMENT_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:

@'
{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
}
'@  | 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/global/gameServerDeployments?deploymentId=DEPLOYMENT_ID" | Select-Object -Expand Content

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": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Deployment delle schede

Console

Nella console Google Cloud, vai alla pagina Deployment di server di giochi.

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

gcloud

Puoi elencare i deployment utilizzando Google Cloud CLI.

Per elencare i deployment, esegui il comando seguente:

gcloud game servers deployments list

REST

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

PROJECT_ID: il tuo ID progetto Google Cloud elencato nelle impostazioni IAM

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/global/gameServerDeployments"

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/global/gameServerDeployments" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "gameServerDeployments": [
    {
      "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-1",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A"
    },
    {
      "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/my-deployment-2",
      "createTime": CREATE_TIME,
      "updateTime": UPDATE_TIME,
      "etag": "az38kwIY4X3WdP2SA0fkTGib9hwVj7iXLFXAtIzMLpc"
    }
  ]
}

Descrizione di un deployment

Console

Nella console Google Cloud, vai alla pagina Deployment di server di giochi.

Vai a Game Servers
Puoi utilizzare la casella di filtro per filtrare l'elenco dei deployment in base a diverse proprietà.
Nell'ultima colonna della tabella, fai clic sui puntini di sospensione e seleziona Elenca configurazioni. In questa pagina puoi visualizzare le configurazioni attive e inattive per il deployment.
Per creare una nuova configurazione per il deployment, fai clic su Crea configurazione. Per aggiornare l'implementazione, fai clic su Gestisci implementazione.

gcloud

Puoi ottenere dettagli su un deployment, come il tempo di creazione o di aggiornamento, utilizzando Google Cloud CLI.

Per descrivere un deployment, esegui il comando seguente e sostituisci deploymentID con l'identificatore di un deployment creato in precedenza:

gcloud game servers deployments describe deploymentID

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: l'identificatore definito dall'utente per il deployment

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/global/gameServerDeployments/DEPLOYMENT_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/global/gameServerDeployments/DEPLOYMENT_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/global/gameServerDeployments/DEPLOYMENT_ID",
  "createTime": CREATE_TIME,
  "updateTime": UPDATE_TIME,
  "etag": "RI8hTm3ZaMNZ3qRVeKVcxcN3W26_oR559JYofnFi69A"
}

Aggiornamento di un deployment

gcloud

Per aggiornare un campo per un deployment, esegui il comando gcloud game servers deployments update dopo aver sostituito deploymentID per un deployment esistente. Il seguente comando aggiorna il campo della descrizione per un deployment.

gcloud game servers deployments update deploymentID --description="My updated description"

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

REST

Il seguente esempio aggiorna il campo description. 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
DEPLOYMENT_ID: l'identificatore definito dall'utente per il deployment

Corpo JSON richiesta:

{
  "description": "My updated description"
}

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'
{
  "description": "My updated description"
}
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/global/gameServerDeployments/DEPLOYMENT_ID?updateMask=description"

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:

@'
{
  "description": "My updated description"
}
'@  | 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/global/gameServerDeployments/DEPLOYMENT_ID?updateMask=description" | Select-Object -Expand Content

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
}

Passaggi successivi

Scopri come creare una configurazione.
Scopri come creare o aggiornare un'implementazione.
Scopri come eliminare un deployment.