Questa pagina è stata tradotta dall'API Cloud Translation.

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 Cloud Run. Ogni servizio ha un URL univoco e permanente che non cambierà nel tempo man mano che ne esegui il deployment di nuove revisioni.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i servizi e le revisioni di Cloud Run, chiedi all'amministratore di concederti il ruolo IAM Sviluppatore Cloud Run (roles/run.developer) per il tuo servizio Cloud Run.

Per un elenco dei ruoli e delle autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Creare un servizio

Puoi creare un nuovo servizio eseguendo il deployment di un'immagine container per la prima volta. Per eseguire il deployment di un nuovo servizio sono disponibili ulteriori istruzioni.

Visualizza l'elenco dei servizi nel tuo 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:

Vai a Cloud Run
Esamina l'elenco di servizi visualizzati per il tuo progetto:

Riga di comando

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 Cloud Run Explorer per IntelliJ e Visual Studio Code.

Librerie client

Per visualizzare l'elenco dei servizi da codice:

API REST

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

Ad esempio, se utilizzi 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. Dall'interno di un'istanza di container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza di container.
REGION con la regione Google Cloud del servizio.
PROJECT-ID con l'ID progetto Google Cloud.

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:

Vai a Cloud Run
Seleziona il servizio da copiare dall'elenco visualizzato per il tuo progetto:
1. Fai clic su Copia.
2. Nella pagina di copia del servizio, imposta o modifica i valori da modificare, ad esempio 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 ed eseguirne il deployment utilizzando il nuovo nome di servizio.

YAML

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
```
Apporta le modifiche necessarie 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 con un nuovo nome di revisione o eliminala (se presente). Se fornisci un nuovo nome per la revisione, deve soddisfare i seguenti criteri:
  - Inizia con SERVICE-
  - Contiene solo lettere minuscole, numeri e -
  - Non termina con -
  - Non deve superare i 63 caratteri
Copia il servizio utilizzando questo 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 vedere altri dettagli su un servizio,

Console

Per visualizzare i dettagli di un servizio:

Vai a Cloud Run
Fai clic sul servizio che ti interessa nell'elenco visualizzato per il tuo progetto per aprire la relativa visualizzazione dei dettagli.

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 --region REGION --format yaml

Sostituisci:

SERVICE con il nome del servizio.
REGION con la regione Google Cloud del servizio.

Puoi utilizzare --format export per eseguire l'esportazione in formato YAML senza etichetta 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 ulteriori dettagli sulle revisioni dei servizi, vedi Gestione delle revisioni.

Librerie client

Per visualizzare i dettagli di un servizio proveniente dal codice:

API REST

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

Ad esempio, se utilizzi 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. Dall'interno di un'istanza di container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza di container.
SERVICE-NAME con il nome del servizio.
REGION con la regione Google Cloud del servizio.
PROJECT-ID con l'ID progetto Google Cloud.

Disattivare un servizio esistente

Per ottenere le autorizzazioni necessarie per disabilitare un servizio e una revisione Cloud Run esistenti, chiedi all'amministratore di concederti il ruolo IAM Amministratore Cloud Run (roles/run.admin) per il tuo progetto.

Cloud Run non offre un modo diretto per impedire a un servizio di gestire il traffico, ma puoi ottenere un risultato simile revocando l'autorizzazione a richiamare il servizio per le identità che richiamano il servizio. In particolare, se il tuo servizio è "public", rimuovi allUsers dal ruolo Invoker di Cloud Run (roles/run.invoker).

Elimina servizi esistenti

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

L'eliminazione di un servizio elimina tutte le risorse correlate al servizio, incluse tutte le revisioni del servizio, indipendentemente dal fatto che stiano gestendo o meno il traffico.
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 Eliminare le immagini.
L'eliminazione di un servizio con uno o più trigger Eventarc non comporta l'eliminazione automatica di 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. Tuttavia, non puoi aggiornare il servizio.
L'eliminazione di un servizio è definitiva: non è possibile annullare o ripristinare il servizio. Tuttavia, se dopo aver eliminato un servizio, esegui il deployment di un nuovo servizio con lo stesso nome nella stessa regione, questo avrà lo stesso URL dell'endpoint.

Console

Per eliminare un servizio:

Vai a Cloud Run
Individua il servizio che desideri eliminare nell'elenco dei servizi e fai clic sulla relativa casella di controllo per selezionarlo.
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 --region REGION

Sostituisci

SERVICE con il nome del tuo servizio.
REGION con la regione Google Cloud del servizio.

Librerie client

Per eliminare un servizio dal codice:

API REST

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

Ad esempio, se utilizzi 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. Dall'interno di un'istanza di container Cloud Run, puoi recuperare un token di accesso utilizzando il server di metadati dell'istanza di container.
SERVICE-NAME con il nome del servizio.
REGION con la regione Google Cloud del servizio.
PROJECT-ID con l'ID progetto Google Cloud.