Gestire i servizi Cloud Run

Console

Per visualizzare l'elenco dei servizi:

1. Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:

   Vai a Cloud Run

2. Esamina l'elenco dei servizi visualizzati per il tuo progetto.

gcloud

Per elencare i servizi nel tuo progetto:

gcloud run services list

Tieni presente che a ogni servizio è associato un URL.

Puoi filtrare questo elenco in base alle proprietà della definizione del servizio, ad esempio un'etichetta assegnata.

Cloud Code

Per visualizzare l'elenco dei servizi con Cloud Code, leggi le guide di Explorer di Cloud Run per IntelliJ e Visual Studio Code.

Librerie client

Per visualizzare l'elenco dei servizi dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per visualizzare l'elenco dei servizi nel tuo progetto, invia una richiesta HTTP GET all' endpointservice dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i servizi. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. All'interno di un'istanza container di Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
• REGION con la Cloud de Confiance regione del servizio.
• PROJECT-ID con l'ID progetto Cloud de Confiance .

Console

Per filtrare le funzioni nell'elenco dei servizi:

1. Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:

   Vai a Cloud Run

2. Seleziona Filtra servizi > Tipo di deployment > Funzione.

   Se hai eseguito il deployment della funzione in precedenza utilizzando l'API Cloud Functions v2, la colonna Deployment eseguito da mostrerà Cloud Functions.

Console

Per copiare un servizio:

1. Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:

   Vai a Cloud Run

2. Seleziona la casella di controllo accanto al servizio da copiare dall'elenco dei servizi visualizzato per il tuo progetto.

3. Fai clic su Copia.

4. Nella pagina di copia del servizio, imposta o modifica i valori che vuoi cambiare, come la regione e così via. Se mantieni la stessa regione, devi fornire un nuovo nome per il servizio.

5. Fai clic su Crea per creare una copia e eseguirne il deployment utilizzando il nuovo nome del servizio.

YAML

1. Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:

   gcloud run services describe SERVICE --format export > service.yaml

2. Apporta le seguenti modifiche alla configurazione del servizio.

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      annotations:
        ...
      name: SERVICE
      ...
    spec:
      template:
        metadata:
          annotations:
          ...
          name: REVISION
   

   • Se non esegui il deployment della copia in un'altra regione, sostituisci SERVICE con il nome che vuoi utilizzare per la copia. Se stai eseguendo il deployment della copia in un'altra regione, puoi utilizzare il nome precedente.
   • Sostituisci REVISION: un nuovo nome di revisione o eliminalo (se presente). Se fornisci un nuovo nome per la revisione, questo deve soddisfare i seguenti criteri:
     • Inizia con SERVICE-
     • Contiene solo lettere minuscole, numeri e -
     • Non termina con -
     • Non supera i 63 caratteri

3. Copia il servizio utilizzando il seguente comando:

   gcloud run services replace service.yaml

   Utilizza il flag --region per eseguire il deployment della copia in un'altra regione.

Console

Per visualizzare i dettagli di un servizio:

1. Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:

   Vai a Cloud Run

2. Fai clic sul servizio nell'elenco visualizzato per aprire la visualizzazione dei dettagli del servizio.

gcloud

Per visualizzare i dettagli di un servizio:

gcloud run services describe SERVICE

Puoi utilizzare il flag --format per formattare l'output. Ad esempio, come YAML:

gcloud run services describe SERVICE --region REGION --format yaml

Sostituisci:

• SERVICE con il nome del servizio.
• REGION con la regione Cloud de Confiance del servizio.

Puoi utilizzare --format export per esportare come YAML senza etichette o stato generati automaticamente:

gcloud run services describe SERVICE --region REGION --format export

Puoi anche utilizzare il flag --format per ottenere l'URL del servizio:

gcloud run services describe SERVICE --region REGION --format='value(status.url)'

Cloud Code

Per visualizzare i dettagli di un servizio con Cloud Code, leggi le guide di Cloud Run Explorer per IntelliJ e Visual Studio Code.

Per maggiori dettagli sulle revisioni del servizio, consulta Gestione delle revisioni.

Librerie client

Per visualizzare i dettagli di un servizio dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per visualizzare i dettagli di un servizio, invia una richiesta HTTP GET all'endpoint service dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per visualizzare i dettagli del servizio. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
• SERVICE-NAME con il nome del servizio.
• REGION con la regione Cloud de Confiance del servizio.
• PROJECT-ID con l'ID progetto Cloud de Confiance .

Console

1. Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:

   Vai a Cloud Run

2. Fai clic sul servizio che vuoi disattivare per visualizzare il relativo pannello dei dettagli, quindi fai clic sulla scheda Scalabilità.

3. Seleziona Scalabilità manuale.

4. Inserisci il valore 0 (zero) nel campo etichettato Numero di istanze.

5. Fai clic su Visualizza differenze e fai il deployment, quindi su Esegui il deployment delle modifiche.

gcloud

Per disattivare un servizio, utilizza il seguente comando per impostare la scalabilità su zero:

gcloud run services update SERVICE --scaling=0

Sostituisci SERVICE con il nome del servizio.

YAML

1. Scarica la configurazione YAML del servizio:

   gcloud run services describe SERVICE --format export > service.yaml

2. Imposta l'attributo manualInstanceCount su zero (0):

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
     annotations:
     run.googleapis.com/scalingMode: manual
     run.googleapis.com/manualInstanceCount: `0`

   Sostituisci SERVICE con il nome del tuo servizio Cloud Run.

3. Crea o aggiorna il servizio utilizzando il seguente comando:

   gcloud run services replace service.yaml

API REST

Per disattivare un servizio, invia una richiesta HTTP PATCH all'endpoint service dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

    curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    -X PATCH \
    -d '{"scaling":{"manualInstanceCount":0 }}' \
    https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.manualInstanceCount

Sostituisci quanto segue:

• ACCESS_TOKEN: un token di accesso valido per un account che dispone delle autorizzazioni IAM per aggiornare un servizio. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. Da un'istanza container Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
• SERVICE: il nome del servizio.
• REGION: la regione Cloud de Confiance in cui è stato eseguito il deployment del servizio.
• PROJECT_ID: l'ID progetto Cloud de Confiance .

Terraform

Per disattivare un servizio, imposta l'attributo manual_instance_count su zero (0):

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE_NAME"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "0"
  }
}

Sostituisci quanto segue:

• SERVICE_NAME: il nome del tuo servizio Cloud Run.
• REGION: la regione Cloud de Confiance . Ad esempio europe-west1.
• IMAGE_URL: un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL segue il formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG

Console

Per eliminare un servizio:

1. Nella console Cloud de Confiance by S3NS , vai alla pagina Servizi di Cloud Run:

   Vai a Cloud Run

2. Individua il servizio che vuoi eliminare nell'elenco dei servizi e fai clic sulla relativa casella di controllo per selezionarlo.

3. Fai clic su Elimina. Verranno eliminate tutte le revisioni del servizio.

gcloud

Per eliminare un servizio, utilizza il comando:

gcloud run services delete SERVICE --region REGION

Sostituisci

• SERVICE con il nome del tuo servizio.
• REGION con la Cloud de Confiance regione del servizio.

Librerie client

Per eliminare un servizio dal codice:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

API REST

Per eliminare un servizio, invia una richiesta HTTP DELETE all'endpoint service dell'API Cloud Run Admin.

Ad esempio, utilizzando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME

Sostituisci:

• ACCESS_TOKEN con un token di accesso valido per un account che dispone delle autorizzazioni IAM per eliminare un servizio. Ad esempio, se hai eseguito l'accesso a gcloud, puoi recuperare un token di accesso utilizzando gcloud auth print-access-token. All'interno di un'istanza container di Cloud Run, puoi recuperare un token di accesso utilizzando il server dei metadati dell'istanza container.
• SERVICE-NAME con il nome del servizio.
• REGION con la regione Cloud de Confiance del servizio.
• PROJECT-ID con l'ID progetto Cloud de Confiance .