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 della gestione di Knative.

crea un servizio

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

Visualizzazione dell'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 alla gestione di Knative nella console Google Cloud:

    Vai alla pubblicazione con Knative

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

Riga di comando

Per elencare i servizi presenti nel tuo progetto:

gcloud run services list

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

Copia di 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 alla gestione di Knative nella console Google Cloud:

    Vai alla pubblicazione con Knative

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

    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 la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe utilizzando il flag --format=export. Puoi quindi modificare il file YAML ed eseguire il deployment delle modifiche con il comando gcloud run services replace. Devi assicurarti 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 di pubblicazione Knative.

  2. Apporta le modifiche alla configurazione del 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 esegui il deployment della copia su un cluster Kubernetes diverso, 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, puoi eliminare completamente il valore e creare automaticamente un nuovo nome 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 un'altra regione.

Visualizzare più dettagli su un servizio

Per visualizzare ulteriori dettagli su un servizio:

Console

Per visualizzare i dettagli di un servizio:

  1. Vai alla gestione di Knative nella console Google Cloud:

    Vai alla pubblicazione con Knative

  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:

  3. Osserva le schede REVISIONI, LOG e DETTAGLI. La scheda Revisioni mostra l'elenco delle revisioni, la scheda Log i log di servizio e la scheda Dettagli mostravano 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 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)'

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

Modifica delle impostazioni di connettività dei servizi

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

  • external, che consente l'accesso esterno al tuo 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 alla gestione di Knative nella console Google Cloud:

    Vai alla pubblicazione con Knative

  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.

  3. Fai clic sulla scheda Trigger.

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

Riga di comando

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

gcloud run services update [SERVICE] --connectivity=[OPTION]
  • Sostituisci [SERVICE] con il nome del servizio che stai aggiornando. Puoi omettere completamente questo parametro, ma se lo ometti ti verrà richiesto 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 al servizio, incluse tutte le revisioni del servizio indipendentemente dal fatto che stiano gestendo il traffico o meno.

Quando si elimina 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 Eliminazione delle immagini.

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

Console

Per eliminare un servizio:

  1. Vai alla gestione di Knative nella console Google Cloud:

    Vai alla pubblicazione con Knative

  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.