Gestione dei servizi

In questa pagina viene descritta la creazione di un servizio e la visualizzazione delle relative informazioni. I servizi sono le risorse principali di Knative serving.

crea un servizio

Crei un nuovo servizio e la sua revisione entro il eseguendo il deployment di un'immagine container per la prima volta. Consulta Deployment di un nuovo servizio per saperne di più su la creazione dei servizi.

Visualizzazione dell'elenco dei servizi nel progetto

Puoi visualizzare un elenco dei servizi disponibili nel tuo progetto utilizzando Console Google Cloud o Google Cloud CLI:

Console

Per visualizzare l'elenco dei servizi:

  1. Vai a Knative serving nella console Google Cloud:

    Vai a Knative serving

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

Riga di comando

Per elencare i servizi nel tuo progetto:

gcloud run services list

Puoi filtrare questo elenco in base alle proprietà della definizione del servizio, come etichetta assegnata.

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 Knative serving nella console Google Cloud:

    Vai a Knative serving

  2. Seleziona il servizio da copiare dall'elenco visualizzato per i tuoi progetto:

    1. Fai clic su Copia.

    2. Nella pagina di copia del servizio, imposta o modifica i valori che desideri modificare. come regione e così via. Se intendi mantenere la stessa regione, devi fornire un valore un nuovo nome per il servizio.

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

YAML

Puoi scaricare la configurazione di un servizio esistente in un YAML con il comando gcloud run services describe utilizzando --format=export. Puoi quindi modificare il file YAML ed eseguire il deployment queste modifiche con il comando gcloud run services replace. Assicurarsi di modificare solo gli attributi specificati.

  1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

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

    Sostituisci SERVICE con il nome del tuo servizio Knative serving.

  2. Apporta le modifiche desiderate alla configurazione del servizio come descritto in da varie pagine di configurazione.

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

    • Se esegui il deployment della copia nello stesso cluster Kubernetes, sostituisci SERVICE con il nome che vuoi utilizzare per la copia. Se eseguendo il deployment della copia in un cluster Kubernetes diverso, puoi utilizzare con lo stesso nome.

    • Assicurati che il valore per REVISION-NAME inizi con il servizio nome (SERVICE). Ad esempio, se il nuovo nome del servizio è mynewfoo, il nome della revisione deve essere nel formato mynewfoo-whatever. (Facoltativo) Elimina completamente il valore e crea un nuovo nome di revisione automaticamente.

  3. Copia il servizio utilizzando questo comando:

    gcloud run services replace service.yaml

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

Visualizzazione di ulteriori dettagli su un servizio

Per vedere altri dettagli su un servizio,

Console

Per visualizzare i dettagli di un servizio:

  1. Vai a Knative serving nella console Google Cloud:

    Vai a Knative serving

  2. Fai clic sul servizio desiderato nell'elenco visualizzato per il tuo progetto per aprire la visualizzazione dei dettagli del servizio:

  3. Prendi nota delle schede REVISIONI, LOG e DETTAGLI. La scheda Revisioni mostra l'elenco delle revisioni, la scheda Log mostra i log di servizio, e la scheda dei dettagli mostra authentication o impostazioni di connettività.

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 utilizzare --format export per eseguire l'esportazione in formato YAML senza etichette o stato generati:

gcloud run services describe SERVICE --format export

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

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

Per maggiori dettagli sulle revisioni di un servizio, vedi Gestione delle revisioni.

Modifica delle impostazioni di connettività dei servizi

Un servizio Knative serving può avere una delle due seguenti opzioni di connessione:

  • external, che consente l'accesso esterno al servizio

  • internal, che limita l'accesso solo ad altri servizi nel tuo cluster.

Per modificare le impostazioni, puoi utilizzare la console o Google Cloud CLI.

Console

Per modificare le impostazioni di connettività del servizio:

  1. Vai a Knative serving nella console Google Cloud:

    Vai a Knative serving

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

  3. Fai clic sulla scheda Trigger.

  4. Seleziona l'impostazione che preferisci e fai clic su Salva.

Riga di comando

Per modificare le impostazioni di connettività del servizio, aggiorna il servizio con il impostazione di connettività:

gcloud run services update [SERVICE] --connectivity=[OPTION]

  • Sostituisci [SERVICE] con il nome del servizio che stai aggiornando. Puoi omettere completamente questo parametro, ma ti verrà chiesto di specificare il nome del servizio, se lo ometti.

  • Sostituisci [OPTION] con internal o external.

Eliminazione di servizi esistenti in corso...

L'eliminazione di un servizio elimina tutte le risorse correlate al servizio, incluse tutte le revisioni di questo servizio indipendentemente dal fatto che stiano gestendo o meno il traffico.

Quando elimini un servizio, le immagini container utilizzate dalle revisioni eliminate non vengono automaticamente da Container Registry. Per eliminare le immagini container da Per Container Registry, consulta Eliminazione di immagini.

Tieni presente che l'eliminazione di un servizio è definitiva: non è possibile annullare o ripristinare un servizio. Tuttavia, se dopo l'eliminazione di un servizio, esegui il deployment di un nuovo servizio con lo stesso nello stesso cluster, avrà lo stesso URL endpoint.

Console

Per eliminare un servizio:

  1. Vai a Knative serving nella console Google Cloud:

    Vai a Knative serving

  2. Individua il servizio che desideri eliminare nell'elenco dei servizi e fai clic su relativa alla casella di controllo per selezionarla.

  3. Fai clic su ELIMINA. Questa operazione 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.