Gestione dei servizi

In questa pagina viene descritta la creazione di un servizio e la relativa visualizzazione delle informazioni. I servizi sono le risorse principali di Cloud Run. Ogni servizio ha un URL univoco e permanente che non cambierà nel tempo man mano che ne eseguirai il deployment.

Il dominio permanente del servizio è costituito dal nome del servizio e da un hash.

Creare un Service

Per creare un nuovo servizio, esegui per la prima volta il deployment di un'immagine container. Eseguire il deployment di un nuovo servizio offre ulteriori istruzioni.

Visualizzare l'elenco dei servizi nel progetto

Puoi visualizzare un elenco dei servizi disponibili nel tuo progetto utilizzando la console Google Cloud o la riga di comando gcloud:

Console

Per visualizzare l'elenco dei servizi:

  1. Vai a Cloud Run

  2. Esamina l'elenco visualizzato dei servizi per il progetto:

    elenco di servizi

Riga di comando

Per elencare i servizi presenti 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:

Copiare un servizio

Puoi creare una copia di un servizio esistente utilizzando la console Google Cloud o YAML. Puoi modificare tutto ciò che vuoi nella copia, inclusi nome e regione.

Console

Per copiare un servizio:

  1. Vai a Cloud Run

  2. Seleziona il servizio da copiare dall'elenco visualizzato dei servizi per il tuo progetto:

    elenco di servizi

    1. Fai clic su Copia.

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

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

YAML

Puoi scaricare e visualizzare le configurazioni di servizio esistenti utilizzando il comando gcloud run services describe --format export, che restituisce risultati puliti in formato YAML. Puoi quindi modificare i campi descritti di seguito e caricare il file YAML modificato utilizzando il comando gcloud run services replace. Assicurati di modificare i campi solo come documentato.

  1. Per visualizzare e scaricare la configurazione:

    gcloud run services describe SERVICE --format export > service.yaml
  2. Apporta le modifiche desiderate alla configurazione al servizio.

     apiVersion: serving.knative.dev/v1
     kind: Service
     metadata:
       annotations:
         ...
       name: SERVICE
       ...
     spec:
       template:
         metadata:
           annotations:
           ...
           name: REVISION
    
    • Se non stai eseguendo 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 una regione diversa, puoi utilizzare il nome precedente.
    • Sostituisci REVISION con un nuovo nome di revisione o eliminalo (se presente). Se specifichi un nuovo nome, la revisione 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.

Visualizzare altri dettagli su un servizio

Per visualizzare ulteriori dettagli su un servizio:

Console

Per visualizzare i dettagli di un servizio:

  1. Vai a Cloud Run

  2. Fai clic sul servizio che ti interessa nell'elenco dei servizi visualizzato per il tuo progetto per aprire la visualizzazione dei dettagli del servizio.

Riga di comando

Per visualizzare i dettagli di un servizio:

gcloud run services describe SERVICE
Sostituisci SERVICE con il nome del servizio.

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

gcloud run services describe SERVICE --format yaml

Puoi usare --format export per esportare come YAML senza etichette o stati generati automaticamente:

gcloud run services describe SERVICE --format export

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

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

Cloud Code

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

Per maggiori dettagli sulle revisioni dei servizi, consulta Gestione delle revisioni.

Librerie client

Per visualizzare i dettagli su un servizio dal codice:

Disattivare un servizio esistente

Cloud Run non offre un modo diretto per far sì che un servizio interrompa la gestione del traffico, ma puoi ottenere un risultato simile revocando l'autorizzazione per richiamare il servizio alle identità che richiamano il servizio. In particolare, se il servizio è "public", rimuovi allUsers dal ruolo Invoker di Cloud Run (roles/run.invoker).

Elimina i servizi esistenti

All'eliminazione di un servizio si applicano le seguenti considerazioni:

  • L'eliminazione di un servizio comporta l'eliminazione di tutte le risorse correlate al servizio, incluse tutte le revisioni del servizio indipendentemente dal fatto che stiano gestendo il traffico o meno.
  • L'eliminazione di un servizio non rimuove automaticamente le immagini container da Container Registry. Per eliminare da Container Registry le immagini container utilizzate dalle revisioni eliminate, consulta la pagina sull'eliminazione delle immagini.
  • L'eliminazione di un servizio con uno o più trigger Eventarc non elimina automaticamente questi trigger. Per eliminare gli attivatori, consulta Gestire gli attivatori.
  • Dopo l'eliminazione, il servizio rimane visibile nella console Google Cloud e nell'interfaccia a riga di comando fino al completamento dell'eliminazione. ma non puoi aggiornarlo.
  • L'eliminazione di un servizio è definitiva: non è possibile annullare o ripristinare. Tuttavia, se dopo l'eliminazione di un servizio esegui il deployment di un nuovo servizio con lo stesso nome nella stessa regione, il servizio avrà lo stesso URL dell'endpoint.

Console

Per eliminare un servizio:

  1. 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. Questa azione elimina tutte le revisioni del servizio.

Riga di comando

Per eliminare un servizio, utilizza il comando:

gcloud run services delete [SERVICE]

Sostituisci [SERVICE] con il nome del tuo servizio.

Librerie client

Per eliminare un servizio dal codice: