Gestione dei servizi

Questa pagina descrive la creazione di un servizio e la visualizzazione delle informazioni su un servizio. I servizi sono le risorse principali di Knative serving.

crea un servizio

Puoi creare un nuovo servizio e la relativa revisione eseguendo per la prima volta il deployment di un'immagine container. Per scoprire di più sulla creazione dei servizi, consulta Eseguire il deployment di un nuovo servizio.

Visualizzare l'elenco dei servizi nel progetto

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

Console

Per visualizzare l'elenco dei servizi:

  1. Vai a Erogazione Knative nella console Google Cloud:

    Vai a Knative serving

  2. Esamina l'elenco di servizi visualizzato 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, ad esempio un'etichetta assegnata.

Copiare un servizio

Puoi creare una copia di un servizio esistente utilizzando la console Google Cloud o YAML. Puoi modificare qualsiasi elemento della copia, inclusi nome e regione.

Console

Per copiare un servizio:

  1. Vai a Erogazione Knative nella console Google Cloud:

    Vai a Knative serving

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

    1. Fai clic su Copia.

    2. Nella pagina della copia del servizio, imposta o modifica i valori che vuoi modificare, come la 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 e implementarla utilizzando il nuovo nome del servizio.

YAML

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe utilizzando il --format=export flag. Puoi quindi modificare il file YAML e implementare queste modifiche con il comando gcloud run services replace. Devi assicurarti di modificare solo gli attributi specificati.

  1. Scarica la configurazione del servizio in un file denominato service.yaml nello spazio di lavoro locale:

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

    Sostituisci SERVICE con il nome del servizio Knative serving.

  2. Apporta le modifiche di configurazione necessarie al servizio come descritto nelle 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 stai eseguendo il deployment della copia in un altro cluster Kubernetes, puoi utilizzare lo stesso nome.

    • Assicurati che il valore di REVISION-NAME inizi con il nome del servizio (SERVICE). Ad esempio, se il nuovo nome del servizio è mynewfoo, il nome della revisione deve essere nel formato mynewfoo-whatever. Se vuoi, elimina del tutto il valore e verrà creato automaticamente un nuovo nome di revisione.

  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 una regione diversa.

Visualizzare ulteriori dettagli su un servizio

Per visualizzare ulteriori dettagli su un servizio,

Console

Per visualizzare i dettagli di un servizio:

  1. Vai a Erogazione Knative nella console Google Cloud:

    Vai a Knative serving

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

  3. Tieni presente le schede REVISIONI, LOG e Dettagli. La scheda Revisioni mostra l'elenco delle revisioni, la scheda Log mostra i log del servizio e la scheda Dettagli mostra le impostazioni attuali di autenticazione o 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 file YAML:

gcloud run services describe SERVICE --format yaml

Puoi utilizzare --format export per esportare in formato YAML senza etichette o stato 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)'

Per informazioni dettagliate sulle revisioni di un servizio, consulta Gestire le revisioni.

Modificare le impostazioni di connettività del servizio

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

  • external, che consente l'accesso esterno al servizio

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

Puoi utilizzare la console o Google Cloud CLI per modificare le impostazioni.

Console

Per modificare le impostazioni di connettività del servizio:

  1. Vai a Erogazione Knative nella console Google Cloud:

    Vai a Knative serving

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

  3. Fai clic sulla scheda Attivatori.

  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 l'impostazione di connettività che preferisci:

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

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

  • Sostituisci [OPTION] con internal o external.

Eliminazione dei servizi esistenti

L'eliminazione di un servizio comporta l'eliminazione di tutte le risorse correlate, incluse tutte le revisioni del servizio, indipendentemente dal fatto che gestiscano o meno il traffico.

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

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

Console

Per eliminare un servizio:

  1. Vai a Erogazione Knative nella console Google Cloud:

    Vai a Knative serving

  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.

Riga di comando

Per eliminare un servizio, utilizza il comando:

gcloud run services delete [SERVICE]

Sostituisci [SERVICE] con il nome del servizio.